Jetons d'accès personnels

Un jeton d’accès personnel (parfois appelé clé API) permet à tes propres outils d’accéder à tes données Kombine via l’API : un script, un alias shell, un agent IA comme Claude Code, un outil d’import depuis Jira. Tu décides à quoi chaque jeton a accès et combien de temps il reste valide, et tu peux le révoquer à tout moment.

Les jetons sont faits pour tes propres outils. Ne colle jamais un jeton dans un service tiers que tu ne contrôles pas.

Créer un jeton

Les jetons se créent dans l’application web. Il te faut un compte avec une adresse e-mail vérifiée.

Sur app.kombine.dev, va dans Paramètres › Compte et trouve Jetons d’accès personnels.
Clique sur Nouveau jeton.
Donne-lui un Nom (à quoi il sert, par ex. « Import Jira ») et, si tu veux, une Description.
Choisis quand il Expire dans : 7, 30, 90 ou 365 jours. La valeur par défaut est 30. Les jetons expirent toujours.
Définis les Autorisations (voir ci-dessous). Ne donne que ce dont l’outil a besoin.
Saisis ton Mot de passe actuel et clique sur Créer le jeton.
Copie ton jeton tout de suite. Il commence par kmb_pat_ et ne s’affiche qu’une seule fois. Kombine n’en garde qu’une empreinte, il ne peut donc pas te le montrer à nouveau. Tu l’as perdu ? Révoque-le et crées-en un nouveau.

Tu peux avoir jusqu’à 10 jetons actifs.

Autorisations

Chaque jeton reçoit un niveau par domaine : Aucun, Lecture ou Lecture et écriture. Un jeton avec tout réglé sur Aucun ne peut rien faire.

Domaine	Ce qu’il couvre	Niveaux
tasks	Les tâches, y compris celles importées	Lecture / Lecture et écriture
goals	Les objectifs de chaque période et les notes de période	Lecture / Lecture et écriture
sessions	Les sessions de concentration, les entrées du journal et les activités	Lecture / Lecture et écriture
timer	Le minuteur en cours et ses réglages	Lecture / Lecture et écriture
stats	Les statistiques et les résumés quotidiens	Lecture

Certaines choses ne sont jamais accessibles avec un jeton, quelles que soient ses autorisations : la connexion, ton mot de passe et ton compte, les appareils, les réglages de l’application et la synchronisation. Un jeton ne peut ni changer ton mot de passe ni supprimer ton compte.

Lire un domaine, c’est n’importe quel GET. Tout le reste (créer, modifier, supprimer) nécessite Lecture et écriture.

Voir et révoquer les jetons

Va dans Paramètres › Compte › Jetons d’accès personnels pour voir tes jetons et en Révoquer un. Tu ne peux pas créer de jetons dans l’application mobile ; utilise l’application web pour ça.

La révocation est immédiate : la requête suivante avec ce jeton échoue.

Te déconnecter, te déconnecter partout, ou changer ou réinitialiser ton mot de passe ne révoque pas les jetons. Seuls la révocation, l’expiration ou la suppression de ton compte le font. Si tu penses qu’un jeton a fuité, révoque-le.

Garder tes jetons en sécurité

Traite un jeton comme un mot de passe. Garde-le dans une variable d’environnement ou dans ton gestionnaire de mots de passe, jamais dans du code que tu commites.
Un jeton par outil. Comme ça, en révoquer un ne casse pas les autres, et dernière utilisation t’indique quel outil est actif.
Une expiration courte pour les essais, plus longue pour les outils sur lesquels tu comptes.