Les jetons API personnels te permettent d'accéder à Krokanti Notes depuis des outils externes — scripts, automatisations, assistants IA (via MCP) et intégrations. Si un jeton est compromis ou n'est plus nécessaire, tu dois le révoquer immédiatement.

Que sont les jetons API ?

Les jetons API sont des identifiants de longue durée au format kn_ suivi de 40 caractères hexadécimaux (par ex., kn_a3f8b2c1...). Ils constituent une alternative aux cookies de session pour l'accès programmatique à l'API Krokanti Notes.

Les jetons sont stockés sous forme de hachages SHA-256 — le jeton brut est affiché une seule fois lors de la création et n'est jamais stocké en clair. Si tu perds un jeton, tu ne peux pas le récupérer — crée-en un nouveau.

Consulter tes jetons

Va dans Paramètres → Connexions
Sous Jetons API personnels, tu verras la liste de tous les jetons actifs avec leurs noms, dates de création et horodatages de dernière utilisation

Révoquer un jeton

Va dans Paramètres → Connexions
Trouve le jeton que tu veux révoquer
Clique sur Révoquer à côté de lui
Confirme l'action

Le jeton est immédiatement désactivé — toute requête l'utilisant recevra une réponse 401 Unauthorized.

La révocation d'un jeton est immédiate et irréversible. Si tu utilises le jeton dans une automatisation ou une intégration, elle cessera de fonctionner instantanément. Mets à jour l'intégration avec un nouveau jeton avant de révoquer l'ancien si le temps d'arrêt est une préoccupation.

Quand révoquer

Révoque un jeton lorsque :

Tu n'utilises plus l'outil ou l'intégration pour lequel il a été créé
Tu soupçonnes que le jeton a été accidentellement exposé (par ex., commité dans un dépôt public, affiché dans un journal)
Tu fais tourner les identifiants dans le cadre d'un audit de sécurité
Tu perds un appareil sur lequel le jeton était stocké

Rotation des jetons (bonne pratique)

Pour la sécurité, fais tourner tes jetons périodiquement :

Crée un nouveau jeton dans Paramètres → Connexions
Mets à jour ton intégration/outil pour utiliser le nouveau jeton
Vérifie que l'intégration fonctionne avec le nouveau jeton
Révoque l'ancien jeton

Ainsi, il n'y a pas de temps d'arrêt pendant la rotation.

Créer un nouveau jeton

Va dans Paramètres → Connexions
Clique sur Nouveau jeton
Saisis un nom descriptif (par ex., « Claude Code MCP », « Script serveur maison »)
Clique sur Créer — la valeur du jeton est affichée une seule fois. Copie-la immédiatement.

Nomme tes jetons de manière descriptive pour savoir à quoi chacun sert. « Jeton 1 » est moins utile que « Claude Desktop MCP » ou « Automatisation Zapier ».

Propriétés de sécurité

Les jetons sont stockés sous forme de hachages SHA-256 — une violation de la base de données n'expose pas les jetons bruts
Les jetons ont une limite de débit de 100 requêtes par minute
Les requêtes basées sur des jetons ne peuvent pas créer ou révoquer d'autres jetons (opération réservée aux sessions)
Toutes les opérations sur les jetons sont enregistrées dans le journal d'audit (Paramètres → Sécurité → Journal d'audit)

Révoquer les jetons API