X509CertificateRecipientClientCredential.ScopedCertificates Właściwość

Definicja

Przestrzeń nazw:

System.ServiceModel.Security

Zestaw:

System.ServiceModel.Primitives.dll

Pakiet:

System.ServiceModel.Primitives v8.0.0

Źródło:

X509CertificateRecipientClientCredential.cs

Pobiera certyfikat o określonym zakresie, który ma być używany do reprezentowania usługi, z którą komunikuje się klient.

public:
 property System::Collections::Generic::Dictionary<Uri ^, System::Security::Cryptography::X509Certificates::X509Certificate2 ^> ^ ScopedCertificates { System::Collections::Generic::Dictionary<Uri ^, System::Security::Cryptography::X509Certificates::X509Certificate2 ^> ^ get(); };

public System.Collections.Generic.Dictionary<Uri,System.Security.Cryptography.X509Certificates.X509Certificate2> ScopedCertificates { get; }

member this.ScopedCertificates : System.Collections.Generic.Dictionary<Uri, System.Security.Cryptography.X509Certificates.X509Certificate2>

Public ReadOnly Property ScopedCertificates As Dictionary(Of Uri, X509Certificate2)

Wartość właściwości

Dictionary<Uri,X509Certificate2>

Certyfikat o określonym zakresie używany do reprezentowania usługi, z którą komunikuje się klient.

Wyjątki

InvalidOperationException

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

Przykłady

Ten kod pokazuje, jak ustawić tę właściwość.

X509CertificateRecipientClientCredential rcc =
    client.ClientCredentials.ServiceCertificate;

X509Certificate2 cert = new X509Certificate2();
rcc.ScopedCertificates.Add(new Uri("http://fabrikam.com/sts"), cert);

Uwagi

Ta właściwość umożliwia klientowi skonfigurowanie certyfikatu usługi do użycia na podstawie adresu URL usługi, z którym komunikuje się. Jest to szczególnie przydatne w scenariuszach wystawionych tokenów, w których klient może komunikować się z wieloma usługami (usługą końcową, a także pośrednimi usługami tokenów zabezpieczających). W przypadku powiązań korzystających z zabezpieczeń komunikatów opartych na certyfikatach ten certyfikat służy do szyfrowania komunikatów w usłudze i oczekuje się, że będzie używany przez usługę do podpisywania odpowiedzi na klienta.

Jeśli powiązanie wymaga certyfikatu dla usługi i nie znaleziono określonego certyfikatu dla adresu URL usługi, ScopedCertificatesużywany jest certyfikat domyślny.

Zobacz też

• DefaultCertificate