4 Jetons d'API
Aperçu
Cette section permet de créer et de gérer des jetons API.
Vous pouvez filtrer les jetons 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 activer/désactiver rapidement un jeton. Vous pouvez également activer/désactiver des jetons en masse 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 API dans le coin supérieur droit, puis renseignez les champs obligatoires dans l'écran de configuration du jeton :
| Parameter | Description |
|---|---|
| Name | Nom visible du jeton. |
| User | 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 de saisie semi-automatique. Vous pouvez également cliquer 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. |
| Set expiration date and time | Décochez cette case si un jeton ne doit pas avoir de date d'expiration. |
| Expiry date | 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 |
| Enabled | Décochez cette case si vous devez créer un jeton à l'état désactivé. |
Cliquez sur Add pour créer un jeton.
Copiez la valeur Auth token et enregistrez-la dans un endroit sûr avant de fermer la page, puis cliquez sur Close. Le jeton apparaîtra dans la liste.
La valeur Auth token ne pourra plus être consulté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 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é. Cliquez sur le bouton Update pour enregistrer les modifications. Si un jeton a été perdu ou exposé, vous pouvez cliquer sur le bouton Regenerate pour générer une nouvelle valeur de jeton. Une boîte de dialogue de confirmation apparaîtra pour vous demander de confirmer cette opération, car après validation le jeton précédemment généré deviendra invalide.
Les utilisateurs sans accès à la section de menu Administration peuvent voir et modifier les détails des jetons qui leur sont attribués uniquement dans la section Profil utilisateur → Jetons API si Manage API tokens est autorisé dans les permissions de leur rôle utilisateur.