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, utilisateurs auxquels les jetons sont attribués, date d'expiration, utilisateurs ayant créé les jetons ou statut (activé/désactivé). Cliquez sur le statut du jeton dans la liste pour activer/désactiver rapidement un jeton. Vous pouvez également activer/désactiver plusieurs jetons à la fois en les sélectionnant dans la liste, puis en cliquant sur les boutons Enable/Disable sous la liste.
Pour créer un nouveau jeton, appuyez sur le bouton Create API token dans le coin supérieur droit, puis remplissez les champs requis dans l'écran de configuration du jeton :
| Paramètre | 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 de famille, puis sélectionnez l'utilisateur requis dans la liste d'autocomplétion. Vous pouvez également appuyer sur le bouton Select et sélectionner 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 un 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é. |
Appuyez sur Add pour créer un jeton.
Copiez la valeur de Auth token et enregistrez-la dans un endroit sûr avant de fermer la page, puis appuyez sur Close. Le jeton apparaîtra dans la liste.
La valeur de Auth token ne peut pas être affichée de nouveau 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 le nom, la description, les paramètres de date d'expiration ou le statut du jeton. Notez qu'il n'est pas possible de modifier l'utilisateur auquel le jeton est attribué. Appuyez sur le bouton Update pour enregistrer les modifications. Si un jeton a été perdu ou exposé, vous pouvez appuyer sur le bouton Regenerate pour générer une nouvelle valeur de jeton. Une boîte de dialogue de confirmation apparaîtra, vous demandant de confirmer cette opération, car après avoir continué, le jeton généré précédemment 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 User profile → API tokens uniquement si Manage API tokens est autorisé dans les permissions de leur rôle utilisateur.