Passer au contenu principal
Un jeton d’automatisation permet à un programme d’agir sur votre espace de travail comme vous le faites dans la console : appairer un connecteur, publier un modèle, créer une clé API, lire l’utilisation. Vous le créez dans Settings, choisissez précisément ce qu’il peut faire, et il expire à la date que vous définissez. Remettez-le à un agent de codage comme Claude Code ou Codex, à une tâche CI ou à un script, et ce programme peut exécuter toute la configuration sans intervention. Ce n’est pas une clé API. Une clé API (sk-tok-…) permet à un client d’appeler vos modèles. Un jeton d’automatisation (at-tok-…) permet à un programme de gérer l’espace de travail, et il ne peut jamais appeler un modèle avec. Les deux ne se croisent jamais.
Les jetons d’automatisation agissent uniquement sur votre propre espace de travail. Ils ne peuvent jamais changer votre mot de passe ou votre adresse e-mail, afficher ou partager une clé API, faire tourner le jeton d’un connecteur, lire les prompts stockés, modifier la journalisation des requêtes ou créer d’autres jetons d’automatisation. Tout cela reste derrière une session de console connectée.

​
Créer un jeton

Seul un administrateur de l’espace de travail peut créer, lister ou révoquer des jetons d’automatisation.
1

Ouvrir Settings

Dans la console, ouvrez Settings et faites défiler jusqu’à Automation tokens. Cliquez sur Create token.
2

Le nommer d'après ce qui le détiendra

Utilisez un nom que vous reconnaîtrez dans la liste des jetons et sur les lignes qu’il crée, par exemple claude-code on my laptop ou ci-deploy.
3

Choisir un préréglage ou sélectionner des portées

Setup est le bon préréglage pour un agent qui installe le connecteur et rend votre modèle appelable. Read-only convient à la supervision. Full accorde toutes les portées. Cochez des portées individuelles pour tout le reste. Consultez Portées ci-dessous.
4

Choisir une expiration

Chaque jeton expire. Choisissez 1 heure pour une configuration ponctuelle, plus long pour une tâche récurrente. Le maximum est 1 an.
5

Copier le jeton une seule fois

Le jeton n’est affiché qu’une seule fois. Copiez-le dans le coffre de secrets du programme ou dans une variable shell. Si vous le perdez, utilisez Regenerate depuis la liste ; l’ancienne valeur cesse immédiatement de fonctionner.

​
Portées

Une portée est resource:verb. Une portée write inclut le read correspondant. Rien n’inclut keys:rotate ni models:reroute. Un appel en dehors des portées du jeton renvoie 403 avec la portée manquante nommée dans l’erreur, de sorte qu’un programme peut vous indiquer exactement quelle autorisation il lui manque.

​
Utiliser un jeton

Envoyez-le comme Bearer token à l’hôte de la console, pas à l’hôte API. Chaque appel de gestion se trouve sous https://tokios.com/account/.
Pour la liste complète des appels et l’ordre dans lequel une configuration sans intervention les exécute, consultez Laisser un agent de codage configurer Tokios pour vous.

​
Le remettre à un agent

Créez un jeton avec le préréglage Setup et une expiration de 1 heure, puis démarrez votre agent sur la machine qui exécute votre modèle et envoyez-lui ce prompt :
Définissez TOKIOS_TOKEN dans le shell avant de démarrer l’agent pour que le secret n’apparaisse jamais dans la conversation. La page du guide indique tout le reste à l’agent.

​
Gérer les jetons

Chaque ligne dans Settings affiche les portées du jeton, son empreinte, son expiration, et quand et depuis quelle adresse IP il a été utilisé la dernière fois.
  • Regenerate remplace le secret. L’ancienne valeur cesse immédiatement de fonctionner et la nouvelle n’est affichée qu’une fois.
  • Revoke arrête le jeton définitivement. Créez-en un nouveau pour le remplacer.
  • Delete supprime de la liste un jeton révoqué ou expiré.
Changer ou réinitialiser votre mot de passe révoque tous les jetons que vous avez créés. Un jeton créé depuis une session volée cesse de fonctionner dès que vous récupérez votre compte, et toute tâche permanente a ensuite besoin d’un nouveau jeton. Les lignes créées par un jeton d’automatisation portent un badge via token sur les onglets Connectors, Models et Keys, pour que vous puissiez toujours distinguer ce qu’un programme a fait. Le badge reste après la suppression du jeton.

​
Garder les jetons en sécurité

  • Limitez strictement les portées. Un jeton Setup qui a terminé son travail doit être révoqué, pas conservé.
  • Fixez une expiration courte. Utilisez 1 heure pour les sessions d’agent interactives. Une longue expiration appartient uniquement à une tâche récurrente dans un coffre de secrets.
  • Gardez-le hors des transcriptions. Lisez-le depuis une variable shell ; ne le collez jamais dans une conversation avec l’agent.
  • Surveillez le badge et la colonne de dernière utilisation. Si un jeton a été utilisé depuis une adresse que vous ne reconnaissez pas, révoquez-le.
  • Sachez ce qu’implique une clé créée. Un jeton avec keys:write peut créer une clé API, et cette clé continue de fonctionner après l’expiration du jeton. Quelqu’un qui vole un jeton Setup d’1 heure peut créer une clé sans expiration et appeler vos modèles jusqu’à ce que vous le remarquiez. Après toute exécution d’agent, ouvrez l’onglet Keys, recherchez les lignes marquées via token, et révoquez celles que vous n’attendiez pas.
  • N’accordez models:reroute que si vous en avez besoin. Déplacer, renommer ou supprimer un modèle existant change la machine qui reçoit son trafic. Un jeton qui peut aussi appairer des connecteurs pourrait appairer une machine contrôlée par son détenteur et y déplacer votre modèle. Setup n’en a jamais besoin : il crée des modèles mais ne les déplace jamais.
  • Attendez-vous à ce qu’une adresse partagée partage aussi un verrouillage. Après 8 tentatives de jeton échouées depuis une même adresse IP, tous les jetons de cette adresse sont refusés avec 429 pendant 6 minutes, y compris les jetons valides. Les agents derrière le même réseau de bureau, la même passerelle NAT ou le même pool de runners CI partagent ce verrouillage. Si un client continue d’envoyer un jeton invalide, arrêtez-le ou corrigez-le au lieu de le laisser réessayer en boucle.

Configuration par agent

La procédure étape par étape qu’un agent suit avec un jeton Setup.

Clés API

Les clés que vos clients utilisent pour appeler vos modèles.