À retenir
- Une clé de service s'utilise avec un en-tête technique, pas en vous connectant : elle est faite pour un programme, pas pour une personne.
- Sa portée se choisit à la création, parmi les permissions que vous détenez vous-même — jamais plus large.
- La clé en clair ne s'affiche qu'une seule fois, au moment de la création : copiez-la avant de quitter l'écran.
- La portée ne se modifie pas après coup. Pour l'élargir ou la resserrer, révoquez la clé et recréez-en une.
Où trouver cet écran — Menu latéral → Accès API.
Une portée choisie à la création, jamais au-delà de la vôtre
Créer une clé, c'est choisir une portée : la liste des permissions qu'elle emportera. L'écran ne vous propose que celles que vous détenez vous-même — impossible d'émettre une clé plus puissante que votre propre compte.
Cette portée est figée dès la création. Ce n'est pas un oubli : changer la portée d'une clé déjà en circulation serait un changement d'autorisation invisible pour qui l'utilise. Si vos besoins changent, la marche à suivre est toujours la même : révoquer, puis recréer avec la nouvelle portée.
Ce que vous réglez en la créant
Le formulaire de création vous demande :
- un nom, pour vous souvenir plus tard à quoi la clé sert ;
- une description facultative ;
- la portée : les permissions à accorder, cochées une par une ;
- une date d'expiration facultative, au-delà de laquelle la clé cesse de fonctionner d'elle-même ;
- une limite d'appels par heure, avec une valeur par défaut raisonnable pour un usage normal.
La clé ne peut jamais dépasser vos droits du moment
La portée déclarée à la création n'est qu'un plafond. À chaque appel, elle est recoupée avec vos permissions du moment, recalculées à chaque requête. Si vous perdez une permission après coup, la clé la perd aussitôt — sans qu'il y ait quoi que ce soit à faire sur la clé elle-même.
Ce que vous pouvez faire
- Ouvrez « Accès API » depuis le menu latéral et cliquez sur le bouton de création de clé.
- Nommez-la clairement : une clé sans nom explicite est une clé qu'on n'ose plus révoquer plus tard, de peur de casser quelque chose.
- Cochez la portée la plus étroite qui suffit au programme qui va l'utiliser — pas plus.
- Copiez la clé affichée immédiatement : elle ne réapparaîtra plus jamais en clair, ni dans l'écran ni dans un e-mail.
Questions fréquentes
J'ai perdu ma clé : puis-je la revoir ?
Non. Digitalyser.io ne conserve qu'une empreinte de la clé, pas sa valeur en clair — elle ne peut donc être ni retrouvée ni réaffichée. Révoquez la clé perdue et créez-en une nouvelle.
Que se passe-t-il si on me retire une permission après avoir créé la clé ?
Rien à faire de votre côté : la portée de la clé est recoupée avec vos permissions actuelles à chaque appel. La perte est répercutée immédiatement, à l'appel suivant.
Puis-je élargir la portée d'une clé existante ?
Non, la portée est immuable après création. Révoquez la clé et recréez-en une avec la portée qui convient désormais.