SecurityTokenService Class

Represents a security token service.

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

Usage

'Usage
Dim securityTokenService1 As New SecurityTokenService()

Syntax

'Declaration
Public Class SecurityTokenService
    Inherits SoapService

public class SecurityTokenService : SoapService

public ref class SecurityTokenService : SoapService

public class SecurityTokenService extends SoapService

public class SecurityTokenService extends SoapService

Remarks

The Web Services Enhancements for Microsoft .NET (WSE) provide a security token service that issues security context tokens. However, if your application must issue tokens other than security context tokens, derive a class from the SecurityTokenService class to build a security token service. To issue security tokens, you must override the IssueSecurityToken method by adding code to it that creates a new instance of the RequestSecurityTokenResponse class if the security token request is valid.

Security token requests are routed to a security token service based on the request's <To> header and then dispatched to a particular method of that security token service based on the request's <Action> header. The following table lists the <Action> header values and the method they are routed to.

Action	Method
https://schemas.xmlsoap.org/ws/2004/04/security/trust/RST/Issue	IssueSecurityTokenRequest
https://schemas.xmlsoap.org/ws/2004/04/security/trust/RSTR/Issue	IssueSecurityTokenRequest
https://schemas.xmlsoap.org/ws/2004/04/security/trust/RST/Renew	RenewSecurityTokenRequest
https://schemas.xmlsoap.org/ws/2004/04/security/trust/RSTR/Renew	RenewSecurityTokenRequest
https://schemas.xmlsoap.org/ws/2004/04/security/trust/RST/Validate	ValidateSecurityTokenRequest
https://schemas.xmlsoap.org/ws/2004/04/security/trust/RSTR/Validate	ValidateSecurityTokenRequest

Once a security token request is dispatched to a method, that method then calls the following methods in the listed order, by default:

A security token service issues security tokens that are trusted by one or more target Web services. A SOAP message sender can request a security token from a security token service using the <RequestSecurityToken> element. A security token service responds to the request with a <RequestSecurityTokenResponse> element. If the security token service issues a security token as requested, the response contains that security token. For more information about issuing security tokens, see Issuing Security Tokens.

Inheritance Hierarchy

System.Object
   Microsoft.Web.Services3.Messaging.SoapPort
     Microsoft.Web.Services3.Messaging.SoapReceiver
       Microsoft.Web.Services3.Messaging.SoapService
        Microsoft.Web.Services3.Security.SecurityTokenService
           Microsoft.Web.Services3.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 2000, Windows 2000 Server, Windows 2000 Advanced Server

Target Platforms

See Also

Reference

SecurityTokenService Members
Microsoft.Web.Services3.Security Namespace