Partager via


<httpTransport>

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

<system.serviceModel>
  <bindings>
    <customBinding>
      <binding>
        <httpTransport>

<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"
IntegratedWindowsAuthentication: Specifies Windows authentication"
    realm="String"
    transferMode="Buffered/Streamed/StreamedRequest/StreamedResponse"
        unsafeConnectionNtlmAuthentication="Boolean"
        useDefaultWebProxy="Boolean" />

Attributs et éléments

Attributs

Attribut Description

allowCookies

Valeur booléenne qui spécifie si le client accepte les cookies et les propage dans de futures demandes. 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 manière, vous avez la certitude que les cookies retournés par le serveur sont automatiquement copiés dans toutes les futures demandes du client pour ce service.

authenticationScheme

Spécifie le protocole utilisé pour authentifier des demandes du client qui sont traitées par un écouteur HTTP. Les valeurs valides sont les suivantes :

  • Digest : spécifie l'authentification Digest.
  • Negotiate : négocie avec le client afin de déterminer le schéma d'authentification. Si le client et le serveur prennent tous les deux en charge Kerberos, ce protocole est utilisé ; sinon, NTLM est utilisé.
  • Ntlm : spécifie l'authentification NTLM.
  • Basic : spécifie l'authentification de base.
  • Anonymous : spécifie l'authentification anonyme.

La valeur par défaut est Anonymous. Cet attribut est de type AuthenticationSchemes. Cet attribut ne peut être défini qu'une fois.

bypassProxyOnLocal

Valeur booléenne qui indique s'il faut ignorer le serveur proxy pour les adresses locales. La valeur par défaut est false.

Une adresse locale est une adresse sur le réseau local ou l'intranet.

Windows Communication Foundation (WCF) ignore toujours le proxy si l'adresse de service commence par https://localhost.

Utilisez le nom d'hôte plutôt que localhost si vous souhaitez que les clients passent par un proxy lorsqu'ils communiquent avec des services sur le même ordinateur.

hostnameComparisonMode

Spécifie le mode de comparaison du nom d'hôte HTTP utilisé pour analyser des URI. Les valeurs valides sont :

  • StrongWildcard : ("+") correspond à tous les noms d'hôtes possibles dans le contexte de la méthode, du port et de l'URI relatif spécifiés.
  • Exact : aucun caractère générique
  • WeakWildcard : ("*") correspond à tous les noms d'hôtes possibles dans le contexte de la méthode, du port et de l'UIR relatif spécifiés n'ayant aucune correspondance explicite ou via un mécanisme générique fort.

La valeur par défaut est StrongWildcard. Cet attribut est de type HostnameComparisonMode.

KeepAliveEnabled

Valeur booléenne qui spécifie si une connexion persistante doit être établie avec la ressource Internet.

maxBufferSize

Entier positif qui spécifie la taille maximale de la mémoire tampon. La valeur par défaut est 524 288.

proxyAddress

URI qui spécifie l'adresse du proxy HTTP. Si useSystemWebProxy est true, ce paramètre doit avoir la valeur null. La valeur par défaut est null.

proxyAuthenticationScheme

Spécifie le protocole utilisé pour l'authentification des demandes du client qui sont traitées par un proxy HTTP. Les valeurs valides sont les suivantes :

  • None : aucune authentification n'est effectuée.
  • Digest : spécifie l'authentification Digest.
  • Negotiate : négocie avec le client afin de déterminer le schéma d'authentification. Si le client et le serveur prennent tous les deux en charge Kerberos, ce protocole est utilisé ; sinon, NTLM est utilisé.
  • Ntlm : spécifie l'authentification NTLM.
  • Basic : spécifie l'authentification de base.
  • Anonymous : spécifie l'authentification anonyme.
  • IntegratedWindowsAuthentication : spécifie l'authentification Windows.

La valeur par défaut est Anonymous. Cet attribut est de type AuthenticationSchemes.

realm

Chaîne qui spécifie le domaine à utiliser sur le proxy/serveur. 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 posséder son propre schéma d'authentification et/ou sa base de données d'autorisation. Les domaines sont utilisés uniquement pour les authentifications Digest et de base. Lorsqu'un client est correctement authentifié, l'authentification est valide pour toutes les ressources contenues dans un domaine donné. Pour obtenir une description détaillée des domaines, consultez la RFC 2617 à l'adresse http://www.ietf.org (page pouvant être en anglais).

transferMode

Spécifie si les messages sont mis en mémoire tampon ou transmis en continu ou s'il s'agit d'une demande ou d'une réponse. Les valeurs valides sont les suivantes :

  • Buffered : les messages de demande et de réponse sont mis en mémoire tampon.
  • Streamed : les messages de demande et de réponse sont transmis en continu.
  • StreamedRequest : le message de demande est transmis en continu et le message de réponse est mis en mémoire tampon.
  • StreamedResponse : le message de demande est mis en mémoire tampon et le message de réponse est transmis en continu.

La valeur par défaut est Buffered. Cet attribut est de type TransferMode.

unsafeConnectionNtlmAuthentication

Valeur booléenne qui spécifie si le partage de connexion potentiellement dangereux est activé sur le serveur. La valeur par défaut est false. Si elle est activée, l'authentification NTLM est exécutée une fois sur chaque connexion TCP.

useDefaultWebProxy

Valeur booléenne qui spécifie si les paramètres proxy à l'échelle de l'ordinateur sont utilisés plutôt que ceux spécifiques à l'utilisateur. La valeur par défaut est true.

Éléments enfants

Aucun

Éléments parents

Élément Description

<binding>

Définit toutes les fonctions de liaison de la liaison personnalisée.

Notes

L'élément httpTransport constitue le point de départ pour créer une liaison personnalisée qui implémente le protocole de transport HTTP. HTTP est le principal transport 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

Référence

<customBinding>
HttpTransportElement
HttpTransportBindingElement
TransportBindingElement
CustomBinding

Autres ressources

Transports in Windows Communication Foundation
Choosing a Transport
Windows Communication Foundation Bindings
Extending Bindings
Custom Bindings