Citrix ADC

Importation et exportation de fichiers

Vous pouvez importer des objets d’erreur HTML ou XML, des schémas XML, des DTD et des WSDL dans le Web App Firewall à l’aide de l’interface graphique ou de la ligne de commande. Vous pouvez modifier n’importe lequel de ces fichiers dans une zone de texte Web après les avoir importés, pour apporter de petites modifications directement sur Citrix ADC au lieu d’avoir à les faire sur votre ordinateur, puis à les réimporter. Enfin, vous pouvez exporter l’un de ces fichiers vers votre ordinateur, ou supprimer l’un de ces fichiers, à l’aide de l’interface graphique.

Remarque :

Vous ne pouvez pas supprimer ou exporter un fichier importé à l’aide de la ligne de commande.

Pour importer un fichier à l’aide de l’interface de ligne de commande

À l’invite de commandes, tapez les commandes suivantes :

  • import appfw htmlerrorpage <src> <name>
  • <save> ns config

Exemple

L’exemple suivant importe un objet d’erreur HTML à partir d’un fichier nommé error.html et lui attribue le nom HTMLError.

import htmlerrorpage error.html HTMLError
save ns config

Pour importer un fichier à l’aide de l’interface graphique

Avant de tenter d’importer un schéma XML, un fichier DTD ou WSDL ou un objet d’erreur HTML ou XML à partir d’un emplacement réseau, vérifiez que Citrix ADC peut se connecter à l’ordinateur Internet ou LAN où se trouve le fichier. Sinon, vous ne pouvez pas importer le fichier ou l’objet.

  1. Accédez à Sécurité > Pare-feu d’application > Importations.

  2. Accédez à Application Pare-feu > Importations.

  3. Dans le volet Importations du pare-feu d’application, sélectionnez l’onglet correspondant au type de fichier à importer, puis cliquez sur Ajouter.

    Les onglets sont Page d’erreur HTML, Page d’erreur XML, Schéma XML ou WSDL. Le processus de téléchargement est identique sur les quatre onglets du point de vue de l’utilisateur.

  4. Remplissez les champs de dialogue.

    • Nom : nom de l’objet importé.

    • Importer à partir : choisissez l’emplacement du fichier HTML, du fichier XML, du schéma XML ou du fichier WSDL que vous souhaitez importer dans la liste déroulante :

      • URL : URL Web d’un site Web accessible à l’appliance.
      • Fichier : fichier sur un disque dur local ou en réseau ou un autre périphérique de stockage.
      • Texte : Tapez ou collez le texte de la réponse personnalisée directement dans un champ de texte de l’interface graphique.

      La troisième zone de texte passe à la valeur appropriée. Les trois valeurs possibles sont indiquées ci-dessous.

    • URL—Saisissez l’URL dans la zone de texte.

    • Fichier : saisissez directement le chemin d’accès et le nom du fichier HTML, ou cliquez sur Parcourir et accédez au fichier HTML.

    • Texte—Le troisième champ est supprimé, laissant un espace vide.

  5. Cliquez sur Continue. La boîte de dialogue Contenu du fichier s’affiche. Si vous avez choisi URL ou Fichier, la zone de texte Contenu du fichier contient le fichier HTML que vous avez spécifié. Si vous avez choisi Texte, la zone de texte Contenu du fichier est vide.

  6. Si vous avez choisi Texte, tapez ou copiez et collez le code HTML de réponse personnalisé que vous souhaitez importer.

  7. Cliquez sur Terminé.

  8. Pour supprimer un objet, sélectionnez-le, puis cliquez sur Supprimer.

Pour exporter un fichier à l’aide de l’interface graphique

Avant de tenter d’exporter un schéma XML, un fichier DTD ou WSDL ou un objet d’erreur HTML ou XML, vérifiez que le Web App Firewall peut accéder à l’ordinateur sur lequel le fichier doit être enregistré. Sinon, vous ne pouvez pas exporter le fichier.

  1. Accédez à Sécurité > Web App Firewall > Importations.

  2. Dans le volet Importations du Web App Firewall, sélectionnez l’onglet correspondant au type de fichier à exporter.

    Le processus d’exportation est identique sur les quatre onglets du point de vue de l’utilisateur.

  3. Sélectionnez le fichier à exporter.

  4. Développez la liste déroulante Action, puis sélectionnez Exporter.

  5. Dans la boîte de dialogue, choisissez Enregistrer le fichier et cliquez sur OK.

  6. Dans la boîte de dialogue Parcourir, accédez au système de fichiers local et au répertoire où vous souhaitez enregistrer le fichier exporté, puis cliquez sur Enregistrer.

Pour modifier un objet d’erreur HTML ou XML dans l’interface graphique

Vous modifiez le texte des objets d’erreur HTML et XML dans l’interface graphique sans exporter, puis les réimporter.

  1. Accédez à Sécurité > Pare-feu d’application > Importations, puis sélectionnez l’onglet correspondant au type de fichier à modifier.

  2. Accédez à Application Pare-feu > Importations, puis sélectionnez l’onglet correspondant au type de fichier à modifier.

  3. Sélectionnez le fichier à modifier, puis cliquez sur Modifier.

    Le texte de l’objet d’erreur HTML ou XML s’affiche dans une zone de texte du navigateur. Vous pouvez modifier le texte à l’aide des outils et méthodes d’édition standard basés sur le navigateur de votre navigateur.

    Remarque : La fenêtre d’édition est conçue pour vous permettre d’apporter des modifications mineures à votre objet d’erreur HTML ou XML. Pour apporter des modifications importantes, vous pouvez préférer exporter l’objet d’erreur sur votre ordinateur local et utiliser les outils standard d’édition de page Web HTML ou XML.

  4. Cliquez sur OK, puis sur Fermer.