<clientCertificate> do elemento <clientCredentials>

  • Artigo

Define um certificado X.509 usado para autenticar um cliente em um serviço.

<configuration>
  <system.serviceModel>
    <behaviors>
      <endpointBehaviors>
        <behavior>
          <clientCredentials>
            <clientCertificate>

Syntax

<clientCertificate findValue="String"
                   storeLocation="LocalMachine/CurrentUser"
                   storeName="AddressBook/AuthRoot/CertificateAuthority/Disallowed/My/Root/TrustedPeople/TrustedPublisher"
                   x509FindType="FindByThumbPrint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier" />

Atributos e elementos

As seções a seguir descrevem os atributos, os elementos filho e os elementos pai

Atributos

Atributo Descrição
findValue Uma cadeia de caracteres que contém o valor a ser pesquisado no repositório de certificados X.509. O tipo contido no atributo deve atender aos requisitos do valor do atributo x509FindType. O padrão é uma cadeia de caracteres vazia.
storeLocation Especifica o local do certificado X.509 que o cliente usa para se autenticar no serviço. Os valores válidos incluem os seguintes:

- LocalMachine: o repositório de certificados atribuído ao computador local.
- CurrentUser: o repositório de certificados atribuído ao usuário atual.

O padrão é LocalMachine. Esse atributo é do tipo StoreLocation.
storeName Especifica o nome do repositório de certificados X.509 a ser pesquisado. Os valores válidos incluem os seguintes:

- AddressBook: o repositório de certificados para outros usuários.
– AuthRoot: repositório de certificados para autoridades de certificação de terceiros.
– CertificateAuthority: repositório de certificados para autoridades de certificação intermediárias.
- Disallowed: o repositório de certificados para certificados revogados.
- My: o repositório de certificados para certificados pessoais.
– Raiz: repositório de certificados para autoridades de certificação raiz confiáveis.
- TrustedPeople: o repositório de certificados para recursos e pessoas diretamente confiáveis.
- TrustedPublisher: o repositório de certificados para editores diretamente confiáveis.

O padrão é My. Esse atributo é do tipo StoreName.
x509FindType Define o tipo de pesquisa de X.509 a ser executada. O tipo contido no atributo findValue deve atender aos requisitos desse atributo. Os valores válidos incluem os seguintes:

- FindByThumbPrint
- FindBySubjectName
- FindBySubjectDistinguishedName
- FindByIssuerName
- FindByIssuerDistinguishedName
- FindBySerialNumber
- FindByTimeValid
- FindByTimeNotYetValid
- FindByTemplateName
- FindByApplicationPolicy
- FindByCertificatePolicy
- FindByExtension
- FindByKeyUsage
- FindBySubjectKeyIdentifier

O valor padrão é FindBySubjectDistinguishedName. Esse atributo é do tipo X509FindType.

Elementos filho

Nenhum.

Elementos pai

Elemento Descrição
<clientCredentials> Especifica as credenciais usadas para autenticar o cliente para um serviço.

Comentários

Esse elemento de configuração especifica o certificado usado para autenticar o cliente com esse elemento. Para mais informações, confira Como especificar valores de credenciais do cliente.

Confira também