X509CertificateRecipientClientCredential.SetDefaultCertificate Yöntem

Tanım

Ad Alanı:

System.ServiceModel.Security

Bütünleştirilmiş Kod:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Hizmet için kullanılacak varsayılan sertifikayı belirtir.

Aşırı Yüklemeler

SetDefaultCertificate(String, StoreLocation, StoreName)	Hizmet için kullanılacak varsayılan sertifikayı belirtir. Sertifika tabanlı ileti güvenliği kullanan bağlamalar için, bu sertifika hizmete gönderilen iletileri şifrelemek için kullanılır ve hizmet tarafından istemciye yanıt imzalamak için kullanılması beklenir.
SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)	Hizmet için kullanılacak varsayılan sertifikayı belirtir. Sertifika tabanlı ileti güvenliği kullanan bağlamalar için, bu sertifika hizmete gönderilen iletileri şifrelemek için kullanılır ve hizmet tarafından istemciye yanıt imzalamak için kullanılması beklenir.

Açıklamalar

Bu yöntemler, belirtilen konumdaki depodan belirtilen parametrelerle eşleşen bir sertifika alır.

Sertifika tabanlı ileti güvenliği kullanan bağlamalar için, bu sertifika hizmete gönderilen iletileri şifrelemek için kullanılır ve hizmet tarafından istemciye yanıt imzalamak için kullanılması beklenir.

SetDefaultCertificate(String, StoreLocation, StoreName)

Kaynak:

X509CertificateRecipientClientCredential.cs

Hizmet için kullanılacak varsayılan sertifikayı belirtir. Sertifika tabanlı ileti güvenliği kullanan bağlamalar için, bu sertifika hizmete gönderilen iletileri şifrelemek için kullanılır ve hizmet tarafından istemciye yanıt imzalamak için kullanılması beklenir.

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)

Parametreler

subjectName

String

Konu ayırt edici adı.

storeLocation

StoreLocation

Hizmetin hizmet sertifikasını almak için kullandığı sertifika deposunun konumu.

storeName

StoreName

Açılacak X.509 sertifika deposunun adı.

Özel durumlar

ArgumentNullException

subjectName, null değeridir.

InvalidOperationException

Kimlik bilgisi salt okunur olduğunda ayar yapılmaya çalışıldı.

Örnekler

Aşağıdaki kod, kullanılacak X.509 sertifikasını belirtmek için bu yöntemi kullanır.

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

Açıklamalar

Bu yöntem, belirtilen konumdaki depodan parametresiyle subjectName eşleşen bir sertifika alır.

değerleri storeLocation numaralandırmaya StoreLocation eklenir:

• LocalMachine: yerel makineye atanan sertifika deposu.

• CurrentUser: geçerli kullanıcı tarafından kullanılan sertifika deposu (varsayılan).

Uygulama bir sistem hesabı altında çalışıyorsa, sertifika genellikle içindedir LocalMachine. Uygulama bir kullanıcı hesabı altında çalışıyorsa, sertifika genellikle içindedir CurrentUser.

değerleri storeName sabit listesi içinde StoreName yer alır.

SetDefaultCertificate(StoreLocation, StoreName, X509FindType, Object)

Kaynak:

X509CertificateRecipientClientCredential.cs

Hizmet için kullanılacak varsayılan sertifikayı belirtir. Sertifika tabanlı ileti güvenliği kullanan bağlamalar için, bu sertifika hizmete gönderilen iletileri şifrelemek için kullanılır ve hizmet tarafından istemciye yanıt imzalamak için kullanılması beklenir.

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)

Parametreler

storeLocation

StoreLocation

Hizmetin hizmet sertifikasını almak için kullandığı sertifika deposunun konumu.

storeName

StoreName

Açılacak X.509 sertifika deposunun adı.

findType

X509FindType

Yürütülecek X.509 arama türü.

findValue

Object

X.509 sertifika deposunda aranacak değer.

Özel durumlar

ArgumentNullException

findValue, null değeridir.

InvalidOperationException

Kimlik bilgisi salt okunur olduğunda ayar yapılmaya çalışıldı.

Örnekler

Aşağıdaki kod, kullanılacak X.509 sertifikasını belirtmek için bu yöntemi kullanır.

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

Açıklamalar

Bu yöntem, belirtilen konumdaki depodan ve findValue parametreleriyle findType eşleşen bir sertifika alır.

değerleri storeLocation numaralandırmaya StoreLocation eklenir:

• LocalMachine: yerel makineye atanan sertifika deposu.

• CurrentUser: geçerli kullanıcı tarafından kullanılan sertifika deposu (varsayılan).

Uygulama bir sistem hesabı altında çalışıyorsa, sertifika genellikle içindedir LocalMachine. Uygulama bir kullanıcı hesabı altında çalışıyorsa, sertifika genellikle içindedir CurrentUser.

değerleri storeName sabit listesi içinde StoreName yer alır.

değerleri findType sabit listesi içinde X509FindType yer alır.

En yaygın olarak kullanılan numaralandırma, belirtilen depodaki sertifikaların konu adı üzerinde büyük/küçük harfe duyarlı olmayan bir arama yapan numaralandırmadır FindBySubjectName. Bu, kesin olmayan bir arama olabilir. Ölçütlerle eşleşen sertifika veya birden çok sertifika bulunmazsa, bir InvalidOperationException oluşturulur.