Windows Communication Foundation (WCF) 通道堆栈采用编码和传输通道将转换为其传输格式的内部消息表示形式和使用特定传输进行发送。 用于 Web 服务互操作性的最常见传输是 HTTP,Web 服务使用的最常见编码是基于 XML 的 SOAP 1.1、SOAP 1.2 和消息传输优化机制 (MTOM)。
本主题介绍如何通过使用以下协议的 WCF 实现详细信息xref:System.ServiceModel.Channels.HttpTransportBindingElement。
规范/文档:
- HTTP 1.1
- SOAP 1.1 HTTP 绑定,第 7 节
- SOAP 1.2 HTTP 绑定第 7 节
本主题介绍了 WCF 实现的详细信息的以下协议xref:System.ServiceModel.Channels.TextMessageEncodingBindingElement和xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement采用。
规范/文档:
- XML
- SOAP 1.1
- SOAP 1.2 核心
- WS-Addressing 2004/08
- W3C Web 服务寻址 1.0-核心
- W3C Web 服务寻址 1.0-SOAP 绑定
- W3C Web 服务寻址 1.0-WSDL 绑定
- W3C Web 服务寻址 1.0-元数据
- WSDL SOAP1.1 绑定
- WSDL SOAP1.2 绑定
本主题介绍了 WCF 实现的详细信息的以下协议xref:System.ServiceModel.Channels.MtomMessageEncodingBindingElement采用。
规范/文档:
在本主题中使用以下 XML 命名空间和关联的前缀:
| 前缀 | 命名空间统一资源标识符 (URI) |
|---|---|
| s11 | http://schemas.xmlsoap.org/soap/envelope |
| s12 | http://www.w3.org/2003/05/soap-envelope |
| wsa | http://www.w3.org/2004/08/addressing |
| wsam | http://www.w3.org/2007/05/addressing/metadata |
| wsap | http://schemas.xmlsoap.org/ws/2004/09/policy/addressing |
| wsa10 | http://www.w3.org/2005/08/addressing |
| wsaw10 | http://www.w3.org/2006/05/addressing/wsdl |
| xop | http://www.w3.org/2004/08/xop/include |
| xmime | http://www.w3.org/2004/06/xmlmime http://www.w3.org/2005/05/xmlmime |
| dp | http://schemas.microsoft.com/net/2006/06/duplex |
SOAP 1.1 和 SOAP 1.2
信封和处理模型
WCF 实现遵循 Basic Profile 1.1 (BP11) 和基本配置文件 1.0 (SSBP10) 的 SOAP 1.1 信封处理。 SOAP 1.2 信封处理是遵循 SOAP12-Part1 实现的。
本部分介绍涉及 BP11 和 SOAP12-Part1 WCF 所执行的某些实现选项。
强制标头处理
WCF 遵循规则处理标头标记mustUnderstand有以下变化的 SOAP 1.1 和 SOAP 1.2 规范中所述。
输入 WCF 通道堆栈的消息是由各个通道由关联的绑定元素,例如配置、 文本消息编码、 安全、 可靠消息传送和事务处理。 每个通道都识别来自关联命名空间的标头,并将其标记为已理解。 消息进入调度程序后,操作格式化程序读取相应消息/操作协定所期望的标头,并将其标记为已理解。 然后,调度程序验证是否还有任何标头未被理解,但仍标记为 mustUnderstand,如果是这样,则引发异常。 包含 mustUnderstand 标头并且目标为接收方的消息不会由接收方应用程序代码进行处理。
这样的分层处理实现了 SOAP 节点的基础结构层和应用层之间的分离。
-
B1111:由 WCF 基础结构通道堆栈处理消息之后但在应用程序处理之前检测到不理解的标头
在 SOAP 1.1 和 SOAP 1.2 中,
mustUnderstand标头值不相同。 Basic Profile 1.1 要求,在 SOAP 1.1 消息中,mustUnderstand值为 0 或 1。 SOAP 1.2 可以使用 0、1、false和true作为值,但建议使用xs:boolean值的规范表示形式(false和true)。 -
B1112:WCF 发出
mustUnderstand值 0,1 表示 SOAP 1.1 和 SOAP 1.2 版本的 SOAP 信封。 WCF 接受的整个值空间xs:boolean有关mustUnderstand标头 (0、 1、false,true)
SOAP 错误
下面是一组特定于 WCF 的 SOAP 错误实现。
-
B2121:WCF 将返回以下 SOAP 1.1 错误代码:
s11:mustUnderstand,s11:Client,和s11:Server。 -
B2122:WCF 将返回以下 SOAP 1.2 错误代码:
s12:MustUnderstand,s12:Sender,和s12:Receiver。
HTTP 绑定
SOAP 1.1 HTTP 绑定
WCF 实现 SOAP1.1 HTTP 绑定遵循 Basic Profile 1.1 规范第 3.4 节如下说明:
-
B2211:WCF 服务不实现 HTTP POST 请求的重定向。
-
B2212:WCF 客户端 3.4.8 支持 HTTP Cookie。
SOAP 1.2 HTTP 绑定
WCF 实现 SOAP 1.2 HTTP 绑定的 SOAP 1.2-part 2 (SOAP12Part2) 规范如下说明中所述。
SOAP 1.2 为 application/soap+xml 媒体类型提供了一个可选的操作参数。 在未使用 WS-Addressing 时,采用此参数优化消息调度很有用,这种情况下,不需要分析 SOAP 消息的正文。
-
R2221:
application/soap+xmlAction 参数时出现在 SOAP 1.2 请求中,必须与匹配soapAction特性,可以在wsoap12:operation相应 WSDL 绑定内的元素。 -
R2222: 如果
application/soap+xml操作参数出现在 SOAP 1.2 消息时,必须匹配wsa:Action时使用的 Ws-addressing 2004/08 或 Ws-addressing 1.0。
如果 WS-Addressing 禁用,并且传入的请求不包含操作参数,则视为未指定消息 Action。
WS-Addressing
WCF 实现 3 个版本的 Ws-addressing:
-
WS-Addressing 2004/08
-
W3C Web 服务寻址 1.0 核心 (ADDR10-CORE) 和 SOAP 绑定 (ADDR10-SOAP)
-
WS-Addressing 1.0 - 元数据
终结点引用
所有版本的 WCF 实现的 Ws-addressing 都使用终结点引用来描述终结点。
终结点引用和 WS-Addressing 版本
WCF 实现多使用 Ws-addressing 的基础结构协议,尤其EndpointReference元素和W3C.WsAddressing.EndpointReferenceType类 (例如,WS-ReliableMessaging、 Ws-secureconversation 和 Ws-trust)。 WCF 支持任一版本的 Ws-addressing 与其他基础结构协议的使用。 WCF 终结点支持每个终结点的一个版本的 Ws-addressing。
对于 R3111 的命名空间EndpointReference元素或与 WCF 终结点交换消息中使用的类型必须匹配的实现此终结点的 WS 寻址版本。
例如,如果一个 WCF 终结点实现 WS-ReliableMessagingAcksTo内的此类的终结点返回标头CreateSequenceResponse使用的 Ws-addressing 版本的EncodingBinding元素指定为此终结点。
终结点引用和元数据
很多情况下,需要对给定终结点进行元数据或元数据引用通信。
B3121:WCF 应采用的 Ws-metadataexchange (MEX) 规范第 6 节通过值或引用包含终结点引用的元数据中所述的机制。
请考虑其中的 WCF 服务要求使用由在令牌颁发者颁发的安全断言标记语言 (SAML) 令牌身份验证的方案http://sts.fabrikam123.com。 WCF 终结点通过使用描述此身份验证要求sp:IssuedToken包含嵌套的断言sp:Issuer指向令牌颁发者的断言。 访问该 sp:Issuer 断言的客户端应用程序需要知道如何与令牌颁发机构终结点进行通信。 客户端需要知道令牌颁发机构的有关元数据。 使用 MEX 中定义的终结点引用元数据扩展,WCF 提供了对令牌颁发者元数据的引用。
<sp:IssuedToken>
<sp:Issuer>
<wsa10:Address>
http://sts.fabrikam123.com
</wsa10:Address>
<wsa10:Metadata>
<mex:Metadata>
<mex:MetadataSection>
<mex:MetadataReference>
<wsa10:Address>
http://sts.fabrikam123.com/mex
</wsa10:Address>
</mex:MetadataReference>
</mex:MetadataSection>
</mex:Metadata>
</wsa10:Metadata>
</sp:Issuer>
</sp:IssuedToken>
消息寻址标头
消息头
这两个 Ws-addressing 版本,WCF 使用以下消息标头,规范中规定wsa:To, wsa:ReplyTo, wsa:Action, wsa:MessageID,和wsa:RelatesTo。
B3211:对于所有 Ws-addressing 版本,WCF 但不会生成默认情况下,Ws-addressing 消息头wsa:FaultTo和wsa:From。
交互的应用程序与 WCF 应用程序可以添加这些消息标头和 WCF 将进行相应处理。
引用参数和属性
WCF 实现的终结点引用参数和引用属性根据各自规范的处理。
B3221:当配置为使用 Ws-addressing 2004/08,WCF 终结点不区分处理引用属性和引用参数。
消息交换模式
Web 服务操作调用所涉及的消息序列称为消息交换模式。 WCF 支持单向、 请求-答复和双工消息交换模式。 本节根据所用的消息交换模式说明 WS-Addressing 对消息处理的需求。
本节通篇都是由请求方发送第一条消息,响应方接收第一条消息。
单向消息
当 WCF 终结点配置为支持消息与给定Action要遵循单向模式时,WCF 终结点下面的以下行为和需求。 除非另行指定,否则行为和规则将适用于这两个版本的 Ws-addressing 在 WCF 中受支持:
-
R3311:请求方必须包含
wsa:To,wsa:Action,和终结点引用所指定的所有引用参数的标头。 如果使用 WS-Addressing 2004/08 并且终结点引用指定了 [reference properties],则对应的标头必须也添加到消息中。 -
B3312:请求者可能包括
MessageID,ReplyTo,和FaultTo标头。 接收方基础结构将忽略这些标头,并且这些标头将传给应用程序。 -
R3313:当使用 HTTP 和在 HTTP 响应路线上发送任何消息时,响应方必须不发送 HTTP 响应正文为空且具有 HTTP 202 状态代码。
如果使用的是 HTTP 传输,并且操作协定声明消息是单向的,则 HTTP 响应仍可用于发送基础结构消息 — 例如,可靠消息传递可通过 HTTP 响应发送
SequenceAcknowledgement消息。 -
B3314:WCF 响应方不发送响应的单向消息中的错误消息。
请求-答复
WCF 终结点配置为使用一条消息时给定Action遵循请求-答复模式,则 WCF 终结点遵循以下行为和需求。 除非另行指定,行为和规则将适用于这两个版本的 Ws-addressing 在 WCF 中受支持:
-
R3321:请求者必须在请求中包含
wsa:To,wsa:Action,wsa:MessageID,和的所有引用参数或引用属性 (或两者) 终结点引用所指定的标头。 -
R3322: 使用当使用 Ws-addressing 2004/08 时,
ReplyTo还必须包含在请求中。 -
R3323:何时使用 Ws-addressing 1.0 和
ReplyTo请求,使用 [address] 属性等于的默认终结点引用中不存在http://www.w3.org/2005/08/addressing/anonymous使用。 -
R3324:请求方必须包含
wsa:To,wsa:Action,并wsa:RelatesTo中答复消息的标头,以及用于所有引用参数或引用属性 (或两者) 指定的标头ReplyTo请求中的终结点引用。
Web 服务寻址错误
R3411:WCF 生成的 Ws-addressing 2004/08 所定义的以下错误。
| 代码 | 原因 |
|---|---|
wsa:DestinationUnreachable |
到达的消息所带有的 ReplyTo 不同于为此通道建立的答复地址;在 To 标头中指定的地址上,没有终结点在进行侦听。 |
wsa:ActionNotSupported |
与终结点关联的基础结构通道或调度程序不能识别在 Action 标头中指定的操作。 |
R3412:WCF 生成的 Ws-addressing 1.0 定义的以下错误。
| 代码 | 原因 |
|---|---|
wsa10:InvalidAddressingHeader |
重复wsa:To, wsa:ReplyTo,wsa:From或wsa:MessageID。 重复wsa:RelatesTo具有相同RelationshipType。 |
wsa10:MessageAddressingHeaderRequired |
缺少必需的 Addressing 标头。 |
wsa10:DestinationUnreachable |
到达的消息所带有的 ReplyTo 不同于为此通道建立的答复地址。 在 To 标头中指定的地址上没有终结点在进行侦听。 |
wsa10:ActionNotSupported |
与终结点关联的基础结构通道或调度程序不能识别在 Action 标头中指定的操作。 |
wsa10:EndpointUnavailable |
RM 通道发送回此错误,指示终结点将不会根据对 CreateSequence 消息的寻址标头的检查结果来处理序列。 |
上表中的代码对应于 SOAP 1.1 中的 FaultCode 和 SOAP 1.2 中的 SubCode (Code=Sender)。
WSDL 1.1 绑定和 WS-Policy 断言
指示使用 WS-Addressing
WCF 使用策略断言来指示终结点支持针对特定的 Ws-addressing 版本。
下面的策略断言具有终结点策略主题 [WS-PA],并指示从终结点收发的消息必须使用 WS-Addressing 2004/08。
<wsap:UsingAddressing />
此策略断言扩充了 WS-Addressing 2004/08 规范。
下面的策略断言指示发送/接收的消息必须使用 WS-Addressing 1.0。
<wsam:Addressing/>
下面的策略断言具有终结点策略主题 [WS-PA],并指示从终结点收发的消息必须使用 WS-Addressing 2004/08。
<wsaw10:UsingAddressing />
wsaw10:UsingAddressing 元素借自于 [WS-Addressing-WSDL],并在符合该规范第 3.1.2 节的 WS-Policy 的上下文中使用。
使用 Addressing 不会更改 WSDL 1.1、SOAP 1.1 和 SOAP 1.2 HTTP 绑定的语义。 例如,如果某个请求发送到使用 Addressing 和 WSDL SOAP 1.x HTTP 绑定的终结点,并且该请求期望得到一个答复,则该答复必须用 HTTP 响应发送。
对于通过 http 响应发送的答复,WS-AM 断言是:
<wsam:AnonymousResponses/>
完整的策略断言可能类似于:
<wsam:Addressing>
<wsp:Policy>
<wsam:AnonymousResponses />
</wsp:Policy>
</wsam:Addressing>
但是,有些消息交换模式可以从在请求方和响应方之间建立两个独立的反向 HTTP 连接中获益,例如,由响应方发送的主动单向消息。
WCF 提供一项功能,通过这两个基础传输通道可构成一个复合双工通道,其中一个通道用于输入消息和其他用于输出消息。 对于 HTTP 传输,复合双工提供了两个反向 HTTP 连接。 请求方使用一个连接将消息发送到响应方,而响应方使用另一个连接将消息发送回请求方。
对于通过单独的 http 请求发送的答复,ws-am 断言是:
<wsam:NonAnonymousResponses/>
完整的策略断言可能类似于:
<wsam:Addressing>
<wsp:Policy>
<wsam:NonAnonymousResponses />
</wsp:Policy>
</wsam:Addressing>
在使用 WSDL 1.1 SOAP 1.x HTTP 绑定的终结点上,如果要使用以下具有终结点策略主题 [WS-PA] 的断言,要求将两个单独的反向 HTTP 连接分别用于从请求方到响应方以及从响应方到请求方传送消息。
<cdp:CompositeDuplex/>
上面的陈述对于请求消息的 wsa:ReplyTo 标头提出了以下要求:
-
R3514:请求消息发送到终结点必须有
ReplyTo标头[address]属性不等于http://www.w3.org/2005/08/addressing/anonymous如果终结点使用 WSDL 1.1 SOAP 1.x HTTP 绑定,并且有的策略备wsap10:UsingAddressing或wsap:UsingAddressing断言再加上cdp:CompositeDuplex附加。 -
R3515:请求消息发送到终结点必须有
ReplyTo标头[address]属性等于http://www.w3.org/2005/08/addressing/anonymous,或不具有ReplyTo根本,如果终结点使用 WSDL 1.1 SOAP 1.x HTTP 绑定,并且有的策略备的标头wsap10:UsingAddressing断言,但不cdp:CompositeDuplex附加。 -
R3516:请求消息发送到终结点必须有
ReplyTo标头[address]属性等于http://www.w3.org/2005/08/addressing/anonymous如果终结点使用 WSDL 1.1 SOAP 1.x HTTP 绑定,并且有的策略备wsap:UsingAddressing断言,但不cdp:CompositeDuplex附加的断言。
WS-addressing WSDL 规范力图描述类似协议绑定,它引入了一个带有 3 个文本值(required、optional 和 prohibited)的 <wsaw:Anonymous/> 元素来指示对 wsa:ReplyTo 标头的需求(第 3.2 节)。 遗憾的是,在 WS-Policy 的上下文中,这样的元素定义不特别适合用作断言,因为它要求使用特定于域的扩展来支持将此类元素用作断言的备选项的交集。 这样的元素定义还指示 ReplyTo 标头的值在传输时与终结点行为相反,这使它只能特定于 HTTP 传输。
操作定义
WS-Addressing 2004/08 为 wsa:Action 元素定义了一个 wsdl:portType/wsdl:operation/[wsdl:input | wsdl:output | wsdl:fault] 属性。 WS-Addressing 1.0 WSDL 绑定 (WS-ADDR10-WSDL) 定义了一个类似属性 wsaw10:Action。
两者之间唯一的区别在于默认 Action 模式语义(分别在 WS-ADDR 第 3.3.2 节和 WS-ADDR10-WSDL 第 4.4.4 节描述)。
一个合理的两个终结点共享同一portType(或协定,在 WCF 术语中),但使用不同版本的 Ws-addressing。 但是,如果 Action 是由 portType 定义的,并且在实现该 portType 的终结点之间不应更改,则不可能同时支持这两种默认操作模式。
若要解决此争议,WCF 支持的单个版本Action属性。
B3521:使用 WCFwsaw10:Action特性,可以在wsdl:portType/wsdl:operation/[wsdl:input | wsdl:output | wsdl:fault]元素中 WS-ADDR10-WSDL 来确定定义Action而不考虑终结点所使用的 Ws-addressing 版本的相应消息的 URI。
在 WSDL 端口内使用终结点引用
WS-ADDR10-WSDL 4.1 节扩展了 wsdl:port 元素以包含 <wsa10:EndpointReference…/> 子元素,从而以 WS-Addressing 方式描述终结点。 WCF 扩展的 Ws-addressing 2004/08,这一实用工具允许<wsa:EndpointReference…/>若要显示的子元素为wsdl:port。
-
R3531:如果终结点有的附加的策略备
<wsaw10:UsingAddressing/>策略断言,相应wsdl:port元素可以包含子元素<wsa10:EndpointReference …/>。 -
R3532:如果
wsdl:port包含一个子元素<wsa10:EndpointReference …/>,则wsa10:EndpointReference/wsa10:Address子元素值必须匹配的值@address的同级元素的特性wsdl:port/wsdl:location元素。 -
R3533:如果终结点有的附加的策略备
<wsap:UsingAddressing/>策略断言,相应wsdl:port元素可以包含子元素<wsa:EndpointReference …/>。 -
R3534:如果
wsdl:port包含一个子元素<wsa:EndpointReference …/>,则wsa:EndpointReference/wsa:Address子元素值必须匹配的值@address的同级元素的特性wsdl:port/wsdl:location元素。
与 WS-Security 的结合
根据 WS-ADDR 和 WS-ADDR10 中的安全注意事项章节,建议将所有寻址消息头和消息正文一起签名,以便将它们绑定在一起。
当 WS-Security 用于消息完整性保护时,WS-Addressing 消息头和从引用参数或/和属性产生的标头必须与消息正文一起签名。
示例
单向消息
在此方案中,发送方向接收方发出单向消息。 使用 SOAP 1.2、HTTP 1.1 和 W3C WS-Addressing 1.0。
请求消息结构:消息标头包括wsa10:To和wsa10:Action元素。 消息正文包含来自应用程序命名空间的一个特定 <app:Ping> 元素。
HTTP 标头:POST 中的目标中的 URI 匹配wsa10:To元素。
按照 SOAP 1.2 的要求,Content-Type 标头的值为 application/soap+xml。 此外,还包含参数 charset 和 action。 Content-Type 标头的 action 参数与 wsa10:Action 消息头的值匹配。
POST http://fabrikam123.com/Service HTTP/1.1
Content-Type: application/soap+xml; charset=utf-8;
action="http://fabrikam123.com/Service/OneWay"
Host: 131.107.72.15
Content-Length: 1501
Expect: 100-continue
Proxy-Connection: Keep-Alive
<s12:Envelope>
<s12:Header>
<wsa10:To s12:mustUnderstand="1">
http://fabrikam123.com/Service
</wsa10:To>
<wsa10:Action s12:mustUnderstand="1">
http://fabrikam123.com/Service/OneWay
</wsa10:Action>
</s12:Header>
<s12:Body>
<Ping xmlns="http://fabrikam123.com/Service/">
<Text>Hello World</Text>
</Ping>
</s12:Body>
</s12:Envelope>
接收方以一个状态为 202 的空 HTTP 响应进行回应。 HTTP 响应的一个示例为:
HTTP/1.1 202 Accepted
Date: Fri, 15 Jul 2005 08:56:07 GMT
Server: Microsoft-IIS/6.0
MicrosoftOfficeWebServer: 5.0_Pub
X-Powered-By: ASP.NET
X-AspNet-Version: 2.0.50215
Cache-Control: private
Content-Length: 0
SOAP Message Transmission Optimization Mechanism(SOAP 消息传输优化机制)
本部分介绍了 HTTP SOAP MTOM WCF 实现详细信息。 MTOM 技术是为传统的 text/XML 编码或 WCF 二进制编码同类的 SOAP 消息编码机制。 MTOM 包括以下内容:
-
[XOP] 描述的 XML 编码和打包机制,用于将包含 base64 编码的二进制数据的 XML 信息项优化为多个独立的二进制部分。
-
XOP 包的 MIME 封装,用于将 XML Infoset 和 XOP 包的每一个二进制部分序列化为单独的 MIME 部分。
-
应用于 SOAP 1.x 信封的 MIME XOP 编码。
-
HTTP 传输绑定。
就可以将 MTOM 用于非 HTTP 传输使用 WCF。 不过,在本主题中,我们将着重讨论 HTTP 上的应用。
MTOM 格式利用了包含 MTOM 本身、XOP 以及 MIME 在内的大型规范集。 在某种程度上,此规范集的模块性使得重新构造格式和处理语义的确切需求变得有点困难。 本节介绍 MTOM HTTP 绑定的格式和处理需求。
MTOM 消息编码
生成 MTOM 消息
[XOP] 第 3.1 节描述了将具有元素信息项(包含 base64 值)的 XML 编码为抽象定义的 XOP 包的过程。
下面的一系列步骤描述了特定于 MTOM 的编码过程:
-
确保 SOAP 信封进行编码包含任何元素信息项替换
[namespace name]的http://www.w3.org/2004/08/xop/include和一个[local name]的Include。 -
创建一个空 MIME 包。
-
在原始 XML Infoset 中标识要优化的元素信息项。 要进行优化的项,这些字符构成
[children]的元素信息项必须是中的规范格式xs:base64Binary(请参见 xsd-2,3.2.16 base64Binary),而且不得包含任何空白字符之前的使用,以内联方式或以下非空白内容。 -
创建一个是原始 SOAP 信封副本的 XOP SOAP 信封,但是,在上一步中标识的每个元素信息项的 children 都替换为如下构造的
xop:Include元素信息项:-
通过将被替换字符处理为 base64 编码的数据,将其转换为二进制数据。
-
生成一个符合 R3133 和 R3134 需求的唯一 Content-ID 标头值。
-
生成一个具有二进制值的 Content-Transfer-Encoding MIME 标头。
-
如果要优化的元素信息项(新插入的
xop:Include元素信息项的 [parent])有一个xmime:contentType属性信息项,则生成一个带有xmime:contentType属性的值的 Content-Type MIME 标头。 -
生成一个新的二进制 MIME 部分,其内容由以下几项组成:从处理为 base64 的被替换数据解码的二进制数据、4b 中的 Content-ID、4c 中的 Content- Transfer-Encoding 标头,以及 Content-Type 标头(如果在步骤 4d 中生成)。
-
将一个
href属性添加到xop:Include元素,其值为从 Content-ID 标头值(在步骤 4b 中生成)派生的 cid: uri。 移除外层"<"和">"字符,URL 转义剩余的字符串,并添加前缀cid:。 以下最小字符集需要根据 RFC1738 和 RFC2396 进行转义。 其他字符也可转义。Hexadecimal 00-1F , 7F, 20, "<" | ">" | "#" | "%" | <"> "{" | "}" | "|" | "\" | "^" | "[" | "]" | "`" | "~" | "^"
-
-
用步骤 4 中的 XOP SOAP 信封创建一个根 MIME 部分。
-
写入 HTTP 标头,包括 HTTP Content-Type 标头。
-
写入 MIME 包。
处理 MTOM 消息
处理 MTOM 消息的过程与前面“生成 MTOM 消息”一节中所述的过程完全相反:
-
确保根 MIME 部分有 Content-Type
application/xop+xml。 -
通过将包的根 MIME 部分作为 XML 文档进行分析,构造一个 SOAP 信封。 字符编码由根 MIME 部分的 Content-Type 的
charset参数确定。 -
对于构造的 SOAP 信封中的每个元素信息项(有一个
xop:Include元素信息项作为其 [children] 属性的唯一成员):-
移除
cid:前缀,取消转义@href元素的xop:Include属性的值中所有 URI 转义序列 (RFC 2396)。 请将结果字符串中的"<",">"。 -
找到 Content-ID 标头值与步骤 3a 中派生的字符串匹配的 MIME 部分。
-
将出现在每一项的
xop:Include属性中的children元素信息项替换为字符信息项,这些字符信息项表示的是 MIME 部分(在步骤 3b 中标识)全部正文的规范 base64 编码(请参见 XSD-2,3.2.16 base64Binary)(实际是将xop:Include元素信息项替换为从包部分重新构造的数据)。
-
HTTP Content-Type 标头
以下是 WCF 所说明的格式的 HTTP 内容类型标头的 SOAP 1.x MTOM 编码消息派生自 MTOM 规范本身所述的要求的列表,并从 MTOM 和 RFC 2387 派生。
-
R4131:HTTP 内容类型标头必须具有值 multipart/related (不区分大小写) 和其参数。 参数名不区分大小写。 参数顺序并不重要。
-
RFC 2045 第 5.1 节中列出了 MIME 消息 Content-Type 标头的完全 Backus-Naur 形式 (BNF)。
-
R4132:HTTP 内容类型标头必须具有值的类型参数
application/xop+xml括在双引号。
要求使用双引号引起来,尽管不是在 RFC 2387 中显式文本观察到的所有 multipart/related 媒体类型参数最有可能包含保留的字符,如"@"或"/",因此需要双引号将标记。
-
R4133:HTTP 内容类型标头应具有一个 start 参数,包含 SOAP 的 MIME 部分的 CONTENT-ID 标头的值与 1.x 信封,括在双引号。 如果省略 start 参数,则第一个 MIME 部分必须包含 SOAP 1.x 信封。
-
R4134:SOAP 1.1 MTOM 编码消息的 HTTP 内容类型标头必须包含值为 text/xml,括在双引号内 start-info 参数。
-
R4135:SOAP 1.2 MTOM 编码消息的 HTTP 内容类型标头必须包含的值的启动信息参数
application/soap+xml、 括在双引号。 -
R4136:SOAP 1.x MTOM 编码消息的 HTTP Content-type 标头必须具有边界参数匹配的 MIME 边界 BNF RFC 2046 第 5.1.1 节中定义的值 (括在双引号内)
boundary := 0*69<bchars> bcharsnospace bchars := bcharsnospace / " " bcharsnospace := DIGIT / ALPHA / "'" / "(" / ")" / "+" / "_" / "," / "-" / "." / "/" / ":" / "=" / "?"示例:
正确
Content-Type: multipart/related; type="application/xop+xml";start=" <part0@tempuri.org>";boundary="uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1";start-info="text/xml"正确
Content-Type: Multipart/Related; type="application/xop+xml";start-info="text/xml";boundary="uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1"不正确
Content-Type: Multipart/Related; type=application/xop+xml;start=" <part0@tempuri.org>";start-info="text/xml";boundary="uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1"
Infoset MIME 部分
SOAP 1.x 信封封装为 XOP MIME 包的根部分,通常称为 infoset 部分。
-
R4141:SOAP 1.x 信封必须封装为 XOP MIME 包,名为的根部分
infoset部分并从 HTTP Content-type 引用。 -
R4142:SOAP
Infoset部分必须包含以下 MIME 标头:Content-ID,Content-Transfer-Encoding,和Content-Type。
Content-ID 标头的格式根据 RFC 2045 定义为
"Content-ID" ":" msg-id
其中 msg-id 在 RFC 2822(取代 RFC 822,在 RFC 2045 中引用)定义:
msg-id = [CFWS] "<" id-left "@" id-right ">" [CFWS]
并且有效的电子邮件地址括起"<"和">"。 RFC 2822 中增加了 [CFWS] 前缀和后缀,用于携带注释,不应用于保持互操作性。
R4143:Infoset MIME 部分的 CONTENT-ID 标头的值必须遵循msg-idRFC 2822 中的生产[CFWS]省略前缀和后缀部分。
多 MIME 实现放宽要求括起来的值"<"和">"电子邮件地址并用absoluteURI括在"<",">"除了电子邮件地址。 此版本的 WCF 使用窗体的 CONTENT-ID MIME 标头的值:
Content-ID: <http://tempuri.org/0>
R4144:处理程序应接受内容 ID 标头值的符合以下宽松msg-id。
msg-id-relaxed = [CFWS] "<" (absoluteURI | mail-address) ">" [CFWS]
mail-address = id-left "@" id-right
MIME (RFC 2045) 提供 Content-Transfer-Encoding 标头来传递 MIME 部分内容的编码。 为 Content-Transfer-Encoding 定义的默认值为 7-bit,它不适合于大多数 SOAP 消息,因此,需要使用 Content-Transfer-Encoding 标头以获得更好的互操作性:
-
R4145:Infoset 部分必须包含的内容传输编码标头。
-
R4146:如果 SOAP 信封字符编码为 utf-8,内容传输编码标头的值必须是 8 位。
-
R4147:如果 SOAP 信封字符编码为 utf-16,内容传输编码标头的值必须是二进制。
-
根据 [XOP] 第 5 节,
-
R4148:SOAP1.1 Infoset 部分必须包含媒体类型为 application/xop + xml 的 Content-type 标头以及参数 type ="text/xml"和 charset
Content-Type: application/xop+xml; charset=utf-8;type="text/xml" -
R4149:SOAP 1.2 Infoset 部分必须包含媒体类型的内容类型标头
application/xop+xml以及参数 type ="application/soap+xml"和charset。Content-Type: application/xop+xml; charset=utf-8;type="application/soap+xml"虽然 XOP 定义
charset参数对于application/xop+xml是可选的,但是对于类似于 BP 1.1 对charset媒体类型要求有text/xml参数的互操作性,该参数仍然是需要的。 -
R41410:
type和charset参数必须出现在 SOAP 1.x Infoset 部分的内容类型标头。
WCF 对 MTOM 的终结点支持
MTOM 的用途是对 SOAP 消息进行编码,以优化 base64 编码数据。 下面列出了相关约束:
-
R4151:任何包含 base64 编码数据的元素信息项可能被优化。
-
B4152:WCF 可以优化包含 base64 编码数据和超过 1024 字节的长度的元素信息项。
WCF 终结点配置为使用 MTOM 会始终发送 MTOM 编码的消息。 即使没有一个部分符合必需的标准,消息仍然是 MTOM 编码消息(序列化为一个 MIME 包,具有包含 SOAP 信封的单个 MIME 部分)。
MTOM 的 WS-Policy 断言
WCF 使用下面的策略断言来指示终结点的 MTOM 的使用情况:
<wsoma:OptimizedMimeSerialization ... />
-
R4211:上面的策略断言具有终结点策略主题,并指定必须使用 MTOM 优化发送到和从终结点接收的所有消息。
-
B4212:WCF 终结点配置为使用 MTOM 优化时,将一个 MTOM 策略断言添加到附加到相应的策略
wsdl:binding。
与 WS-Security 的结合
MTOM 是一种编码机制,类似于text/xml和 WCF 二进制 XML。 MTOM 可以与 WS-Security 及其他 WS-* 协议自然结合:使用 WS-Security 进行保护的消息可使用 MTOM 优化。
示例
使用 MTOM 编码的 WCF SOAP 1.1 消息
POST http://131.107.72.15/Mtom/svc/service.svc/Soap11MtomUTF8 HTTP/1.1
SOAPAction: "http://xmlsoap.org/echoBinaryAsString"
Content-Type: multipart/related;type="application/xop+xml";
start="<http://tempuri.org/0>";start-info="text/xml";
boundary="uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1"
Host: 131.107.72.15
Content-Length: 1501
--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1
Content-ID: <http://tempuri.org/0>
Content-Transfer-Encoding: 8bit
Content-Type: application/xop+xml;charset=utf-8;type="text/xml"
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Body>
<EchoBinaryAsString xmlns="http://xmlsoap.org/Ping">
<array>
<xop:Include
href="cid:http%3A%2F%2Ftempuri.org%2F1%2F632618206521093670"
xmlns:xop="http://www.w3.org/2004/08/xop/include"/>
</array>
</EchoBinaryAsString>
</s:Body>
</s:Envelope>
--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1
Content-ID: <http://tempuri.org/1/632618206521093670>
Content-Transfer-Encoding: binary
Content-Type: application/octet-stream
…Binary Content..
--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=1
使用 MTOM 编码的 WCF 安全 SOAP 1.2 消息
此示例中,消息是使用 MTOM 以及采用 WS-Security 进行保护的 SOAP 1.2 编码的。 标识来进行编码的二进制部分为 BinarySecurityToken 的内容、对应于加密签名的 CipherValue 的 EncryptedData,以及经过加密的正文。 请注意,CipherValue的EncryptedKey未标识为优化由 WCF,因为其长度小于 1024 个字节。
POST http://131.107.72.15/Mtom/service.svc/Soap12MtomSecureSignEncrypt HTTP/1.1
Content-Type: multipart/related; type="application/xop+xml";
start="<http://tempuri.org/0>";
boundary="uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3";
start-info="application/soap+xml";
action="http://xmlsoap.org/echoBinaryAsString"
Host: 131.107.72.15
Content-Length: 1941
--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3
Content-ID: <http://tempuri.org/0>
Content-Transfer-Encoding: 8bit
Content-Type: application/xop+xml;charset=utf-8;type="application/soap+xml"
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
<s:Header>
<o:Security s:mustUnderstand="1" xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<u:Timestamp u:Id="uuid-4d4ee765-5717-4d53-9ac9-99bddc07df6c-5">
<u:Created>2005-09-09T06:57:32.488Z</u:Created>
<u:Expires>2005-09-09T07:02:32.488Z</u:Expires>
</u:Timestamp>
<o:BinarySecurityToken u:Id="uuid-4d4ee765-5717-4d53-9ac9-99bddc07df6c-2" ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3" EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">
<xop:Include href="cid:http%3A%2F%2Ftempuri.org%2F1%2F632618206525089430" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>
</o:BinarySecurityToken>
<e:EncryptedKey Id="_1" xmlns:e="http://www.w3.org/2001/04/xmlenc#">
<e:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p"/>
<KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">
<o:SecurityTokenReference>
<o:KeyIdentifier ValueType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509SubjectKeyIdentifier">Xeg55vRyK3ZhAEhEf+YT0z986L0=</o:KeyIdentifier>
</o:SecurityTokenReference>
</KeyInfo>
<e:CipherData> <e:CipherValue>oQfpxwT8/SAGyZQzKE2b4yO6dXuQj7pwJ+5CGL3Rf7C06bQ5ttMoQ9GLJcQYkXTzin+WwHEgs5bj5ml9HKTW9QAU5JJ6lksdymmQvWP5ZtGPBVchO4sofEGoCKmBiZL/DYS/cnbzgnc/3a6NYnc10y2fWGaGLiqa00zijAw7o0Y=</e:CipherValue>
</e:CipherData>
</e:EncryptedKey>
<c:DerivedKeyToken u:Id="_2" xmlns:c="http://schemas.xmlsoap.org/ws/2005/02/sc">
<o:SecurityTokenReference>
<o:Reference URI="#_1"/>
</o:SecurityTokenReference>
<c:Nonce>OrEPRX7fISIS4sXYWPMv3g==</c:Nonce>
</c:DerivedKeyToken>
<e:ReferenceList xmlns:e="http://www.w3.org/2001/04/xmlenc#">
<e:DataReference URI="#_3"/>
<e:DataReference URI="#_4"/>
</e:ReferenceList>
<e:EncryptedData Id="_4" Type="http://www.w3.org/2001/04/xmlenc#Element" xmlns:e="http://www.w3.org/2001/04/xmlenc#">
<e:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#aes256-cbc"/>
<KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">
<o:SecurityTokenReference>
<o:Reference URI="#_2"/>
</o:SecurityTokenReference>
</KeyInfo>
<e:CipherData>
<e:CipherValue>
<xop:Include href="cid:http%3A%2F%2Ftempuri.org%2F2%2F632618206525089430" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>
</e:CipherValue>
</e:CipherData>
</e:EncryptedData>
</o:Security>
</s:Header>
<s:Body u:Id="_0">
<e:EncryptedData Id="_3" Type="http://www.w3.org/2001/04/xmlenc#Content" xmlns:e="http://www.w3.org/2001/04/xmlenc#">
<e:EncryptionMethod Algorithm="http://www.w3.org/2001/04/xmlenc#aes256-cbc"/>
<KeyInfo xmlns="http://www.w3.org/2000/09/xmldsig#">
<o:SecurityTokenReference xmlns:o="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<o:Reference URI="#_2"/>
</o:SecurityTokenReference>
</KeyInfo>
<e:CipherData>
<e:CipherValue>
<xop:Include href="cid:http%3A%2F%2Ftempuri.org%2F3%2F632618206525089430" xmlns:xop="http://www.w3.org/2004/08/xop/include"/>
</e:CipherValue>
</e:CipherData>
</e:EncryptedData>
</s:Body>
</s:Envelope>
--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3
Content-ID: <http://tempuri.org/1/632618206525089430>
Content-Transfer-Encoding: binary
Content-Type: application/octet-stream
...Binary content of BinarySecurityToken - X509 Certificate...
--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3
Content-ID: <http://tempuri.org/2/632618206525089430>
Content-Transfer-Encoding: binary
Content-Type: application/octet-stream
...Binary serialization of the encrypted primary signature...
--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3
Content-ID: <http://tempuri.org/3/632618206525089430>
Content-Transfer-Encoding: binary
Content-Type: application/octet-stream
...Binary serialization of the encrypted Body...
--uuid:0ca0e16e-feb1-426c-97d8-c4508ada5e82+id=3--
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
