Obtener acceso a la Compliance API

La Compliance API usa dos tipos de claves, y cuál debes crear depende de qué producto de Claude usa tu organización. Los propietarios principales crean Compliance Access Keys en claude.ai; estas claves desbloquean la Compliance API completa. Los administradores de la organización crean claves de Admin API en Claude Console; estas claves desbloquean únicamente el Activity Feed.

¿Qué clave necesitas?

Un tenant de Claude Enterprise tiene una organización principal que centraliza la identidad, el SSO y el SCIM para cada organización de carga de trabajo que está debajo de ella. Estas organizaciones de carga de trabajo son las organizaciones vinculadas de la principal.

Solicitar acceso a la Compliance API

Contacta a tu representante de Anthropic para solicitar acceso. La habilitación ocurre a nivel de la organización principal y se propaga a todas las organizaciones vinculadas, tanto de claude.ai como de Claude Console. Lo que cambia después de la habilitación depende de qué producto de Claude usa tu organización.

Después de la habilitación: organizaciones de claude.ai

Después de que Anthropic habilite la Compliance API para tu organización principal, el propietario principal puede crear Compliance Access Keys desde la sección Keys en claude.ai > Organization settings > API.

Después de la habilitación: organizaciones de Claude Console

Después de que Anthropic habilite la Compliance API para tu organización principal, las claves de Admin API creadas a partir de ese momento incluyen el scope read:compliance_activities. Las claves de Admin API creadas antes de la habilitación siguen funcionando con la Admin API, pero llamar al Activity Feed con una de ellas devuelve 403 Forbidden; crea una nueva clave de Admin API para obtener el scope.

Crear una Compliance Access Key

Crear una clave de Admin API

Las claves de Admin API incluyen el scope read:compliance_activities solo cuando la Compliance API se habilitó para la organización antes de que se creara la clave; consulta Después de la habilitación: organizaciones de Claude Console. No se les puede otorgar ningún otro scope de la Compliance API, por lo que las llamadas a cualquier endpoint que no sea el Activity Feed devuelven 403 Forbidden.

Para conocer el rol de esta misma clave en la administración de tu organización de Claude Console, consulta Admin API.

Verificar los scopes de tu clave

Para inspeccionar los scopes de una clave que ya tienes, usa una de las siguientes señales.

• Prefijo de la clave. sk-ant-admin01- es una clave de Admin API (incluye solo read:compliance_activities, sujeto al momento de habilitación descrito en la sección anterior). sk-ant-api01- es una Compliance Access Key; sus scopes son el subconjunto que seleccionaste al crearla.
• Interfaz de configuración. Abre la sección Keys en claude.ai > Organization settings > API, o la sección Admin keys en Claude Console > Settings > Admin keys, y lee la columna Scopes de la clave.
• Respuestas de error. Una llamada que excede los scopes de la clave devuelve un 403 con un mensaje en el formato Missing required scopes. Got: [<scopes the key carries>] Needed: [<scopes the endpoint requires>]. Consulta Manejar errores de la Compliance API para ver el catálogo completo de errores.

{
  "error": {
    "type": "permission_error",
    "message": "Missing required scopes. Got: ['read:compliance_activities'] Needed: ['read:compliance_user_data']"
  }
}

Administrar y rotar claves

Elimina una Compliance Access Key desde la misma tabla Keys donde la creaste: ve a claude.ai > Organization settings > API. Elimina una clave de Admin API desde Claude Console > Settings > Admin keys.

La eliminación de una clave surte efecto en la siguiente solicitud: no hay período de gracia. Las Compliance Access Keys no expiran por sí solas.

Para rotar una clave sin interrupciones:

1. Crea una nueva clave con los mismos scopes.
2. Actualiza tu integración para usar la nueva clave.
3. Verifica que la integración funcione correctamente con la nueva clave.
4. Elimina la clave anterior.

Los cursores de paginación almacenados antes de una rotación siguen siendo válidos: los cursores están asociados a la organización, no a la clave.

Si una Compliance Access Key se filtra, elimínala de inmediato, audita el Activity Feed en busca de actividades compliance_api_accessed realizadas por la clave comprometida, y rota cualquier credencial posterior a la que la clave filtrada pudiera acceder. Pasa activity_types[]=compliance_api_accessed para delimitar la consulta y luego, en tu cliente, conserva las actividades cuyo actor.type sea api_actor y cuyo actor.api_key_id coincida con la clave comprometida; consulta Entender el objeto Activity para ver el esquema del actor.

Próximos pasos