Jetons de compte

Les jetons de compte offrent un moyen simple d'authentifier les requêtes API sans passer par le flux OAuth complet. Ils sont idéaux pour les scripts, les pipelines CI/CD et l'automatisation personnelle.

Création d'un jeton

1. Connectez-vous à Glossia et accédez au tableau de bord de votre compte.
2. Ouvrez la section API depuis la barre latérale.
3. Cliquez sur Jetons de compte, puis sur Nouveau jeton.
4. Donnez au jeton un nom descriptif (par exemple, "CI deploy" ou "Accès CLI").
5. Choisissez les portées dont le jeton a besoin. N'accordez que les autorisations minimales requises.
6. Définissez une date d'expiration ou laissez-la vide pour un jeton sans expiration.
7. Cliquez sur Créer un jeton.

Après la création, la valeur complète du jeton est affichée une seule fois. Copiez-la immédiatement et stockez-la en toute sécurité. Vous ne pourrez plus voir la valeur complète.

Utilisation d'un jeton

Incluez le jeton dans l'Authorization en-tête de vos requêtes HTTP :

Authorization: Bearer glsa_abc123def456...

Par exemple, en utilisant curl :

curl -H "Authorization: Bearer glsa_abc123def456..." \
  https://glossia.ai/api/projects

Les jetons de compte suivent le même modèle d'autorisation que les jetons OAuth. Les portées du jeton définissent l'ensemble maximum d'actions qu'il peut effectuer, et les politiques de niveau ressource s'appliquent toujours en fonction des relations de votre compte.

Format des jetons

Tous les jetons de compte commencent par le préfixe glsa_ suivi d'une chaîne hexadécimale aléatoire. Ce préfixe facilite l'identification des jetons Glossia dans les logs et les analyseurs de secrets.

Portées

Les jetons de compte supportent les mêmes portées que les jetons OAuth. Consultez la référence des portées pour la liste complète.

Lors de la création d'un jeton, sélectionnez uniquement les portées requises par votre cas d'usage. Par exemple :

• Une intégration en lecture seule nécessite project:read et voice:read.
• Un pipeline CI qui crée des projets nécessite project:read et project:write.
• Un script qui gère les membres de l'organisation nécessite members:read et members:write.

Gestion des jetons

Affichage des jetons

La page Jetons de compte liste tous les jetons actifs avec leur nom, leur portée, leur date de dernière utilisation et leur expiration. Les jetons qui n'ont jamais été utilisés affichent "Jamais" dans la colonne de la dernière utilisation.

Modification des jetons

Cliquez sur le nom du jeton pour modifier son nom et sa description. Les portées et l'expiration ne peuvent pas être changées après la création. Si vous avez besoin de portées différentes, créez un nouveau jeton et révoquez l'ancien.

Révocation des jetons

Pour révoquer un jeton, cliquez sur Révoquer dans la liste des jetons ou ouvrez la page de modification du jeton et utilisez le bouton Révoquer un jeton dans la zone de danger. Les jetons révoqués cessent de fonctionner immédiatement et ne peuvent pas être rétablis.

Bonnes pratiques de sécurité

• Stockez les jetons en toute sécurité. Utilisez des variables d'environnement ou un gestionnaire de secrets. Ne commitez jamais les jetons dans le contrôle de source.
• Utilisez des jetons à durée de vie courte. Définissez toujours une date d'expiration si possible.
• Réduisez les portées. N'accordez que les autorisations dont le jeton a réellement besoin.
• Renouvelez régulièrement. Créez de nouveaux jetons et révoquez les anciens selon un calendrier.
• Suivez l'utilisation. Vérifiez la date "de dernière utilisation" périodiquement. Révoquez les jetons qui ne sont plus utilisés.
• Utilisez un jeton par intégration. De cette façon, la révocation d'un jeton n'affecte pas les autres flux de travail.

Gestion des API

Vous pouvez également gérer les jetons de compte via l'API REST et le serveur MCP.

API REST

MCP

Le serveur MCP expose list_tokens, create_token et revoke_token outils qui correspondent à l'API REST.