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 will return 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 will use the system property to determine if it should return a fault or ignore it.