`<httpsTransport>`

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

<configuration>
  <system.serviceModel>
    <bindings>
      <customBinding>
        <binding>
          <httpsTransport>

Syntaxe

<httpsTransport allowCookies="Boolean"
                authenticationScheme="Digest/Negotiate/Ntlm/Basic/Anonymous"
                bypassProxyOnLocal="Boolean"
                hostnameComparisonMode="StrongWildcard/Exact/WeakWildcard"
                manualAddressing="Boolean"
                maxBufferPoolSize="Integer"
                maxBufferSize="Integer"
                maxReceivedMessageSize="Integer"
                proxyAddress="Uri"
                proxyAuthenticationScheme="None/Digest/Negotiate/Ntlm/Basic/Anonymous"
                realm="String"
                requireClientCertificate="Boolean"
                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. La valeur par défaut est StrongWildcard. Cet attribut est de type `System.ServiceModel.HostnameComparison`.
manualAddressing	Valeur booléenne qui permet à l’utilisateur de prendre le contrôle de l’adressage des messages. Cette propriété est généralement utilisée dans les scénarios de routeur, où l’application détermine l’une des destinations auxquelles envoyer un message. Lorsqu’il est défini `true`sur , le canal suppose que le message a déjà été adressé et n’y ajoute aucune information supplémentaire. L’utilisateur peut ensuite traiter chaque message individuellement. Lorsqu’il est défini `false`sur , le mécanisme d’adressage WINDOWS Communication Foundation (WCF) par défaut crée automatiquement des adresses pour tous les messages. La valeur par défaut est `false`.
maxBufferPoolSize	Entier positif qui spécifie la taille maximale du pool de mémoires tampons. La valeur par défaut est 524288. De nombreuses parties de WCF utilisent des mémoires tampons. La création et la destruction de mémoires tampons chaque fois qu’elles sont utilisées est coûteuse et le garbage collection pour les mémoires tampons est également coûteux. Avec les pools de mémoires tampons, vous pouvez prendre une mémoire tampon à partir du pool, l’utiliser et la retourner au pool une fois que vous avez terminé. Ainsi, la surcharge dans la création et la destruction de mémoires tampons est évitée.
maxBufferSize	Entier positif qui spécifie la taille maximale de la mémoire tampon. La valeur par défaut est 524288
maxReceivedMessageSize	Entier positif qui spécifie la taille maximale autorisée du message qui peut être reçue. La valeur par défaut est 65536.
proxyAddress	URI qui spécifie l’adresse du proxy HTTP. Si `useSystemWebProxy` c’est `true`le 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.
requireClientCertificate	Valeur booléenne qui spécifie si le serveur exige que le client fournisse un certificat client dans le cadre de l’établissement d’une liaison HTTPS. La valeur par défaut est `false`.
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 httpsTransport est le point de départ de la création d’une liaison personnalisée qui implémente le protocole de transport HTTPS. HTTPS est le transport principal utilisé à des fins d’interopérabilité sécurisée. HTTPS est pris en charge par Windows Communication Foundation (WCF) pour garantir l’interopérabilité avec d’autres piles de services Web.

Voir aussi

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-12-19