Élément <certificate>

Article
06/08/2023

Spécifie un certificat X.509 à utiliser pour signer et chiffrer des messages pour les clients de réseau pair à pair.

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

Syntaxe

<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" />

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
`findValue`	Chaîne qui contient la valeur à rechercher dans le magasin de certificats X.509. Le type contenu dans l’attribut doit répondre aux exigences du `x509FindType` spécifié. La valeur par défaut est une chaîne vide.
`storeLocation`	Indique l'emplacement du magasin de certificats X.509 utilisé par le client pour valider le certificat de l'homologue. Les valeurs valides sont les suivantes : - LocalMachine : magasin de certificats assigné à l’ordinateur local. - CurrentUser : magasin de certificats assigné à l’utilisateur actuel. La valeur par défaut est LocalMachine.
`storeName`	Spécifie le nom du magasin de certificats X.509 à ouvrir. Les valeurs valides sont les suivantes : - AddressBook : magasin de certificats pour d’autres utilisateurs. - AuthRoot : magasin de certificats pour les autorités de certification (AC) tierces. - CertificateAuthority : magasin de certificats pour les autorités de certification (AC) intermédiaires. - Disallowed : magasin de certificats pour les certificats révoqués. - My : magasin de certificats pour les certificats personnels. - Root : magasin de certificats pour les autorités de certification (AC) racines approuvées. - TrustedPeople : magasin de certificats pour les personnes et les ressources directement approuvées. - TrustedPublisher : magasin de certificats pour les éditeurs directement approuvés. La valeur par défaut est My.
`X509FindType`	Définit le type de recherche X.509 à exécuter. Les valeurs valides sont les suivantes : - FindByThumbprint - FindBySubjectName - FindBySubjectDistinguishedName - FindByIssuerName - FindByIssuerDistinguishedName - FindBySerialNumber - FindByTimeValid - FindByTimeNotYetValid - FindByTemplateName - FindByApplicationPolicy - FindByCertificatePolicy - FindByExtension - FindByKeyUsage - FindBySubjectKeyIdentifier Le type contenu dans l'attribut `findValue` doit répondre aux spécifications du `X509FindType` spécifié. La valeur par défaut est FindBySubjectDistinguishedName.

Éléments enfants

Aucune.

Éléments parents

Élément	Description
<peer>	Spécifie les informations d'identification utilisées lors de l'authentification de clients de réseau pair à pair.

Notes

Cet élément de configuration contient une instance de X509Certificate2 utilisée lors de l'authentification de voisins dans la maille d'homologues.

Pour plus d’informations sur la programmation d’égal à égal, consultez Réseaux pair à pair.

Exemple

Le code suivant spécifie comment rechercher le certificat utilisé dans un scénario de réseau pair à pair.

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

Partager via