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 |
- 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
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 :
- Conservez la clé API permanente uniquement sur votre propre serveur et ne la livrez jamais à un client.
- Lorsque le frontend doit appeler un modèle, demandez d'abord une clé temporaire à votre backend.
- 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.
- Le frontend appelle Model Studio directement avec la clé st-.
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 :
- Créez une nouvelle clé et reconfigurez ses permissions et son budget selon les besoins actuels.
- Mettez à jour les références d'identifiants dans vos services.
- Vérifiez que la nouvelle clé fonctionne.
- Supprimez l'ancienne clé et confirmez qu'elle ne peut plus émettre d'appels.
- Mettez à jour le registre des clés.
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.
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.
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
Les clés API temporaires ont-elles moins de permissions que les clés API permanentes ?
Les clés API temporaires ont-elles moins de permissions que les clés API permanentes ?
Avec une liste blanche IP configurée, dois-je toujours craindre une fuite de clé ?
Avec une liste blanche IP configurée, dois-je toujours craindre une fuite de clé ?
Que faire si j'ai fourni une clé à un service de relais tiers ?
Que faire si j'ai fourni une clé à un service de relais tiers ?