Skip to main content

Meilleures pratiques de prévention des fuites de clés API

Prévenez les fuites de clés API en raccourcissant le temps d'exposition des identifiants, en réduisant la portée des permissions et en configurant des alertes et la limitation des pertes : clés API temporaires, rotation régulière, liste blanche IP, connexion privée, alertes de budget et alertes de surveillance des modèles.

Vue d'ensemble

Une clé API est l'identifiant utilisé pour appeler les services de modèles d'Alibaba Cloud Model Studio. En cas de fuite, quiconque la détient peut appeler les modèles couverts par les permissions de la clé et consommer votre quota. L'impact d'une fuite se décompose en quatre facteurs : probabilité de fuite, durée d'exposition, portée des permissions par appel et durée de l'anomalie. La probabilité de fuite est réduite par les pratiques de base présentées tout au long de cette page, et les trois autres facteurs sont réduits par les trois niveaux suivants :

Niveau

Facteur réduit

Mesures clés

Raccourcir le temps d'exposition

Durée d'exposition

Clés API temporaires côté client, affichage unique avec stockage contrôlé, rotation régulière et retrait au départ

Réduire la portée des permissions

Portée des permissions par appel

Une clé par activité, isolation par espace de travail, liste blanche IP et portée des modèles, connexion privée

Alertes et limitation des pertes

Durée de l'anomalie

Alertes de budget avec arrêt automatique, alertes de surveillance des modèles, détection des risques par la plateforme

Pratiques de base applicables aux trois niveaux :
  • Les applications lisent les identifiants depuis des variables d'environnement ou un service de gestion des clés au lieu de les coder en dur ; configurez l'analyse des informations sensibles dans la CI/CD (avec des outils d'analyse d'identifiants tels que gitleaks), en couvrant les formats de clé API.
  • Tenez un registre des clés : commencez par un tableau simple répertoriant les ID de clés, les usages, les responsables et les dates de dernière rotation, puis ajoutez progressivement les régions, les espaces de travail, les portées de permissions et les budgets ; ne stockez jamais de clés complètes dans le registre.
  • Réservez les permissions de gestion des clés (création, consultation, modification, suppression) aux administrateurs qui en ont besoin.

Raccourcir le temps d'exposition des identifiants

Conserver les clés API permanentes en toute sécurité

Une clé API nouvellement créée n'est affichée en clair qu'une seule fois, lors de sa création ; une fois la boîte de dialogue fermée, le texte en clair ne peut plus être consulté ni copié. Si vous ne l'avez pas enregistrée, vous ne pouvez que la réinitialiser ou la recréer. Voir Obtenir une clé API. Après la création, stockez la clé complète directement dans un magasin d'identifiants contrôlé (un service de gestion des clés ou la gestion des secrets de votre plateforme de déploiement), sans la transiter par captures d'écran, e-mails, outils de messagerie ou documents ordinaires ; la valeur masquée de la liste sert uniquement à l'identification et à la comparaison. Ne placez jamais de clés API permanentes aux emplacements suivants :
  • Scripts de navigateur, artefacts de build frontend et paquets d'applications mobiles
  • Dépôts de code publics ou partagés (ajouter .gitignore ne suffit pas à éliminer les identifiants des commits historiques)
  • Sorties de notebooks et exemples de code
  • Captures d'écran et enregistrements d'écran
  • Tickets, discussions de groupe et documents en ligne
  • Prompts, bases de connaissances et contextes d'agents
  • URL de requête et paramètres de requête
  • Journaux d'accès et piles d'exceptions
  • Plug-ins tiers et services de relais de modèles
  • Environnements partagés et fichiers de configuration exposés vers l'extérieur, images et sauvegardes
Pour le débogage local, définissez la variable d'environnement avec une saisie masquée afin d'éviter de laisser le texte en clair dans l'historique des commandes :
read -r -s -p "Enter API key: " DASHSCOPE_API_KEY
printf '\n'
export DASHSCOPE_API_KEY
Cet exemple s'applique à Linux/macOS.
Les variables d'environnement évitent le codage en dur mais ne constituent pas un stockage chiffré : les identifiants peuvent encore fuiter via les diagnostics de processus, les configurations de conteneurs, les dumps de crash ou les exports d'exploitation ; évitez pendant le débogage les options telles que set -x qui affichent des variables sensibles. En production, utilisez un service de gestion des clés ou l'injection de secrets de votre plateforme de déploiement.
Si vous avez fourni une clé API à un service de relais de modèles ou à un plug-in tiers non fiable, cessez de lui livrer de nouvelles clés, passez par l'API officielle ou une intégration côté serveur de confiance, et réinitialisez les clés déjà livrées.

Utiliser des clés API temporaires dans les scénarios côté client

Les navigateurs, applications mobiles et mini-programmes ne peuvent pas garantir de manière fiable la confidentialité des identifiants. Dans ces scénarios, faites émettre les clés API temporaires par un backend authentifié, pour que le frontend les utilise en appel direct :
  1. Conservez la clé API permanente uniquement sur votre propre serveur et ne la livrez jamais à un client.
  2. Lorsque le frontend doit appeler un modèle, demandez d'abord une clé temporaire à votre backend.
  3. Le backend appelle l'API de génération de clé API temporaire et renvoie au frontend une clé st- à durée de vie courte.
  4. Le frontend appelle Model Studio directement avec la clé st-.
Par défaut, une clé API temporaire reste valide 60 secondes ; vous pouvez définir une durée de 1 à 1 800 secondes via expire_in_seconds (choisissez la durée la plus courte nécessaire à la tâche, sans utiliser systématiquement le maximum). Elle expire automatiquement et ne peut pas être supprimée par anticipation ; elle hérite de toutes les permissions de la clé API permanente qui l'a émise, réduisez donc d'abord la clé émettrice lorsque des permissions plus restreintes sont nécessaires. L'API d'émission est appelée via OpenAPI avec la clé permanente ; vérifiez les permissions de l'appelant et limitez la fréquence d'émission afin de ne pas en faire un point de distribution public d'identifiants. Pour plus de détails sur l'API, voir Générer une clé d'API temporaire.

Rotation régulière et retrait au départ du personnel

Les clés à durée de vie longue configurées dans du code ou des agents accumulent de l'exposition au fil du temps et doivent faire l'objet d'une rotation régulière :
  1. Créez une nouvelle clé et reconfigurez ses permissions et son budget selon les besoins actuels.
  2. Mettez à jour les références d'identifiants dans vos services.
  3. Vérifiez que la nouvelle clé fonctionne.
  4. Supprimez l'ancienne clé et confirmez qu'elle ne peut plus émettre d'appels.
  5. Mettez à jour le registre des clés.
Une nouvelle clé n'hérite pas automatiquement des permissions et du budget de l'ancienne ; reconfigurez-les. Lorsqu'un membre du personnel part ou qu'une activité est retirée, vous devez recenser séparément les clés concernées, puis les supprimer ou les réinitialiser : les clés API créées le 25 mars 2026 ou après ne sont pas supprimées en cascade avec l'utilisateur RAM auquel elles appartiennent et restent utilisables (cette règle ne s'applique que lorsque la clé appartient à un sous-compte RAM) ; la suppression d'un utilisateur RAM ne suffit donc pas à considérer les identifiants comme retirés. Voir Validité et limites. Si plusieurs clés sont conservées dans un même serveur suspecté d'être compromis, une même configuration publique, un même dépôt de code ou un même environnement tiers, réinitialisez ensemble les identifiants potentiellement affectés et corrigez l'environnement : ne remplacez pas toutes les clés sans distinction, mais ne traitez pas non plus une seule clé en ignorant l'environnement d'exposition commun. Pratique avancée : hébergez le texte en clair des clés dans un service de gestion des clés (KMS), faites-les récupérer par les applications par nom d'identifiant, et utilisez la rotation des clés du KMS pour les mettre à jour périodiquement.

Réduire la portée des permissions des identifiants

Une clé par activité et isolation par espace de travail

Attribuez des clés API distinctes aux différentes applications et environnements (production, test et débogage personnel) : cela réduit l'impact de la fuite d'une clé donnée et facilite le suivi des problèmes et la rotation clé par clé. Lorsque vous avez besoin d'une isolation des permissions, d'un contrôle d'accès fin aux modèles ou d'une comptabilisation indépendante des coûts, attribuez à l'activité un espace de travail autre que celui par défaut (un espace de travail est un conteneur de Model Studio qui isole les permissions et les coûts ; chaque compte dispose par défaut d'un espace de travail par défaut) ; la portée d'appel de base d'une clé est contrainte par l'espace de travail auquel elle appartient. Voir Gestion des permissions. Réservez également les permissions de gestion des clés aux administrateurs nécessaires ; les comptes autorisés à se connecter à la console pour gérer les identifiants doivent appliquer le privilège minimum et activer l'authentification multifacteur conformément aux exigences de votre organisation.

Configurer la liste blanche IP et la portée des modèles

Après avoir défini la permission d'une clé API sur Custom dans le panneau de création ou de modification de la clé, vous pouvez restreindre davantage sa portée d'appel :
  • Liste blanche IP : n'autorisez que les IP ou plages CIDR de sortie publique réellement utilisées par l'activité, jusqu'à 20 entrées (utilisez un moyen tel que curl ifconfig.me pour connaître votre sortie publique). Par défaut, toutes les adresses IPv4 sont autorisées ; la seule création d'une clé ne signifie pas que les restrictions de source sont en vigueur. En cas d'appels via NAT, proxy ou passerelle, renseignez l'adresse de sortie publique que Model Studio voit réellement, et non l'adresse intranet du serveur.
  • Portée des modèles : une fois activée, la clé ne peut appeler que les modèles sélectionnés (jusqu'à 30, dans la limite des modèles autorisés dans l'espace de travail), ce qui empêche qu'une clé divulguée soit utilisée sur des modèles coûteux.
Après la configuration, vérifiez que la restriction fonctionne : seuls les réseaux et modèles autorisés peuvent être appelés, et pas les autres ; n'affichez pas la clé complète pendant la vérification. Pour le point d'entrée et les règles complètes, voir Permissions des clés API.
Une liste blanche IP ne remplace pas la confidentialité des identifiants : des personnes ou des hôtes compromis capables d'émettre des appels depuis le même réseau de sortie peuvent toujours détourner une clé divulguée.

Appeler via une connexion privée

Pour les scénarios exigeant une sécurité réseau élevée, vous pouvez établir une connexion privée (PrivateLink) entre votre VPC et Model Studio : les appels contournent le réseau public, si bien que des attaquants externes dont le réseau n'est pas connecté ne peuvent pas appeler le service, même en cas de fuite de la clé. Pour la configuration, voir Accéder aux API Model Studio via un réseau privé.

Configurer les alertes et la limitation des pertes

Alertes de budget et arrêt automatique

Définissez des budgets mensuels et des seuils d'alerte pour le compte, un espace de travail ou une clé API ; donnez la priorité à des budgets indépendants pour les clés à risque, telles que celles de développement, de test, de démonstration ou d'intégration tierce. Lorsque les coûts atteignent le seuil, puis lorsque le budget est épuisé, des notifications sont envoyées par messages sur le site, SMS, e-mail ou robot ; après l'activation de l'option « Arrêter le service lorsque le budget est atteint », le service restreint pour cette dimension les appels à l'usage et renvoie 429. Pour la configuration, voir Gestion du budget.
L'option « Arrêter le service lorsque le budget est atteint » prend effet avec un délai, et les frais encourus pendant ce délai restent facturés ; le dépassement du débit préprovisionné (PTU) et les appels générés par les applications ne prennent pas encore en charge l'arrêt automatique. Pour les activités critiques en production, l'arrêt automatique n'est pas recommandé ; privilégiez les alertes associées à un traitement contrôlé.

Alertes de surveillance des modèles

La surveillance des modèles agrège, par espace de travail, le nombre d'appels, la consommation de tokens, le nombre d'échecs et le taux d'échec ; elle prend en charge le filtrage par clé API et permet de créer des règles d'alerte à partir de modèles d'alerte prédéfinis ou personnalisés, notifiant des contacts ou des groupes de contacts. Configurez pour les clés à risque des alertes de type pic de volume ou de nombre d'appels : les anomalies deviennent visibles en quelques minutes après les appels, et un déclenchement hors heures ouvrées appelle une intervention manuelle. La première configuration d'alerte requiert d'autoriser au préalable le rôle de service Cloud Monitor dans la livraison des données ; pour la configuration, voir Alertes.

Détection des risques par la plateforme

La plateforme analyse périodiquement les environnements publics tels que les dépôts de code ouverts afin d'identifier les clés API divulguées et vous en informe activement ; les canaux effectifs dépendent de ce qui est activé (SMS, e-mail, messages sur le site, etc.). Elle identifie également les comportements anormaux tels que les connexions depuis des IP inhabituelles, les pics de trafic nocturnes ou les hausses anormales de coûts. La détection des risques et les alertes de la plateforme constituent une capacité de détection des anomalies et d'avertissement fournie à titre proactif par la plateforme afin d'améliorer l'expérience d'utilisation, hors du périmètre des services couverts par la SLA ; compte tenu de la complexité des scénarios de risque, aucune couverture d'alerte absolue n'est garantie, et l'identification et la livraison des alertes peuvent également subir des délais. La conservation sécurisée et l'utilisation conforme des identifiants tels que les clés API relèvent de votre responsabilité : privilégiez comme première ligne de défense les alertes de budget, les alertes de surveillance des modèles et la rotation régulière que vous configurez vous-même ; l'absence d'alerte de la plateforme ne signifie pas l'absence de risque de fuite. En cas de fuite présumée ou dès réception d'une alerte, localisez et traitez le problème en suivant la procédure Investigation sur les fuites de clé API.

Liste de contrôle avant mise en production

Les développeurs individuels et les petites équipes peuvent commencer par le strict minimum : définir pour la clé un budget avec notifications d'alerte, conserver l'identifiant uniquement dans des variables d'environnement et effectuer une rotation régulière. La liste de contrôle complète est la suivante :
  • Production, test et intégrations tierces ne partagent pas la même clé API ; les responsables et les usages des clés sont clairement définis.
  • Région, espace de travail, portée des modèles et IP de sortie des requêtes sont vérifiés, les permissions ne couvrant que le nécessaire.
  • Les clés permanentes ne sont stockées que dans des backends contrôlés et n'entrent jamais dans les clients, le code source, les prompts, les documents partagés ni les journaux.
  • Les clés n'ont pas été livrées à des services de relais tiers ou à des environnements de plug-ins non fiables ; le cas échéant, la livraison a cessé et les clés ont fait l'objet d'une rotation.
  • Les identifiants sont injectés par variables d'environnement ou par secrets ; les fichiers sensibles et les artefacts de build ne contiennent pas de texte en clair.
  • Les scénarios d'appel direct côté client utilisent des clés à durée courte émises par un backend authentifié, et la clé permanente émettrice a des permissions restreintes.
  • Les nouvelles clés sont stockées de manière contrôlée ; les anciennes clés, les clés inactives et les clés liées au personnel parti ont été passées en revue.
  • Les budgets et alertes aux niveaux compte, espace de travail et clé sont configurés, avec des canaux de notification et des responsables clairement établis.
  • L'impact sur la disponibilité et le délai d'effet de l'option « Arrêter le service lorsque le budget est atteint » ont été évalués.
  • Les procédures de rotation et de traitement des fuites sont définies ; les étapes d'investigation sont décrites dans Investigation sur les fuites de clé API.

FAQ

Non. Une clé API temporaire hérite de toutes les permissions de la clé API permanente qui l'a émise ; seule sa durée de validité est plus courte. Pour des permissions plus restreintes, réduisez d'abord la clé API permanente émettrice.
Oui. Une liste blanche IP ne restreint que le réseau source des appels ; une clé divulguée au sein du même réseau de sortie peut toujours être détournée. Combinez-la avec le privilège minimum, les alertes de budget et la rotation régulière.
Cessez de livrer de nouvelles clés à ce service, réinitialisez les clés déjà livrées et passez à l'API officielle ou à une intégration côté serveur de confiance. Pour le traitement des clés divulguées, voir Investigation sur les fuites de clé API.