clé de service

Une clé de service est une longue chaîne secrète que votre programme envoie à chaque appel, pour que le service sache que l’appel vient de vous. La plupart des logiciels l’appellent une clé d’API.

En détail

Une personne se connecte avec un nom et un mot de passe. Un programme envoie plutôt sa clé, sans nom à côté.

Une seule chaîne fait le travail des deux. Elle est assez longue pour que personne ne la devine, elle appartient à un seul compte, et elle se remplace sans toucher au compte auquel elle appartient.

Ce qu’il fait sur un vrai document

Chaque appel au service envoie la clé avec lui, et le service décompte de votre offre chaque document PDF qu’il crée pour cette clé. C’est aussi par elle qu’il distingue vos polices de celles d’un autre compte.

La page de votre compte montre la clé en clair dès que vous êtes connecté. Si quelqu’un d’autre l’a vue, remplacez-la depuis cette page : l’ancienne clé cesse de fonctionner et une nouvelle prend sa place du même geste, et rien d’autre ne change.

D’où il vient, et pourquoi

Les services appelés par des programmes plutôt que par des personnes ont adopté des clés de ce genre. Un mot de passe appartient à une personne et ouvre tout ; une clé de service appartient à un seul programme et peut être retirée sans toucher au reste.

Parmi les façons de prouver qui appelle, celle-ci demande le moins au programme appelant. C’est aussi sa faiblesse : quiconque détient la chaîne agit en votre nom, donc elle a sa place dans la configuration de votre serveur, jamais dans le code d’une page.

Retour au glossaire complet