X509ClientCertificateAuthentication Clase

Referencia

Definición

Espacio de nombres:: System.ServiceModel.Security

Ensamblado:: System.ServiceModel.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Especifica las propiedades de autenticación para validar el certificado del cliente.

public ref class X509ClientCertificateAuthentication

public class X509ClientCertificateAuthentication

type X509ClientCertificateAuthentication = class

Public Class X509ClientCertificateAuthentication

Herencia: Object
X509ClientCertificateAuthentication

Ejemplos

El código siguiente muestra cómo establecer esta propiedad.

// 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 propiedad también puede establecerse en un archivo de configuración.

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

Comentarios

Si CertificateValidationMode está establecido en Custom, entonces debe crear un validador del certificado personalizado que herede de la clase X509CertificateValidator. Para obtener más información, vea How to: Create a Service that Employs a Custom Certificate Validator.

Propiedades

CertificateValidationMode	Obtiene o establece el modo de validación del certificado.
CustomCertificateValidator	Obtiene o establece un validador de certificado de cliente personalizado.
IncludeWindowsGroups	Obtiene o establece un valor que indica si los grupos de Windows están incluidos en el contexto de la autorización.
MapClientCertificateToWindowsAccount	Obtiene o establece un valor que indica si el certificado está asignado a las cuentas de Windows.
RevocationMode	Obtiene o establece el modo de revocación de certificados para la validación de certificados ChainTrust y PeerOrChainTrust X.509.
TrustedStoreLocation	Obtiene o establece la ubicación del almacén de confianza bajo el que el se valida el contexto de la cadena del certificado del cliente.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Se aplica a

Compartir vía