Remarque : Reportez-vous à la page man « man add ns variable » pour la description des paramètres de commande.

Exemple 1 : Créez une variable ulong nommée « my_counter » et initialisez-la à 1.

Exemple 2 : Créer une carte nommée « user_privilege_map ». La carte contiendra des clés d'une longueur maximale de 15 caractères et des valeurs de texte d'une longueur maximale de 10 caractères, avec un maximum de 10000 entrées.

Remarque : Si la carte contient 10000 entrées non expirées, les affectations pour les nouvelles clés réutilisent l'une des entrées les moins récemment utilisées. Par défaut, une expression essayant d'obtenir une valeur pour une clé inexistante initialisera une valeur de texte vide.

Affectez la valeur ou spécifiez l'opération à effectuer sur la variable. Cela se fait en créant une affectation.

Remarque : Une variable est référencée à l'aide du sélecteur de variable ($). Par conséquent, $variable1 est utilisé pour faire référence à des variables de texte ou ulong. De même, **$variable2**est utilisée pour faire référence à des variables de carte.

Exemple 1 : Définissez une affectation nommée « inc_my_counter » qui ajoute automatiquement 1 à la variable « my_counter ».

Exemple 2 : Définissez une affectation nommée « set_user_privilege » qui ajoute à la variable « user_privilege_map » une entrée pour l'adresse IP du client avec la valeur renvoyée par la légende HTTP « get_user_privilege ».

Remarque : Si une entrée pour cette clé existe déjà, la valeur sera remplacée. Sinon, une nouvelle entrée pour la clé et la valeur sera ajoutée. Sur la base de la déclaration précédente pour user_privilege_map, si la carte contient déjà 10000 entrées, l'une des entrées les moins récemment utilisées sera réutilisée pour la nouvelle clé et la nouvelle valeur.

L'exemple suivant montre un exemple de variable singleton.

Ajoutez une variable singleton de type texte. Cette variable peut contenir un maximum de 100 octets de données.

Ajoutez une action d'affectation, qui sera utilisée pour stocker les données de requête HTTP dans la variable.

Ajoutez une action de réécriture pour insérer l'en-tête HTTP, dont la valeur sera récupérée à partir de la variable.

Ajoutez une stratégie de réécriture qui évaluera dans l'heure de la requête et effectuera une action d'affectation pour stocker les données. Lorsque nous atteignons cette stratégie, nous allons prendre l'action d'affectation et stocker les données dans la variable ns (http_req_data)

Ajoutez une stratégie de réécriture qui évaluera dans le temps de réponse, et ajoutez un en-tête HTTP dans la réponse.

Dans une appliance Citrix ADC, une action d'affectation liée à la stratégie est déclenchée lorsque la règle de stratégie est évaluée à true. L'action met à jour la valeur de la variable qui peut être utilisée dans les évaluations ultérieures des règles de stratégie. De cette façon, la même variable peut être mise à jour et utilisée pour des évaluations de stratégie ultérieures dans la même fonctionnalité. Auparavant, l'appliance exécutait des actions d'affectation uniquement après avoir évalué toutes les stratégies de la fonction lorsque les stratégies des actions d'affectation associées étaient évaluées à true. Par conséquent, la valeur de variable définie par l'action d'affectation ne peut pas être utilisée dans les évaluations de règles de stratégie suivantes au sein de la fonction.

Cette fonctionnalité peut être mieux comprise avec un cas d'utilisation qui contrôle la liste d'accès des clients sur une appliance Citrix ADC. La décision d'accès est fournie par un service Web distinct, avec la demandeGET /client-access?<client-IP-address> qui renvoie une réponse avec « BLOCK » ou « Autoriser » dans le corps. La légende HTTP est configurée pour inclure l'adresse IP du client associée à une requête entrante. Lorsque l'appliance Citrix ADC reçoit une demande d'un client, l'appliance génère la demande de légende et l'envoie au serveur de légende, qui héberge une base de données d'adresses IP figurant sur la liste noire et un agent de légende HTTP qui vérifie si l'adresse IP du client est répertoriée dans la base de données. L'agent de légende HTTP reçoit la demande de légende, vérifie si l'adresse IP du client est répertoriée et envoie une réponse. La réponse est un code d'état, 200, 302 avec « BLOCK » ou « Autoriser » dans le corps. En fonction du code d'état, l'appliance effectue l'évaluation de la stratégie. Si l'évaluation de stratégie a la valeur true, l'action d'affectation est déclenchée immédiatement et l'action définit la valeur à la variable. L'appliance utilise et définit cette valeur de variable pour une évaluation ultérieure de stratégie dans le même module.