X509ClientCertificateAuthentication Classe

Definizione

Spazio dei nomi:

System.ServiceModel.Security

Assembly:

System.ServiceModel.dll

Specifica le proprietà di autenticazione per la convalida del certificato client.

public ref class X509ClientCertificateAuthentication

public class X509ClientCertificateAuthentication

type X509ClientCertificateAuthentication = class

Public Class X509ClientCertificateAuthentication

Ereditarietà

Object

X509ClientCertificateAuthentication

Esempio

Nel codice seguente viene illustrato 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()

La proprietà può essere impostata anche in un file di configurazione.

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

Commenti

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

Proprietà

Nome	Descrizione
CertificateValidationMode	Ottiene o imposta la modalità di convalida del certificato.
CustomCertificateValidator	Ottiene o imposta un validator di 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 il certificato è mappato agli account di Windows.
RevocationMode	Ottiene o imposta la modalità di revoca del certificato per la convalida del certificato ChainTrust e PeerOrChainTrust X.509.
TrustedStoreLocation	Ottiene o imposta il percorso dell'archivio attendibile in base al quale viene convalidata la catena di certificati client.

Metodi

Nome	Descrizione
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 il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (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 di certificato personalizzato
• Uso di certificati