LocalCertificateSelectionCallback デリゲートとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

LocalCertificateSelectionCallback デリゲート

メモ : このデリゲートは、.NET Framework version 2.0 で新しく追加されたものです。

認証に使用するローカルの SSL (Secure Sockets Layer) 証明書を選択します。

名前空間: System.Net.Security
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Public Delegate Function
 LocalCertificateSelectionCallback ( _
    sender As Object, _
    targetHost As String, _
    localCertificates As X509CertificateCollection, _
    remoteCertificate As X509Certificate, _
    acceptableIssuers As String() _
) As X509Certificate

Visual Basic (使用法)

Dim instance As New LocalCertificateSelectionCallback(AddressOf
 HandlerMethod)

public delegate X509Certificate LocalCertificateSelectionCallback
 (
    Object sender,
    string targetHost,
    X509CertificateCollection localCertificates,
    X509Certificate remoteCertificate,
    string[] acceptableIssuers
)

C++

public delegate X509Certificate^ LocalCertificateSelectionCallback
 (
    Object^ sender, 
    String^ targetHost, 
    X509CertificateCollection^ localCertificates, 
    X509Certificate^ remoteCertificate, 
    array<String^>^ acceptableIssuers
)

/** @delegate */
public delegate X509Certificate LocalCertificateSelectionCallback
 (
    Object sender, 
    String targetHost, 
    X509CertificateCollection localCertificates, 
    X509Certificate remoteCertificate, 
    String[] acceptableIssuers
)

JScript

JScript では、デリゲートは使用できますが、新規に宣言することはできません。

パラメータ

sender: この検証のステータス情報を格納するオブジェクト。

targetHost: クライアントが指定したホストサーバー。

localCertificates: ローカルの証明書を格納している X509CertificateCollection。

remoteCertificate: リモート側の認証に使用される証明書。

acceptableIssuers: リモート側が受け入れることのできる証明書発行者の String 配列。

戻り値
SSL 接続の確立に使用する X509Certificate。

解説

このデリゲートは、SslStream クラスのインスタンスを生成するために使用されます。SslStream クラスは、クライアントとサーバーの間で交換される情報をセキュリティ保護できるようにするために使用されます。クライアントとサーバーは、このデリゲートを使用して、認証に使用される証明書を選択します。

使用例

このデリゲートにメソッドを実装するコード例を次に示します。

public static X509Certificate SelectLocalCertificate(
    object sender,
    string targetHost, 
    X509CertificateCollection localCertificates, 
    X509Certificate remoteCertificate, 
    string[] acceptableIssuers)
{    
    Console.WriteLine("Client is selecting a local certificate.");
    if (acceptableIssuers != null &&
 
        acceptableIssuers.Length > 0 &&
        localCertificates != null &&
        localCertificates.Count > 0)
    {
        // Use the first certificate that is from an acceptable issuer.
        foreach (X509Certificate certificate in
 localCertificates)
        {
            string issuer = certificate.Issuer;
            if (Array.IndexOf(acceptableIssuers, issuer) != -1)
                return certificate;
        }
    }
    if (localCertificates != null &&
        localCertificates.Count > 0)
        return localCertificates[0];
        
    return null;
}

このデリゲートのインスタンスを作成するコード例を次に示します。

// Server name must match the host name and the name on the host's certificate.
 
serverName = args[0];
// Create a TCP/IP client socket.
TcpClient client = new TcpClient(serverName,80);
Console.WriteLine("Client connected.");
// Create an SSL stream that will close the client's stream.
SslStream sslStream = new SslStream(
    client.GetStream(), 
    false, 
    new RemoteCertificateValidationCallback (ValidateServerCertificate),
 
    new LocalCertificateSelectionCallback(SelectLocalCertificate)
    );