X509CertificateRecipientClientCredential.SetDefaultCertificate Metoda

Definicja

Przestrzeń nazw:

System.ServiceModel.Security

Zestaw:

System.ServiceModel.Primitives.dll

Pakiet:

System.ServiceModel.Primitives v8.0.0

Określa domyślny certyfikat do użycia dla usługi.

Przeciążenia

SetDefaultCertificate(String, StoreLocation, StoreName)	Określa domyślny certyfikat do użycia dla usługi. W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat jest używany do szyfrowania komunikatów w usłudze i oczekuje się, że będzie używany przez usługę do podpisywania odpowiedzi na klienta.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)	Określa domyślny certyfikat do użycia dla usługi. W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat jest używany do szyfrowania komunikatów w usłudze i oczekuje się, że będzie używany przez usługę do podpisywania odpowiedzi na klienta.

Uwagi

Te metody pobierają certyfikat z magazynu w określonej lokalizacji, która jest zgodna z określonymi parametrami.

W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat jest używany do szyfrowania komunikatów w usłudze i oczekuje się, że będzie używany przez usługę do podpisywania odpowiedzi na klienta.

SetDefaultCertificate(String, StoreLocation, StoreName)

Źródło:

X509CertificateRecipientClientCredential.cs

Określa domyślny certyfikat do użycia dla usługi. W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat jest używany do szyfrowania komunikatów w usłudze i oczekuje się, że będzie używany przez usługę do podpisywania odpowiedzi na klienta.

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)

Parametry

subjectName

String

Nazwa wyróżniająca podmiotu.

storeLocation

StoreLocation

Lokalizacja magazynu certyfikatów używanego przez usługę do uzyskania certyfikatu usługi.

storeName

StoreName

Nazwa magazynu certyfikatów X.509 do otwarcia.

Wyjątki

ArgumentNullException

subjectName to null.

InvalidOperationException

Podjęto próbę ustawienia, gdy poświadczenie jest tylko do odczytu.

Przykłady

Poniższy kod używa tej metody do określenia certyfikatu X.509 do użycia.

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

Uwagi

Ta metoda pobiera certyfikat z magazynu w określonej lokalizacji zgodnej z parametrem subjectName .

Wartości dla storeLocation elementu są uwzględniane w wyliczenie StoreLocation :

• LocalMachine: magazyn certyfikatów przypisany do komputera lokalnego.

• CurrentUser: magazyn certyfikatów używany przez bieżącego użytkownika (ustawienie domyślne).

Jeśli aplikacja jest uruchomiona na koncie systemowym, certyfikat zazwyczaj znajduje się w elemecie LocalMachine. Jeśli aplikacja jest uruchomiona na koncie użytkownika, certyfikat zazwyczaj znajduje się w elemecie CurrentUser.

Wartości dla storeName są uwzględniane w wyliczenie StoreName .

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Źródło:

X509CertificateRecipientClientCredential.cs

Określa domyślny certyfikat do użycia dla usługi. W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat jest używany do szyfrowania komunikatów w usłudze i oczekuje się, że będzie używany przez usługę do podpisywania odpowiedzi na klienta.

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)

Parametry

storeLocation

StoreLocation

Lokalizacja magazynu certyfikatów używana przez usługę do uzyskania certyfikatu usługi.

storeName

StoreName

Nazwa magazynu certyfikatów X.509 do otwarcia.

findType

X509FindType

Typ wyszukiwania X.509 do wykonania.

findValue

Object

Wartość do wyszukania w magazynie certyfikatów X.509.

Wyjątki

ArgumentNullException

findValue to null.

InvalidOperationException

Podjęto próbę ustawienia, gdy poświadczenie jest tylko do odczytu.

Przykłady

Poniższy kod używa tej metody do określenia certyfikatu X.509 do użycia.

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

Uwagi

Ta metoda pobiera certyfikat z magazynu w określonej lokalizacji zgodnej z parametrami findType i findValue .

Wartości dla storeLocation elementu są uwzględniane w wyliczenie StoreLocation :

• LocalMachine: magazyn certyfikatów przypisany do komputera lokalnego.

• CurrentUser: magazyn certyfikatów używany przez bieżącego użytkownika (ustawienie domyślne).

Jeśli aplikacja jest uruchomiona na koncie systemowym, certyfikat zazwyczaj znajduje się w elemecie LocalMachine. Jeśli aplikacja jest uruchomiona na koncie użytkownika, certyfikat zazwyczaj znajduje się w elemecie CurrentUser.

Wartości dla storeName są uwzględniane w wyliczenie StoreName .

Wartości dla findType są uwzględniane w wyliczenie X509FindType .

Najczęściej używane wyliczenie to FindBySubjectName, co umożliwia wyszukiwanie bez uwzględniania wielkości liter w nazwie podmiotu certyfikatów w określonym magazynie. Może to być nieprecyzyjne wyszukiwanie. Jeśli nie zostaną znalezione żadne certyfikaty lub wiele certyfikatów spełniających kryteria, InvalidOperationException zostanie zgłoszony element .