ADC

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 exécutées. La plupart des transformations transforment un nom d’hôte externe et un chemin facultatif en un nom d’hôte et un chemin 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 sa configuration sont des étapes distinctes. La création d’un profil et sa configuration sont des étapes distinctes à la fois 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 NetScaler

À l’invite de commandes NetScaler, 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
<!--NeedCopy-->

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

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

Remarque : Utilisez respectivement un profil de transformation défini ou une commande d’action de transformation. La commande set transform profile utilise les mêmes arguments que la commande add transform profile, et set transform action 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
<!--NeedCopy-->

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

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

  • action de transformation rm <name> Après avoir supprimé toutes les actions associées à un profil, supprimez le profil comme indiqué ci-dessous.
  • profil de transformation rm <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, développez 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 , saisissez 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 de configuration des profils de transformation d’URL » comme suit (un astérisque indique un paramètre obligatoire) :
    • Nom*—Nom
    • Commentaire—commentaire
    • Transformez uniquement les URL absolues dans le corps de la 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é correctement configuré.

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, développez Transformation d’URL, puis cliquez sur Profils.
  2. Dans le volet de détails, sélectionnez le profil que vous souhaitez 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 nouvelle action, cliquez sur Ajouter.
    • Pour modifier une action existante, sélectionnez-la, puis cliquez sur Ouvrir.
  4. Remplissez 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 de configuration des profils de transformation d’URL » comme suit (un astérisque indique un paramètre obligatoire) :
    • Nom de l’action* : nom
    • Commentaires — commentaire
    • Priorité* : priorité
    • Demander une URL à partir de : requrlFrom
    • Demande d’URL dans : RequrLinto
    • URL de réponse depuis — ResurlFrom
    • URL de réponse dans : URL de retour
    • Domaine du cookie From—CookieDomainFrom
    • Domaine du cookie Into — CookieDomainInto
    • État activé
  5. Enregistrez vos modifications.
    • Si vous créez une nouvelle 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é correctement configuré.
  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.