Udostępnij za pośrednictwem

X509CertificateRecipientClientCredential.SetDefaultCertificate Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.ServiceModel.Security
Zestaw:
System.ServiceModel.Primitives.dll
Zestaw:
System.ServiceModel.dll
Pakiet:
System.ServiceModel.Primitives v8.1.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
Ź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 .

Dotyczy

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Źródło:
X509CertificateRecipientClientCredential.cs
Ź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 .

Dotyczy