<messageSenderAuthentication>, élément

Article
06/08/2023

Spécifie les options d'authentification pour les expéditeurs du message du réseau pair à pair.

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

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

Syntaxe

<messageSenderAuthentication customCertificateValidatorType= "namespace.typeName, [,AssemblyName] [,Version=version number] [,Culture=culture] [,PublicKeyToken=token]"
                             certificateValidationMode = "ChainTrust/None/PeerTrust/PeerOrChainTrust/Custom"
                             revocationMode="NoCheck/Online/Offline"
                             trustedStoreLocation="CurrentUser/LocalMachine" />

Attributs et éléments

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

Attributs

Attribut	Description
`customCertificateValidatorType`	Type et assembly utilisés pour valider un type personnalisé. Cet attribut doit être défini lorsque `certificateValidationMode` a la valeur `Custom`.
`certificateValidationMode`	Spécifie l'un de trois modes utilisés pour valider des informations d'identification. S'il est défini à `Custom`, un `customCertificateValidator` doit également être fourni.
`revocationMode`	Un des modes utilisés pour vérifier des listes de certificat révoqués (CRL).
`trustedStoreLocation`	L'un des deux emplacements du magasin du système : `LocalMachine` ou `CurrentUser`. Cette valeur est utilisée lorsqu'un certificat de service est négocié au client. La validation est exécutée par rapport au magasin Personnes autorisées dans l’emplacement de magasin spécifié.

customCertificateValidatorType, attribut

Valeur	Description
String	Optionnel. Spécifie le nom de type, l'assembly et d'autres données utilisées pour rechercher le type. Au minimum, un espace de noms et un nom de type sont requis. Les informations facultatives incluent : le nom de l'assembly, le numéro de version, la culture et le jeton de clé publique.

certificateValidationMode, attribut

Valeur	Description
Énumération	Optionnel. Une des valeurs suivantes : `None`, `PeerTrust`, `ChainTrust`, `PeerOrChainTrust` et `Custom`. Par défaut, il s’agit de `ChainTrust`. Par défaut, il s’agit de `ChainTrust`. Pour plus d’informations, consultez Utilisation des certificats.

revocationMode, attribut

Valeur	Description
Énumération	Une des valeurs suivantes : `NoCheck`, `Online` et `Offline`. Par défaut, il s’agit de `Online`. Pour plus d’informations, consultez Utilisation des certificats.

trustedStoreLocation, attribut

Valeur	Description
Énumération	L’une des valeurs suivantes : `LocalMachine` ou `CurrentUser`. Par défaut, il s’agit de `CurrentUser`. Si l'application cliente s'exécute sous un compte système, le certificat se trouve généralement dans `LocalMachine`. Si l'application cliente s'exécute sous un compte d'utilisateur, le certificat se trouve généralement dans `CurrentUser`. Par défaut, il s’agit de `CurrentUser`.

Éléments enfants

Aucune.

Éléments parents

Élément	Description
<peer>	Spécifie une information d'identification utilisée pour authentifier le client auprès d'un service homologue.

Notes

Cet élément doit être configuré si l'authentification des messages est sélectionnée. Pour les canaux de sortie, chaque message est signé à l’aide du certificat fourni par <certificate>. Avant d'être remis à l'application, tous les messages sont vérifiés par rapport aux informations d'identification de message à l'aide du validateur spécifié par l'attribut customCertificateValidatorType de cet élément. Le validateur peut accepter ou rejeter les informations d'identification.

Exemple

Les jeux de codes suivants affectent le mode de validation de l’expéditeur du message à PeerOrChainTrust.

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

Partager via