SecurityContextTokenService Class

  • Article

Represents a security token service that issues SecurityContextToken security tokens.

Namespace: Microsoft.Web.Services2.Security
Assembly: Microsoft.Web.Services2 (in microsoft.web.services2.dll)

Usage

'Usage
Dim securityContextTokenService1 As New SecurityContextTokenService()

Syntax

'Declaration
Public Class SecurityContextTokenService
    Inherits SecurityTokenService

public class SecurityContextTokenService : SecurityTokenService

public ref class SecurityContextTokenService : public SecurityTokenService

public class SecurityContextTokenService extends SecurityTokenService

public class SecurityContextTokenService extends SecurityTokenService

Remarks

Use this class to issue SecurityContextToken security tokens. To issue SecurityContextToken tokens using the SecurityContextTokenService class, typically you add an <autoIssueSecurityContextToken> Element element to the Web.config file in the virtual directory that issues the security tokens. Within the <autoIssueSecurityContextToken> Element element, set the enabled attribute to true. For more details about issuing security tokens, see Issuing Security Tokens.

The SecurityContextTokenService security token service handles security token requests that contain <Action> SOAP headers with the value https://schemas.xmlsoap.org/ws/2004/04/security/trust/RST/SCT.

The SecurityContextTokenService class has two overloaded IssueSecurityContextTokenRequest methods for handling security token requests. One method, which takes a RequestSecurityToken parameter is called when a security token request is received within a <RequestSecurityToken> element. If the request is valid, the method issues a security token. The other method, which takes a RequestSecurityTokenResponse parameter, is called when a security token request is received within a <RequestSecurityTokenResponse> element. Note that the SecurityContextTokenService security token service does not support this type of request and therefore a TrustFault exception is thrown.

When you want to issue security tokens other than SecurityContextToken security tokens, you must derive a class from the SecurityTokenService class to build your security token service. For more details about issuing custom security tokens, see How to: Issue Custom Security Tokens.

Inheritance Hierarchy

System.Object
   Microsoft.Web.Services2.Messaging.SoapPort
     Microsoft.Web.Services2.Messaging.SoapReceiver
       Microsoft.Web.Services2.Messaging.SoapService
         Microsoft.Web.Services2.Security.SecurityTokenService
          Microsoft.Web.Services2.Security.SecurityContextTokenService

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 Namespace
IssueSecurityToken
SecurityContextTokenServiceClient

Other Resources

SecurityContextTokenService Members
ms820023(v=msdn.10).md
ms819953(v=msdn.10).md