UsernameForCertificateAssertion.ClientInputFilter.GetUnattachedTokensCore Method

Retrieves the security token for the specified SoapContext.

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

Usage

'Usage
Dim context As SoapContext
Dim returnValue As IEnumerable(Of SecurityToken)
Dim usernameForCertificateAssertion_ClientInputFilter1 As UsernameForCertificateAssertion.ClientInputFilter
returnValue = usernameForCertificateAssertion_ClientInputFilter1.GetUnattachedTokensCore(context)

Syntax

'Declaration
Public Overrides Function GetUnattachedTokensCore( _
    ByVal context As SoapContext _
) As IEnumerable(Of SecurityToken)

public override IEnumerable<SecurityToken> GetUnattachedTokensCore(
    SoapContext context
);

public:
virtual IEnumerable<SecurityToken^>^ GetUnattachedTokensCore(
    SoapContext^ context
) override;

public override IEnumerable<SecurityToken> GetUnattachedTokensCore(
    SoapContext context
);

JScript does not support Generics.

Parameters

• context
  The SoapContext for which the security token is to be retrieved.

Return Value

An IEnumerable<SecurityToken> that contains the security token for the specified context.

Remarks

When a response is received it is secured with an unattached security token—a token that is not included in the message, but whose reference is included. When WSE policy resolves these references to actual tokens, it first looks at the context list by invoking this method and verifies whether any of the incoming tokens are on that list.

The list is created by the client's output filter when the message is secured. The tokens that are used to secure the outgoing request are saved in the operation state. This method uses the operation state to retrieve the list of tokens used and verifies whether any of the incoming tokens are on that list.

This ensures that the message response has to be protected with exactly the same token that protected the request.

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

UsernameForCertificateAssertion.ClientInputFilter Class
UsernameForCertificateAssertion.ClientInputFilter Members
Microsoft.Web.Services3.Design Namespace