X509CertificateRecipientClientCredential.SetDefaultCertificate メソッド

定義

名前空間:

System.ServiceModel.Security

アセンブリ:

System.ServiceModel.Primitives.dll

パッケージ:

System.ServiceModel.Primitives v8.1.0

サービスに使用する既定の証明書を指定します。

オーバーロード

SetDefaultCertificate(String, StoreLocation, StoreName)	サービスに使用する既定の証明書を指定します。 証明書に基づくメッセージ セキュリティを使用したバインディングでは、この証明書を使用してサービスへのメッセージを暗号化します。サービスは、クライアントへの応答に署名する際に、この証明書を使用することが要求されます。
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)	サービスに使用する既定の証明書を指定します。 証明書に基づくメッセージ セキュリティを使用したバインディングでは、この証明書を使用してサービスへのメッセージを暗号化します。サービスは、クライアントへの応答に署名する際に、この証明書を使用することが要求されます。

注釈

これらのメソッドは、指定されたパラメーターに一致する指定された場所にあるストアから証明書を取得します。

証明書に基づくメッセージ セキュリティを使用したバインディングでは、この証明書を使用してサービスへのメッセージを暗号化します。サービスは、クライアントへの応答に署名する際に、この証明書を使用することが要求されます。

SetDefaultCertificate(String, StoreLocation, StoreName)

ソース:

X509CertificateRecipientClientCredential.cs

サービスに使用する既定の証明書を指定します。 証明書に基づくメッセージ セキュリティを使用したバインディングでは、この証明書を使用してサービスへのメッセージを暗号化します。サービスは、クライアントへの応答に署名する際に、この証明書を使用することが要求されます。

public:
 void SetDefaultCertificate(System::String ^ subjectName, System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName);

public void SetDefaultCertificate (string subjectName, System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName);

member this.SetDefaultCertificate : string * System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName -> unit

Public Sub SetDefaultCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)

パラメーター

subjectName

String

サブジェクト識別名。

storeLocation

StoreLocation

サービスがサービス証明書を取得するときに使用する証明書ストアの場所。

storeName

StoreName

開く X.509 証明書ストアの名前。

例外

ArgumentNullException

subjectName が nullです。

InvalidOperationException

資格情報が読み取り専用のときに設定しようとしました。

例

このメソッドを使用して、使用する X.509 証明書を指定するコードを次に示します。

public void snippet23(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate("http://fabrikam.com/sts",
                             StoreLocation.CurrentUser,
                             StoreName.TrustedPeople);
}

注釈

このメソッドは、subjectName パラメーターに一致する指定された場所にあるストアから証明書を取得します。

storeLocation の値は、StoreLocation 列挙体に格納されます。

• LocalMachine: ローカル コンピューターに割り当てられた証明書ストア。

• CurrentUser: 現在のユーザーによって使用される証明書ストア (既定値)。

アプリケーションがシステム アカウントで実行されている場合、証明書は通常、LocalMachine にあります。 アプリケーションがユーザー アカウントで実行されている場合、証明書は通常、CurrentUser にあります。

storeName の値は、StoreName 列挙体に格納されます。

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

ソース:

X509CertificateRecipientClientCredential.cs

サービスに使用する既定の証明書を指定します。 証明書に基づくメッセージ セキュリティを使用したバインディングでは、この証明書を使用してサービスへのメッセージを暗号化します。サービスは、クライアントへの応答に署名する際に、この証明書を使用することが要求されます。

public:
 void SetDefaultCertificate(System::Security::Cryptography::X509Certificates::StoreLocation storeLocation, System::Security::Cryptography::X509Certificates::StoreName storeName, System::Security::Cryptography::X509Certificates::X509FindType findType, System::Object ^ findValue);

public void SetDefaultCertificate (System.Security.Cryptography.X509Certificates.StoreLocation storeLocation, System.Security.Cryptography.X509Certificates.StoreName storeName, System.Security.Cryptography.X509Certificates.X509FindType findType, object findValue);

member this.SetDefaultCertificate : System.Security.Cryptography.X509Certificates.StoreLocation * System.Security.Cryptography.X509Certificates.StoreName * System.Security.Cryptography.X509Certificates.X509FindType * obj -> unit

Public Sub SetDefaultCertificate (storeLocation As StoreLocation, storeName As StoreName, findType As X509FindType, findValue As Object)

パラメーター

storeLocation

StoreLocation

サービスがサービス証明書を取得するときに使用する証明書ストアの場所。

storeName

StoreName

開く X.509 証明書ストアの名前。

findType

X509FindType

実行する X.509 検索の種類。

findValue

Object

X.509 証明書ストアで検索する値。

例外

ArgumentNullException

findValue が nullです。

InvalidOperationException

資格情報が読み取り専用のときに設定しようとしました。

例

このメソッドを使用して、使用する X.509 証明書を指定するコードを次に示します。

public void snippet22(CalculatorClient cc)
{
    X509CertificateRecipientClientCredential rcc = cc.ClientCredentials.ServiceCertificate;
    rcc.SetDefaultCertificate(StoreLocation.CurrentUser,
                             StoreName.TrustedPeople,
                             X509FindType.FindBySubjectName,
                             "FabrikamSTS");
}

注釈

このメソッドは、findType パラメーターと findValue パラメーターに一致する指定された場所にあるストアから証明書を取得します。

storeLocation の値は、StoreLocation 列挙体に格納されます。

• LocalMachine: ローカル コンピューターに割り当てられた証明書ストア。

• CurrentUser: 現在のユーザーによって使用される証明書ストア (既定値)。

アプリケーションがシステム アカウントで実行されている場合、証明書は通常、LocalMachine にあります。 アプリケーションがユーザー アカウントで実行されている場合、証明書は通常、CurrentUser にあります。

storeName の値は、StoreName 列挙体に格納されます。

findType の値は、X509FindType 列挙体に格納されます。

最もよく使用される列挙体は FindBySubjectName です。これは、指定されたストア内の証明書のサブジェクト名を検索 (大文字小文字の違いは無視) します。 この検索結果は厳密ではない可能性があります。 条件に一致する証明書が見つからないか、複数見つかった場合は、InvalidOperationException がスローされます。