ADC

Protocole Proxy

Le protocole proxy transporte en toute sécurité les détails du client d’un client à un autre sur les appliances Citrix ADC. L’appliance ajoute un en-tête de protocole proxy avec les détails du client et le transfère au serveur principal. Voici quelques-uns des scénarios d’utilisation du protocole proxy dans une appliance Citrix ADC.

  • Adresse IP du client d’origine
  • Sélection d’une langue pour un site Web
  • Bloquer la liste des adresses IP sélectionnées
  • Enregistrement et collecte de statistiques.

Voici les trois modes de fonctionnement :

  • Insérer. L’appliance insère les détails du client et les envoie au serveur principal.
  • Avancer. L’appliance transmet les détails du client au serveur principal.
  • Dépouillé. L’appliance stocke les détails du client à des fins de journalisation. De plus, si le protocole proxy n’est pas pris en charge sur le serveur principal, envoie les détails du client au serveur à l’aide de la configuration de la stratégie de réécriture

Le tableau suivant fournit des informations sur l’état du serveur virtuel et du service LB dans différents modes de protocole proxy :

Mode protocole proxy Serveur virtuel LB Service
Insérer Désactivé Activé
Vers l’avant Activé Activé
Dépouillé Activé Désactivé

Limitations

Le protocole proxy n’est pas pris en charge pour les fonctionnalités TCP Fast Open (TFO) et TCP MultiPath. La fonctionnalité est prise en charge uniquement pour les services pour lesquels l’appliance Citrix ADC met fin à la connexion TCP. Il ne prend pas en charge d’autres services, par exemple « ANY ».

Fonctionnement du protocole proxy dans une appliance Citrix ADC

Les diagrammes de flux suivants montrent comment configurer le protocole proxy sur les appliances Citrix ADC pour les opérations d’insertion, de transfert et de dépouillement :

Opération d’insertion

Opération d'insertion

L’interaction des composants est la suivante :

  • Sur l’instance Citrix ADC, vous devez activer le protocole proxy dans le profil réseau et le lier au service.
  • Dans l’opération d’insertion, Citrix ADC ajoute un en-tête proxy avec les détails de la connexion client et le transfère au serveur principal.
  • Côté envoi, l’appliance décide de la version du protocole proxy en fonction de la configuration de l’interface de ligne de commande.

Opération Forward

Opération Forward

L’interaction des composants est la suivante :

  • Un client envoie une demande avec l’en-tête du proxy au Citrix ADC. L’appliance identifie dynamiquement la version.
  • Dans l’appliance Citrix ADC, il s’agit d’une opération de transfert. Le protocole proxy est activé sur le serveur virtuel d’équilibrage de charge ou le serveur virtuel de commutation de contenu et activé sur le service. L’appliance reçoit l’en-tête du proxy et transmet les détails de l’en-tête au serveur principal.
  • Si les détails de l’en-tête du proxy ne sont pas au format incorrect, l’appliance réinitialise la connexion.
  • Côté envoi, l’appliance décide de la version du protocole proxy en fonction de la configuration de l’interface de ligne de commande.

Opération dépouillée

Opération dépouillée

L’interaction des composants est la suivante :

  • Un client envoie une demande accompagnée d’un en-tête de proxy à l’appliance Citrix ADC.
  • Dans l’appliance Citrix ADC, s’il s’agit d’une opération Stripped, l’appliance transfère les informations client obtenues à partir du protocole proxy et les insère dans l’en-tête HTTP à l’aide d’expressions de stratégie de réécriture.
  • Les détails du client, tels que l’adresse IP source, l’adresse IP de destination, le port source et le port de destination, sont ajoutés dans un en-tête HTTP à l’aide d’expressions de stratégie de réécriture. La stratégie de réécriture évalue l’expression et si elle est « true », l’action de stratégie de réécriture correspondante est déclenchée. Les détails du client sont ensuite transférés au serveur principal dans un en-tête HTTP.
  • Si les détails de l’en-tête du proxy ne sont pas au format incorrect, l’appliance réinitialise la connexion.

Formats de version du protocole proxy

La version du protocole Proxy est disponible en deux formats. L’appliance décide d’utiliser un format basé sur la longueur des données entrantes. Pour plus d’informations, voir DP sur le protocole proxy .

  1. Format de version 1 du protocole proxy

    PROXY TCP4/TCP6/UNKNOWN <SRC IP> <DST IP> <SRC PORT> <DST PORT>

    • PROXY -> Format de chaîne unique pour l’en-tête proxy version -1.
    • Prise en charge des protocoles TCP sur IPv4 et TCP sur IPv6. Pour les autres protocoles, c’est INCONNU.
    • IP SRC : adresse IP source (IP du client d’origine) d’un paquet.
    • IP DST : adresse IP de destination d’un paquet.
    • Port SRC : port source d’un paquet.
    • Port DST : port de destination d’un paquet.
  2. Format de version 2 du protocole proxy

    0D 0A 0D 0A 00 0D 0A 51 55 49 54 0A <13th byte> <14th byte> <15-16th byte> <17th byte onwards>

    • D 0A 0D 0A 00 0D 0A 51 55 49 54 0A -> Chaîne binaire unique pour l’en-tête Proxy version -2.
    • Prise en charge des protocoles TCP sur IPv4 et TCP sur IPv6. Pour les autres protocoles, c’est INCONNU.
    • Treizième octet — version du protocole et commande.
    • Quatorzième octet — famille d’adresses et de protocoles.
    • 15-16e octet : longueur de l’adresse dans l’ordre du réseau.
    • À partir du dix-septième octet - Adresses des informations présentes dans l’ordre du réseau - IP src, IP dst, port src, port dst.

Configurer le protocole proxy dans l’appliance Citrix ADC

Effectuez les étapes suivantes pour configurer le protocole proxy dans votre appliance Citrix ADC.

  1. Activez le protocole proxy en tant que global.
  2. Configurer le protocole proxy pour l’opération d’insertion
  3. Configurer le protocole proxy pour l’opération Forward
  4. Configurer le protocole proxy pour l’opération Strip
  5. Configurer le protocole proxy sans opération

Activer le protocole proxy en tant que global

À l’invite de commandes, tapez ce qui suit :

set ns param –proxyProtocol ENABLED

Configurer le protocole proxy pour l’opération d’insertion

Pour configurer le protocole proxy pour l’opération d’insertion, vous devez activer ou désactiver le protocole sur le serveur virtuel d’équilibrage de charge et l’activer sur le service.

Ajouter un profil réseau avec le protocole proxy désactivé pour le serveur virtuel d’équilibrage de charge

À l’invite de commandes, tapez ce qui suit :

add netprofile <name> -proxyProtocol ENABLED/DISABLED> -proxyprotocoltxversion <V1/V2>

Exemple :

Add netprofile proxyprofile-1 –proxyProtocol ENABLED –proxyprotocoltxversion V1

Remarque :

Si vous désactivez le protocole proxy sur votre appliance, il n’est pas nécessaire de définir le paramètre de version du protocole.

Ajouter un profil réseau avec un protocole proxy activé pour le service

À l’invite de commandes, tapez ce qui suit :

add netprofile <name> -proxyProtocol ENABLED/DISABLED> -proxyprotocoltxversion <V1/V2>

Exemple :

add netprofile proxyprofile-2 –proxyProtocol ENABLED –proxyprotocoltxversion V1

Ajouter un serveur virtuel d’équilibrage de charge pour l’appliance Citrix ADC dans la couche proxy

À l’invite de commandes, tapez ce qui suit :

add lb vserver <name>@ <serviceType> [(<IPAddress>@ <port>)]

Exemple :

add lb vserver lbvserver-1 http 1.1.1.1 80

Ajouter un service HTTP pour l’appliance Citrix ADC dans la couche proxy

À l’invite de commandes, tapez ce qui suit :

add service <name>@ (<IP>@ | <serverName>@) <serviceType> <port>

Exemple :

Add service http-service-1 2.2.2.1 http 80

Définir un profil réseau avec un serveur virtuel d’équilibrage de charge dans l’appliance Citrix ADC

À l’invite de commandes, tapez ce qui suit :

set lb vserver <vserver name> -netprofile <name>

Exemple :

set lb vserver lbvserver-1 –netprofile proxyProfile-1

Définir un profil réseau avec le service HTTP dans l’appliance Citrix ADC

À l’invite de commandes, tapez ce qui suit :

set service <service name> –netprofile <name>

Exemple :

set service http-service-1 –netprofile proxyProfile-1

Configurer le protocole proxy pour une opération de transfert

Pour configurer le protocole proxy pour l’opération de transfert pour la prochaine instance Citrix ADC de la couche proxy. Vous devez activer ou désactiver le protocole et vous lier au serveur ou au service virtuel.

Ajouter un profil réseau avec le protocole proxy activé pour le serveur virtuel d’équilibrage de charge

À l’invite de commandes, tapez ce qui suit :

add netprofile <name> -proxyProtocol ENABLED/DISABLED> -proxyprotocoltxversion <V1/V2>

Exemple :

add netprofile proxyprofile-3 –proxyProtocol ENABLED –proxyprotocoltxversion V1

Ajouter un profil réseau avec le protocole proxy activé pour le service

À l’invite de commandes, tapez ce qui suit :

add netprofile <name> -proxyProtocol ENABLED/DISABLED> -proxyprotocoltxversion <V1/V2>

Exemple :

add netprofile proxyprofile-4 –proxyProtocol ENABLED –proxyprotocoltxversion V1

Ajouter un serveur virtuel d’équilibrage de charge pour l’appliance Citrix ADC dans la couche proxy

À l’invite de commandes, tapez ce qui suit :

add lb vserver <name>@ <serviceType> [(<IPAddress>@ <port>)]

Exemple :

add lb vserver lbvserver-2 http 2.2.2.2 80

Ajouter un service HTTP pour l’appliance Citrix ADC dans la couche proxy

À l’invite de commandes, tapez ce qui suit :

add service <name>@ (<IP>@ | <serverName>@) <serviceType> <port>

Exemple :

Add service http-service-2 3.3.3.1 http 80

Définir un profil réseau avec un serveur virtuel d’équilibrage de charge dans l’appliance Citrix ADC

À l’invite de commandes, tapez ce qui suit :

set lb vserver <vserver name> -netprofile <name>

Exemple :

set lb vserver lbvserver-2 –netprofile proxyProfile-3

Définir un profil réseau avec le service HTTP dans l’appliance Citrix ADC

À l’invite de commandes, tapez ce qui suit :

set service <service name> –netprofile <name>

Exemple :

set service http-service-2 –netprofile proxyProfile-4

Configurer le protocole proxy pour l’opération de bande

Pour configurer le protocole proxy pour l’opération de dépouillement, vous devez activer le protocole proxy sur le serveur virtuel d’équilibrage de charge et désactiver le protocole proxy sur le service.

Ajouter un profil réseau avec le protocole proxy activé pour le serveur virtuel

À l’invite de commandes, tapez ce qui suit :

add netprofile <name> -proxyProtocol ENABLED> -proxyprotocoltxversion <V1/V2>

Exemple :

add netprofile proxyprofile-5 –proxyProtocol ENABLED –proxyprotocoltxversion V1

Ajouter un serveur virtuel d’équilibrage de charge ou de commutation de contenu pour l’appliance Citrix ADC dans la couche proxy

À l’invite de commandes, tapez ce qui suit :

add lb vserver <name>@ <serviceType> [(<IPAddress>@ <port>)]

Exemple :

add lb vserver lbvserver-3 http 2.2.2.2 80

Ajouter un service HTTP pour l’appliance Citrix ADC dans la couche proxy

À l’invite de commandes, tapez ce qui suit :

add service <name>@ (<IP>@ | <serverName>@) <serviceType> <port>

Exemple :

Add service http-service-3 3.3.3.1 http 80

Définir un profil réseau avec un serveur virtuel d’équilibrage de charge ou de commutation de contenu dans l’appliance Citrix ADC

À l’invite de commandes, tapez ce qui suit :

set lb vserver <vserver name> -netprofile <name>

Exemple : set lb vserver lbvserver-3 –netprofile proxyProfile-5

Configurer le protocole proxy à l’aide de l’interface graphique Citrix ADC

  1. Accédez à Système > Paramètres > Modifier les paramètres système globaux.
  2. Dans la page Configurer les paramètres globaux du système, activez la case à cocher Protocole proxy .
  3. Cliquez sur OK et Fermer.
  4. Accédez à Système > Réseau > Profils réseau.
  5. Dans le volet d’informations, cliquez sur Ajouter pour créer un profil réseau pour le serveur virtuel d’équilibrage de charge.
  6. Dans la page Profil réseau, définissez les paramètres suivants :
    1. Nom. Nom du profil de réseau.
    2. Protocole Proxy. Activez ou désactivez le protocole proxy pour le serveur virtuel d’équilibrage de charge.
    3. Version TX du protocole proxy. Définissez la version du protocole proxy sur V1 ou V2 en fonction du format de données entrant.
  7. Cliquez sur OK.
  8. Accédez à Gestion du trafic > Équilibrage de charge > Serveurs virtuels .
  9. Dans le volet d’informations, cliquez sur Ajouter.
  10. Dans la page Serveur virtuel d’équilibrage de charge, définissez les paramètres de base.
  11. Dans la section Paramètres avancés, sélectionnez Profils.
  12. Dans la section Profils, cliquez sur l’icône en forme de crayon.
  13. Sélectionnez un profil réseau, puis cliquez sur OK.
  14. Cliquez sur Terminé.
  15. Accédez à Gestion du trafic > Équilibrage de charge > Services .
  16. Dans le volet d’informations, cliquez sur Ajouter.
  17. Dans la page Service d’équilibrage de charge, définissez les paramètres de base.
  18. Dans la section Paramètres avancés, sélectionnez Profils.
  19. Dans la section Profils, cliquez sur l’icône en forme de crayon.
  20. Sélectionnez un profil réseau, puis cliquez sur OK.
  21. Cliquez sur Terminé.

Remarque :

Si plusieurs appliances Citrix ADC font partie de la couche proxy, vous devez définir la configuration du protocole proxy sur chaque appliance pour l’opération de transfert.

Protocole Proxy