The mustUnderstand Attribute
The SOAP
mustUnderstand
attribute indicates whether or not the recipient is required to process a header entry. If the attribute is
true
, the recipient must process it correctly. If the attribute is
false
, processing the header entry is optional.
TIBCO ActiveMatrix Policy Director Governance allows you to control the behavior of the governance agent when it encounters
mustUnderstand = "true"|"1"
headers that are not processed in the SOAP pipeline.
This is done using the system property:
java.property.com.tibco.governance.agent.enforce.mustUnderstand=true
. The default value of this system property is
true
. If the
mustUnderstand="true"|"1"
headers are not processed in the SOAP pipeline the agent returns a fault message.
If you want the governance agent to ignore the unprocessed
mustUnderstand="true"|"1"
headers, set the system property to:
java.property.com.tibco.governance.agent.enforce.mustUnderstand=false
.
For example, WS Security headers have the attribute
mustUnderstand = "true"|"1"
. When you configure a security policy in TIBCO ActiveMatrix Policy Director Governance, the policy enforcement on the governance agent automatically handles the mustUnderstand="true"|"1"
headers. In the absence of a security policy, the security headers are not processed. The governance agent uses the system property to determine if it should return a fault or ignore it.