UsernameForCertificateAssertion.ServiceInputFilter.GetUnattachedTokens Method

Retrieves the list of security tokens to resolve security tokens that secure the incoming messages.

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_ServiceInputFilter1 As UsernameForCertificateAssertion.ServiceInputFilter
returnValue = usernameForCertificateAssertion_ServiceInputFilter1.GetUnattachedTokens(context)

Syntax

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

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

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

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

JScript does not support Generics.

Parameters

• context
  The SoapContext which provides the operation state where the unattached tokens list is stored.

Return Value

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

Remarks

Unattached tokens provide security for policy assertions. For example, in the case of the UsernameForCertificateAssertion, when a message is received, it should be protected with a EncryptedKeyToken, which in turn should be protected by a Web services X509 Certificate. However, when the message arrives, it only contains a reference to the Web Service's X509. During message processing, the unattached tokens list provided by this method helps resolve this reference. Furthermore, if the encrypted key token is not protected with the Web services X509 certificate, then resolving this reference against the encrypted key token from the list fails.

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.ServiceInputFilter Class
UsernameForCertificateAssertion.ServiceInputFilter Members
Microsoft.Web.Services3.Design Namespace