X509ClientCertificateAuthentication Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.ServiceModel.Security
Assembly:
System.ServiceModel.Primitives.dll
Assembly:
System.ServiceModel.dll
Pacchetto:
System.ServiceModel.Primitives v6.0.0
Pacchetto:
System.ServiceModel.Primitives v6.2.0
Pacchetto:
System.ServiceModel.Primitives v8.0.0
Source:
X509ClientCertificateAuthentication.cs
Source:
X509ClientCertificateAuthentication.cs
Source:
X509ClientCertificateAuthentication.cs

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.

Costruttori

X509ClientCertificateAuthentication()

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

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)

Si applica a

Vedi anche