Partager via

<httpTransport>

Spécifie un transport HTTP pour la transmission de messages SOAP pour une liaison personnalisée.

<Configuration>
   <system.serviceModel>
     <Liaisons>
       <customBinding>
         <reliure>
           <httpTransport>

Syntaxe

<httpTransport allowCookies="Boolean"
               authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
               bypassProxyOnLocal="Boolean"
               hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
               keepAliveEnabled="Boolean"
               maxBufferSize="Integer"
               proxyAddress="Uri"
               proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
               realm="String"
               transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
               unsafeConnectionNtlmAuthentication="Boolean"
               useDefaultWebProxy="Boolean" />

Attributs et éléments

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

Attributes

Caractéristique Descriptif
allowCookies Valeur booléenne qui spécifie si le client accepte les cookies et les propage sur les demandes futures. La valeur par défaut est false.

Vous pouvez utiliser cet attribut lorsque vous interagissez avec les services web ASMX qui utilisent des cookies. De cette façon, vous pouvez vous assurer que les cookies retournés par le serveur sont automatiquement copiés vers toutes les futures demandes clientes pour ce service.
authentificationSchéma Spécifie le protocole utilisé pour authentifier les requêtes clientes traitées par un écouteur HTTP. Les valeurs valides sont les suivantes :

- Digest : spécifie l’authentification digest.
- Négocier : négocie avec le client pour déterminer le schéma d’authentification. Si le client et le serveur prennent en charge Kerberos, il est utilisé ; sinon, NTLM est utilisé.
- Ntlm : spécifie l’authentification NTLM.
- De base : spécifie l’authentification de base.
- Anonyme : spécifie l’authentification anonyme.

La valeur par défaut est Anonyme. Cet attribut est de type AuthenticationSchemes. Cet attribut ne peut être défini qu’une seule fois.
bypassProxyOnLocal Valeur booléenne qui indique s’il faut contourner le serveur proxy pour les adresses locales. La valeur par défaut est false.

Une adresse locale est une adresse locale qui se trouve sur le réseau local ou l’intranet.

Windows Communication Foundation (WCF) ignore toujours le proxy si l’adresse du service commence par http://localhost.

Vous devez utiliser le nom d’hôte plutôt que localhost si vous souhaitez que les clients passent par un proxy lors de la conversation avec des services sur le même ordinateur.
hostnameComparisonMode Spécifie le mode de comparaison de noms d’hôte HTTP utilisé pour analyser les URI. Les valeurs valides sont,

- StrongWildcard : (« + ») correspond à tous les noms d’hôte possibles dans le contexte du schéma, du port et de l’URI relatif spécifiés.
- Exact : pas de caractères génériques
- WeakWildcard : (« * ») correspond à tous les noms d’hôte possibles dans le contexte du schéma, du port et de l’UIR relatif spécifiés qui n’ont pas été mis en correspondance explicitement ou par le biais du mécanisme générique fort.

Cet attribut est de type HostNameComparisonMode. La valeur par défaut est StrongWildcard.
keepAliveEnabled Valeur booléenne qui spécifie s’il faut établir une connexion persistante à la ressource Internet.
maxBufferSize Entier positif qui spécifie la taille maximale de la mémoire tampon. La valeur par défaut est 524288
proxyAddress URI qui spécifie l’adresse du proxy HTTP. Si useSystemWebProxy c’est truele cas, ce paramètre doit être null. La valeur par défaut est null.
proxyAuthenticationScheme Spécifie le protocole utilisé pour l’authentification des requêtes clientes traitées par un proxy HTTP. Les valeurs valides sont les suivantes :

- Aucun : aucune authentification n’est effectuée.
- Digest : spécifie l’authentification digest.
- Négocier : négocie avec le client pour déterminer le schéma d’authentification. Si le client et le serveur prennent en charge Kerberos, il est utilisé ; sinon, NTLM est utilisé.
- Ntlm : spécifie l’authentification NTLM.
- De base : spécifie l’authentification de base.
- Anonyme : spécifie l’authentification anonyme.

La valeur par défaut est Anonyme. Cet attribut est de type AuthenticationSchemes. Notez qu’il AuthenticationSchemes.IntegratedWindowsAuthentication n’est pas pris en charge.
royaume Chaîne qui spécifie le domaine à utiliser sur le serveur/proxy. La valeur par défaut est une chaîne vide.

Les serveurs utilisent des domaines pour partitionner des ressources protégées. Chaque partition peut avoir son propre schéma d’authentification et/ou base de données d’autorisation. Les domaines sont utilisés uniquement pour l’authentification de base et digest. Une fois qu’un client s’authentifie correctement, l’authentification est valide pour toutes les ressources d’un domaine donné. Pour obtenir une description détaillée des domaines, consultez RFC 2617 sur le site web IETF.
transferMode Spécifie si les messages sont mis en mémoire tampon ou diffusés en continu, ou une demande ou une réponse. Les valeurs valides sont les suivantes :

- Mise en mémoire tampon : les messages de requête et de réponse sont mis en mémoire tampon.
- Diffusé en continu : les messages de demande et de réponse sont diffusés en continu.
- StreamedRequest : le message de requête est diffusé en continu et le message de réponse est mis en mémoire tampon.
- StreamedResponse : le message de requête est mis en mémoire tampon et le message de réponse est diffusé en continu.

La valeur par défaut est mise en mémoire tampon. Cet attribut est de type TransferMode .
unsafeConnectionNtlmAuthentication Valeur booléenne qui spécifie si le partage de connexion non sécurisé est activé sur le serveur. La valeur par défaut est false. Si elle est activée, l’authentification NTLM est effectuée une fois sur chaque connexion TCP.
useDefaultWebProxy Valeur booléenne qui spécifie si les paramètres de proxy à l’échelle de l’ordinateur sont utilisés plutôt que les paramètres spécifiques à l’utilisateur. La valeur par défaut est true.

Éléments enfants

Aucun

Éléments parents

Élément Descriptif
<reliure> Définit toutes les fonctionnalités de liaison de la liaison personnalisée.

Remarques

L’élément httpTransport est le point de départ de la création d’une liaison personnalisée qui implémente le protocole de transport HTTP. HTTP est le transport principal utilisé à des fins d’interopérabilité. Ce transport est pris en charge par Windows Communication Foundation (WCF) pour garantir l’interopérabilité avec d’autres piles de services web non WCF.

Voir aussi

  • Last updated on