SecurityContextTokenManager.RequestTokenFromIssuer Method

Requests a SecurityContextToken security token from a security token service.

Namespace: Microsoft.Web.Services3.Security.Tokens
Assembly: Microsoft.Web.Services3 (in microsoft.web.services3.dll)

Usage

'Usage
Dim tokenIssuer As EndpointReference
Dim tokenType As String
Dim appliesTo As AppliesTo
Dim policy As Policy
Dim soapVersion As SoapProtocolVersion
Dim messageState As StateManager
Dim operationState As StateManager
Dim sessionState As StateManager
Dim returnValue As IssuedToken
Dim securityContextTokenManager1 As SecurityContextTokenManager
returnValue = securityContextTokenManager1.RequestTokenFromIssuer(tokenIssuer, tokenType, appliesTo, policy, soapVersion, messageState, operationState, sessionState)

Syntax

'Declaration
Public Overrides Function RequestTokenFromIssuer( _
    ByVal tokenIssuer As EndpointReference, _
    ByVal tokenType As String, _
    ByVal appliesTo As AppliesTo, _
    ByVal policy As Policy, _
    ByVal soapVersion As SoapProtocolVersion, _
    ByVal messageState As StateManager, _
    ByVal operationState As StateManager, _
    ByVal sessionState As StateManager _
) As IssuedToken
public override IssuedToken RequestTokenFromIssuer(
    EndpointReference tokenIssuer, 
    string tokenType, 
    AppliesTo appliesTo, 
    Policy policy, 
    SoapProtocolVersion soapVersion, 
    StateManager messageState, 
    StateManager operationState, 
    StateManager sessionState
);
public:
virtual IssuedToken^ RequestTokenFromIssuer(
    EndpointReference^ tokenIssuer,
    String^ tokenType,
    AppliesTo^ appliesTo,
    Policy^ policy,
    SoapProtocolVersion^ soapVersion,
    StateManager^ messageState,
    StateManager^ operationState,
    StateManager^ sessionState
) override;
public override IssuedToken RequestTokenFromIssuer(
    EndpointReference tokenIssuer, 
    System.String tokenType, 
    AppliesTo appliesTo, 
    Policy policy, 
    SoapProtocolVersion soapVersion, 
    StateManager messageState, 
    StateManager operationState, 
    StateManager sessionState
);
public override function RequestTokenFromIssuer(
     tokenIssuer : EndpointReference, 
     tokenType : String, 
     appliesTo : AppliesTo, 
     policy : Policy, 
     soapVersion : SoapProtocolVersion, 
     messageState : StateManager, 
     operationState : StateManager, 
     sessionState : StateManager
) : IssuedToken;

Parameters

  • tokenIssuer
    An EndpointReference that represents the endpoint of the security token service.
  • appliesTo
    An AppliesTo that represents the Web service for which the security token will be used to secure SOAP messages with.
  • policy
    A Policy that represents the policy to apply to the SOAP messages exchanged between the client and the security token service.
  • soapVersion
    A System.Web.Services.Protocols.SoapProtocolVersion that represents the version of the SOAP protocol to communicate with the security token service.
  • messageState
    A StateManager that represents the state for the security token request.
  • operationState
    A StateManager that represents the state for the security token request and its response.
  • sessionState
    A StateManager that represents the state for the set of SOAP messages that are exchanged between the client and the security token service.

Return Value

The IssuedToken that contains the security token from the security token service.

Exceptions

Exception type Condition
System.ArgumentNullException

tokenIssuer is null.

-or-

tokenType is null.

System.ArgumentException

tokenType is not SecurityContextToken.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server

Target Platforms

See Also

Reference

SecurityContextTokenManager Class
SecurityContextTokenManager Members
Microsoft.Web.Services3.Security.Tokens Namespace