X509CertificateRecipientClientCredential.SetDefaultCertificate メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
サービスに使用する既定の証明書を指定します。
オーバーロード
| SetDefaultCertificate(String, StoreLocation, StoreName) |
サービスに使用する既定の証明書を指定します。 証明書に基づくメッセージ セキュリティを使用したバインディングでは、この証明書を使用してサービスへのメッセージを暗号化します。サービスは、クライアントへの応答に署名する際に、この証明書を使用することが要求されます。 |
| SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object) |
サービスに使用する既定の証明書を指定します。 証明書に基づくメッセージ セキュリティを使用したバインディングでは、この証明書を使用してサービスへのメッセージを暗号化します。サービスは、クライアントへの応答に署名する際に、この証明書を使用することが要求されます。 |
注釈
これらのメソッドは、指定されたパラメーターに一致する指定された場所にあるストアから証明書を取得します。
証明書に基づくメッセージ セキュリティを使用したバインディングでは、この証明書を使用してサービスへのメッセージを暗号化します。サービスは、クライアントへの応答に署名する際に、この証明書を使用することが要求されます。
SetDefaultCertificate(String, StoreLocation, StoreName)
サービスに使用する既定の証明書を指定します。 証明書に基づくメッセージ セキュリティを使用したバインディングでは、この証明書を使用してサービスへのメッセージを暗号化します。サービスは、クライアントへの応答に署名する際に、この証明書を使用することが要求されます。
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 -> unitPublic Sub SetDefaultCertificate (subjectName As String, storeLocation As StoreLocation, storeName As StoreName)パラメーター
- subjectName
- String
サブジェクト識別名。
- storeLocation
- StoreLocation
サービスがサービス証明書を取得するときに使用する証明書ストアの場所。
- storeName
- StoreName
開く X.509 証明書ストアの名前。
例外
subjectName が nullです。
資格情報が読み取り専用のときに設定しようとしました。
例
このメソッドを使用して、使用する 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)
サービスに使用する既定の証明書を指定します。 証明書に基づくメッセージ セキュリティを使用したバインディングでは、この証明書を使用してサービスへのメッセージを暗号化します。サービスは、クライアントへの応答に署名する際に、この証明書を使用することが要求されます。
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 -> unitPublic 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 証明書ストアで検索する値。
例外
findValue が nullです。
資格情報が読み取り専用のときに設定しようとしました。
例
このメソッドを使用して、使用する 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 がスローされます。
適用対象
.NET