Skip to main content

Investigación de fugas de claves de API

Ruta de investigación tras una sospecha de fuga de clave de API: localice y desactive la clave filtrada para contener el daño, identifique los periodos anómalos a partir del uso y de los costos, confirme el comportamiento de las llamadas con los registros de auditoría e inferencia, revise las operaciones de gestión con ActionTrail y complete la evaluación del daño, la recopilación de evidencias y la rotación para la recuperación.

Enfoque de la investigación

Si la fuga está confirmada, vaya primero a la página de gestión de claves de API y restablezca o elimine la clave filtrada para contener el daño de inmediato; después siga los pasos de esta página para evaluar el impacto. Si no está seguro de que haya fuga, comience por la verificación del uso del segundo paso. Una investigación de fugas responde a cinco preguntas, y cada pregunta corresponde a una fuente de información de la consola:

Pregunta a responder

Dónde consultar

Qué se obtiene

¿Qué clave se ha filtrado? ¿Quién la creó? ¿Cuál es su estado actual?

Página de gestión de claves de API

ID de clave, clave enmascarada, descripción, cuenta propietaria, hora de creación; acciones de restablecer, editar, eliminar y ver costos

¿Cuánto se ha llamado a esta clave y cuánto ha costado?

Uso de modelos, descripción general de costos y facturas

Número de llamadas, uso de tokens, curvas de uso por día e importes agrupados por clave de API

¿Desde dónde se llamó, a qué modelos y con qué resultado?

Registros de auditoría

ID de solicitud, hora, modelo, uso de tokens, latencia, código de estado, código de error; filtrable por clave de API

¿Cuál fue la entrada y la salida de las llamadas?

Registros de inferencia (deben activarse por adelantado)

Prompts y respuestas completos (hasta 128K)

¿Qué operaciones de gestión ha tenido la clave?

ActionTrail (auditoría de operaciones)

Registros de eventos de operaciones a nivel de consola y OpenAPI

Se recomienda avanzar en el siguiente orden:
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

Paso 1: Localizar y desactivar la clave filtrada

Vaya a la página API Key de Alibaba Cloud Model Studio y seleccione la región en la esquina superior derecha: las claves de cada región son independientes y no se pueden utilizar entre regiones. Cuando la fuga esté confirmada, priorice restablecer o eliminar la clave para contener el daño de inmediato; editar para reducir permisos solo encaja en los escenarios en los que aún no se puede confirmar la fuga y se necesita un periodo de observación. Localice la clave objetivo en la lista de claves de API y utilice las acciones de su fila:
  • Restablecer: emite un valor nuevo para la clave y el valor antiguo deja de ser válido de inmediato.
  • Editar: reduce los permisos (lista blanca de IP, alcance de modelos); consulte Prácticas recomendadas para prevenir fugas de claves de API.
  • Eliminar: surte efecto de inmediato y es irreversible.
  • Ver costos: salta a la vista de costos y uso de la clave.
En esta página puede consultar la información de identidad de la clave: ID de clave, clave de API enmascarada (por ejemplo sk-ws-H.YHXL****PgonKozeC4RM-Nm), descripción, cuenta propietaria y hora de creación. La descripción y la cuenta propietaria son las primeras pistas para localizar la aplicación o el responsable al que pertenece la clave; el texto completo normalmente no se puede consultar: las claves nuevas se muestran completas una sola vez en el momento de la creación, mientras que algunas claves de versiones antiguas aún se pueden copiar directamente desde la lista, según lo que la lista ofrezca realmente. Durante la investigación, compare utilizando el valor enmascarado, el ID y la descripción.
Eliminar una clave no cancela las tareas asíncronas asociadas: las tareas asíncronas que no han terminado de ejecutarse seguirán ejecutándose y generando costos, y deben terminarse por separado; consulte Descripción de la facturación de tareas asíncronas con pagos vencidos. Durante la investigación, también puede activar para esa clave la opción de presupuesto "detener inmediatamente al alcanzar el presupuesto" como segunda contención; consulte Gestión de presupuestos.
Tenga en cuenta dos errores frecuentes al gestionarla:
  1. Crear una clave nueva no invalida automáticamente la clave antigua; la clave antigua debe gestionarse por separado.
  2. No devuelva la clave nueva a un entorno sospechoso cuya investigación no haya terminado; de lo contrario, equivale a volver a entregar la credencial nueva.

Paso 2: Comprobar el uso y los costos para localizar el periodo anómalo

La señal más directa de una fuga son llamadas o costos que no deberían existir. En la consola de Model Studio, vaya a Costo y uso > Uso de modelos, establezca la dimensión de agrupación en Clave de API y compare el volumen de llamadas de cada clave para detectar de un vistazo cuál es anómala:
  • Granularidad temporal: minuto (hasta 1 día), hora (hasta 7 días), día (hasta 31 días) y mes (hasta 12 meses); utilice la granularidad horaria para localizar llamadas repentinas de alto costo.
  • Retraso de los datos: el número de llamadas se retrasa unos 1 minuto como máximo, el uso de tokens y los costos unos 10 minutos; el abuso reciente puede reflejarse más tarde, así que no descarte la sospecha solo porque todavía no haya datos.
  • Las filas de detalle permiten hacer clic en Ver costos para consultar los importes asociados; para la descripción general de costos y la contabilidad de facturas, consulte Ver la descripción general de costos y Consultar facturas.
Para las definiciones de las métricas y los detalles de las operaciones, consulte Ver el uso de modelos. Descarte primero las fluctuaciones normales del negocio: compare la hora, los modelos y el volumen de llamadas anómalos con los lanzamientos, los trabajos por lotes, las pruebas de estrés y las tareas programadas del negocio, y compruebe si ha cambiado la región de despliegue, la IP de salida o las herramientas de terceros del servicio que utiliza la clave. Las IP extranjeras, las IP nuevas y los picos de uso son señales que deben verificarse, no pruebas concluyentes de una fuga. Ajuste la contención al nivel de sospecha: ante una simple notificación de alerta o una anomalía leve, compruebe primero el origen de las llamadas en los registros de auditoría; cuando la curva de uso confirme la existencia de llamadas desde orígenes desconocidos, restablezca o elimine la clave de inmediato y continúe con la recopilación de evidencias. Se recomienda tomar la hora de confirmación de la fuga como punto final y mirar hacia atrás 7 días (granularidad horaria) y 31 días (granularidad diaria) para comparar la línea base histórica de la clave; la ventana temporal anómala localizada es el alcance de la investigación de registros posterior.

Paso 3: Comprobar los registros de llamadas y confirmar el comportamiento

Los registros de llamadas de Model Studio se dividen en registros de auditoría y registros de inferencia, con límites de capacidad distintos; distinga ambos durante la investigación.

Registros de auditoría

Los registros de auditoría están activados de forma predeterminada y se almacenan en el lado de la plataforma sin necesidad de configuración, por lo que son la herramienta principal de la investigación; pueden consultarse en la página de monitoreo de modelos:
  • Campos registrados: ID de solicitud, hora, modelo, uso de tokens, latencia, estado, código de error; no incluyen el contenido de entrada ni de salida.
  • Filtrado y búsqueda: filtrar por hora (hasta 30 días), modelo, ID de clave de API, estado, tipo de inferencia, o buscar por ID de solicitud.
  • Utilidad: confirmar si las llamadas de la clave dentro de la ventana de fuga corresponden al comportamiento esperado, por ejemplo grandes volúmenes de 4xx/5xx, un ritmo de llamadas anómalo o registros de llamadas a modelos desconocidos.
Para el método de uso, consulte Registros.

Registros de inferencia

Los registros de inferencia contienen los prompts y las respuestas completos, así como los pasos intermedios (hasta 128K); deben activarse por adelantado en la entrega de datos y entregarse a su propio servicio de registros (SLS; la activación implica la autorización de productos en la nube y los costos del servicio de registros), y solo se aplican a los datos futuros: las llamadas históricas anteriores a la activación no se pueden rastrear y los registros generados durante el periodo de desactivación no se recuperan. Para el método de activación y el soporte por región, consulte Activar los registros de inferencia. Si no se han activado los registros de inferencia, las llamadas anteriores solo se pueden investigar mediante la información a nivel de campos de los registros de auditoría.

Límites del rastreo

La plataforma puede ayudar a verificar los comportamientos anómalos a partir de los registros de llamadas, pero la información de IP, modelo y hora de las llamadas normalmente no basta para confirmar directamente al usuario real o al canal original de la fuga; el rastreo posterior requiere evidencias de su lado: repositorios de código, servidores, terminales y servicios de terceros. El entregable de la investigación es la cadena de evidencias y el alcance del impacto, no una conclusión de atribución de responsabilidad; ante actividades ilegales, conserve las evidencias conforme a la ley y tramítelas por los canales apropiados.

Paso 4: Comprobar el historial de operaciones de gestión

Las operaciones del ciclo de vida de las claves de API, como la creación y la eliminación, se recopilan de forma unificada en la auditoría de operaciones de Alibaba Cloud (ActionTrail). Vaya a la página de consulta de eventos de la consola de ActionTrail y filtre por servicio (Model Studio) y rango de tiempo:
  • Busque los eventos de creación de la clave para confirmar quién la creó y cuándo, y verificar la responsabilidad de propiedad.
  • Busque los eventos de eliminación de la clave para confirmar si alguien eliminó claves antes o después de la ventana de fuga, por ejemplo un atacante o un interno que intenta borrar huellas.
Confirme primero el estado de la clave y el historial de operaciones mediante la auditoría de operaciones y, a continuación, investigue el comportamiento concreto con los registros de llamadas.

Paso 5: Evaluación del daño, recopilación de evidencias y recuperación

  1. Resumir el daño: la ventana temporal anómala (curvas de uso) más el origen y el estado de las llamadas (registros de auditoría) más los importes (facturas) forman la conclusión del alcance del impacto.
  2. Delimitar el alcance del impacto: evalúe según el alcance de autorización de la clave. Poseer una clave de API de Model Studio no equivale a obtener la contraseña de la cuenta ni los permisos sobre todos los recursos de la nube; el impacto real se limita al alcance de llamadas autorizado de la clave. Tenga en cuenta que la clave de API de Model Studio y la AccessKey (AK) de Alibaba Cloud no son el mismo tipo de credencial: si lo que se filtró es una AK, debe seguir el proceso de gestión de AK de RAM.
  3. Conservar evidencias enmascaradas: al guardar capturas de pantalla y listas de IDs de solicitud, enmascare los valores de las claves y los ID de cuenta, y no vuelva a difundir la clave completa por ningún canal.
  4. Comprobar las tareas asíncronas: eliminar la clave no cancela las tareas asíncronas ya enviadas; finalice las tareas cancelables y realice un seguimiento de los costos de las no cancelables.
  5. Determinar el alcance de la rotación: las claves con fuga confirmada deben invalidarse y sustituirse cuanto antes; las demás claves se valoran según el alcance de exposición, y las que se guardan en el mismo entorno ya expuesto se rotan conjuntamente junto con la corrección del entorno.
  6. Orden de recuperación: tras corregir el origen de la fuga con la lista de ubicaciones de alto riesgo, cree una clave nueva en un entorno de confianza y vuelva a configurar los permisos y el presupuesto, actualice las referencias de credenciales de los servicios, tareas e integraciones de terceros, confirme que la clave nueva funciona correctamente y verifique finalmente que la clave antigua ya no es válida.
Antes de aclarar por completo los costos anómalos, no se limite a aumentar el presupuesto ni a restaurar las llamadas tras desactivar la contención; complete primero la investigación anterior para confirmar que el origen de la fuga está corregido.

Preguntas frecuentes

La detección y la notificación presentan diferencias de tiempo, y no se puede juzgar si la anomalía continúa solo por la hora de la notificación; los eventos históricos también pueden descubrirse y notificarse durante comprobaciones posteriores. Recibir una notificación no equivale a que la clave antigua aún pueda llamar con éxito: si ya ha gestionado la clave antigua y el uso reciente no presenta anomalías, puede verificar la hora de la llamada y el identificador de la clave correspondientes a la notificación e ignorarla.
No se puede confirmar la fuga solo por el número de repeticiones. Compruebe la hora de la llamada, el identificador de la clave y el contenido anómalo correspondientes a cada alerta, y distinga entre llamadas de nueva aparición, notificaciones repetidas del mismo evento y registros históricos.
La detección de riesgos de la plataforma y sus alertas son una capacidad que la plataforma ofrece de forma proactiva; no está incluida en el alcance de los servicios acordado en el SLA y, debido a la complejidad de los escenarios de riesgo, no se garantiza una cobertura absoluta de las alertas; la custodia segura y el uso conforme de las credenciales corresponden a su ámbito de responsabilidad. No recibir alertas no significa que no exista riesgo de fuga: complete primero la investigación y la gestión de las claves con fuga sospechosa siguiendo los pasos de este documento y, a continuación, compruebe la causa de que la alerta no se haya entregado combinando la hora de la anomalía con los registros de notificaciones.
No. Las claves nuevas se muestran completas una sola vez en el momento de la creación y después ya no se pueden ver ni copiar (algunas claves de versiones antiguas aún se pueden copiar directamente desde la lista, según lo que la lista ofrezca realmente).
Los registros de inferencia solo se aplican a los datos futuros y los datos históricos no se pueden rastrear. Las llamadas anteriores solo se pueden investigar mediante la información a nivel de campos de los registros de auditoría.
El uso de tokens y los costos presentan un retraso de unos 10 minutos; además, la página de uso solo contabiliza las llamadas de pago por uso basadas en tokens, y el entrenamiento de modelos, el rendimiento aprovisionado (PTU), etc., no se incluyen. El número de fallos, los errores de limitación de tasa y otras métricas se consultan en la página de monitoreo de modelos.
Ambas situaciones devuelven 429. El mensaje de error de presupuesto agotado es "El presupuesto configurado en Gestión de presupuestos se ha agotado..."; consulte Códigos de error. El 429 por limitación lo disparan la limitación de tasa o los límites de cuota; puede distinguirlos consultando la métrica de número de errores de limitación en el monitoreo de modelos.
Para sus necesidades de análisis propio, entregue los registros a su propio almacén de registros SLS y realice en él la búsqueda y la exportación; consulte Entrega de datos.
No son el mismo tipo de credencial: la clave de API de Model Studio solo se utiliza para acceder a los servicios de modelos dentro de su alcance de autorización; la AccessKey de Alibaba Cloud se utiliza para la autenticación de identidad en las API de la nube, con permisos determinados por la cuenta y la configuración de autorizaciones. Confirme primero el tipo de credencial filtrada y vaya después a la entrada de gestión del producto correspondiente; no mezcle los procesos.