Avant de commencer
La création de tokens est réservée aux administrateurs qui gèrent les intégrations.
Un token appartient à l'école, pas à une personne : il continue de fonctionner si son créateur quitte l'équipe, et il ne consomme aucune licence.
Vous ne pouvez pas accorder à un token plus de droits que vous n'en avez vous-même.
1. Ouvrir la page Tokens API
Dans Paramètres › Intégrations, cliquez sur Configurer dans le bloc Tokens API.
La liste affiche, pour chaque token : son nom, son statut, le début de sa clé, son créateur, sa date d'expiration, sa dernière utilisation, ses campus et ses droits.
2. Créer un token
Cliquez sur Créer un token, puis renseignez :
Nom : le nom de l'outil qui l'utilisera. Il apparaît dans l'historique sur toutes les actions faites avec ce token.
Durée de validité : de 30 jours à illimitée (90 jours par défaut).
Campus : le token ne voit et ne modifie que les données de ces campus.
Droits : pour toutes les ressources, ou ressource par ressource avec Détail par ressource : aucun accès, lecture ou écriture. L'écriture inclut la lecture, et tout ce qui n'est pas accordé est refusé.
Cliquez sur Créer le token, puis copiez la clé et transmettez-la à votre outil. Conservez-la en lieu sûr.
3. Modifier, renouveler ou révoquer
Modifier : changer le nom, les campus ou les droits.
Renouveler : générer une nouvelle clé, par exemple avant l'expiration.
Révoquer : couper immédiatement l'accès, par exemple si la clé a fuité ou si l'outil n'est plus utilisé.
Bonnes pratiques
Créez un token par outil, avec uniquement les droits dont il a besoin.
Préférez une durée limitée et renouvelez le token régulièrement.
Consultez la documentation de l'API Grimp pour connaître les ressources disponibles.
Un problème ? Écrivez-nous depuis l'aide en ligne.