Génération de clés d'API

Utilisez un ID de clé et une clé secrète pour accéder aux API REST AppScan 360° et vous connecter à partir de certains outils client AppScan 360° (par exemple, depuis le plug-in Jenkins et les plug-ins Utilitaire de ligne de commande Static Analyzer et IDE).

Pourquoi et quand exécuter cette tâche

Un ID de clé est propre à chaque utilisateur. Si vous ne disposez pas d'un ID de clé, ou si vous avez perdu votre clé secrète, vous pouvez générer une nouvelle combinaison. Pour générer une nouvelle clé, deux choix s'offrent à vous :

Procédure

  1. Accédez à la page Clé d'API au service AppScan 360° :
    • https://<appscan 360 host>/main/apikey
      Remarque : Si vous ne connaissez pas l'URL hôte, veuillez contacter votre administrateur AppScan 360°.
  2. Générez la clé via l'interface utilisateur :
    1. Cliquez sur le menu utilisateur dans le coin supérieur droit et sélectionnez Clé d'API ou Paramètres de compte > Clé d'API.
    2. Cliquez sur Générer des clés.
    3. Si vous avez déjà généré les clés, un avertissement s'affiche, indiquant que la création d'une paire de clés rompra toutes les intégrations existantes qui dépendent de vos informations d'identification actuelles. Cliquez sur Continuer pour poursuivre.
    4. Facultatif : Définissez une date d'expiration (activée par défaut) en sélectionnant une date et en cliquant sur Continuer. Si vous ne souhaitez pas définir de date d'expiration, décochez la case et cliquez sur Continuer.
    5. Vous devez vous authentifier à nouveau avant qu'une nouvelle clé ne soit émise. Renseignez l'invite de connexion pour continuer. Une fois l'authentification réussie, le nouvel ID de clé et le nouveau Secret de clé s'affichent.
      Avertissement : Le Secret de clé s'affiche une seule fois et est visible pendant une minute. Copiez-le et stockez-le dans un gestionnaire de secrets sécurisé. Le secret ne peut plus s'afficher de nouveau via l'interface utilisateur. La génération d'une nouvelle clé entraîne immédiatement l'expiration de la précédente.
      Remarque : Les utilisateurs autorisés à révoquer des clés peuvent supprimer leur propre clé de cette page à l'aide de l'option Révoquer des clés d'API
  3. Gestion des clés pour les administrateurs et les gestionnaires :

    Les administrateurs et les gestionnaires (rôles disposant de l'autorisation de gestion des clés d'API) peuvent afficher et gérer les clés d'API d'autres utilisateurs à partir de la pageGestion des utilisateurs. Les administrateurs et les gestionnaires peuvent révoquer la clé d'API d'un autre utilisateur ; cependant, la révocation d'une clé n'empêche pas cet utilisateur d'en générer une nouvelle si son rôle le permet.