Créer ou télécharger une définition d'API
Une définition d'API est un document qui décrit une API à l'aide des normes de spécification OpenAPI. Cette définition peut contenir des chemins de ressources API et des méthodes pour les exploiter. Vous pouvez ajouter des définitions d'API à NetScaler Console, puis les déployer sur une passerelle API (NetScaler).
Vous pouvez créer des définitions d'API de l'une des manières suivantes :
Remarque :
Actuellement, NetScaler Console prend en charge l'analyse des fichiers de spécification OAS qui utilisent Swagger 2.0 ou openapi 3.0.1.
Télécharger la spécification OAS
Vous pouvez télécharger la spécification OAS vers l'interface graphique de NetScaler Console.
-
Accédez à Security > API Security > API Definitions.
-
Cliquez sur Add.
-
Sélectionnez Upload OAS Specification.Remarque :Assurez-vous que le fichier de spécification OAS est au format YAML ou JSON. Et ce fichier ne doit pas contenir de références externes.
-
Parcourez une spécification OAS depuis votre ordinateur local et téléchargez-la sur NetScaler Console.
Créer une définition d'API
Vous pouvez créer votre propre définition d'API dans l'interface graphique de NetScaler Console.
-
Accédez à Sécurité > Sécurité des API > Définitions d'API.
-
Cliquez sur Ajouter.
-
Sélectionnez Créer votre définition et spécifiez les éléments suivants :
-
Nom - Un nom pour la définition d'API.
-
Définition d'API - Une définition doit inclure un titre, une version, un chemin de base et un hôte. Vous pouvez spécifier un nom de domaine ou une adresse IP dans le champ Hôte.
-
Ressources API - Ajoutez plusieurs ressources API à votre définition. Chaque ressource a un chemin et une méthode prise en charge. Cliquez sur Ajouter. La ressource est ajoutée au tableau Ressources ajoutées. Cliquez sur Supprimer pour supprimer une ressource API.

-
-
Cliquez sur Créer.
Afficher les définitions d'API
La page Définitions d'API répertorie la définition téléchargée. Cliquez sur Afficher pour voir les détails de la définition d'API suivants :
-
Nom – Affiche le nom d'une définition d'API.
-
Définition d'API – Affiche le titre, la version, le chemin de base et l'hôte d'une définition.
-
Ressources API – Répertorie les ressources API dans une définition d'API et leurs méthodes pour les exploiter.