Integration Server 10.11 | Web Services Developer’s Guide | Securing Web Services Using the WS-Security Facility | WS-Security Facility Policy Reference | InboundSecurity and OutboundSecurity Elements | Setting a Policy Element’s Usage Attribute
 
Setting a Policy Element’s Usage Attribute
The “Usage” attribute applies to any policy element in an <InboundSecurity> section to explicitly indicate how the element should be treated.
Usage Value
Description
Optional
If the element is present, it will be processed. Absence of the policy element will not result in an error being generated.
Required
The element must be present or processing will fail with an error.
Rejected
The incoming message must not contain any instances of this element. If one or more instances are present, processing fails and the message will be rejected with an error.
Ignored
Instances of this token type are not processed. Whether the element is present or absent, an error will not be generated.
As an example, this setting could be used to disable the processing of UsernameToken credentials when more secure credentials (such as X.509 certificates) are being used.
Default: All policy elements are treated as “Optional”.
Example
<InboundSecurity>
. . .
<Signature
Usage="Optional"
. . . />
<Encryption
Usage="Required"
. . . />
. . .
</InboundSecurity>