Aller au contenu principal
Version: ⭐ 24.04

Jetons d'API

Avec un jeton d'application, une application tierce peut faire des appels à l'API Centreon afin de réaliser des actions dans Centreon (webhooks).

Un jeton est lié à un utilisateur Centreon et a une durée de validité. Les appels API seront exécutés en fonction des droits assignés à cet utilisateur. Un même utilisateur peut avoir plusieurs jetons.

Qui peut créer des jetons d'API ?

  • Les utilisateurs ou les administrateurs ayant accès à la page Administration > Jetons d'API peuvent créer des jetons d'API pour leur propre usage.
  • Les administrateurs ou les utilisateurs avec la permission Gérer les jetons d’authentification de l’organisation dans les ACL d'actions peuvent également voir les jetons créés par d'autres utilisateurs, créer des jetons pour d'autres utilisateurs, ou les désactiver ou les supprimer.

Créer un jeton d'API

  1. Allez à la page Administration > Jetons d'API.
  2. Cliquer sur Ajouter. Une fenêtre pop-up apparaît.
  3. Remplissez les champs demandés puis cliquez sur Créer un nouveau jeton. Un champ Jeton apparaît dans la fenêtre. Vous pouvez cliquer sur l'icône en forme d'oeil pour afficher le jeton si vous le souhaitez.
  4. Copiez le jeton à l'aide du bouton "copie" à droite du champ. Stockez le jeton avec soin : vous ne pourrez pas l'afficher une deuxième fois.
  5. Cliquez sur Fermer.

Gérer les jetons d'API

La liste des jetons indique le statut de chaque jeton dans la colonne de gauche (activé, valide mais désactivé, périmé). La date de dernière utilisation du jeton est également indiquée.

Les utilisateurs ayant le rôle Administrator peuvent :

  • Désactiver un jeton d'API valide en utilisant le switch Activé/Désactivé à droite de la ligne. Le jeton pourra être réactivé si besoin.
  • Supprimer totalement un jeton en utilisant le bouton Supprimer.