Vous utilisez des jetons d'API pour vous authentifier lorsque vous effectuez des connexions autorisées avec des API. Un jeton d'API autorise l'accès par organisation.

Génération de jetons d'API

Les jetons d'API sont inclus au sein d'organisations individuelles. Pour gérer une organisation de clients à l'aide de l'API, vous devez générer un jeton d'API au sein de cette organisation.

  1. Basculez vers l'organisation pour laquelle vous souhaitez générer un jeton d'API.

  2. Cliquez sur votre nom d'utilisateur, puis sur Mon compte > Jetons d'API.

  3. Cliquez sur Générer un jeton.

  4. Entrez un nom pour le jeton, sélectionnez-en la période de validité, puis cliquez sur Générer.

    Un fenêtre contextuelle Jeton généré s'affiche. Vous pouvez copier, télécharger et imprimer le jeton.

  5. Cliquez sur Continuer.

Le jeton d'API est généré et vous pouvez l'utiliser pour accéder aux API VMware Cloud Partner Navigator. Le jeton est valide pendant la période sélectionnée. Vous devez ensuite régénérer le jeton si vous souhaitez continuer à utiliser les API qui en dépendent.

Utilisation d'un jeton d'API pour interagir avec les API VMware Cloud Partner Navigator

Pour utiliser les API VMware Cloud Partner Navigator, vous devez échanger le jeton généré contre un jeton d'authentification.

  1. Générer un jeton d'API.

  2. Échangez le jeton d'API contre un jeton d'authentification en effectuant une demande POST auprès de /cphub/api/auth/v1/authn/accesstoken avec "refreshToken" : "your_api_token" dans le corps de la demande.

    Vous devez définir l'en-tête Content-Type de cette demande POST sur application/json.

  3. Utilisez le jeton d'authentification reçu de l'en-tête csp-auth-token dans vos appels HTTP de script.

Pour plus d'informations sur l'utilisation des API VMware Cloud Partner Navigator, reportez-vous au Guide des API Cloud Partner Navigator.

Régénération ou révocation de jetons d'API

Pour régénérer un jeton d'API qui est sur le point d'expirer, cliquez sur le bouton Régénérer d'un jeton.

Pour révoquer un jeton que vous n'avez plus besoin d'utiliser, cliquez sur le bouton Révoquer d'un jeton. Pour révoquer également tous les jetons, cliquez sur le bouton Révoquer tous les jetons.