Skip to main content

Investigation sur les fuites de clé API

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

Avancez dans l'ordre suivant :
Suspected leak
  ├─ Step 1: locate the key and immediately reset or delete it (containment)
  ├─ Step 2: identify anomalous periods from usage and cost curves
  ├─ Step 3: confirm call sources and behavior in audit logs (input and output available if inference logs were enabled)
  ├─ Step 4: review management operations such as key creation and deletion
  └─ Step 5: summarize the damage, rotate credentials, and fix the leak source

É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é.
Cette page présente les informations d'identité de la clé : ID de clé, clé API masquée (par exemple sk-ws-H.YHXL****PgonKozeC4RM-Nm), description, compte propriétaire et date de création. La description et le compte propriétaire sont les premiers indices pour identifier l'application ou le responsable de la clé ; le texte en clair complet n'est généralement plus consultable : une nouvelle clé n'est affichée intégralement qu'une seule fois à sa création, tandis que certaines clés d'anciennes versions peuvent encore être copiées directement dans la liste, selon les capacités réellement proposées. Pour l'identification, appuyez-vous sur la valeur masquée, l'ID et la description.
La suppression d'une clé n'annule pas les tâches asynchrones associées : les tâches non terminées continuent de s'exécuter et génèrent des frais, et doivent être interrompues séparément ; voir Facturation des tâches asynchrones en cas de retard de paiement. Pendant l'investigation, vous pouvez aussi activer pour cette clé l'option « Arrêter le service lorsque le budget est atteint » en guise de seconde mesure d'endiguement ; voir Gestion du budget.
Deux erreurs fréquentes à éviter lors du traitement :
  1. 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.
  2. 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.
Pour les définitions des métriques et le détail des opérations, voir Consulter l'utilisation des modèles. Commencez par écarter les fluctuations normales de l'activité : comparez les horaires, modèles et volumes d'appels anormaux avec les mises en production, les traitements par lots, les tests de charge et les tâches planifiées, et vérifiez si la région de déploiement, les IP de sortie ou les outils tiers utilisant la clé ont changé. Des IP étrangères, des IP nouvelles et des pics d'utilisation sont des signaux qui appellent une vérification, et non des preuves concluantes de fuite. Ajustez la réponse au niveau de suspicion : en cas de simple notification d'alerte ou d'anomalie légère, vérifiez d'abord les sources des appels dans les journaux d'audit ; dès que la courbe d'utilisation confirme des appels depuis des sources inconnues, réinitialisez ou supprimez immédiatement la clé avant de poursuivre la collecte de preuves. En prenant l'heure de confirmation de la fuite comme point d'arrivée, examinez les 7 jours précédents (granularité horaire) et les 31 jours précédents (granularité quotidienne) pour comparer la base historique de la clé ; la fenêtre anormale ainsi cernée délimite le périmètre de l'investigation ultérieure dans les journaux.

É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.
Pour le mode d'emploi, voir Journaux.

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.
Confirmez d'abord l'état de la clé et l'historique des opérations via ActionTrail, puis instruisez les comportements précis avec les journaux d'appels.

Étape 5 : Évaluation des dommages, collecte de preuves et restauration

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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.
Avant que les coûts anormaux ne soient intégralement élucidés, n'augmentez pas simplement le budget et ne reprenez pas les appels après avoir désactivé les mesures d'endiguement ; achevez d'abord l'investigation ci-dessus pour confirmer que la source de la fuite est corrigée.

FAQ

La détection et la notification comportent des écarts temporels, et l'heure d'une notification ne suffit pas à déterminer si l'anomalie se poursuit ; des événements historiques peuvent aussi n'être découverts et notifiés que lors de contrôles ultérieurs. Recevoir une notification ne signifie pas que l'ancienne clé peut encore appeler avec succès : si l'ancienne clé a été traitée et que l'utilisation récente est normale, vérifiez l'heure d'appel et l'identifiant de clé indiqués dans la notification, puis ignorez-la.
Le seul nombre de répétitions ne suffit pas à confirmer une fuite. Vérifiez, pour chaque alerte, l'heure des appels, l'identifiant de clé et le contenu de l'anomalie, afin de distinguer les appels nouveaux, les notifications répétées d'un même événement et les enregistrements historiques.
La détection des risques et les alertes de la plateforme sont une capacité fournie à titre proactif par la plateforme, hors du périmètre des services couverts par la SLA et, compte tenu de la complexité des scénarios de risque, sans garantie d'une couverture d'alerte absolue ; la conservation sécurisée et l'utilisation conforme des identifiants relèvent de votre responsabilité. L'absence d'alerte ne signifie pas l'absence de risque de fuite : suivez d'abord les étapes de cette page pour localiser et traiter la clé présumée divulguée, puis vous appuyez sur l'heure de l'anomalie et l'historique des notifications pour déterminer pourquoi l'alerte n'a pas été délivrée.
Non. Une nouvelle clé n'est affichée intégralement qu'une seule fois, à sa création, et ne peut plus ensuite être consultée ni copiée en clair (certaines clés d'anciennes versions peuvent encore être copiées directement dans la liste, selon les capacités réellement proposées).
Les journaux d'inférence ne s'appliquent qu'aux données futures ; les données historiques ne peuvent pas être reconstituées. Les appels antérieurs ne peuvent être examinés qu'au travers des informations au niveau des champs des journaux d'audit.
La consommation de tokens et les coûts présentent environ 10 minutes de retard ; par ailleurs, la page d'utilisation ne comptabilise que les appels au paiement à l'usage facturés par token, à l'exclusion de l'entraînement de modèles et du débit préprovisionné (PTU). Le nombre d'échecs et les erreurs de limitation de débit se consultent sur la page de surveillance des modèles.
Les deux cas renvoient 429. Le message d'erreur d'un budget épuisé est "The budget configured in Budget Management has been exhausted..." ; voir Codes d'erreur. Un 429 de limitation de débit est déclenché par la limitation de débit ou de quota ; distinguez-les grâce à la métrique du nombre d'erreurs de limitation de débit dans la surveillance des modèles.
Pour vos propres analyses, livrez les journaux vers votre propre magasin de journaux SLS, puis effectuez-y vos recherches et exports ; voir Livraison des données.
Ce sont deux identifiants distincts : une clé API Model Studio n'accède qu'aux services de modèles couverts par ses autorisations ; une AccessKey Alibaba Cloud sert à l'authentification des appels d'API cloud, ses permissions étant déterminées par le compte et la configuration des autorisations. Confirmez d'abord le type d'identifiant divulgué, puis rendez-vous à l'entrée de gestion du produit correspondant ; ne mélangez pas les deux processus.