Pour stocker les clés API en toute sécurité, gardez-les hors de tout ce qui se copie : code source, dépôts, images de firmware, URL et journaux. Lisez chaque clé à l’exécution depuis un coffre de secrets ou un fichier que seul le service peut lire, accordez-lui le plus petit ensemble de permissions possible, et soyez prêt à la révoquer et à la remplacer.
Une clé fuit par ses copies : chaque règle ci-dessous porte donc sur l’endroit où une copie finit.
| Où se trouve la clé | Comment elle est copiée | Règle |
|---|---|---|
| Une chaîne de requête d’URL | Historique du navigateur, journaux du serveur et du proxy | L’envoyer dans un en-tête, via TLS |
| Code source et dépôts | Chaque clone, et l’historique | La lire à l’exécution ; la révoquer si elle a été commitée |
| Variables d’environnement | Autres processus, journaux, vidages système | Privilégier un coffre de secrets ou un fichier protégé |
| Images de firmware | Chaque appareil flashé avec l’image | Un identifiant par appareil, aucune clé API externe |
Est-il sûr de mettre une clé API dans une URL ?
Non. La norme sur les jetons porteurs OAuth, RFC 6750, indique que les jetons porteurs ne doivent pas être transmis dans les URL des pages, car les navigateurs, les serveurs web et d’autres logiciels peuvent ne pas sécuriser suffisamment les URL dans l’historique du navigateur, les journaux des serveurs et d’autres structures de données.
Une clé API dans une chaîne de requête est exposée aux mêmes endroits, j’applique donc la même règle : je place la clé dans un en-tête de requête et je ne l’envoie que via TLS, ce que la RFC 6750 exige pour les jetons porteurs. Si un service n’accepte sa clé que comme paramètre de requête, je considère cette clé comme à moitié exposée et je lui accorde les permissions les plus restreintes proposées.
Les clés API doivent-elles être dans des variables d’environnement ?
Elles valent mieux que le code source, mais elles constituent une solution de repli. Le OWASP Secrets Management Cheat Sheet indique que les variables d’environnement sont en général accessibles à tous les processus et peuvent figurer dans les journaux ou les vidages système, et ne recommande de les utiliser que lorsque les autres méthodes sont impossibles.
Dans le code d’intégration, je lis la clé au démarrage depuis un coffre de secrets ou un fichier que seul le compte de service peut lire, et je ne journalise jamais la configuration chargée. Un fichier .env de développement reste hors du dépôt. Une fois commitée, une clé se trouve dans chaque clone et dans l’historique.
Comment garder les identifiants hors du firmware ?
Ne les compilez pas. La référence de base pour l’IoT grand public, ETSI EN 303 645, indique que les paramètres de sécurité critiques codés en dur dans le code source des appareils ne doivent pas être utilisés, car la rétro-ingénierie permet de trouver facilement des identifiants, y compris des clés API, et une simple obfuscation peut être contournée trivialement.
Les appareils industriels ne relèvent pas du champ d’application de cette norme, mais l’argument tient sur le terrain industriel. Donnez à chaque appareil son propre identifiant lors de la mise en service, conservez-le dans un stockage protégé, et livrez une seule image de firmware ne contenant aucun secret, de sorte qu’un identifiant extrait d’un appareil n’ouvre que cet appareil (plus de détails sur pourquoi les mots de passe partagés ne passent pas à l’échelle). Un capteur ne doit pas détenir du tout une clé vers une API externe : il envoie ses données à votre plateforme, et c’est le serveur qui effectue l’appel externe (voir comment un autre système doit être informé des nouvelles données des appareils).
Hermetry relie les appareils de terrain à des tableaux de bord en direct, des règles et des alertes : télémétrie IoT et SCADA sur une même plateforme. Dans ses flux d’automatisation, un bloc qui appelle un système externe ne détient jamais lui-même l’adresse ni le mot de passe ; il nomme une connexion, et le bloc de requête HTTP ne tire le schéma, l’hôte, le port, l’authentification et TLS que de cette connexion, jamais du message. Les secrets des connexions sont stockés chiffrés, ne peuvent plus être relus après enregistrement, et n’atteignent jamais les messages, les enregistrements d’exécution, les journaux, le journal d’audit ni les exports ; un flux importé nécessite donc de ressaisir ses secrets.
Limitez chaque clé à une seule intégration et à une seule tâche (voir le moindre privilège pour les personnes, les programmes et les appareils). Une clé par intégration indique ce qu’une fuite expose et permet de la révoquer sans arrêter tout le reste.
Questions fréquentes
Que faire si une clé API a été commitée dans un dépôt ?
Révoquez-la d’abord. L’OWASP Secrets Management Cheat Sheet donne l’ordre de confinement : révocation de la clé exposée, puis rotation vers un nouveau secret, puis suppression du secret révoqué du code et des journaux. Réécrire l’historique ne suffit pas, car les clones et les forks peuvent déjà contenir l’ancien commit.
À quelle fréquence faut-il renouveler les clés API ?
L’OWASP recommande de renouveler les secrets régulièrement pour qu’un identifiant volé ne fonctionne que peu de temps, et d’automatiser la rotation lorsque c’est possible, car la rotation manuelle est difficile et source d’erreurs. Choisissez un intervalle que votre intégration peut absorber sans interruption, et renouvelez immédiatement dès qu’une clé risque d’avoir fuité.
Chiffrer une clé dans le firmware suffit-il ?
Non, si l’appareil peut la déchiffrer seul. L’ETSI EN 303 645 indique que les méthodes d’obfuscation simples utilisées pour masquer ou chiffrer des informations codées en dur peuvent être trivialement contournées. Si l’appareil peut récupérer la clé sans aide extérieure, quiconque extrait son firmware le peut aussi.

