文章目录
第十七章 手动添加安全元素
本主题主要介绍如何手动向 IRIS Web 服务和 IRIS Web 客户端发送的消息中添加安全元素。
以下主题提供了有关特定安全任务的详细信息。
添加安全标头元素
要将安全元素添加到 WS-Security 标头元素,请在 Web 客户端或 Web 服务中使用以下常规过程:
- 创建适用类的实例。为此,可以使用名为
Create()或CreateX509()的方法(具体取决于类)。该实例表示WS-Security标头元素之一,例如<Username> or <EncryptedKey>。 - 通过更新 Web 客户端或
Web服务的SecurityOut属性,将每个实例添加到WS-Security标头元素。为此,请调用AddSecurityElement()方法。 - 发送
SOAP消息。WS-Security标头包含在消息中,并包含添加到其中的元素。 - 对于后续传出消息:
- 对于
Web客户端,SecurityOut属性保持不变,以便此实例的后续出站消息包含添加的安全标头。如果不希望这样,请将SecurityOut属性设置为null。 - 对于
Web服务,在第一个出站SOAP消息之后,SecurityOut属性会自动设置为null`。
标题元素的顺序
当将多个安全元素添加到标头时,按适当的顺序添加安全标头元素非常重要。当对同一消息元素执行加密和签名时,这一点尤其重要:即按执行加密和签名操作的相同顺序添加它们。
标头元素的顺序指示了消息处理的顺序。WS-Security 1.1 规范规定如下:
当元素添加到 <wsse:Security> 标头块时,它们应该被添加到现有元素的前面。因此,<wsse:Security> 标头块表示消息生产者创建消息所采取的签名和加密步骤。此前置规则确保接收应用程序可以按照子元素在<wsse:Security> 标头块中出现的顺序处理子元素,因为子元素之间不存在前向依赖关系。
当添加标题元素时, IRIS 会将每个元素添加到先前添加的元素之前,但以下情况除外:
- 如果包含
<Timestamp>元素,则强制将其作为第一个。 - 如果包含任何
<BinarySecurityToken>元素,它们将被强制遵循<Timestamp>元素(如果包含)或被强制放在第一个。 - 当使用
AddSecurityElement()添加安全标头元素的加密版本时,可以指定第二个参数来强制插入的<EncryptedData>元素遵循关联的<EncryptedKey>
当对同一消息元素执行加密和签名时,按适当的顺序添加安全标头元素尤为重要:即,按照执行加密和签名操作的相同顺序添加它们。