方法 : カスタムセキュリティトークンプロバイダーを作成する

[アーティクル]
02/24/2011

ここでは、カスタムセキュリティトークンプロバイダーを持つ新しいトークンの種類を作成する方法と、そのプロバイダーをカスタムセキュリティトークンマネージャーと統合する方法について説明します。

注 :
System.IdentityModel.Tokens 名前空間にあるシステム指定のトークンがユーザーの要件に一致しない場合、カスタムトークンプロバイダーを作成します。

セキュリティトークンプロバイダーは、クライアントまたはサービスの資格情報に基づいてセキュリティトークンの表現を作成します。Windows Communication Foundation (WCF) セキュリティでカスタムセキュリティトークンプロバイダーを使用するには、カスタム資格情報とセキュリティトークンマネージャーの実装を作成する必要があります。

カスタム資格情報とセキュリティトークンマネージャーの詳細については、「チュートリアル: カスタムクライアントおよびサービスの資格情報を作成する」を参照してください。

資格情報、セキュリティトークンマネージャー、およびプロバイダークラスと認証システムクラスの詳細については、「セキュリティアーキテクチャ」を参照してください。

カスタムセキュリティトークンプロバイダーを作成するには

SecurityTokenProvider クラスから派生する新しいクラスを定義します。

GetTokenCore メソッドを実装します。このメソッドは、セキュリティトークンのインスタンスを作成して返す役割を担います。MySecurityTokenProvider という名前のクラスを作成し、GetTokenCore メソッドをオーバーライドして X509SecurityToken クラスのインスタンスを返す例を次に示します。クラスコンストラクターには X509Certificate2 クラスのインスタンスが必要です。

Friend Class MySecurityTokenProvider
    Inherits SecurityTokenProvider
    Private certificate As X509Certificate2

    Public Sub New(ByVal certificate As X509Certificate2) 
        Me.certificate = certificate

    End Sub 

    Protected Overrides Function GetTokenCore(ByVal timeout As TimeSpan) As SecurityToken 
        Return New X509SecurityToken(certificate)

    End Function 
End Class

internal class MySecurityTokenProvider : SecurityTokenProvider
{
    X509Certificate2 certificate;

    public MySecurityTokenProvider(X509Certificate2 certificate)
    {
        this.certificate = certificate;
    }

    protected override SecurityToken GetTokenCore(TimeSpan timeout)
    {
        return new X509SecurityToken(certificate);
    }
}

カスタムセキュリティトークンマネージャーにカスタムセキュリティトークンプロバイダーを統合するには

SecurityTokenManager クラスから派生する新しいクラスを定義します。以下の例は、SecurityTokenManager クラスから派生した ClientCredentialsSecurityTokenManager クラスから派生したクラスです。
まだオーバーライドされていない場合は、CreateSecurityTokenProvider メソッドをオーバーライドします。

CreateSecurityTokenProvider メソッドは、WCF セキュリティフレームワークによりメソッドに渡される SecurityTokenRequirement パラメーターに適した SecurityTokenProvider クラスのインスタンスを返す役割を担います。メソッドが適切なセキュリティトークンパラメーターで呼び出された場合に、カスタムセキュリティトークンプロバイダーの実装 (以前の手順で作成済み) を返すようにメソッドを変更します。セキュリティトークンマネージャーの詳細については、「チュートリアル: カスタムクライアントおよびサービスの資格情報を作成する」を参照してください。
SecurityTokenRequirement パラメーターに基づいてカスタムセキュリティトークンプロバイダーを返すカスタムロジックをメソッドに追加します。トークンの要件が満たされた場合に、カスタムセキュリティトークンプロバイダーを返す例を次に示します。要件には、X.509 セキュリティトークンとメッセージの方向 (メッセージ出力にトークンが使用される) が含まれます。他のすべての場合で、コードは基本クラスを呼び出し、他のセキュリティトークンの要件に合わせてシステム指定の動作を維持します。

Friend Class MyClientCredentialsSecurityTokenManager
    Inherits ClientCredentialsSecurityTokenManager
    Private credentials As ClientCredentials
    
    
    Public Sub New(ByVal credentials As ClientCredentials) 
        MyBase.New(credentials)
        Me.credentials = credentials
    
    End Sub 'New
    
    
    Public Overrides Function CreateSecurityTokenProvider(ByVal tokenRequirement As SecurityTokenRequirement) As SecurityTokenProvider 
        ' Return your implementation of the SecurityTokenProvider based on the 
        ' tokenRequirement argument.
        Dim result As SecurityTokenProvider
        If tokenRequirement.TokenType = SecurityTokenTypes.X509Certificate Then
            Dim direction As MessageDirection = tokenRequirement.GetProperty(Of MessageDirection) _
               (ServiceModelSecurityTokenRequirement.MessageDirectionProperty)
            If direction = MessageDirection.Output Then
                result = New MySecurityTokenProvider(credentials.ClientCertificate.Certificate)
            Else
                result = MyBase.CreateSecurityTokenProvider(tokenRequirement)
            End If
        Else
            result = MyBase.CreateSecurityTokenProvider(tokenRequirement)
        End If
        
        Return result
    
    End Function 
End Class

internal class MyClientCredentialsSecurityTokenManager:ClientCredentialsSecurityTokenManager
{
    ClientCredentials credentials;

    public MyClientCredentialsSecurityTokenManager(ClientCredentials credentials)
        : base(credentials)
    {
        this.credentials = credentials;
    }

    public override SecurityTokenProvider CreateSecurityTokenProvider(
        SecurityTokenRequirement tokenRequirement)
    {
        // Return your implementation of the SecurityTokenProvider based on the 
        // tokenRequirement argument.
        SecurityTokenProvider result;
        if (tokenRequirement.TokenType == SecurityTokenTypes.X509Certificate)
        {
            MessageDirection direction = tokenRequirement.GetProperty<MessageDirection>(
                ServiceModelSecurityTokenRequirement.MessageDirectionProperty);
            if (direction == MessageDirection.Output)
            {
                result = new MySecurityTokenProvider(credentials.ClientCertificate.Certificate);
            }
            else
            {
                result = base.CreateSecurityTokenProvider(tokenRequirement);
            }
        }
        else
        {
            result = base.CreateSecurityTokenProvider(tokenRequirement);
        }

        return result;
    }
}

例

完全な SecurityTokenProvider 実装と対応する SecurityTokenManager 実装を次に示します。

Imports System
Imports System.IdentityModel.Selectors
Imports System.IdentityModel.Tokens
Imports System.Security.Permissions
Imports System.Security.Cryptography.X509Certificates
Imports System.ServiceModel
Imports System.ServiceModel.Description
Imports System.ServiceModel.Security.Tokens

<assembly: SecurityPermission(SecurityAction.RequestMinimum, Execution := True)>
Friend Class MySecurityTokenProvider
    Inherits SecurityTokenProvider
    Private certificate As X509Certificate2
    
    Public Sub New(ByVal certificate As X509Certificate2) 
        Me.certificate = certificate
    
    End Sub 
    
    Protected Overrides Function GetTokenCore(ByVal timeout As TimeSpan) As SecurityToken 
        Return New X509SecurityToken(certificate)
    
    End Function 
End Class 

Friend Class MyClientCredentialsSecurityTokenManager
    Inherits ClientCredentialsSecurityTokenManager
    Private credentials As ClientCredentials
    
    
    Public Sub New(ByVal credentials As ClientCredentials) 
        MyBase.New(credentials)
        Me.credentials = credentials
    
    End Sub 'New
    
    
    Public Overrides Function CreateSecurityTokenProvider(ByVal tokenRequirement As SecurityTokenRequirement) As SecurityTokenProvider 
        ' Return your implementation of the SecurityTokenProvider based on the 
        ' tokenRequirement argument.
        Dim result As SecurityTokenProvider
        If tokenRequirement.TokenType = SecurityTokenTypes.X509Certificate Then
            Dim direction As MessageDirection = tokenRequirement.GetProperty(Of MessageDirection) _
               (ServiceModelSecurityTokenRequirement.MessageDirectionProperty)
            If direction = MessageDirection.Output Then
                result = New MySecurityTokenProvider(credentials.ClientCertificate.Certificate)
            Else
                result = MyBase.CreateSecurityTokenProvider(tokenRequirement)
            End If
        Else
            result = MyBase.CreateSecurityTokenProvider(tokenRequirement)
        End If
        
        Return result
    
    End Function 
End Class

using System;
using System.IdentityModel.Selectors;
using System.IdentityModel.Tokens;
using System.Security.Permissions;
using System.Security.Cryptography.X509Certificates;
using System.ServiceModel;
using System.ServiceModel.Description;
using System.ServiceModel.Security.Tokens;

[assembly: SecurityPermission(SecurityAction.RequestMinimum, Execution = true)]
namespace CustomProvider
{
    internal class MySecurityTokenProvider : SecurityTokenProvider
    {
        X509Certificate2 certificate;

        public MySecurityTokenProvider(X509Certificate2 certificate)
        {
            this.certificate = certificate;
        }

        protected override SecurityToken GetTokenCore(TimeSpan timeout)
        {
            return new X509SecurityToken(certificate);
        }
    }

    internal class MyClientCredentialsSecurityTokenManager:ClientCredentialsSecurityTokenManager
    {
        ClientCredentials credentials;

        public MyClientCredentialsSecurityTokenManager(ClientCredentials credentials)
            : base(credentials)
        {
            this.credentials = credentials;
        }

        public override SecurityTokenProvider CreateSecurityTokenProvider(
            SecurityTokenRequirement tokenRequirement)
        {
            // Return your implementation of the SecurityTokenProvider based on the 
            // tokenRequirement argument.
            SecurityTokenProvider result;
            if (tokenRequirement.TokenType == SecurityTokenTypes.X509Certificate)
            {
                MessageDirection direction = tokenRequirement.GetProperty<MessageDirection>(
                    ServiceModelSecurityTokenRequirement.MessageDirectionProperty);
                if (direction == MessageDirection.Output)
                {
                    result = new MySecurityTokenProvider(credentials.ClientCertificate.Certificate);
                }
                else
                {
                    result = base.CreateSecurityTokenProvider(tokenRequirement);
                }
            }
            else
            {
                result = base.CreateSecurityTokenProvider(tokenRequirement);
            }

            return result;
        }
    }
}

参照

リファレンス

SecurityTokenProvider
SecurityTokenRequirement
SecurityTokenManager
X509SecurityToken

概念

チュートリアル: カスタムクライアントおよびサービスの資格情報を作成する
 方法 : カスタムセキュリティトークン認証システムを作成する
 セキュリティアーキテクチャ

次の方法で共有

方法 : カスタムセキュリティトークンプロバイダーを作成する

カスタムセキュリティトークンプロバイダーを作成するには

カスタムセキュリティトークンマネージャーにカスタムセキュリティトークンプロバイダーを統合するには

例

参照

リファレンス

概念

その他のリソース

次の方法で共有

方法 : カスタム セキュリティ トークン プロバイダーを作成する

カスタム セキュリティ トークン プロバイダーを作成するには

カスタム セキュリティ トークン マネージャーにカスタム セキュリティ トークン プロバイダーを統合するには

例

参照

リファレンス

概念

その他のリソース

方法 : カスタムセキュリティトークンプロバイダーを作成する

カスタムセキュリティトークンプロバイダーを作成するには

カスタムセキュリティトークンマネージャーにカスタムセキュリティトークンプロバイダーを統合するには