X509ClientCertificateAuthentication Klasse

Definition

Namespace:

System.ServiceModel.Security

Assembly:

System.ServiceModel.dll

Gibt die Authentifizierungseigenschaften für die Überprüfung 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 der CertificateValidationMode Wert auf Custom festgelegt ist, müssen Sie einen benutzerdefinierten Zertifikats validator erstellen, der von der X509CertificateValidator Klasse erbt. Weitere Informationen finden Sie unter Erstellen eines Diensts, der einen benutzerdefinierten Zertifikatsvalidierungsdienst verwendet.

Eigenschaften

Name	Beschreibung
CertificateValidationMode	Dient zum Abrufen oder Festlegen des Zertifikatüberprüfungsmodus.
CustomCertificateValidator	Dient zum Abrufen oder Festlegen eines benutzerdefinierten Clientzertifikats validator.
IncludeWindowsGroups	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Windows-Gruppen im Autorisierungskontext enthalten sind.
MapClientCertificateToWindowsAccount	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Zertifikat Windows-Konten zugeordnet ist.
RevocationMode	Ruft den Zertifikatsperrmodus für ChainTrust und PeerOrChainTrust X.509-Zertifikatüberprüfung ab, oder legt den Zertifikatsperrmodus fest.
TrustedStoreLocation	Ruft den Speicherort des vertrauenswürdigen Speichers ab, unter dem der Kontext der Clientzertifikatkette überprüft wird, oder legt den Speicherort fest.

Methoden

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

Weitere Informationen

• X509CertificateValidator
• How To: Create a Service Employing a Custom Certificate Validator
• Verwenden von Zertifikaten