<clientCertificate> do elemento <clientCredentials>

Artigo
05/24/2023

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.

Compartilhar via