ClientCredentials.ServiceCertificate Eigenschaft

Definition

Namespace:

System.ServiceModel.Description

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Ruft ein Objekt ab, mit dem das X.509-Zertifikat eines Diensts angegeben wird.

public:
 property System::ServiceModel::Security::X509CertificateRecipientClientCredential ^ ServiceCertificate { System::ServiceModel::Security::X509CertificateRecipientClientCredential ^ get(); };

public System.ServiceModel.Security.X509CertificateRecipientClientCredential ServiceCertificate { get; }

member this.ServiceCertificate : System.ServiceModel.Security.X509CertificateRecipientClientCredential

Public ReadOnly Property ServiceCertificate As X509CertificateRecipientClientCredential

Eigenschaftswert

X509CertificateRecipientClientCredential

X509CertificateRecipientClientCredential zur Darstellung des Zertifikats, das für einen bestimmten Dienst verwendet werden soll.

Beispiele

Dieser Code zeigt, wie Sie mithilfe dieser Eigenschaft das Zertifikat des Diensts abrufen und seine Eigenschaften festlegen können.

X509CertificateRecipientClientCredential rcc =
    client.ClientCredentials.ServiceCertificate;

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

Hinweise

Mithilfe des von dieser Eigenschaft zurückgegebenen Objekts können Sie die Eigenschaften des Zertifikats durch Aufrufen seiner Member konfigurieren.

Sie können ein einzelnes Standardzertifikat sowie ein anderes Zertifikat festlegen, das bei der Kommunikation mit einem bestimmten URI verwendet werden soll.

Über diese Klasse können Sie auch die Authentifizierungseinstellungen für Dienstzertifikate steuern, die mittels SSL/TLS-Aushandlung auf Nachrichtenebene ausgehandelt werden.

Diese Eigenschaft muss nicht immer angegeben werden. Ob dies erforderlich ist, hängt vom Authentifizierungsmodus und den Aushandlungsoptionen ab, die für die zur Kommunikation mit dem Dienst verwendete Bindung festgelegt sind. Einige relevante Klassen, die dieses Verhalten steuern, sind MessageSecurityOverHttp und MessageSecurityOverTcp.

Sie können diesen Wert auch mithilfe des <Zertifikatelements> in einer Clientanwendungskonfigurationsdatei festlegen.