Partilhar via


<certificate> Elemento

Especifica um certificado X.509 para usar na assinatura e encriptação de mensagens para clientes peer-to-peer.

<configuration>
  <system.serviceModel>
    <behaviors>
      <endpointBehaviors>
        <behavior>
          <clientCredentials>
            <peer>
              <certificate>

Sintaxe

<certificate 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 atributos, elementos filho e elementos pai.

Attributes

Attribute Description
findValue Uma cadeia que contém o valor a procurar na loja de certificados X.509. O tipo contido no atributo deve satisfazer os requisitos do especificado x509FindType. O padrão é uma cadeia de caracteres vazia.
storeLocation Especifica a localização do armazenamento de certificados X.509 que o cliente usa para validar o certificado do par contra ele. Os valores válidos incluem os seguintes:

- LocalMachine: o armazenamento de certificados atribuído à máquina local.
- CurrentUser: o armazenamento de certificados atribuído ao utilizador atual.

O padrão é o LocalMachine.
storeName Especifica o nome da loja de certificados X.509 a abrir. Os valores válidos incluem os seguintes:

- AddressBook: Armazenamento de certificados para outros utilizadores.
- AuthRoot: Armazenamento de certificados para autoridades de certificação (CAs) de terceiros.
- Autoridade de Certificação: Armazenamento de certificados para autoridades de certificação intermédias (CAs).
- Proibido: Armazenamento de certificados para certificados revogados.
- Meu: Loja de certificados para certificados pessoais.
- Root: Armazenamento de certificados para autoridades de certificação raiz (CAs) de confiança.
- TrustedPeople: Armazenamento de certificados para pessoas e recursos diretamente confiáveis.
- TrustedPublisher: Armazenamento de certificados para editores diretamente confiáveis.

O padrão é o meu.
X509FindType Define o tipo de pesquisa X.509 a ser executada. Os valores válidos incluem os seguintes:

- FindByThumbFingerprint
- FindBySubjectName
- FindBySubjectNominatedDistinguishedName
- FindByIssuerName
- FindByIssuerDistinguishedName
- FindBySerialNumber
- FindByTimeValid
- FindByTimeNotYetValid
- FindByTemplateName
- FindByApplicationPolicy
- FindByCertificatePolicy
- FindByExtension
- FindByKeyUsage
- FindBySubjectKeyIdentifier

O tipo contido no findValue atributo deve satisfazer os requisitos do especificado X509FindType.

O valor padrão é FindBySubjectDistinguishedName.

Elementos filho

Nenhum.

Elementos Principais

Elemento Description
<Peer> Especifica credenciais usadas ao autenticar clientes peer-to-peer.

Observações

Este elemento de configuração contém uma instância X509Certificate2 usada ao autenticar vizinhos na malha peer.

Para mais informações sobre programação peer-to-peer, veja Peer-to-Peer Networking.

Example

O código seguinte especifica como encontrar o certificado utilizado num cenário peer-to-peer.

<behaviors>
  <endpointBehaviors>
    <behavior name="MyEndpointBehavior">
      <clientCredentials>
        <peer>
          <certificate findValue="www.contoso.com"
                       storeLocation="LocalMachine"
                       x509FindType="FindByIssuerName" />
        </peer>
      </clientCredentials>
    </behavior>
  </endpointBehaviors>
</behaviors>

Consulte também