SecurityTokenManager Class

When overridden in a derived class, represents a security token manager. The class also provides static methods for working with all registered security token managers.

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

Usage

'Usage
Dim securityTokenManager1 As New SecurityTokenManager()

Syntax

'Declaration
MustInherit Public Class SecurityTokenManager
    Implements ISecurityTokenManager

public abstract class SecurityTokenManager : ISecurityTokenManager

public ref class SecurityTokenManager abstract : ISecurityTokenManager

public abstract class SecurityTokenManager implements ISecurityTokenManager

public abstract class SecurityTokenManager implements ISecurityTokenManager

Remarks

WSE uses security token managers to interact with security tokens. Security token managers typically derive from the SecurityTokenManager class, however it is possible to implement the ISecurityTokenManager interface directly.

To build a custom security token manager, either derive a class from SecurityTokenManager or create a class that implements the ISecurityTokenManager interface and register the class in the SOAP message receiver's configuration file using the <securityTokenManager> element. For more details about creating a custom security token manager, see How to: Create a Security Token Manager for a Custom Security Token. For more details about configuring a security token manager, see How to: Configure the Security Token Manager for a Custom Security Token.

Notes to Inheritors: The following table provides guidance on when you typically override a member.

Member	When you typically override
TokenType	Always.
LoadTokenFromXml	Always.
VerifyToken	Always.
LoadTokenFromKeyInfo	Security token supports encryption. Used during decryption of the security token.

The following table lists the natively supported security tokens and their respective security token managers.

Security token	Security token manager
X509SecurityToken	X509SecurityTokenManager
UsernameToken	UsernameTokenManager
KerberosToken	KerberosTokenManager
DerivedKeyToken	DerivedKeyTokenManager
SecurityToken	SecurityContextTokenManager

Inheritance Hierarchy

System.Object
  Microsoft.Web.Services3.Security.Tokens.SecurityTokenManager
     Microsoft.Web.Services3.Security.Tokens.DerivedKeyTokenManager
     Microsoft.Web.Services3.Security.Tokens.IssuedTokenManager
     Microsoft.Web.Services3.Security.Tokens.KeyIdentifierCachedSecurityTokenManager
     Microsoft.Web.Services3.Security.Tokens.UsernameTokenManager
     Microsoft.Web.Services3.Security.Tokens.X509SecurityTokenManager

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 Members
Microsoft.Web.Services3.Security.Tokens Namespace