class %SOAP.WST.RequestSecurityToken
extends %SOAP.RequestMessage
RequestSecurityToken as used for request body in WS-Trust 1.3.
• parameter ELEMENTQUALIFIED = 1;
ELEMENTQUALIFIED controls the format of exported XML.
The ELEMENTQUALIFIED specification should be based on the elementFormDefault attribute of the
schema that defines the type.
To maintain compatibility, ELEMENTQUALIFIED will default to 1 (true) for literal format export
and will default to 0 (false) for encoded or encoded12 format export.
These were the values always previously assumed for the elementFormDefault attribute.
NOTE: Direct use of XMLExport method does not support the ELEMENTQUALIFIED. The export must be
done using %XML.Writer or SOAP support.
• parameter NAMESPACE = "http://docs.oasis-open.org/ws-sx/ws-trust/200512";
NAMESPACE specifies the XML namespace to be used when projecting the
class to XML. if NAMESPACE - "", the default namespace is used for the XML schema
is used as the namespace for his class.
• parameter XMLFORMAT = "literal";
The XMLFORMAT parameter controls the generation of the XMLExport and XMLImport
methods for XML enabled classes to include code for only literal or only encoded format.
This allows the generated routines to be significantly smaller since usually
both formats are not needed.
If XMLFORMAT="Literal", then only support for literal format import and export is generated.
If XMLFORMAT="Encoded", then only support for SOAP encoded format import and export is generated.
The default is to generate support for both literal and encoded format.
• parameter XMLIGNOREINVALIDTAG = 1;
The XMLIGNOREINVALIDTAG parameter allows the programmer to control handling of unexpected
elements in the XML input.
By default (XMLIGNOREINVALIDTAG = 0), will treat an unexpected element as an error.
If XMLIGNOREINVALIDTAG is set = 1, then unexpected elements will be ignored.
• parameter XMLPREFIX = "wst";
The XMLPREFIX parameter controls the prefix to be used for the XML namespace that
is given by the NAMESPACE parameter.
• parameter XMLSEQUENCE = 0;
If the XMLSEQUENCE = 1, then the order of the XML elements must match the
order of the class properties. This allows us to deal with XML where the
same field appears multiple times and is distinguished by the order.
• method CreateCancelResponse(soapClass As %SOAP.WebService, Output error As %String)
as %SOAP.WST.RequestSecurityTokenResponseCollection
Create and return an Cancel response for this Cancel request.
- soapClass is the web service to which the request was sent.
- error contained the returned error string. "" if successful.
Otherwise, fault code from section 11 of WS-Trust 1.3 specification.
• classmethod CreateIssueRequest(interval As %Integer = 300, clientEntropy As %SOAP.WST.Entropy = "", requireServerEntropy As %Boolean)
as %SOAP.WST.RequestSecurityToken
Create an Issue request for WS-SecureConversation SecurityContextToken.
If ComputedKeySize is not pre-agreed or specified by a WS-Policy then the ComputedKeySize property should be set
to indicate the desired KeySize in bytes before calling StartSecureConversation.
- interval is lifetime of the requested token. To include no Lifetime element pass interval as "".
The default interval is 300 seconds.
- clientEntropy is the client entropy to be included in the request
which is created using ##class(%SOAP.WST.Entropy).Create(....
- requireServerEntropy is a %Boolean argument which specifies if server entropy must be supplied.
Default is false.
• method CreateIssueResponse(soapClass As %SOAP.WebService, keysize As %Integer, requireClientEntropy As %Boolean, serverEntropy As %SOAP.WST.Entropy = "", Output error As %String, lifetime As %Integer)
as %SOAP.WST.RequestSecurityTokenResponseCollection
Create and return an Issue response for this request with WS-SecureConversation SecurityContextToken.
- soapClass is the web service to which the request was sent.
- keysize is the size of the desired key in bytes.
This argument is used only when key is computed based on both client and server entropy.
Default is the smaller of length of client entropy and server entropy.
- requireClientEntropy is true if the request must include client entropy.
requireClientEntropy is false if the request must not include client entropy.
- serverEntropy is %SOAP.WST.Entropy with server entropy or "" if no server entropy.
- error contained the returned error string. "" if successful.
Otherwise, fault code from section 11 of WS-Trust 1.3 specification.
- lifetime is the required duration of the lifetime token in seconds.
If not specifed, the client requested lifetime is used or 300 secondss if no client requested lifetime
