Jetons d'accès

Un jeton d'accès permet à un script, à un agent ou à la ligne de commande de lire et de publier des présentations sans passer par le navigateur. Il agit avec les droits de votre compte : il ouvre les présentations et les dossiers que votre compte ouvre, et il modifie ceux que votre compte modifie.

Créer un jeton

1. Ouvrez le menu de votre compte, en haut à droite, puis « Jetons d'accès ».
2. Cliquez sur « Créer un jeton ».
3. Donnez-lui un nom qui dit où il sert, par exemple « CLI MacBook » ou « Publication CI ».
4. Choisissez sa portée. « Lecture » lit les présentations et les dossiers. « Lecture et publication » crée, enregistre et publie aussi les présentations.
5. Choisissez sa durée : 30, 90 ou 365 jours. À la fin de cette durée, le studio refuse le jeton, et vous en créez un nouveau.
6. Cliquez sur « Créer le jeton », puis sur « Copier le jeton ».

Le studio affiche le jeton une seule fois. Rangez-le dans le gestionnaire de secrets du script ou de la CI, ou dans le trousseau de votre ordinateur. Le studio garde une empreinte du jeton, qui lui suffit pour le reconnaître : il ne peut pas vous le montrer de nouveau.

Ce qu'un jeton peut faire

Un jeton ouvre les mêmes présentations que votre compte. Si un Propriétaire retire votre accès à une présentation ou change votre rôle, le jeton suit ce changement dès la requête suivante.

Un jeton agit au plus comme un compte Éditeur. Le jeton d'un Propriétaire publie les présentations, et la page « Comptes », les accès aux dossiers et la corbeille restent réservés à sa session dans le navigateur. Vous partagez une présentation et réglez sa visibilité dans le studio.

Un script envoie le jeton dans l'en-tête Authorization de ses requêtes :

curl -H "Authorization: Bearer $VIGNETTES_TOKEN" https://vignettes.example.org/api/presentations/ma-presentation/markdown

Révoquer un jeton

La page « Jetons d'accès » liste vos jetons avec leur date de création, leur dernière utilisation et leur date d'expiration. Cliquez sur « Révoquer » à côté d'un jeton : le studio refuse aussitôt les requêtes qui le portent. Un jeton révoqué ou expiré reste dans la liste jusqu'à ce que vous le retiriez avec la croix.

Révoquez un jeton dès que vous pensez qu'une autre personne a pu le lire, par exemple après l'avoir collé dans un message.

Un Propriétaire voit sur la page « Comptes » le nombre de jetons actifs de chaque compte, et révoque tous les jetons d'un compte avec le bouton en forme de clé.