Clé API : définition et bons réflexes pour la protéger

Clé ancienne en laiton avec une étiquette, posée sur du velours devant un petit coffre ouvert

Un module de paiement, une carte Google Maps, un outil d’automatisation ou un plugin d’IA vous demande de coller « votre clé API » ? Vous l’avez peut-être déjà fait sans trop savoir ce que vous manipuliez. Pourtant, une clé API, c’est un peu le badge d’accès de votre site à un service : entre de mauvaises mains, elle peut coûter cher. Voyons ensemble ce que c’est, et les bons réflexes pour la protéger.

Trousseau de clés avec un petit couteau de poche rouge
Une clé API ouvre une porte : mieux vaut savoir laquelle, et à qui on la confie.

Une clé API, c’est quoi ?

Une API, c’est la porte d’entrée qu’un service ouvre aux autres logiciels : votre boutique parle à votre outil de paiement, votre site parle à un service de cartes. Notre article Connecter deux applications sans coder explique ce principe en détail.

La clé API, elle, sert à prouver qui frappe à la porte. La documentation de Stripe sur les clés API le résume bien : Stripe utilise des clés API pour authentifier les requêtes de votre intégration et déterminer les ressources auxquelles elle peut accéder. Autrement dit, la clé dit au service « c’est bien ce compte qui demande », et fixe ce que la demande a le droit de faire.

Schéma du fonctionnement d’une clé API : votre site envoie une requête accompagnée de sa clé, le service vérifie la clé puis répond selon les droits accordés
La clé accompagne chaque requête : le service vérifie qui demande et ce qu’il a le droit de faire.

Toutes les clés ne se valent pas

Chez Stripe, la documentation distingue plusieurs types de clés, et c’est un excellent exemple pour comprendre la logique :

  • La clé publiable (qui commence par « pk_ ») sert dans le navigateur ou les applications mobiles. Elle peut identifier votre compte et préparer des informations de paiement, mais ne peut pas effectuer d’opérations sensibles comme créer des paiements ou lire les données du compte. Stripe indique que vous pouvez l’inclure dans le code visible des visiteurs.
  • La clé limitée (« rk_ ») est une clé dont vous contrôlez les autorisations, pour limiter les dégâts qu’un acteur malveillant pourrait causer s’il l’obtenait.
  • La clé secrète (« sk_ ») dispose d’autorisations illimitées sur toutes les API Stripe. Comme on ne peut pas limiter ses autorisations, Stripe déconseille de l’utiliser pour de nouveaux cas d’usage et recommande de migrer vers des clés limitées.
Schéma des trois types de clés Stripe : clé publiable sans danger côté visiteur, clé limitée aux droits choisis, clé secrète aux droits illimités
Publiable, limitée, secrète : trois niveaux de risque très différents.

La documentation précise aussi que chaque mode a son propre jeu de clés : les clés de test (« pk_test_ », « rk_test_ », « sk_test_ ») et celles du mode production (« pk_live_ », « rk_live_ », « sk_live_ »). Les premières servent à tester sans traiter de vrais paiements, les secondes à encaisser pour de bon.

Capture de la documentation de Stripe présentant les types de clés API
La documentation de Stripe détaille chaque type de clé et son niveau de risque.

Retenez la règle d’or que pose Stripe : seules les clés publiables peuvent être exposées en toute sécurité en dehors du serveur de votre application. Toutes les autres doivent rester secrètes.

Les bons réflexes pour protéger vos clés

Stripe rappelle que vous êtes responsable de la gestion sécurisée de vos clés API, et liste plusieurs précautions, valables bien au-delà de son service :

  1. Ne placez pas de clés dans le code source ni dans des fichiers de configuration versionnés, c’est-à-dire envoyés dans un outil comme GitHub.
  2. Ne partagez pas vos clés par e-mail, messagerie instantanée ou tout autre canal non chiffré.
  3. Stockez-les dans un coffre-fort de secrets fourni par votre hébergement. À défaut, Stripe conseille d’utiliser des variables d’environnement.
  4. Configurez des politiques d’accès pour que les clés ne puissent être utilisées qu’à partir de vos serveurs connus.
  5. Changez les clés lorsqu’un membre de votre équipe qui y avait accès quitte l’organisation.
Liste des bons réflexes pour protéger une clé API : jamais dans le code ni par e-mail, coffre-fort de secrets, restrictions d’usage, droits minimum, renouvellement au départ d’un collaborateur
Cinq réflexes à adopter pour toutes vos clés API.

Exemple fictif : un graphiste envoie à son développeur, par e-mail, la clé secrète de son outil de facturation pour qu’il installe un module. Trois mois plus tard, sa boîte mail est piratée. Avec une clé limitée aux seules factures, transmise par un gestionnaire de mots de passe partagé puis renouvelée après l’installation, l’incident aurait eu beaucoup moins de conséquences.

Restreindre une clé : l’exemple de Google

Les clés des services Google, utilisées par exemple pour afficher une carte sur votre site, suivent la même logique. La documentation Gérer les clés API de Google Cloud est très directe : les clés API sans restriction ne sont pas sécurisées.

Elle décrit deux types de restrictions, et recommande de définir les deux :

  • Les restrictions d’API, qui définissent les API pouvant être appelées avec la clé.
  • Les restrictions d’application, qui limitent l’usage de la clé à des sites web, des adresses IP ou des applications précises. Une clé sans restriction d’application peut être utilisée n’importe où.

Pour une carte affichée sur votre site, cela revient à dire : « cette clé ne sert qu’au service de cartes, et uniquement depuis mon nom de domaine ». Si quelqu’un la copie depuis le code de votre page, elle ne lui servira à rien ailleurs.

Que faire si une clé a fuité ?

Pas de panique, mais agissez vite. Le principe est le même partout : remplacer la clé compromise par une nouvelle, puis désactiver l’ancienne. Google Cloud décrit cette « rotation » ainsi : vous créez une clé avec les mêmes restrictions que l’ancienne, vous mettez à jour vos applications pour qu’elles utilisent la nouvelle, puis vous supprimez l’ancienne une fois toutes les applications mises à jour.

Bon à savoir : selon cette même documentation, une clé supprimée par erreur peut être restaurée dans les 30 jours. Chez Stripe, la documentation précise qu’une clé secrète de production ne s’affiche qu’une seule fois à sa création, et que Stripe ne peut pas récupérer une clé perdue : il faut alors la faire pivoter ou la supprimer, puis en créer une nouvelle.

Les étapes du remplacement d’une clé API compromise : créer une nouvelle clé avec les mêmes restrictions, mettre à jour les applications, supprimer l’ancienne clé, vérifier les journaux
Remplacer une clé en quatre étapes, sans couper vos services.

Profitez-en pour vérifier les journaux d’activité du service concerné : des requêtes inhabituelles vous diront si la clé a été utilisée par quelqu’un d’autre.

Et avec les outils d’automatisation et d’IA ?

Les outils comme Make, Zapier ou n8n, et de plus en plus d’agents IA, vous demandent eux aussi des clés pour agir sur vos comptes. Appliquez-leur le principe du moindre privilège : donnez-leur des clés limitées aux seules actions nécessaires. Stripe propose d’ailleurs de marquer une clé limitée comme appartenant à un agent autonome, avec des règles d’approbation qui exigent qu’un réviseur valide les actions sensibles. Côté agents, notre article Agent IA : définition simple et usages pour une petite entreprise détaille les garde-fous à poser.

Envie d’automatiser sereinement vos tâches, clés comprises ? La formation Automatiser son activité vous guide pas à pas.

Questions fréquentes

Qu’est-ce qu’une clé API ?

C’est un identifiant secret que votre site ou votre outil envoie avec chaque requête à un service. Il permet au service de savoir quel compte fait la demande et ce qu’il a le droit de faire.

Puis-je afficher une clé API dans le code de mon site ?

Seulement si elle est prévue pour cela, comme la clé publiable de Stripe, qui ne peut pas effectuer d’opérations sensibles. Les clés secrètes et limitées doivent rester sur le serveur.

Comment envoyer une clé API à un prestataire ?

Évitez l’e-mail et la messagerie instantanée, que Stripe déconseille. Préférez un gestionnaire de mots de passe partagé, créez une clé limitée aux besoins du prestataire et renouvelez-la une fois sa mission terminée.

Que faire si ma clé API a été publiée par erreur ?

Créez une nouvelle clé avec les mêmes restrictions, mettez à jour vos applications, puis supprimez l’ancienne. Vérifiez ensuite les journaux d’activité du service.

Pourquoi restreindre une clé API Google ?

Parce qu’une clé sans restriction peut être utilisée n’importe où. Google recommande de limiter à la fois les API qu’elle peut appeler et les sites, adresses IP ou applications qui peuvent l’utiliser.

Dernière mise à jour : · Launch-IT