X509ClientCertificateAuthentication Classe

Definição

Espaço de Nomes:
System.ServiceModel.Security
Assemblagem:
System.ServiceModel.dll
Origem:
X509ClientCertificateAuthentication.cs
Origem:
X509ClientCertificateAuthentication.cs
Origem:
X509ClientCertificateAuthentication.cs

Especifica propriedades de autenticação para validar o certificado do cliente.

public ref class X509ClientCertificateAuthentication
public class X509ClientCertificateAuthentication
type X509ClientCertificateAuthentication = class
Public Class X509ClientCertificateAuthentication
Herança
Object
X509ClientCertificateAuthentication

Exemplos

O código seguinte mostra como definir esta propriedade.

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

A propriedade também pode ser definida num ficheiro de configuração.

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

Observações

Se o CertificateValidationMode estiver definido para Custom, então deve criar um validador de certificado personalizado que herde da X509CertificateValidator classe. Para obter mais informações, consulte Como criar um serviço que emprega um validador de certificado personalizado.

Propriedades

Name Description
CertificateValidationMode

Obtém ou define o modo de validação de certificados.
CustomCertificateValidator

Recebe ou define um validador personalizado de certificado de cliente.
IncludeWindowsGroups

Recebe ou define um valor que indica se os grupos do Windows estão incluídos no contexto de autorização.
MapClientCertificateToWindowsAccount

Recebe ou define um valor que indica se o certificado está mapeado para contas Windows.
RevocationMode

Obtém ou define o modo de revogação de certificados para validação de certificados ChainTrust e PeerOrChainTrust X.509.
TrustedStoreLocation

Obtém ou define a localização de armazenamento confiável no contexto em que a cadeia de certificados do cliente é validada.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também