X509ClientCertificateAuthentication Classe

Definizione

Spazio dei nomi:

System.ServiceModel.Security

Assembly:

System.ServiceModel.dll

Specifica le proprietà di autenticazione per convalidare il certificato client.

public ref class X509ClientCertificateAuthentication

public class X509ClientCertificateAuthentication

type X509ClientCertificateAuthentication = class

Public Class X509ClientCertificateAuthentication

Ereditarietà

Object

X509ClientCertificateAuthentication

Esempio

Nel codice seguente viene mostrato come impostare questa proprietà.

// 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()

È anche possibile impostare la proprietà in un file di configurazione.

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

Commenti

Se la proprietà CertificateValidationMode è impostata su Custom, è necessario creare un validator personalizzato del certificato che eredita dalla classe X509CertificateValidator. Per altre informazioni, vedere Procedura: Creare un servizio che usa un validator certificato personalizzato.

Proprietà

CertificateValidationMode	Ottiene o imposta la modalità di convalida dei certificati.
CustomCertificateValidator	Ottiene o imposta un validator del certificato client personalizzato.
IncludeWindowsGroups	Ottiene o imposta un valore che indica se i gruppi di Windows sono inclusi nel contesto di autorizzazione.
MapClientCertificateToWindowsAccount	Ottiene o imposta un valore che indica se del certificato viene mappato agli account di Windows.
RevocationMode	Ottiene o imposta la modalità di revoca dei certificati per ChainTrust e la convalida dei certificati X.509 PeerOrChainTrust.
TrustedStoreLocation	Ottiene o imposta il percorso dell'archivio attendibile nel cui contesto viene convalidata la catena dei certificati client.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• X509CertificateValidator
• Procedura: Creare un servizio che usa un validator certificato personalizzato
• Utilizzo dei certificati