Class Reference
IRIS for UNIX 2019.2
InterSystems: The power behind what matters   
Documentation  Search
  [ENSLIB] >  [%SOAP] >  [WST] >  [RequestSecurityToken]
Private  Storage   

class %SOAP.WST.RequestSecurityToken extends %SOAP.RequestMessage

RequestSecurityToken as used for request body in WS-Trust 1.3.

Inventory

Parameters Properties Methods Queries Indices ForeignKeys Triggers
6 34 4


Summary

Properties
AllowPostdating AppliesTo AuthenticationType CancelTarget
CanonicalizationAlgorithm Claims ComputedKeyAlgorithm ComputedKeySize
Context Delegatable DelegateTo EncryptWith
Encryption EncryptionAlgorithm Entropy Forwardable
Issuer KeySize KeyType KeyWrapAlgorithm
Lifetime OnBehalfOf Participants Policy
PolicyReference ProofEncryption RenewTarget Renewing
RequestType SignWith SignatureAlgorithm TokenType
UseKey

Methods
%AddToSaveSet %ClassIsLatestVersion %ClassName %ConstructClone
%DispatchClassMethod %DispatchGetModified %DispatchGetProperty %DispatchMethod
%DispatchSetModified %DispatchSetMultidimProperty %DispatchSetProperty %Extends
%GetParameter %IsA %IsModified %New
%NormalizeObject %ObjectModified %OriginalNamespace %PackageName
%RemoveFromSaveSet %SerializeObject %SetModified %ValidateObject
CreateCancelResponse CreateIssueRequest CreateIssueResponse XMLDTD
XMLExport XMLExportToStream XMLExportToString XMLNew
XMLSchema XMLSchemaNamespace XMLSchemaType


Parameters

• 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. The XMLIGNOREINVALIDTAG parameter will only take affect if XMLSEQUENCE = 0 (the default). By default (XMLIGNOREINVALIDTAG = 0), will treat an unexpected element as an error. If XMLIGNOREINVALIDTAG is set = 1 and XMLSEQUENCE = 0, 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.

Properties

• property AllowPostdating as %String;
• property AppliesTo as %XML.String(REFNAMESPACE="http://www.w3.org/ns/ws-policy",XMLREF=1);
• property AuthenticationType as %xsd.anyURI;
• property CancelTarget as %SOAP.WST.Target;
• property CanonicalizationAlgorithm as %xsd.anyURI;
• property Claims as %SOAP.WST.Claims;
• property ComputedKeyAlgorithm as %xsd.anyURI;
• property ComputedKeySize as %Integer(XMLPROJECTION="none");
ComputedKeySize specifies the size in bytes of the computed key which will be established. ComputedKeySize is meaningful only if client and server entropy are both specified for a computed key. Default is $$$SOAPWSSCDEFAULTKEYSIZE.
• property Context as %xsd.anyURI(XMLPROJECTION="attribute");
• property Delegatable as %Boolean;
• property DelegateTo as %SOAP.WST.Target;
• property EncryptWith as %xsd.anyURI;
• property Encryption as %XML.String;
• property EncryptionAlgorithm as %xsd.anyURI;
• property Entropy as %SOAP.WST.Entropy;
• property Forwardable as %Boolean;
• property Issuer as %SOAP.Addressing.EndpointReference(REFNAMESPACE="http://www.w3.org/2005/08/addressing",XMLREF=1);
• property KeySize as %xsd.unsignedInt;
• property KeyType as %xsd.anyURI;
• property KeyWrapAlgorithm as %xsd.anyURI;
• property Lifetime as %SOAP.WST.Lifetime;
• property OnBehalfOf as %SOAP.WST.Target;
• property Participants as %SOAP.WST.Participants;
• property Policy as %SOAP.Policy(REFNAMESPACE="http://www.w3.org/ns/ws-policy",XMLREF=1);
• property PolicyReference as %SOAP.PolicyReference(REFNAMESPACE="http://www.w3.org/ns/ws-policy",XMLREF=1);
• property ProofEncryption as %SOAP.WST.Target;
• property RenewTarget as %SOAP.WST.Target;
• property Renewing as %SOAP.WST.Renewing;
• property RequestType as %xsd.anyURI(XMLREF=1) [ Required ];
• property SignWith as %xsd.anyURI;
• property SignatureAlgorithm as %xsd.anyURI;
• property TokenType as %xsd.anyURI(XMLREF=1);
• property UseKey as %SOAP.WST.Target;

Methods

• 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


Copyright (c) 2019 by InterSystems Corporation. Cambridge, Massachusetts, U.S.A. All rights reserved. Confidential property of InterSystems Corporation.