X509ClientCertificateAuthentication Klasse

Definition

Namespace:

System.ServiceModel.Security

Assembly:

System.ServiceModel.Primitives.dll

Paket:

System.ServiceModel.Primitives v8.0.0

Quelle:

X509ClientCertificateAuthentication.cs

Gibt Authentifizierungseigenschaften zum Überprüfen des Clientzertifikats an.

public ref class X509ClientCertificateAuthentication

public class X509ClientCertificateAuthentication

type X509ClientCertificateAuthentication = class

Public Class X509ClientCertificateAuthentication

Vererbung

Object

X509ClientCertificateAuthentication

Beispiele

Der folgende Code zeigt, wie diese Eigenschaft festgelegt wird.

// Create a service host.
Uri httpUri = new Uri("http://localhost/Calculator");
ServiceHost sh = new ServiceHost(typeof(Calculator), httpUri);

// Get a reference to the authentication object.
X509ClientCertificateAuthentication myAuthProperties =
    sh.Credentials.ClientCertificate.Authentication;

// Configure peer trust.
myAuthProperties.CertificateValidationMode =
    X509CertificateValidationMode.PeerTrust;
// Configure chain trust.
myAuthProperties.CertificateValidationMode =
    X509CertificateValidationMode.ChainTrust;
// Configure custom certificate validation.
myAuthProperties.CertificateValidationMode =
    X509CertificateValidationMode.Custom;

// Specify a custom certificate validator (not shown here) that inherits
// from the X509CertificateValidator class.
// creds.ClientCertificate.Authentication.CustomCertificateValidator =
//    new MyCertificateValidator();

' Create a service host.
Dim httpUri As New Uri("http://localhost/Calculator")
Dim sh As New ServiceHost(GetType(Calculator), httpUri)

' Get a reference to the authentication object.
Dim myAuthProperties As X509ClientCertificateAuthentication = _
sh.Credentials.ClientCertificate.Authentication

' Configure peer trust.
myAuthProperties.CertificateValidationMode = X509CertificateValidationMode.PeerTrust
' Configure chain trust.
myAuthProperties.CertificateValidationMode = X509CertificateValidationMode.ChainTrust
' Configure custom certificate validation.
myAuthProperties.CertificateValidationMode = X509CertificateValidationMode.Custom
' Specify a custom certificate validator (not shown here) that inherits 
' from the X509CertificateValidator class. 
' creds.ClientCertificate.Authentication.CustomCertificateValidator = _
'    new MyCertificateValidator()

Die Eigenschaft kann auch in einer Konfigurationsdatei festgelegt werden.

<serviceCredentials>  
  <clientCertificate>  
     <authentication certificateValidationMode='ChainTrust' />  
  </clientCertificate>  
</serviceCredentials>  

Hinweise

Wenn CertificateValidationMode auf Custom festgelegt ist, müssen Sie eine benutzerdefinierte Zertifikatüberprüfung erstellen, die von der X509CertificateValidator-Klasse erbt. Weitere Informationen finden Sie unter Vorgehensweise: Erstellen eines Diensts, der eine benutzerdefinierte Zertifikatüberprüfung verwendet.

Konstruktoren

X509ClientCertificateAuthentication()

Gibt Authentifizierungseigenschaften zum Überprüfen des Clientzertifikats an.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• X509CertificateValidator
• Vorgehensweise: Erstellen eines Diensts mit einem benutzerdefinierten Zertifikatüberprüfungssteuerelement
• Verwenden von Zertifikaten