claudio.cool
CCDV-PLecciones

CCDV-P · Guardrails en ejecución y seguridad en producción

Identidad del agente, secretos sin claves estáticas y auditoría

⏱ 4 min de lecturaBorrador

Una empresa tiene quince agentes en producción. Todos usan la misma clave de API de Anthropic, guardada como variable de entorno en cada servicio y también en dos repositorios, y todos se conectan a la base con la cuenta de un empleado que ya se fue. Cuando una clave se filtra, nadie sabe de qué agente salió, ni qué hizo, ni cuántos sistemas hay que actualizar para rotarla.

Identidad del agente

Un agente es una carga de trabajo con permisos. Su identidad (agent identity) tiene que ser propia, no la de una persona ni una cuenta compartida:

  • una identidad por agente y por entorno (producción, pruebas), para atribuir y revocar de forma individual;
  • permisos asociados a esa identidad y no heredados de quien lo lanzó;
  • cuando el agente actúa en nombre de un usuario, se distingue: qué puede hacer el agente en sí y qué puede hacer ese usuario, y se aplica la intersección.

Así, ante un incidente, se puede revocar a un agente sin parar a los demás, y el registro dice quién fue.

Reemplazar claves estáticas

Una clave estática de larga vida es un secreto que se copia, se filtra y no vence. La federación de identidad de cargas de trabajo (workload identity federation) cambia el modelo: la carga se identifica con una credencial que le da su plataforma (un token firmado del orquestador, de la nube o del sistema de CI) y la intercambia por una credencial de corta vida y de alcance limitado. No hay un secreto de larga vida guardado que robar. Ejemplos: en una nube, los roles de servicio asignados a la carga; en CI, tokens OIDC por ejecución. Cuando una clave estática es inevitable (por ejemplo, la clave de API de un proveedor que no federa), se trata como el secreto más cuidado: ver más abajo. Verificá en la documentación de Anthropic y de tu nube qué mecanismos de federación están disponibles para tu forma de despliegue.

Gestión de secretos

  • Los secretos viven en un gestor de secretos (secrets manager) y se inyectan en tiempo de ejecución; no van en el código, en el prompt, en el contexto del modelo, en logs ni en el repositorio.
  • Rotación periódica y ante sospecha, automatizada, para que rotar no signifique un incidente.
  • Una clave por entorno y por aplicación, con límites de gasto cuando el proveedor lo permite.
  • El modelo nunca necesita ver un secreto: la herramienta lo usa del lado del servidor y devuelve solo el resultado. Un secreto en el contexto puede terminar en una salida, un log o una exfiltración.
  • Escaneo de secretos en el repositorio y en los logs.

Mínimo privilegio por herramienta

Cada herramienta recibe el permiso más chico que le permite hacer su trabajo: una consulta de solo lectura con filtro por cuenta, una escritura limitada a una tabla, un token con alcance a un recurso. Los permisos se evalúan por llamada, en el servidor de la herramienta, y no se confía en lo que el agente dice que va a hacer. Las acciones de mayor riesgo agregan aprobación.

Auditoría

El registro de auditoría (audit logging) de un agente guarda las acciones relevantes para la seguridad: identidad del agente y del usuario, herramienta y argumentos relevantes, resultado, aprobaciones, denegaciones, cambios de permisos, hora y un identificador que lo une a la traza. Requisitos:

  • Inmutable o con control de integridad, y con acceso y retención definidos (con las normas aplicables);
  • sin secretos ni datos personales innecesarios en el contenido registrado;
  • registra también los rechazos, que muestran intentos;
  • se revisa y alerta ante patrones: un agente que accede a lo que nunca accedió, a horarios raros, o volúmenes inusuales.

Las trampas típicas

  • Una clave compartida por todos los agentes y entornos.
  • Claves en el repositorio, en variables de entorno de larga vida o en el prompt.
  • Agentes que usan la cuenta personal de alguien.
  • Auditar solo los éxitos.
  • Registrar el contenido completo (con secretos o datos personales) en los logs de auditoría.

En el examen

Ante una clave filtrada o difícil de rotar, buscá identidad propia por agente y credenciales de corta vida por federación. Ante “quién hizo qué”, el registro de auditoría con identidad individual. Descartá soluciones que dejan el secreto en el contexto del modelo o en el prompt.

Pregunta rápida

Una pregunta del simulacro sobre este dominio. Cuenta para tu progreso.

A company runs Claude-powered review agents from its CI system across 60 repositories. All pipelines use the same long-lived API key stored as a repository secret, and the key has been copied into several local developer environments for debugging. Last month a contractor left the company and nobody was sure whether the key had been exposed, so the team had to rotate it everywhere during a weekend.

Security wants to remove the static credential and make it possible to know which workload made each request.

Which approach best fits enterprise identity practice?

Practicá este dominio en el simulacro →