Conectando con Anthropic (NHI)
Last updated: September 28, 2026
Lo que estás configurando
Estás otorgando a Lumos acceso de solo lectura a una organización de Claude Console mediante la API de administración de Anthropic, para que pueda mostrar el inventario y el riesgo de identidades no humanas: agentes administrados y cuentas de servicio, las claves de API que se autentican como ellas, claves sin caducidad, claves vinculadas a una persona y los espacios de trabajo y Roles que delimitan a qué puede acceder cada una. No tienes que implementar nada de tu lado. Lumos genera la clave de firma utilizada para la Federación de identidades de carga de trabajo, por lo que nunca manejas una clave privada.
Conecta la organización donde se ejecutan tus cargas de trabajo de API, en platform.claude.com. Esto se aplica tanto si funciona de forma independiente como si está vinculada a una organización principal de Claude Empresa. Una organización de claude.ai no ejecuta cargas de trabajo de API, por lo que no tiene agentes, cuentas de servicio ni claves de API de Claude que esta integración pueda leer. En Claude Empresa, conecta cada organización de Console vinculada.
La configuración requiere hasta tres credenciales:
Credencial | Qué añade | Cuándo la necesitas |
|---|---|---|
Clave de API de la organización | Agentes, claves de API, espacios de trabajo, miembros y Roles | Siempre |
Federación de identidades de carga de trabajo | Cuentas de servicio y sus membresías en espacios de trabajo | Recomendado. Sin ella, Lumos no puede ver las cuentas de servicio. |
Clave de acceso de cumplimiento | Grupos y Roles de cumplimiento | Opcional. Solo para organizaciones vinculadas a una organización principal de Claude Empresa, y requiere federación. |
Lo que Lumos NO hace:
No realiza escrituras. Solo se registran capacidades de lectura. Lumos no puede crear, modificar, archivar ni eliminar un miembro, una cuenta de servicio, un agente, una clave de API, un espacio de trabajo o un Rol.
No accede a conversaciones, archivos ni sesiones. Lumos nunca llama a la API de Messages y, desde la API de cumplimiento, solo lee grupos, miembros de grupos y Roles de la organización.
No accede a secretos de claves. Anthropic muestra el valor completo de una clave una vez, al crearla, y nunca lo devuelve desde la API. Lumos recibe metadatos y una indicación redactada.
No accede a Datos de uso, gasto ni facturación. Las API de Usage and Cost, Analytics y Spend Limits nunca se llaman.
Requisitos previos
Necesitarás un administrador de la organización en la organización de Claude Console y su ID de organización. El ID es un UUID que se muestra en Settings Organization en Claude Console. Pégalo sin un org_ prefijo.
Para los Datos de cumplimiento, también necesitarás al propietario principal de la organización principal de Claude Empresa, quien crea la clave de acceso de cumplimiento en claude.ai. Primero debe habilitarse la API de cumplimiento. El propietario principal la activa en la configuración de la organización de claude.ai, y se aplica a todas las organizaciones vinculadas.
Paso 1: Crea la clave de API de la organización
Una clave de administrador (sk-ant-admin01-...) no funcionará, y tampoco una clave con ámbito de espacio de trabajo. Lumos rechaza una clave de administrador en el formulario de configuración antes de que puedas guardarla.
Inicia sesión en Claude Console como administrador de la organización.
Ve a Settings API keys y selecciona Create key.
Establece Linked account en una cuenta de servicio. Usa tu propia cuenta u otra cuenta de administrador solo si no existe ninguna cuenta de servicio. Una clave vinculada a una persona deja de funcionar cuando esa persona abandona la organización, y la conexión se detiene con ella.
Establece Scope en Organization.
Copia la clave.
Paso 2: Inicia la conexión en Lumos
En la aplicación de Lumos, ve a Integrations Add Integration y busca "Anthropic (NHI)". Se abre el cuadro de diálogo Connect to Anthropic (NHI) con tres secciones.
En Authentication Method, selecciona:
Organization API Key + Workload Identity Federation, sin Datos de cumplimiento
Organization API Key + Workload Identity Federation + Compliance Access Key, si añadirás Datos de cumplimiento en el Paso 4
En Capabilities and Integration Settings:
Establece Scope en Read. El campo tiene Read + Write como valor predeterminado, lo que aquí no concede nada, porque el conector no registra ninguna capacidad de escritura.
Organization ID es obligatorio. Pega el UUID de Requisitos previos.
Deja Enterprise Plan desactivado, aunque tengas un plan Claude Empresa. Activarlo impide que Lumos lea agentes, cuentas de servicio y claves de API.
Federation Rule ID, Service Account ID y Default Workspace ID provienen del Paso 3. Déjalos por ahora.
En Authentication Credentials:
Pega la clave del Paso 1 en Organization API Key.
En Workload Identity Federation, introduce un Key Identifier utilizando letras, números y guiones, como
lumos-anthropic-nhi. Selecciona Get Key y copia el JWK que muestra. Lumos genera el par de claves y conserva la parte privada. El JWK es la parte pública, que registrarás con Anthropic en el siguiente paso.
Mantén abierto el cuadro de diálogo si planeas configurar la Federación de identidades de carga de trabajo. De lo contrario, puedes pasar al Paso 5.
Paso 3: Configura la Federación de identidades de carga de trabajo en Anthropic
Las cuentas de servicio son lo único que Anthropic no devuelve a una clave de API. Necesitan un token de OAuth que contenga el ámbito org:admin , y la federación es la forma en que Lumos obtiene uno: firma una aserción de corta duración con la clave del Paso 2 y la intercambia por un token.
En Claude Console, con la sesión iniciada como administrador de la organización, ve a Settings Workload Identity Federation y selecciona Connect workload.
Crea el emisor:
En Issuer, selecciona Connect a new providery, a continuación, Custom OIDC.
Completa Name.
Establece Issuer URL (iss claim) en
https://lumos.com.Establece JWKS source en Inline keys.
Pega el JWK del Paso 2 en JWK set (JSON).
Deja Maximum token lifetime (hours) en 1.
Crea la regla de federación:
Completa Rule name utilizando letras minúsculas, números y guiones.
Establece la declaración Subject (sub) exactamente en
lumos:anthropic-nhi, sin ningún*final.En Habilitar en los espacios de trabajo, activa Todos los espacios de trabajo (incluidos los futuros).
Expande Opciones de reglas avanzadas.
Establece el alcance de OAuth en
org:admin.Establece la duración del token en 1 hora.
Elige el destino:
Selecciona Crear uno nuevo y asigna un nombre a la cuenta de servicio, como
lumos-anthropic-nhi, o elige una cuenta de servicio existente utilizada únicamente por este conector.El rol de organización del destino debe ser de administrador. Anthropic no concederá
org:adminmediante una regla dirigida a un desarrollador.
Copia el ID de regla de federación (comienza por fdrl_) y el ID de cuenta de servicio (comienza por svac_).
Paso 4: Crear la clave de acceso de cumplimiento (opcional)
Omite este paso a menos que la organización de tu Console esté vinculada a una organización principal de Claude Empresa y quieras grupos y roles de cumplimiento en Lumos. El cuadro de diálogo de Lumos puede permanecer abierto mientras lo haces.
El propietario principal de la organización matriz inicia sesión en claude.ai, va a Configuración de la organización > API, y crea una clave en Claves.
Concede
read:compliance_org_datayread:compliance_user_data.Copia la clave. Comienza por
sk-ant-api01-.
Los alcances se fijan al crear la clave, por lo que una clave a la que le falte uno debe reemplazarse. No concedas read:compliance_activities: Lumos no lee el feed de actividad.
Paso 5: Finalizar la conexión en Lumos
De vuelta en el cuadro de diálogo:
Pega el ID de regla de federación y el ID de cuenta de servicio en sus respectivos campos.
Si creaste una en el paso 4, pégala en Clave de acceso de cumplimiento.
Deja ID de espacio de trabajo predeterminado en
default.
Selecciona Validar, y después Completar.
Validar comprueba cada credencial contra Anthropic mediante llamadas en tiempo real. Confirma que la clave API de la organización pertenece al ID de organización que introdujiste, que la federación devuelve un token que contiene org:admin, y que la clave de acceso de cumplimiento puede leer grupos, miembros y roles de cumplimiento. Si una comprobación falla, indica qué está mal. Completar vuelve a ejecutar las mismas comprobaciones antes de guardar la conexión.
Conectar varias organizaciones
Una conexión cubre una organización, y una clave creada en una organización no puede leer otra. Si tienes varias organizaciones de Console, incluidas varias vinculadas a la misma organización principal de Claude Empresa, repite estos pasos para cada una.
Qué lee Lumos
Cada llamada se dirige a https://api.anthropic.com/v1. Todas son lecturas, excepto el intercambio del token de federación.
Punto de conexión | Credencial | Para qué sirve |
|---|---|---|
| Clave API de la organización | Comprobación de conexión e ID del inquilino |
| Clave API de la organización | Miembros y sus roles de organización |
| Clave API de la organización | Claves API como credenciales, con estado, creación y vencimiento, y la entidad principal que representa cada una |
| Clave API de la organización | Espacios de trabajo como recursos |
| Clave API de la organización | Asignaciones de roles de espacios de trabajo |
| Clave API de la organización | Agentes administrados como cuentas no humanas |
| Federación | Intercambia una afirmación firmada por un token de corta duración |
| Federación | Cuentas de servicio como cuentas no humanas, con sus roles de organización |
| Federación | Membresía de cuentas de servicio en espacios de trabajo |
| Clave de acceso de cumplimiento | Grupos de cumplimiento como recursos |
| Clave de acceso de cumplimiento | Membresía de grupos de cumplimiento |
| Clave de acceso de cumplimiento | Roles de cumplimiento como derechos |
Limitaciones de la API
Estas son limitaciones de lo que expone la API de Anthropic o de lo que la integración lee actualmente:
Las cuentas de servicio necesitan federación. Anthropic solo las proporciona mediante un token OAuth de
org:adminalcance. Sin federación, una clave API vinculada a una cuenta de servicio apunta a una cuenta que Lumos no ha leído.No existe una señal de último uso. Lumos informa cuándo se creó una clave, cuándo vence y su estado, pero no cuándo se utilizó por última vez. La marca de tiempo de actualización de un agente corresponde a su último cambio de configuración, no a su última ejecución.
Los agentes y las cuentas de servicio archivados aparecen como suspendidos, por lo que siguen visibles en el inventario.
Los datos de cumplimiento requieren Claude Empresa. Las claves de acceso de cumplimiento solo existen en inquilinos Empresa, por lo que una organización de Console independiente se conecta sin ellas.
Preguntas frecuentes de seguridad
¿Puede Lumos cambiar algo en nuestra organización de Anthropic?
No. Solo se registran capacidades de lectura. El intercambio del token de federación es el único POST que realiza el conector, y genera un token que Lumos usa únicamente para lecturas. Nada en el conector crea, actualiza ni elimina elementos.
¿Lee Lumos nuestras conversaciones, archivos o proyectos?
No. Nunca llama a la API de Messages y, desde la API de cumplimiento, llama a tres puntos de conexión de directorio: grupos, miembros de grupos y roles de organización. Nunca se llaman los puntos de conexión que devuelven contenido. read:compliance_user_data también cubre algunos puntos de conexión de contenido, porque así es como Anthropic agrupa sus alcances. Lumos lo necesita para los miembros de grupos y nunca llama al resto.
¿Puede Lumos leer los secretos de nuestras claves API?
No. Anthropic muestra el valor de una clave una sola vez, al crearla, y nunca lo devuelve desde la API. Lumos recibe metadatos y una indicación redactada.
¿Por qué la clave debe tener alcance de organización?
Una clave con alcance de espacio de trabajo solo ve su propio espacio de trabajo. Lumos lee todos los espacios de trabajo y los miembros y agentes de cada uno, por lo que necesita alcance de organización. Una clave de administrador también funcionaría con la API, pero Lumos la rechaza para que no entregues una credencial con acceso de escritura.
¿Por qué la federación necesita org:admin?
Anthropic no proporciona cuentas de servicio con ningún alcance más limitado. org:admin es amplio, así que esto es lo que lo limita: cada token dura como máximo una hora, solo puede generarse con la clave privada que Lumos creó y se utiliza únicamente para lecturas. Puedes desactivar la regla en cualquier momento.
¿Qué ocurre cuando la persona que creó la clave se va?
Una clave vinculada a una persona deja de funcionar, y la conexión se interrumpe con ella. Por eso el paso 1 indica que se vincule la clave a una cuenta de servicio.
¿Cómo se gestionan las credenciales?
Lumos almacena las claves de API que pegas y la mitad privada del par de claves de federación que generó. La clave privada nunca sale de Lumos y tú nunca la ves. Anthropic solo conserva el JWK público. Rotar una clave de API en Anthropic significa actualizarla en Lumos, porque la anterior deja de funcionar cuando la eliminas.
¿Cómo revocamos el acceso de Lumos?
Elimina las claves de API en la configuración de Console o en la configuración de la organización de claude.ai, y elimina o desactiva la regla de federación en Configuración Federación de identidades de carga de trabajo. La siguiente sincronización no podrá autenticarse y Lumos mostrará un error de conexión. No es necesario limpiar nada del lado de Anthropic, porque Lumos no creó nada allí.
Conexión rechazada con «Esta es una clave de API de administrador».
La clave comienza con sk-ant-admin01-. Crea una clave con el alcance establecido en Organización, como se describe en el Paso 1.
Conexión rechazada porque la clave pertenece a una organización diferente.
La clave y el ID de organización proceden de organizaciones diferentes. Corrige el ID de organización o pega una clave de la organización que querías usar.
«Anthropic no aceptó la afirmación firmada».
Comprueba que el conjunto de JWK del emisor contenga el JWK de Get Key, que la URL del emisor sea exactamente https://lumos.com, que la reclamación Subject sea exactamente lumos:anthropic-nhi, y que el ID de la regla de federación y el ID de la cuenta de servicio coincidan con los de la regla.
«La regla de federación concede ...; este conector necesita org:admin»."
El alcance de OAuth de la regla está establecido en otro valor. Cámbialo en las opciones avanzadas de la regla y confirma que la cuenta de servicio de destino aún tenga el rol de administrador de la organización.
«La clave de acceso de cumplimiento no puede leer los grupos de cumplimiento» (ni los Roles ni las membresías).
A la clave le falta un alcance. Crea una clave nueva con los alcances del Paso 2 y pega esa en su lugar. Si una clave con los alcances correctos sigue fallando, probablemente la API de cumplimiento aún no esté habilitada para tu tenant. Consulta con tu equipo de cuenta de Anthropic.
La conexión se guardó, pero no hay agentes, cuentas de servicio ni claves de API.
Comprueba que la configuración de integración del plan Empresa esté desactivada. Si lo está, confirma que conectaste una organización de Console, no una de claude.ai. Si aparecen agentes pero no cuentas de servicio, comprueba que la federación esté configurada y que la regla esté habilitada en todos los espacios de trabajo.
Algunos espacios de trabajo no tienen agentes administrados.
Managed Agents todavía no cubre todos los espacios de trabajo. Lumos omite un espacio de trabajo que no lo tenga, por lo que una brecha en el inventario de agentes suele indicar un espacio de trabajo sin agentes, no una conexión averiada.
¿Preguntas? Contacta con tu equipo de cuenta de Lumos o escribe a support@lumos.com.