Share via

SecurityTokenManager.GetSecurityTokenManagerByValueType Method

  • Article

Gets the security token manager for a binary security token.

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

Usage

'Usage
Dim valueType As String
Dim returnValue As ISecurityTokenManager
returnValue = SecurityTokenManager.GetSecurityTokenManagerByValueType(valueType)

Syntax

'Declaration
Public Shared Function GetSecurityTokenManagerByValueType( _
    ByVal valueType As String _
) As ISecurityTokenManager

public static ISecurityTokenManager GetSecurityTokenManagerByValueType(
    string valueType
);

public:
static ISecurityTokenManager^ GetSecurityTokenManagerByValueType(
    String^ valueType
);

public static ISecurityTokenManager GetSecurityTokenManagerByValueType(
    System.String valueType
);

public static function GetSecurityTokenManagerByValueType(
     valueType : String
) : ISecurityTokenManager;

Parameters

  • valueType
    An URI that represents a binary security token.

Return Value

An ISecurityTokenManager that is the security token manager for the binary security token.

Remarks

All binary security tokens that are contained within a SOAP message are each placed in their own <BinarySecurityToken> element within the SOAP message and the ValueType attribute of the <BinarySecurityToken> element is used to specifiy the token type. When WSE receives a SOAP message containing a <BinarySecurityToken> element, it calls the GetSecurityTokenManagerByValueType method with the ValueType attribute is passed to the ValueType parameter. The GetSecurityTokenManagerByTokenType method then uses the values of any <binarySecurityTokenManager> elements in the current application domain's configuration file to determine the security token manager for the token type. If the binary security token is not in the configuration file, WSE then checks whether it is a natively supported binary security token, such as the X509SecurityToken . If it is, then the natively supported security token manager, such as the X509SecurityTokenManager , is called. If not, a SOAP fault is returned to the client. For more information about registering binary security token managers, see <binarySecurityTokenManager> Element.

WSE has defined a set of constants for the value types that it natively supports, as well as other industry defined value types. For more details, see the WSSecurity.ValueTypes 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