Expiration des jetons d'accès
Vous avez reçu l'un de ces emails : « Jeton de connexion API va expirer dans une semaine » ou « Jeton de connexion API a expiré » ? Un outil qui se connecte à Nicoka par l'API utilise un jeton d'accès arrivé en fin de validité. Cet article explique comment le renouveler.
C'est quoi un jeton d'accès API ?
Un outil externe (Power BI, Zapier, Excel…) qui lit ou écrit des données dans Nicoka par l'API s'identifie avec un jeton d'accès, et non avec un email et un mot de passe. Chaque jeton a :
- un Nom du jeton, pour savoir quel outil l'utilise ;
- des Permissions : Lecture et écriture ou Lecture seule ;
- une Durée de validité, choisie à sa création : 15 jours, 30 jours, 90 jours, 1 an ou Illimité.
Qui reçoit ces emails, et quand ?
- Les emails sont envoyés aux administrateurs de votre espace Nicoka.
- Ils concernent les jetons des utilisateurs API : des comptes techniques, rattachés à aucun collaborateur, contact ni candidat.
- « va expirer dans une semaine » : l'outil a appelé l'API avec un jeton qui expire dans moins de 7 jours. Il fonctionne encore.
- « a expiré » : l'outil essaie toujours d'utiliser un jeton expiré. Ses appels sont refusés : il ne reçoit plus de données.
L'email indique le nom du jeton, la date et l'adresse IP du dernier appel, et la date d'expiration. Le bouton Gérer les tokens ouvre directement la fiche de l'utilisateur API concerné.
Renouveler le jeton
- Cliquez sur Gérer les tokens dans l'email. Vous pouvez aussi ouvrir Paramétrage > Administration, déplier Utilisateurs dans le menu de gauche, cliquer sur Utilisateurs API, puis sur le nom de l'utilisateur.

- Ouvrez l'onglet Accès API. La liste des jetons affiche pour chacun le Nom du jeton, les Permissions, la date de Création, la date Expire le et la Dernière utilisation (date et adresse IP).

- Cliquez sur Générer un jeton d'accès. Saisissez le Nom du jeton (obligatoire) et, si vous le souhaitez, une Description. Choisissez la Durée de validité et les Permissions, puis cliquez sur Générer.

- Le nouveau jeton s'affiche au-dessus de la liste, avec le message « Copiez ce jeton maintenant, il ne sera plus affiché ». Cliquez sur Copier, puis collez le jeton dans l'outil externe, à la place de l'ancien.

- Quand l'outil fonctionne avec le nouveau jeton, cliquez sur Révoquer sur la ligne de l'ancien jeton, puis confirmez avec Oui. Cette action est irréversible.

Si vous ne copiez pas le jeton à temps, générez-en simplement un autre : un jeton n'est jamais affiché une seconde fois. Tant que l'outil externe utilise l'ancien jeton, les emails d'alerte continuent.
Le bouton Révoquer tous les jetons d'accès rend inutilisables tous les jetons de l'utilisateur en une fois, par exemple si un jeton a pu être divulgué.
Le bouton Générer un jeton d'accès n'apparaît pas
La génération de jetons dépend du profil de l'utilisateur qui détient le jeton : il doit avoir le droit Création sur Jeton d'accès API. Sans ce droit, il ne peut ni générer de jeton, ni appeler l'API, même avec un jeton existant. Pour modifier les droits d'un profil, voir Définir des profils d'accès dans Nicoka.
Et l'extension Nicoka pour Chrome ?
L'extension n'est pas concernée par ces emails : ils ne portent que sur les jetons des utilisateurs API. Si l'extension vous demande de vous reconnecter, ouvrez son menu ⋮, cliquez sur Se déconnecter, puis connectez-vous de nouveau à votre espace Nicoka. Voir Plugin Nicoka - Import de candidats et de contacts.