Les Jetons d’API Analytics Sont des Identifiants, Pas des Identifiants de Ressource
Un jeton d’API donne accès aux données. Traitez-le comme un secret avec un cycle de vie : affichage unique, vérificateur stocké, droits limités et révocation possible.
Un jeton d’API n’est pas une étiquette désignant un utilisateur ou un site. C’est un identifiant d’accès : toute personne qui obtient un jeton valide peut agir comme son propriétaire. Le traiter comme un simple identifiant le fait apparaître dans les logs, les URL, les captures d’écran du support et les configurations durables que personne ne sait révoquer.
Les meilleures pratiques de sécurité OAuth 2.0 de l’IETF, publiées en janvier 2025, actualisent le modèle de menace et les recommandations pour les déploiements OAuth. Un jeton d’API personnel n’est pas nécessairement un jeton d’accès OAuth, mais le principe d’ingénierie reste valable : les identifiants fondés sur leur possession doivent être protégés en transit, limités au service visé et aux droits nécessaires.
N’afficher le secret qu’une fois
Générez les jetons avec une source aléatoire cryptographiquement sûre et suffisamment d’entropie pour empêcher les tentatives réalistes de devinette. Ne renvoyez le jeton complet qu’à sa création ; stockez ensuite un préfixe non secret pour l’identifier et un vérificateur à sens unique pour les recherches ultérieures. Si la base de données est copiée, un vérificateur est plus sûr qu’un secret réutilisable en clair. Ne confondez pas un hash général avec un hash de mot de passe : les jetons d’API doivent être très aléatoires, tandis que les mots de passe humains nécessitent une fonction de hachage volontairement lente.
Indiquez clairement dans l’interface et la réponse API que le jeton ne sera affiché qu’une fois. Lorsque l’utilisateur quitte l’écran de création, proposez une révocation suivie d’une nouvelle émission plutôt que la récupération du secret d’origine. Ne placez jamais de jetons dans des paramètres de requête, des URL, des événements analytics, des rapports d’erreur ou des captures d’écran. Les URL se retrouvent plus facilement que les en-têtes d’autorisation dans l’historique du navigateur, les référents, les logs de proxy et les tickets de support.
Envoyer l’identifiant au bon endroit
Pour les API HTTP, acceptez les jetons dans l’en-tête Authorization au-dessus de TLS. RFC 6750 décrit les jetons bearer comme utilisables par quiconque les possède et avertit que leur divulgation lors du stockage ou du transport permet un usage abusif. La RFC déconseille aussi les paramètres de requête URI, car les URL sont souvent consignées. Refusez les jetons dans les chaînes de requête et les corps de requête, sauf si un protocole exige un autre transport et qu’un modèle de menace est documenté.
Sur le serveur, validez le jeton avant de traiter l’opération demandée. Résolvez son propriétaire et ses permissions depuis un stockage fiable ; n’acceptez pas un utilisateur ou un propriétaire de site fourni dans la requête comme autorité. Gardez les secrets hors des logs applicatifs, traces et messages d’exception. Si une corrélation opérationnelle est nécessaire, consignez l’ID ou le préfixe non secret du jeton, jamais le secret lui-même.
Limiter, faire expirer et révoquer
Un jeton doit accorder le minimum de permissions utiles. Lorsque le produit le permet, laissez l’utilisateur le limiter à certains sites et à la lecture seule ou à des opérations précises. Ne donnez pas implicitement à un script d’automatisation un accès en écriture à tout le compte s’il doit uniquement récupérer un rapport. Les recommandations de sécurité OAuth couvrent la restriction des privilèges et de l’audience des jetons ; elles restent une référence utile même si l’API emploie son propre format opaque.
Faites de l’expiration et de la révocation des contrôles de premier plan. Une durée de vie plus courte réduit la période pendant laquelle un secret divulgué reste utile ; la révocation répond aux incidents et aux changements d’équipe ou d’intégration. Si la rotation exige une période de chevauchement, limitez-la et indiquez quel jeton est actif. La révocation doit s’appliquer à la frontière de l’API, pas seulement masquer le jeton dans le dashboard.
Dans l’API programmatique de Monoid, les jetons mnd_live_… créés par les utilisateurs sont opaques, renvoyés en clair une seule fois et stockés sous forme de hash SHA-256 avec expiration facultative et révocation logique. Ce choix protège la valeur originale en cas de lecture de la base, mais ne rend pas inoffensif un jeton actif divulgué. Excluez-le du contrôle de version, des sorties CI, des bundles navigateur et de l’historique de terminal partagé ; en cas de fuite suspectée, émettez un nouveau jeton et révoquez l’ancien.
Rendre le cycle de vie testable
Testez le parcours complet : création, utilisation avec les droits prévus, rejet d’un jeton invalide ou expiré, révocation, puis vérification que ce même jeton ne fonctionne plus. Vérifiez qu’un jeton ne traverse pas les comptes ou les sites et que chaque endpoint applique les mêmes règles d’authentification et d’autorisation. Ajoutez des contrôles opérationnels pour masquer les secrets dans les logs et empêcher les réponses API de renvoyer le jeton stocké.
Le cycle de gestion des secrets comprend création, contrôle d’accès, rotation, audit et révocation — pas seulement stockage sécurisé. Un jeton d’API reste sûr uniquement si le système sait identifier son propriétaire, limiter ses actions, détecter une exposition sans consigner le secret et le désactiver rapidement.
Comments
Loading comments…