<request> Element (WSE for Microsoft .NET)
Defines the policy for SOAP messages received by a specific Web service method at an endpoint.
<request>
and
<request>
<request policy="policy name" />
Attributes and Elements
Attributes
Attribute | Description |
---|---|
policy |
Required attribute. The ID of the policy to apply to SOAP requests received for the operation. The ID is preceded by a number sign (#). |
Child Elements
None.
Parent Elements
Element | Description |
---|---|
Defines the default policy to apply for SOAP messages that match the criteria in the enclosing <endpoint> Element element. |
|
Defines the policy for SOAP messages sent to or received by a specific Web service method at an endpoint. |
Remarks
The enclosing <operation> Element element can contain zero or more <request> elements. Each <request> element specifies the policy ID to apply to requests received for the operation.
In order for a SOAP message to have the policy applied to it, the policy attribute must match the wsu:Id attribute of the <Policy> Element (WSE for Microsoft .NET) (1) element, the SOAP action must match the requestAction attribute of the <operation> element, and the WS-Addressing <to> element must match the uri attribute of the <endpoint> Element element.
Example
The following code example defines a policy assertion named signed-body-x509
that requires the digital signing of the <Body> element, timestamp header, and all addressing headers by an X509SecurityToken. The policy file then specifies that SOAP messages adhere to the policy assertion if they are sent to the http://www.cohowinery.com/Service1.asmx
endpoint with a SOAP action of http://www.cohowinery.com/AddNumbers
.
Note
This code example is designed to demonstrate WSE features and is not intended for production use.
<?xml version="1.0" encoding="utf-8"?>
<policyDocument xmlns="https://schemas.microsoft.com/wse/2003/06/Policy">
<mappings>
<endpoint uri="http://www.cohowinery.com/Service1.asmx">
<operation requestAction="http://www.cohowinery.com/AddNumbers">
<request policy="#signed-body-x509" />
<response policy="" />
<fault policy="" />
</operation>
</endpoint>
</mappings>
<policies xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"
xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd"
xmlns:wse="https://schemas.microsoft.com/wse/2003/06/Policy"
xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/03/addressing"
xmlns:wssp="https://schemas.xmlsoap.org/ws/2002/12/secext"
xmlns:wsp="https://schemas.xmlsoap.org/ws/2002/12/policy"
xmlns:wssc="https://schemas.xmlsoap.org/ws/2004/04/sc"
xmlns:rp="https://schemas.xmlsoap.org/rp">
<!--This policy requires that the body be digitally signed by an X509 security token.-->
<wsp:Policy wsu:Id="signed-body-x509">
<wssp:Integrity wsp:Usage="wsp:Required">
<wssp:TokenInfo>
<wssp:SecurityToken>
<wssp:TokenType>http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-x509-token-profile-1.0#X509v3</wssp:TokenType>
</wssp:SecurityToken>
</wssp:TokenInfo>
<wssp:MessageParts xmlns:rp="https://schemas.xmlsoap.org/rp"
Dialect="https://schemas.xmlsoap.org/2002/12/wsse#part">wsp:Body() wse:Timestamp() wse:Addressing()</wssp:MessageParts>
</wssp:Integrity>
</wsp:Policy>
</policies>
</policyDocument>
See Also
Reference
<endpoint> Element
<operation> Element
<response> Element (WSE for Microsoft .NET)
<fault> Element