4 Jetons d'API

Aperçu

Cette section permet de créer et de gérer des jetons d’API.

Vous pouvez filtrer les jetons d’API par nom, par utilisateurs auxquels les jetons sont attribués, par date d’expiration, par utilisateurs ayant créé les jetons, ou par statut (activé/désactivé). Cliquez sur le statut du jeton dans la liste pour l’activer/le désactiver rapidement. Vous pouvez également activer/désactiver plusieurs jetons à la fois en les sélectionnant dans la liste, puis en cliquant sur les boutons Activer/Désactiver sous la liste.

Pour créer un nouveau jeton, cliquez sur le bouton Créer un jeton d’API dans le coin supérieur droit, puis renseignez les champs requis dans l’écran de configuration du jeton :

Parameter Description
Nom Nom visible du jeton.
Utilisateur Utilisateur auquel le jeton doit être attribué. Pour sélectionner rapidement un utilisateur, commencez à saisir le nom d’utilisateur, le prénom ou le nom, puis sélectionnez l’utilisateur requis dans la liste d’autocomplétion. Vous pouvez également cliquer sur le bouton Sélectionner et choisir un utilisateur dans la liste complète des utilisateurs. Un jeton ne peut être attribué qu’à un seul utilisateur.
Description Description facultative du jeton.
Définir la date et l’heure d’expiration Décochez cette case si le jeton ne doit pas avoir de date d’expiration.
Date d’expiration Cliquez sur l’icône du calendrier pour sélectionner la date d’expiration du jeton ou saisissez la date manuellement au format YYYY-MM-DD hh:mm:ss
Activé Décochez cette case si vous devez créer un jeton à l’état désactivé.

Cliquez sur Ajouter pour créer un jeton.

Copiez la valeur du Jeton d’authentification et enregistrez-la dans un endroit sûr avant de fermer la page, puis cliquez sur Fermer. Le jeton apparaîtra dans la liste.

La valeur du Jeton d’authentification ne pourra plus être affichée ultérieurement. Elle n’est disponible qu’immédiatement après la création d’un jeton. Si vous perdez un jeton enregistré, vous devrez le régénérer, ce qui créera une nouvelle chaîne d’autorisation.

Cliquez sur le nom du jeton pour modifier son nom, sa description, les paramètres de date d’expiration ou son statut. Notez qu’il n’est pas possible de modifier l’utilisateur auquel le jeton est attribué. Cliquez sur le bouton Mettre à jour pour enregistrer les modifications. Si un jeton a été perdu ou exposé, vous pouvez cliquer sur le bouton Régénérer pour générer une nouvelle valeur de jeton. Une boîte de dialogue de confirmation s’affichera et vous demandera de confirmer cette opération, car après validation, le jeton précédemment généré deviendra invalide.

Les utilisateurs n’ayant pas accès à la section de menu Administration peuvent voir et modifier les détails des jetons qui leur sont attribués dans la section Profil utilisateur → Jetons d’API uniquement si Gérer les jetons d’API est autorisé dans les permissions de leur rôle utilisateur.