<scopedCertificates>, élément

Article
02/27/2011

Représente une collection de certificats X.509 fournie par les services spécifiques (à portée) à des fins d'authentification. Cette collection sert généralement à spécifier les certificats des services d'émission de jeton de sécurité dans un scénario fédéré.

Hiérarchie de schéma

<system.serviceModel>
  <behaviors>
    <endpointBehaviors>
      <behavior> de <endpointBehaviors>
        <clientCredentials>
          <serviceCertificate> de <serviceCredentials>
            <scopedCertificates>, élément
              <add>, élément de <scopedCertificates>

Syntaxe

<scopedCertificates>
      <add findValue="String"
                storeLocation="CurrentUser/LocalMachine"
                storeName=" CurrentUser/LocalMachine"
                targetUri="string"
            x509Type="FindByThumbprint/FindBySubjectName/FindBySubjectDistinguishedName/FindByIssuerName/FindByIssuerDistinguishedName/FindBySerialNumber/FindByTimeValid/FindByTimeNotYetValid/FindBySerialNumber/FindByTimeExpired/FindByTemplateName/FindByApplicationPolicy/FindByCertificatePolicy/FindByExtension/FindByKeyUsage/FindBySubjectKeyIdentifier" /> 
</scopedCertificates>

Attributs et éléments

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

Attributs

Aucun.

Éléments enfants

Élément	Description
<add>, élément de <scopedCertificates>	Ajoute un certificat X.509 à la collection de certificats à portée.

Éléments parents

Élément	Description
<serviceCertificate> de <serviceCredentials>	Spécifie un certificat à utiliser lors de l'authentification d'un service au client.

Notes

Cette collection permet au client de configurer les certificats de service à utiliser en fonction de l'URL du service avec lequel il communique. Ceci s'avère particulièrement utile dans les scénarios de jeton émis dans lesquels un client peut communiquer avec plusieurs services (autant le service final que les services de jeton de sécurité intermédiaire). Pour les liaisons qui utilisent la sécurité de message basée sur des certificats, ce certificat est utilisé pour chiffrer les messages au service et doit être utilisé par le service pour signer les réponses au client.

Le certificat par défaut est utilisé si une liaison requiert un certificat pour le service et qu'aucun certificat spécifique de l'URL du service n'est trouvé dans ScopedCertificates.

Pour plus d'informations, consultez la section "Certificats à étendue" dans How To: Create a Federated Client.

Exemple

L'exemple suivant spécifie un certificat de service que le client utilise au cours de communications avec les points de terminaison dont le nom de domaine est https://www.contoso.com sur le protocole HTTP.

<serviceCertificate>
  <scopedCertificates>
     <add targetUri="https://www.contoso.com" 
          findValue="www.contoso.com" storeLocation="LocalMachine"
                  storeName="Root" x509FindType="FindByIssuerName" />
  </scopedCertificates>
</serviceCertificate>

Voir aussi

Référence

<add>, élément de <scopedCertificates>
ScopedCertificates
X509ScopedServiceCertificateElementCollection
X509ScopedServiceCertificateElement
X509CertificateRecipientClientCredential
ScopedCertificates

Autres ressources

Working with Certificates
How To: Create a Federated Client
Securing Clients
Securing Services and Clients

Partager via