ADC

Importer et exporter des 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 NetScaler au lieu d’avoir à les apporter sur votre ordinateur puis à les réimporter. Enfin, vous pouvez exporter n’importe lequel de ces fichiers vers votre ordinateur ou supprimer n’importe lequel 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
<!--NeedCopy-->

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 NetScaler peut se connecter à l’ordinateur Internet ou LAN sur lequel se trouve le fichier. Dans le cas contraire, vous ne pouvez pas importer le fichier ou l’objet.

  1. Accédez à Sécurité > NetScaler Web App FirewallImportations.

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

  3. Dans le volet Importations du pare-feu d’applications, sélectionnez l’onglet correspondant au type de fichier que vous souhaitez 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. Renseignez les champs de la boîte de dialogue.

    • Nom : nom de l’objet importé.

    • Importer depuis : 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 sur un site Web accessible à l’appliance.
      • Fichier : fichier sur un disque dur local ou en réseau ou sur un autre périphérique de stockage.
      • Texte : saisissez 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 prend la valeur appropriée. Les trois valeurs possibles sont indiquées ci-dessous.

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

    • Fichier : saisissez directement le chemin et le nom du fichier HTML, ou cliquez sur Parcourir pour accéder au fichier HTML.

    • Texte : le troisième champ est supprimé, laissant un espace vide.

  5. Cliquez sur Continuer. 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 sélectionné Texte, la zone de texte Contenu du fichier est vide.

  6. Si vous avez choisi Texte, tapez ou copiez-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 l’appliance Web App Firewall peut accéder à l’ordinateur sur lequel le fichier doit être enregistré. Dans le cas contraire, 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 que vous souhaitez exporter.

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

  3. Sélectionnez le fichier que vous souhaitez 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 dans lesquels 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 les exporter puis les réimporter.

  1. Accédez à Sécurité > NetScaler Web App Firewall > Importations, puis sélectionnez l’onglet correspondant au type de fichier que vous souhaitez modifier.

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

  3. Sélectionnez le fichier que vous souhaitez 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 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 vers votre ordinateur local et utiliser des outils d’édition de pages Web HTML ou XML standard.

  4. Cliquez sur OK, puis sur Fermer.

Gérez les fichiers de spécifications d’API à l’aide de la

Vous pouvez valider le trafic d’API entrant par rapport à la spécification d’API importée en l’attribuant à un profil et en définissant une règle de relaxation pour bloquer ou autoriser le trafic. Vous pouvez également utiliser la spécification d’API importée pour créer des expressions de stratégie. L’importation d’une spécification d’API se déroule en deux étapes :

  1. Importer la spécification d’API : importez une spécification d’API dans NetScaler via une URL ou depuis le système.
  2. Ajouter la spécification d’API à NetScaler : lorsque vous ajoutez une spécification d’API à NetScaler, le fichier est validé, converti dans un format interne et une entité de spécification d’API est créée. L’entité de spécification d’API créée sera utilisée dans les expressions de stratégie et les profils Web App Firewall.

Les paramètres suivants sont utilisés dans les commandes CLI :

  • Nom : nom du fichier de spécification d’API chargé.
  • Source : URL (protocole, hôte, chemin et nom) indiquant l’emplacement où stocker le fichier de spécifications importé.
  • Nom de la spécification - nom de l’entité créée à partir de la spécification d’API téléchargée.
  • Type : format d’entrée de la spécification de l’API. Valeur par défaut : OAS

Pour importer un fichier de spécification d’API, saisissez :

import api specFile <name> <src>

Exemple :
import apispec testapispec.json http://www.example.com/testapispec.json

Pour ajouter un fichier de spécification d’API, tapez :

add api spec <Name> -File <string> -Type <string>

Exemple :
add api spec testapispec -File testapispec.json -Type OAS

Pour mettre à jour un fichier de spécification d’API, importez un nouveau fichier de spécifications qui doit être mis à jour.

À l’invite de commandes, tapez :

update api spec <specName> -File <string> -Type <string>

Exemple :
update api spec testapispec -File testapispec.json -Type OAS

Remarque :

Si l’attribut type n’est pas spécifié, OAS est le type par défaut.

Pour afficher tous les points de terminaison, tapez :

show api spec <specName>

Exemple :

show api spec testapispec

Pour supprimer la spécification de l’API, tapez :

rm api spec <specName>

Exemple :

rm api spec testapispec

Remarque :

Avant de supprimer la spécification d’API, assurez-vous qu’elle n’est pas utilisée par un profil ou une stratégie.

Gérez les fichiers de spécifications d’API à l’aide de l’interface graphique

  1. Accédez à Sécurité > NetScaler Web App FirewallImportations.
  2. Sur la page Importations, sélectionnez l’onglet Page d’importation des spécifications API, puis cliquez sur Ajouter.
  3. Sur la page API Spec Import Object, sélectionnez l’une des options suivantes pour le paramètre Importer depuis :
    1. URL : URL Web sur un site Web accessible à l’appliance.
    2. Fichier : fichier sur un disque dur local ou en réseau ou sur un autre périphérique de stockage.
  4. Cliquez sur Continuer.
  5. Sur la page API Spec Import Object, entrez les informations suivantes :
    1. Nom de la spécification d’API : nom de l’entité créée à partir de la spécification d’API téléchargée. Remarque : le nom du fichier API et le nom de spécification de l’API saisis doivent être identiques.
    2. Type de spécification d’API : sélectionnez le type de spécification.

      Types : REST (OpenAPI/Swagger) et gRPC (PROTO).

      Type par défaut : REST (OpenAPI/Swagger)

    3. Cliquez sur Terminé.

L’entité nouvellement ajoutée est répertoriée sur la page Imports sous l’ onglet API Spec Import Page.