Citrix ADC

Configuration de la fonctionnalité AppFlow

Vous configurez AppFlow de la même manière que la plupart des autres fonctionnalités basées sur des stratégies. Tout d’abord, vous activez la fonctionnalité AppFlow. Ensuite, vous spécifiez les collecteurs auxquels les enregistrements de flux sont envoyés. Après cela, vous définissez des actions, qui sont des ensembles de collecteurs configurés. Ensuite, vous configurez une ou plusieurs stratégies et associez une action à chaque stratégie. La stratégie indique à l’appliance Citrix ADC de sélectionner les demandes dont les enregistrements de flux sont envoyés à l’action associée. Enfin, vous liez chaque stratégie globalement ou au serveur virtuel spécifique pour la mettre en œuvre.

Vous pouvez définir davantage les paramètres AppFlow pour spécifier l’intervalle d’actualisation du modèle et activer l’exportation des informations HttpURL, HttpCookie et HttPreferer. Sur chaque collecteur, vous devez spécifier l’adresse IP Citrix ADC comme adresse de l’exportateur.

Remarque

Pour plus d’informations sur la configuration de Citrix ADC en tant qu’exportateur sur le collecteur, consultez la documentation du collecteur spécifique.

L’utilitaire de configuration fournit des outils qui aident les utilisateurs à définir les stratégies et les actions qui déterminent exactement comment l’appliance Citrix ADC exporte les enregistrements d’un flux particulier vers un ensemble de collecteurs (action). L’interface de ligne de commande fournit un ensemble correspondant de commandes basées sur l’interface utilisateur pour les utilisateurs expérimentés qui préfèrent une ligne de commande.

Activation d’AppFlow

Pour pouvoir utiliser la fonctionnalité AppFlow, vous devez d’abord l’activer.

Remarque

AppFlow peut être activé uniquement sur les appliances NCore Citrix ADC.

Pour activer la fonctionnalité AppFlow à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez l’une des commandes suivantes :

enable ns feature AppFlow

Pour activer la fonctionnalité AppFlow à l’aide de l’utilitaire de configuration

Accédez à Système > Paramètres, cliquez sur Configurer les fonctionnalités avancéeset sélectionnez l’option AppFlow .

Spécification d’un collecteur

Un collecteur reçoit les enregistrements AppFlow générés par l’appliance Citrix ADC. Pour envoyer les enregistrements AppFlow, vous devez spécifier au moins un collecteur. Par défaut, le collecteur écoute les messages IPFIX sur le port UDP 4739. Vous pouvez modifier le port par défaut lors de la configuration du collecteur. De même, par défaut, NSIP est utilisé comme adresse IP source pour le trafic AppFlow. Vous pouvez modifier cette adresse IP source par défaut en une adresse SNIP lors de la configuration d’un collecteur. Vous pouvez également supprimer les collecteurs inutilisés.

Pour spécifier un collecteur à l’aide de l’interface de ligne de commande

Important

À partir de la version 12.1—55.13 de Citrix ADC, vous pouvez spécifier le type de collecteur que vous souhaitez utiliser. Un nouveau paramètre « Transport » est introduit dans la commande « add appflow collector ». Par défaut, le collecteur écoute les messages IPFIX. Vous pouvez changer le type de collecteur en logstream ou ipfix ou rest en utilisant le paramètre « Transport ». Pour plus d’informations sur la configuration, reportez-vous à l’exemple.

À l’invite de commandes, tapez les commandes suivantes pour ajouter un collecteur et vérifier la configuration :

-  add appflow collector <name> -IPAddress <ipaddress> -port <port_number> -netprofile <netprofile_name> -Transport <Transport>

-  show appflow collector <name>  

Exemple

add appflow collector col1 -IPaddress 10.102.29.251 -port 8000 -netprofile n2 -Transport ipfix

Pour spécifier plusieurs collecteurs à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez les commandes suivantes pour ajouter et envoyer les mêmes données à plusieurs collecteurs :

add appflow collector <collector1> -IPAddress <IP>

add appflow collector <collector2> -IPAddress <IP>

add appflow action <action> -collectors <collector1> <collector2>

add appflow policy <policy> true <action>

bind lbvserver <lbvserver> -policy <policy> -priority <priority>

Pour spécifier un ou plusieurs collecteurs à l’aide de l’utilitaire de configuration

Accédez à Système > AppFlow > Collecteurs, puis créez le collecteur AppFlow.

Configuration d’une action AppFlow

Une action AppFlow est un collecteur d’ensemble auquel les enregistrements de flux sont envoyés si la stratégie AppFlow associée correspond.

Pour configurer une action AppFlow à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez les commandes suivantes pour configurer une action AppFlow et vérifier la configuration :

add appflow action <name> --collectors <string> ... [-clientSideMeasurements (Enabled|Disabled) ] [-comment <string>]

show appflow action  

Exemple

add appflow action apfl-act-collector-1-and-3 -collectors collector-1 collecter-3

Pour configurer une action AppFlow à l’aide de l’utilitaire de configuration

Accédez à Système > AppFlow > Actions, puis créez l’action AppFlow.

Configuration d’une stratégie AppFlow

Après avoir configuré une action AppFlow, vous devez ensuite configurer une stratégie AppFlow. Une stratégie AppFlow est basée sur une règle, qui consiste en une ou plusieurs expressions.

Remarque

Pour créer et gérer des stratégies AppFlow, l’utilitaire de configuration fournit une assistance qui n’est pas disponible sur l’interface de ligne de commande.

Pour configurer une stratégie AppFlow à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez la commande suivante pour ajouter une stratégie AppFlow et vérifier la configuration :

add appflow policy <name> <rule> <action>

show appflow policy <name>

Exemple

add appflow policy apfl-pol-tcp-dsprt client.TCP.DSTPORT.EQ(22) apfl-act-collector-1-and-3

Pour configurer une stratégie AppFlow à l’aide de l’utilitaire de configuration

Accédez à Système > AppFlow > Stratégies, puis créez la stratégie AppFlow.

Pour ajouter une expression à l’aide de la boîte de dialogue Ajouter une expression

  1. Dans la boîte de dialogue Ajouter une expression, dans la première zone de liste, choisissez le premier terme de votre expression.

    • HTTP Protocole HTTP. Choisissez l’option si vous souhaitez examiner un aspect de la demande qui se rapporte au protocole HTTP.
    • SSL

      Les sites protégés. Choisissez l’option si vous souhaitez examiner un aspect de la demande qui se rapporte au destinataire de la demande.

    • CLIENT

      Ordinateur qui a envoyé la demande. Choisissez l’option si vous souhaitez examiner un aspect de l’expéditeur de la demande. Lorsque vous faites votre choix, la zone de liste la plus à droite répertorie les termes appropriés pour la partie suivante de votre expression.

  2. Dans la deuxième zone de liste, choisissez le deuxième terme pour votre expression. Les choix dépendent du choix que vous avez fait à l’étape précédente et sont adaptés au contexte. Après avoir fait votre deuxième choix, la fenêtre d’aide située sous la fenêtre Construire une expression (qui était vide) affiche de l’aide décrivant le but et l’utilisation du terme que vous venez de choisir.
  3. Continuez à choisir des termes dans les zones de liste qui apparaissent à droite de la zone de liste précédente, ou à taper des chaînes ou des nombres dans les zones de texte qui s’affichent pour vous inviter à entrer une valeur, jusqu’à ce que votre expression soit terminée.

Liaison d’une stratégie AppFlow

Pour mettre une stratégie en œuvre, vous devez la lier globalement, de sorte qu’elle s’applique à tout le trafic qui circule via Citrix ADC, ou à un serveur virtuel spécifique, de sorte que la stratégie ne s’applique qu’au trafic lié à ce serveur virtuel.

Lorsque vous liez une stratégie, vous lui attribuez une priorité. La priorité détermine l’ordre dans lequel les stratégies que vous définissez sont évaluées. Vous pouvez définir la priorité sur n’importe quel entier positif.

Dans le système d’exploitation Citrix ADC, les priorités de stratégie fonctionnent dans l’ordre inverse : plus le nombre est élevé, plus la priorité est faible. Par exemple, si vous avez trois stratégies avec des priorités de 10, 100 et 1000, la stratégie affectée d’une priorité de 10 est exécutée en premier. Plus tard, la stratégie assignée avec une priorité de 100, et enfin la stratégie a attribué un ordre de 1000.

Vous pouvez vous laisser suffisamment d’espace pour ajouter d’autres stratégies dans n’importe quel ordre et les définir pour les évaluer dans l’ordre souhaité, en définissant des priorités avec des intervalles de 50 ou 100 entre chaque stratégie lorsque vous la liez globalement. Vous pouvez ensuite ajouter d’autres stratégies à tout moment sans avoir à modifier la priorité d’une stratégie existante.

Pour lier globalement une stratégie AppFlow à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez la commande suivante pour lier globalement une stratégie AppFlow et vérifier la configuration :

bind appflow global <policyName> <priority> [<gotoPriorityExpression [-type <type>] [-invoke (<labelType> <labelName>)]  

show appflow global  

Exemple

bind appflow global af_policy_lb1_10.102.71.190 1 NEXT -type REQ_OVERRIDE -invoke vserver google

Pour lier une stratégie AppFlow à un serveur virtuel spécifique à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez la commande suivante pour lier une stratégie AppFlow à un serveur virtuel spécifique et vérifier la configuration :

bind lb vserver <name> -policyname <policy_name> -priority <priority>

Exemple

bind lb vserver google -policyname af_policy_google_10.102.19.179 -priority 251

Pour lier globalement une stratégie AppFlow à l’aide de l’utilitaire de configuration

Accédez à Système > AppFlow, cliquez sur Gestionnaire de stratégies AppFlow, sélectionnez le point de liaison (Global par défaut) et le type de connexion appropriés, puis liez la stratégie AppFlow.

Pour lier une stratégie AppFlow à un serveur virtuel spécifique à l’aide de l’utilitaire de configuration

Accédez à Gestion du trafic > Équilibrage de charge > Serveurs virtuels, sélectionnez le serveur virtuel, cliquez sur Stratégieset liez la stratégie AppFlow.

Activation d’AppFlow pour les serveurs virtuels

Si vous souhaitez surveiller uniquement le trafic via certains serveurs virtuels, activez AppFlow spécifiquement pour ces serveurs virtuels. Vous pouvez activer AppFlow pour l’équilibrage de charge, la commutation de contenu, la redirection de cache, le VPN SSL, le GSLB et l’authentification des serveurs virtuels.

Pour activer AppFlow pour un serveur virtuel à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

set cs vserver <name> <protocol> <IPAddress> <port> -appflowLog ENABLED

Exemple

set cs vserver Vserver-CS-1 HTTP 10.102.29.161 80 -appflowLog ENABLED

Pour activer AppFlow pour un serveur virtuel à l’aide de l’utilitaire de configuration

Accédez à Gestion du trafic > Content Switching > Virtual Servers, sélectionnez le serveur virtuel et activez l’option AppFlow Logging.

Activation d’AppFlow pour un service

Vous pouvez activer AppFlow pour les services qui doivent être liés aux serveurs virtuels d’équilibrage de charge.

Pour activer AppFlow pour un service à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez :

set service <name> -appflowLog ENABLED

Exemple

set service ser -appflowLog ENABLED

Pour activer AppFlow pour un service à l’aide de l’utilitaire de configuration

Accédez à Gestion du trafic > Équilibrage de charge > Services, sélectionnez le service et activez l’option AppFlow Logging.

Définition des paramètres AppFlow

Vous pouvez définir des paramètres AppFlow pour personnaliser l’exportation des données vers les collecteurs.

Pour définir les paramètres AppFlow à l’aide de l’interface de ligne de commande

Important

  • À partir de Citrix ADC version 12.1—55.13, vous pouvez utiliser le NSIP pour envoyer des enregistrements Logstream au lieu du SNIP. Un nouveau paramètre « LogStreamOvernSIP » est introduit dans la commande « set appflow param ». Par défaut, le paramètre « LogStreamOvernSIP » est DISABLE, vous devez le « ENABLE ». Pour plus d’informations sur la configuration, reportez-vous à l’exemple.

  • À partir de la version 13.0-58.x de Citrix ADC, vous pouvez activer l’option d’application Web SaaS dans la fonctionnalité AppFlow. Il peut être activé pour recevoir l’utilisation des données des applications Web ou SaaS à partir du service Citrix Gateway. Pour plus d’informations sur la configuration, reportez-vous à l’exemple.

À l’invite de commandes, tapez les commandes suivantes pour définir les paramètres AppFlow et vérifier les paramètres :

-  set appflow param [-templateRefresh <secs>] [-appnameRefresh <secs>] [-flowRecordInterval <secs>] [-udpPmtu <positive_integer>] [-httpUrl ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpCookie ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpReferer ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpMethod ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpHost ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpUserAgent ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-httpXForwardedFor ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )][-clientTrafficOnly ( \*\*YES\*\* | \*\*NO\*\*)] [-webSaaSAppUsageReporting ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )] [-logstreamOverNSIP ( \*\*ENABLED\*\* | \*\*DISABLED\*\* )]

-  show appflow Param

Exemple

set appflow Param -templateRefresh 240 -udpPmtu 128 -httpUrl enabled -webSaaSAppUsageReporting ENABLED -logstreamOverNSIP ENABLED

Pour définir les paramètres AppFlow à l’aide de l’utilitaire de configuration

Accédez à Système > AppFlow, cliquez sur Modifier les paramètres AppFlowet spécifiez les paramètres AppFlow pertinents.

Exemple : Configuration d’AppFlow pour DataStream

L’exemple suivant illustre la procédure de configuration d’AppFlow for DataStream à l’aide de l’interface de ligne de commande.

enable feature appflow

add db user sa password freebsd

add lbvserver lb0 MSSQL 10.102.147.97 1433 -appflowLog ENABLED

add service sv0 10.103.24.132 MSSQL 1433 -appflowLog ENABLED

bind lbvserver lb0 sv0

add appflow collector col0 -IPAddress 10.102.147.90

add appflow action act0 -collectors col0

add appflow policy pol0 "mssql.req.query.text.contains("select")" act0

bind lbvserver lb0 -policyName pol0 -priority 10

Lorsque l’appliance Citrix ADC reçoit une demande de base de données, l’appliance évalue la demande par rapport à une stratégie configurée. Si une correspondance est trouvée, les détails sont envoyés au collecteur AppFlow configuré dans la stratégie.