Share via

SecurityTokenManager.GetSecurityTokenManagerByTokenType Method

  • Article

Gets the security token manager for an XML-based security token.

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

Usage

'Usage
Dim tokenType As String
Dim returnValue As ISecurityTokenManager
returnValue = SecurityTokenManager.GetSecurityTokenManagerByTokenType(tokenType)

Syntax

'Declaration
Public Shared Function GetSecurityTokenManagerByTokenType( _
    ByVal tokenType As String _
) As ISecurityTokenManager

public static ISecurityTokenManager GetSecurityTokenManagerByTokenType(
    string tokenType
);

public:
static ISecurityTokenManager^ GetSecurityTokenManagerByTokenType(
    String^ tokenType
);

public static ISecurityTokenManager GetSecurityTokenManagerByTokenType(
    System.String tokenType
);

public static function GetSecurityTokenManagerByTokenType(
     tokenType : String
) : ISecurityTokenManager;

Parameters

  • tokenType
    The XML qualified name for an XML-based security token.

Return Value

An ISecurityTokenManager that is the security token manager for the XML-based security token.

Remarks

All XML-based security tokens contained within a SOAP message are each placed in their own application or industry defined XML element. When WSE receives a SOAP message containing an XML-based security token, it calls the GetSecurityTokenManagerByTokenType method with the URI representing the token type to the TokenType parameter. The GetSecurityTokenManagerByTokenType method then uses the values of any <securityTokenManager> elements in the current application domain's configuration file to determine the security token manager for the token type. If the XML-based security token is not in the configuration file, WSE then checks whether it is a natively supported XML-based security token, such as the UsernameToken. If it is, then the natively supported security token manager, such as the UsernameTokenManager , is called. If not, a SOAP fault is returned to the client. For more information about registering XML-based security token managers, see <securityTokenManager> Element.

WSE has defined a set of constants for the token types that it natively supports, as well as other industry defined token types. For more details, see the WSTrust.TokenTypes class.

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

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