AppExpert

Configuration des profils de transformation d’URL

Un profil décrit une transformation d’URL spécifique sous la forme d’une série d’actions. Le profil fonctionne principalement comme un conteneur pour les actions, déterminant l’ordre dans lequel les actions sont effectuées. La plupart des transformations transforment un nom d’hôte externe et un chemin optionnel en un nom d’hôte et un chemin d’accès internes différents. La plupart des transformations utiles sont simples et ne nécessitent qu’une seule action, mais vous pouvez utiliser plusieurs actions pour effectuer des transformations complexes.

Vous ne pouvez pas créer d’actions, puis les ajouter à un profil. Vous devez d’abord créer le profil, puis y ajouter des actions. Dans l’interface de ligne de commande, la création d’une action et la configuration de l’action sont des étapes distinctes. La création d’un profil et la configuration du profil sont des étapes distinctes dans l’interface de ligne de commande et dans l’utilitaire de configuration.

Pour créer un profil de transformation d’URL à l’aide de la ligne de commande Citrix ADC

À l’invite de commandes Citrix ADC, tapez les commandes suivantes, dans l’ordre indiqué, pour créer un profil de transformation d’URL et vérifier la configuration. Vous pouvez ensuite répéter les deuxième et troisième commandes pour configurer des actions supplémentaires :

  • add transform profile <profileName> -type URL [-onlyTransformAbsURLinBody (ON|OFF)] \[-comment <comment>]
  • add transform action <name> <profileName> <priority>
  • set transform action <name> [-priority <priority>] [-reqUrlFrom <expression>] [-reqUrlInto <expression>] [-resUrlFrom <expression>] [-resUrlInto <expression>] [-cookieDomainFrom <expression>] [-cookieDomainInto <expression>] [-state (ENABLED|DISABLED)] [-comment "<string>"]
  • show transform profile <name>

Exemple :

> add transform profile shoppingcart -type URL
 Done
> add transform action actshopping shoppingcart 1000
 Done
> set transform action actshopping -priority 1000 -reqUrlFrom 'shopping.example.com' -reqUrlInto 'www.example.net/shopping' -resUrlFrom 'www.example.net/shopping' -resUrlInto 'shopping.example.com' -cookieDomainFrom 'example.com' -cookieDomainInto 'example.net' -state ENABLED -comment 'URL transformation for shopping cart.'
 Done
> show transform profile shoppingcart
        Name: shoppingcart
                Type: URL       onlyTransformAbsURLinBody: OFF
        Comment:
        Actions:

1)              Priority 1000   Name: actshopping       ENABLED
 Done

Pour modifier un profil ou une action de transformation d’URL existant à l’aide de la ligne de commande Citrix ADC

À l’invite de commandes Citrix ADC, tapez les commandes suivantes pour modifier un profil ou une action de transformation d’URL existant et vérifier la configuration :

Remarque : Utilisez respectivement une commande set transform profile ou set transform action. La commande set transform profile prend les mêmes arguments que la commande add transform profile, et l’action set transform est la même commande que celle utilisée pour la configuration initiale.

  • set transform action <name> [-priority <priority>] [-reqUrlFrom <expression>] [-reqUrlInto <expression>] [-resUrlFrom <expression>] [-resUrlInto <expression>] [-cookieDomainInto <expression>] [-state (ENABLED|DISABLED)] [-comment "<string>"]
  • show transform profile <name>

Exemple :

> set transform action actshopping -priority 1000 -reqUrlFrom 'searching.example.net' -reqUrlInto 'www.example.net/searching' -resUrlFrom 'www.example.net/searching' -resUrlInto 'searching.example.com' -cookieDomainInto 'example.net' -state ENABLED -comment 'URL transformation for searching cart.'
 Done
> show transform profile shoppingcart
        Name: shoppingcart
                Type: URL       onlyTransformAbsURLinBody: OFF
        Comment:
        Actions:

1)              Priority 1000   Name: actshopping       ENABLED
 Done

Pour supprimer un profil de transformation d’URL et des actions à l’aide de la ligne de commande Citrix ADC

Supprimez d’abord toutes les actions associées à ce profil en tapant la commande suivante une fois pour chaque action :

  • rm transform action <name> Après avoir supprimé toutes les actions associées à un profil, supprimez le profil comme indiqué ci-dessous.
  • rm transform profile <name>

Pour créer un profil de transformation d’URL à l’aide de l’utilitaire de configuration

  1. Dans le volet de navigation, développez Réécrire, Transformation d’URL, puis cliquez sur Profils.
  2. Dans le volet d’informations, cliquez sur Ajouter.
  3. Dans la boîte de dialogue Créer un profil de transformation d’URL, tapez ou sélectionnez des valeurs pour les paramètres. Le contenu de la boîte de dialogue correspond aux paramètres décrits dans « Paramètres pour la configuration des profils de transformation d’URL » comme suit (un astérisque indique un paramètre requis) :
    • Nom* : nom
    • Commentaire—Commentaire
    • Transformer uniquement les URL absolues dans le corps de réponse : OnlyTransformAbsurlinBody
  4. Cliquez sur Créer, puis sur Fermer. Un message s’affiche dans la barre d’état indiquant que le profil a été configuré avec succès.

Pour configurer un profil de transformation d’URL et des actions à l’aide de l’utilitaire de configuration

  1. Dans le volet de navigation, développez Réécrire, Transformation d’URL, puis cliquez sur Profils.
  2. Dans le volet d’informations, sélectionnez le profil à configurer, puis cliquez sur Ouvrir.
  3. Dans la boîte de dialogue Configurer le profil de transformation d’URL, effectuez l’une des opérations suivantes.
    • Pour créer une action, cliquez sur Ajouter.
    • Pour modifier une action existante, sélectionnez-la, puis cliquez sur Ouvrir.
  4. Renseignez la boîte de dialogue Créer une action de transformation d’URL ou Modifier une action de transformation d’URL en saisissant ou en sélectionnant des valeurs pour les paramètres. Le contenu de la boîte de dialogue correspond aux paramètres décrits dans « Paramètres pour la configuration des profils de transformation d’URL » comme suit (un astérisque indique un paramètre requis) :
    • Nom de l’action* : nom
    • Commentaires—Commentaire
    • Priorité*—Priorité
    • URL de la requête de—RequrlFrom
    • URL de la requête dans—RequrlInto
    • URL de réponse de—ResURLFrom
    • URL de réponse dans—ResURLInto
    • Cookie Domain de—CookieDomainFrom
    • Domaine de cookie dans—CookieDomainInto
    • Activé : état
  5. Enregistrez vos modifications.
    • Si vous créez une action, cliquez sur Créer, puis sur Fermer.
    • Si vous modifiez une action existante, cliquez sur OK. Un message s’affiche dans la barre d’état indiquant que le profil a été configuré avec succès.
  6. Répétez les étapes 3 à 5 pour créer ou modifier des actions supplémentaires.
  7. Pour supprimer une action, sélectionnez-la, puis cliquez sur Supprimer. Lorsque vous y êtes invité, cliquez sur OK pour confirmer la suppression.
  8. Cliquez sur OK pour enregistrer vos modifications et fermer la boîte de dialogue Modifier le profil de transformation d’URL.
  9. Pour supprimer un profil, sélectionnez le profil dans le volet d’informations, puis cliquez sur Supprimer. Lorsque vous y êtes invité, cliquez sur OK pour confirmer la suppression.