Protéger sa clé API d'IA : les règles des éditeurs

Une clé API d'IA est un mot de passe qui dépense de l'argent : quiconque la détient appelle le modèle à vos frais, avec vos limites. Les trois éditeurs donnent les mêmes règles de base : ne jamais l'écrire dans le code, ne jamais l'envoyer au navigateur, la ranger dans un gestionnaire de secrets, la limiter dans le temps et dans l'espace, et la révoquer au moindre doute. Voici la liste, d'après les consignes d'Anthropic, de Google et de Mistral lues le 15/11/2026.

1. Jamais dans le code ni dans un fichier de configuration

Anthropic : ne l'incluez jamais directement dans votre code ou vos fichiers de configuration. Google : traitez-la comme un mot de passe, ne la publiez jamais dans un dépôt de code, ne la codez pas en dur dans une application web ou mobile.

Passez-la par une variable d'environnement (ANTHROPIC_API_KEY, MISTRAL_API_KEY, GEMINI_API_KEY), et ajoutez vos fichiers .env au fichier d'exclusion de votre gestionnaire de versions (.gitignore pour Git).

2. Un gestionnaire de secrets en production

Dans le cloud, Anthropic préfère un stockage chiffré des secrets aux fichiers .env ; pour les grandes installations, un service de gestion de clés centralisé. Google cite Google Cloud Secret Manager. Mistral conseille, dès la création, un gestionnaire de mots de passe ou un coffre à secrets.

3. Jamais dans le navigateur

C'est l'erreur la plus fréquente avec les sites et les applications web. La documentation d'Anthropic est claire : appelez l'API depuis votre propre serveur, pas depuis le code qui tourne dans le navigateur de vos utilisateurs, car n'importe quel visiteur peut lire une clé présente dans une page. Le schéma correct : la page appelle votre serveur, qui détient la clé et appelle l'API. Google donne la même consigne : faites passer les appels par un serveur intermédiaire.

L'API Claude refuse par défaut les requêtes venues d'un navigateur ; elle ne les accepte qu'avec l'en-tête au nom explicite anthropic-dangerous-direct-browser-access: true. Pour une application iOS ou macOS distribuée au public, Anthropic propose App Attest : l'appareil prouve qu'il exécute une version authentique de votre application et reçoit un jeton d'une heure, sans clé embarquée.

4. Une clé par usage, une identité par clé

• Des clés différentes pour le développement, les tests et la production (consigne d'Anthropic) : une clé compromise se désactive sans tout arrêter.
• Chez Claude, une clé personnelle pour vos essais, une clé de compte de service pour ce qui est partagé ; les clés d'espace de travail sont un type hérité. Une clé adossée à une identité s'arrête quand la personne quitte l'organisation.
• Pour la production sur un cloud, la fédération d'identité remplace la clé statique par des jetons de courte durée, renouvelés par la bibliothèque.

5. Limiter dans le temps et dans l'espace

• Expiration : chez Claude, 3 heures, 1 jour, 7 jours, 30 jours, une durée personnalisée ou jamais ; chez Mistral, une date d'expiration se fixe à la création.
• Rotation : Anthropic donne l'exemple d'une rotation tous les 90 jours.
• Restrictions : Google recommande d'ajouter des restrictions à la clé ; Anthropic propose une liste d'adresses IP (Internet Protocol) autorisées.
• Plafonds : fixez une limite de dépense et des limites de débit par espace de travail, pour qu'une clé volée ne vide pas le budget (voir erreur 429 et limites). Google recommande des alertes de facturation.

6. Surveiller

Anthropic conseille de consulter régulièrement les pages Logs et Usage de la Console. Une consommation qui grimpe la nuit, un modèle que vous n'utilisez pas : ce sont des signaux d'alerte.

7. Scanner les dépôts

Vérifiez régulièrement vos dépôts de code pour repérer les secrets commités par erreur, et ajoutez l'analyse des secrets à votre chaîne d'intégration continue. Depuis le 20/08/2024, Anthropic est partenaire du programme d'analyse des secrets de GitHub : une clé Claude trouvée dans un dépôt public est signalée à Anthropic, qui la désactive et prévient l'utilisateur par courriel.

8. En cas de fuite

1. Révoquez la clé tout de suite depuis la page des clés (chez Claude, « Disable » est réversible, « Delete » est définitif).
2. Créez une nouvelle clé et déployez-la.
3. Vérifiez la consommation sur la période.
4. Cherchez comment elle a fui (dépôt, journal, capture d'écran, message) pour fermer la porte.

La sécurité ne s'arrête pas à la clé : l'injection de prompt, qui détourne un modèle par un texte malveillant, est traitée par Cercle IA Tech · Sécurité.