Parcours d'investigation après une fuite de clé API présumée : localiser et neutraliser la clé divulguée pour limiter les pertes, identifier les périodes anormales via l'utilisation et les coûts, confirmer le comportement des appels dans les journaux d'audit et d'inférence, passer en revue les opérations de gestion via ActionTrail, puis finaliser l'évaluation des dommages, la collecte de preuves et la rotation.
Approche de l'investigation
Si la fuite est confirmée, rendez-vous d'abord sur la page de gestion des clés API pour réinitialiser ou supprimer la clé divulguée et arrêter les pertes, puis suivez les étapes de cette page pour évaluer l'impact ; si la fuite n'est pas certaine, commencez par la vérification de l'utilisation de l'étape 2.
Une investigation de fuite répond à cinq questions, chacune associée à une source d'information de la console :
Question à laquelle répondre | Où consulter | Ce que vous obtenez |
|---|---|---|
Quelle clé a fuité ? Qui l'a créée ? Quel est son état actuel ? | Page de gestion des clés API | ID de clé, clé masquée, description, compte propriétaire, date de création ; actions de réinitialisation, de modification, de suppression et de consultation des coûts |
Combien cette clé a-t-elle été appelée, et combien a-t-elle coûté ? | Utilisation des modèles, aperçu des coûts et factures | Nombre d'appels, consommation de tokens, courbes d'utilisation au jour et montants, regroupés par clé API |
D'où provenaient les appels, quels modèles ont été appelés, et ont-ils réussi ? | Journaux d'audit | Request ID, horodatage, modèle, consommation de tokens, latence, code de statut, code d'erreur ; filtrage par clé API |
Quels étaient les contenus d'entrée et de sortie des appels ? | Journaux d'inférence (activation requise au préalable) | Prompts et réponses complets (limite de 128K) |
Quelles opérations de gestion cette clé a-t-elle connues ? | Audit des opérations (ActionTrail) | Enregistrements des événements d'opérations au niveau de la console et de l'OpenAPI |
Étape 1 : Localiser et neutraliser la clé divulguée
Accédez à la page API Key d'Alibaba Cloud Model Studio et sélectionnez la région dans le coin supérieur droit : les clés sont indépendantes d'une région à l'autre et ne peuvent pas être utilisées entre régions.
Lorsque la fuite est confirmée, privilégiez la réinitialisation ou la suppression de la clé afin d'arrêter immédiatement les pertes ; modifier la clé pour restreindre ses permissions ne convient qu'aux situations où la fuite n'est pas certaine et où une période d'observation est nécessaire. Repérez la clé visée dans la liste des clés API et utilisez les actions de sa ligne :
- Réinitialiser : émet une nouvelle valeur pour la clé ; l'ancienne valeur devient immédiatement invalide.
- Modifier : restreint les permissions (liste blanche IP, portée des modèles) ; voir Meilleures pratiques de prévention des fuites de clés API.
- Supprimer : prend effet immédiatement et est irréversible.
- Consulter les coûts : accède à la vue des coûts et de l'utilisation de la clé.
- La seule création d'une nouvelle clé n'invalide pas automatiquement l'ancienne clé ; cette dernière doit être traitée séparément.
- Ne remettez pas la nouvelle clé dans un environnement suspect dont l'investigation n'est pas terminée, sinon vous livrez à nouveau le nouvel identifiant.
Étape 2 : Vérifier l'utilisation et les coûts pour cerner les périodes anormales
Le signal le plus direct d'une fuite est la présence d'appels ou de coûts qui ne devraient pas exister. Dans la console Model Studio, choisissez Cost and Usage > Model Usage, définissez la dimension de regroupement sur API Key, puis comparez le volume d'appels de chaque clé pour repérer d'un coup d'œil celle qui est anormale :
- Granularité temporelle : minute (jusqu'à 1 jour), heure (jusqu'à 7 jours), jour (jusqu'à 31 jours) et mois (jusqu'à 12 mois) ; utilisez la granularité horaire pour localiser des appels soudains et coûteux.
- Retard des données : le nombre d'appels est disponible avec moins d'une minute de retard, la consommation de tokens et les coûts avec environ 10 minutes ; une utilisation abusive récente peut n'apparaître que plus tard, n'écartez donc pas une suspicion simplement parce qu'aucune donnée ne s'affiche encore.
- Les lignes de détail offrent l'action Consulter les coûts pour les montants associés ; pour l'aperçu des coûts et la comptabilisation des factures, voir Consulter l'aperçu des coûts et Interroger les factures.
Étape 3 : Consulter les journaux d'appels pour confirmer le comportement
Les journaux d'appels de Model Studio se répartissent en deux catégories, aux limites de capacité différentes ; distinguez-les pendant l'investigation.
Journaux d'audit
Les journaux d'audit sont activés par défaut et stockés côté plateforme, sans configuration requise, ce qui en fait l'outil principal de l'investigation ; consultez-les sur la page de surveillance des modèles :
- Champs enregistrés : Request ID, horodatage, modèle, consommation de tokens, latence, statut et code d'erreur, sans les contenus d'entrée et de sortie.
- Filtrage et recherche : filtrez par période (jusqu'à 30 jours), modèle, ID de clé API, statut et type d'inférence, ou recherchez par Request ID.
- Utilisation : confirmez si les appels de la clé pendant la fenêtre de fuite correspondent au comportement attendu, par exemple de forts volumes d'erreurs 4xx/5xx, des rythmes d'appel anormaux ou des appels à des modèles inconnus.
Journaux d'inférence
Les journaux d'inférence contiennent les prompts et réponses complets ainsi que les étapes intermédiaires (limite de 128K). Ils doivent être activés au préalable dans la livraison des données et livrés vers votre propre service de journalisation (SLS ; l'activation implique une autorisation de produit cloud et des frais de service de journalisation), et ne s'appliquent qu'aux données futures : les appels antérieurs à l'activation ne peuvent pas être reconstitués, et les journaux générés pendant une période de désactivation ne sont pas complétés a posteriori. Pour la méthode d'activation et les régions prises en charge, voir Activer les journaux d'inférence. Sans les journaux d'inférence, les appels antérieurs ne peuvent être examinés qu'au travers des informations au niveau des champs des journaux d'audit.
Limites du traçage
La plateforme peut aider à vérifier les comportements anormaux à partir des journaux d'appels, mais l'IP appelante, le modèle et les informations temporelles ne suffisent généralement pas à confirmer directement l'utilisateur réel ou le canal initial de la fuite ; un traçage plus poussé exige des éléments de preuve issus de vos dépôts de code, serveurs, terminaux et services tiers. Le livrable d'une investigation est une chaîne de preuves et une évaluation de l'impact, et non une conclusion d'imputation ; en cas d'activité illégale, conservez les preuves conformément à la loi et traitez-les par les canaux appropriés.
Étape 4 : Passer en revue l'historique des opérations de gestion
Les opérations de cycle de vie des clés API, telles que la création et la suppression, sont centralisées dans l'audit des opérations Alibaba Cloud (ActionTrail). Accédez à la page de requête d'événements de la console ActionTrail et filtrez par service (Model Studio) et plage temporelle :
- Recherchez les événements de création de la clé pour confirmer qui l'a créée et à quel moment, et vérifier la responsabilité associée.
- Recherchez les événements de suppression de la clé pour confirmer si des clés ont été supprimées autour de la fenêtre de fuite, par exemple par un attaquant ou un membre interne cherchant à effacer des traces.
Étape 5 : Évaluation des dommages, collecte de preuves et restauration
- Résumer les dommages : croisez la fenêtre anormale (courbes d'utilisation), les sources et statuts des appels (journaux d'audit) et les montants (factures) pour aboutir à une conclusion d'impact.
- Délimiter le périmètre d'impact : évaluez-le au regard de la portée d'autorisation de la clé. Détenir une clé API Model Studio n'équivaut ni à détenir le mot de passe du compte, ni à disposer de l'ensemble des permissions sur les ressources cloud ; l'impact réel se limite à la portée d'appels autorisée de la clé. Notez qu'une clé API Model Studio et une AccessKey (AK) Alibaba Cloud sont des identifiants distincts : en cas de fuite d'une AK, suivez plutôt le processus de traitement des AK de la RAM.
- Conserver des preuves masquées : lors de l'enregistrement de captures d'écran et de listes de Request ID, masquez les valeurs de clé et les ID de compte, et cessez de diffuser la clé complète par quelque canal que ce soit.
- Vérifier les tâches asynchrones : la suppression d'une clé n'annule pas les tâches asynchrones déjà soumises ; interrompez les tâches annulables et suivez les coûts de celles qui ne le sont pas.
- Déterminer le périmètre de rotation : invalidez et remplacez dès que possible les clés dont la fuite est confirmée ; pour les autres clés, appréciez selon l'étendue de l'exposition, et réinitialisez d'un même geste les clés conservées dans un même environnement exposé, en corrigeant celui-ci.
- Ordre de restauration : après avoir corrigé la source de la fuite en vous appuyant sur la liste des emplacements à risque, créez une clé dans un environnement de confiance en reconfigurant permissions et budget, mettez à jour les références d'identifiants des services, tâches et intégrations tierces, confirmez que la nouvelle clé fonctionne, puis vérifiez enfin que l'ancienne est devenue invalide.
FAQ
La clé divulguée est supprimée. Pourquoi reçois-je encore des alertes ?
La clé divulguée est supprimée. Pourquoi reçois-je encore des alertes ?
La même clé déclenche des alertes à répétition. Cela suffit-il à confirmer une fuite ?
La même clé déclenche des alertes à répétition. Cela suffit-il à confirmer une fuite ?
Une fuite s'est produite, mais je n'ai reçu aucune alerte de la plateforme. Pourquoi ?
Une fuite s'est produite, mais je n'ai reçu aucune alerte de la plateforme. Pourquoi ?
Pourquoi la console n'affiche-t-elle pas la clé complète ? Le support peut-il retrouver le texte en clair ?
Pourquoi la console n'affiche-t-elle pas la clé complète ? Le support peut-il retrouver le texte en clair ?
Je viens d'activer les journaux d'inférence. Pourquoi ne puis-je pas retrouver les entrées et sorties d'hier ?
Je viens d'activer les journaux d'inférence. Pourquoi ne puis-je pas retrouver les entrées et sorties d'hier ?
Les données de la page d'utilisation ne correspondent pas aux appels réels ?
Les données de la page d'utilisation ne correspondent pas aux appels réels ?
Les appels renvoient 429. S'agit-il d'une limitation de débit ou d'un arrêt sur budget ?
Les appels renvoient 429. S'agit-il d'une limitation de débit ou d'un arrêt sur budget ?
Puis-je exporter les journaux en masse pour mes propres analyses ?
Puis-je exporter les journaux en masse pour mes propres analyses ?
Comment déterminer si l'identifiant divulgué est une clé API Model Studio ou une AccessKey Alibaba Cloud ?
Comment déterminer si l'identifiant divulgué est une clé API Model Studio ou une AccessKey Alibaba Cloud ?