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.Services2.Security.Tokens
Assembly: Microsoft.Web.Services2 (in microsoft.web.services2.dll)

Usage

'Usage
Dim securityTokenManager1 As New SecurityTokenManager()

Syntax

'Declaration
MustInherit Public Class SecurityTokenManager
    Implements ISecurityTokenManager
public abstract class SecurityTokenManager : ISecurityTokenManager
public abstract ref class SecurityTokenManager : public 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.

PermitsPolicyEnforcementTokenCaching

Security token is used with policy.

LoadSecurityTokenAssertion

Security token is used with policy.

LoadTokenFromSecurityTokenAssertion

Security token is used with policy.

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.Services2.Security.Tokens.SecurityTokenManager
     Microsoft.Web.Services2.Security.Tokens.DerivedKeyTokenManager
     Microsoft.Web.Services2.Security.Tokens.KeyIdentifierCachedSecurityTokenManager
     Microsoft.Web.Services2.Security.Tokens.SecurityContextTokenManager
     Microsoft.Web.Services2.Security.Tokens.UsernameTokenManager
     Microsoft.Web.Services2.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 Longhorn, and Windows 2000

Target Platforms

Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows Longhorn, Pocket PC, Windows CE, Smart Phone

See Also

Reference

Microsoft.Web.Services2.Security.Tokens Namespace

Other Resources

SecurityTokenManager Members