ServiceCredentialsSecurityTokenManager.CreateSecurityTokenAuthenticator Yöntem

Tanım

Ad Alanı:

System.ServiceModel.Security

Bütünleştirilmiş Kod:

System.ServiceModel.dll

tabanlı SecurityTokenRequirementbir güvenlik belirteci kimlik doğrulayıcısı oluşturur.

public:
 override System::IdentityModel::Selectors::SecurityTokenAuthenticator ^ CreateSecurityTokenAuthenticator(System::IdentityModel::Selectors::SecurityTokenRequirement ^ tokenRequirement, [Runtime::InteropServices::Out] System::IdentityModel::Selectors::SecurityTokenResolver ^ % outOfBandTokenResolver);

public override System.IdentityModel.Selectors.SecurityTokenAuthenticator CreateSecurityTokenAuthenticator (System.IdentityModel.Selectors.SecurityTokenRequirement tokenRequirement, out System.IdentityModel.Selectors.SecurityTokenResolver outOfBandTokenResolver);

override this.CreateSecurityTokenAuthenticator : System.IdentityModel.Selectors.SecurityTokenRequirement * SecurityTokenResolver -> System.IdentityModel.Selectors.SecurityTokenAuthenticator

Public Overrides Function CreateSecurityTokenAuthenticator (tokenRequirement As SecurityTokenRequirement, ByRef outOfBandTokenResolver As SecurityTokenResolver) As SecurityTokenAuthenticator

Parametreler

tokenRequirement

SecurityTokenRequirement

Güvenlik belirteci gereksinimi.

outOfBandTokenResolver

SecurityTokenResolver

Bu yöntem döndürdüğünde bir SecurityTokenResolveriçerir. Bu parametre, başlatmadan iletilir.

Döndürülenler

SecurityTokenAuthenticator

Güvenlik belirteci kimlik doğrulayıcısı.

Özel durumlar

ArgumentNullException

tokenRequirement, null değeridir.

NotSupportedException

geçirilen için tokenRequirement bir güvenlik belirteci kimlik doğrulayıcısı oluşturulamıyor.

Örnekler

Aşağıdaki kod, bu yöntemin nasıl geçersiz kılınacaklarına ilişkin bir örnektir.

internal class MyServiceCredentialsSecurityTokenManager :
    ServiceCredentialsSecurityTokenManager
{
    ServiceCredentials credentials;
    public MyServiceCredentialsSecurityTokenManager(ServiceCredentials credentials)
        : base(credentials)
    {
        this.credentials = credentials;
    }

    public override SecurityTokenAuthenticator CreateSecurityTokenAuthenticator
        (SecurityTokenRequirement tokenRequirement, out SecurityTokenResolver outOfBandTokenResolver)
    {
        // Return your implementation of the SecurityTokenProvider based on the
        // tokenRequirement argument.
        SecurityTokenAuthenticator result;
        if (tokenRequirement.TokenType == SecurityTokenTypes.UserName)
        {
            MessageDirection direction = tokenRequirement.GetProperty<MessageDirection>
                (ServiceModelSecurityTokenRequirement.MessageDirectionProperty);
            if (direction == MessageDirection.Input)
            {
                outOfBandTokenResolver = null;
                result = new MySecurityTokenAuthenticator();
            }
            else
            {
                result = base.CreateSecurityTokenAuthenticator(tokenRequirement, out outOfBandTokenResolver);
            }
        }
        else
        {
            result = base.CreateSecurityTokenAuthenticator(tokenRequirement, out outOfBandTokenResolver);
        }

        return result;
    }
}

Friend Class MyServiceCredentialsSecurityTokenManager
    Inherits ServiceCredentialsSecurityTokenManager

    Private credentials As ServiceCredentials

    Public Sub New(ByVal credentials As ServiceCredentials)
        MyBase.New(credentials)
        Me.credentials = credentials
    End Sub

    Public Overrides Function CreateSecurityTokenAuthenticator(ByVal tokenRequirement As SecurityTokenRequirement, _
                                                               <System.Runtime.InteropServices.Out()> _
                                                               ByRef outOfBandTokenResolver _
                                                               As SecurityTokenResolver) As SecurityTokenAuthenticator
        ' Return your implementation of the SecurityTokenProvider based on the 
        ' tokenRequirement argument.
        Dim result As SecurityTokenAuthenticator
        If tokenRequirement.TokenType = SecurityTokenTypes.UserName Then
            Dim direction = tokenRequirement.GetProperty(Of MessageDirection)(ServiceModelSecurityTokenRequirement.MessageDirectionProperty)
            If direction = MessageDirection.Input Then
                outOfBandTokenResolver = Nothing
                result = New MySecurityTokenAuthenticator()
            Else
                result = MyBase.CreateSecurityTokenAuthenticator(tokenRequirement, _
                                                                 outOfBandTokenResolver)
            End If
        Else
            result = MyBase.CreateSecurityTokenAuthenticator(tokenRequirement, _
                                                             outOfBandTokenResolver)
        End If

        Return result
    End Function

End Class

Açıklamalar

Bir outOfBand belirteç çözümleyicisi isteğe bağlı olarak yöntemi tarafından döndürülebilir. Bu yöntem, güvenlik işlenirken SOAP iletisinde olmayan belirteçleri çözümlemek için WCF güvenlik işlemcisi tarafından kullanılır. SecurityTokenAuthenticator Bu yöntem tarafından döndürülen belirteçleri doğrular ve talepleri ayıklar. öğesinden ServiceModelSecurityTokenRequirementtüretilen her sınıf için bir SecurityTokenAuthenticator tane oluşturulur.