Intramedial está en beta restringida. Al registrarte o iniciar sesión, debes indicar la contraseña de beta tester que recibiste o solicitar una en preview@intramedial.com. Gracias.
Cargando…
identity.enrollMódulo 12
Módulo de la plataforma
Agent identity registry
Da a cada agente su propia identidad antes de que actúe, para que toda acción admitida se remonte a un agente y nunca a una cuenta compartida.
identity.enroll registra a un agente en el registro del workspace por su DID, un nombre visible y un tipo. Donde hay un runtime de identidad vinculado, también emite el DID propio del agente, y cada agente empieza con un perfil de confianza en la puntuación base de 50. Los ID SPIFFE y los usuarios SCIM se asocian al mismo registro.
Los agentes actúan cuando el plano dice sí, y el registro dice por qué.
Pasa por Intramedial acciones de agentes, hashes de contenido, pruebas de API, DNS, webhooks, llamadas LLM y commits. Obtén un recibo firmado que cualquiera verifica, sin fiarse de nadie.
El DID que el runtime de identidad emitió para este agente, cuando se emitió uno.
spiffeId
El ID SPIFFE vinculado con identity/spiffe, una vez vinculado.
owner
La cuenta notificada cuando cambia el nivel de autonomía del agente. Opcional.
enrolledAt
Cuándo se registró el agente, como marca de tiempo ISO.
shadow
true cuando el agente está en seguimiento pero aún no autorizado, la marca que ofrece mcp.shadow.
skipped
true cuando no se emitió ningún DID, algo que solo ocurre en un worker sin runtime de identidad.
Mecanismo
Paso a paso
Cómo funciona
Nombra al agente
Envía did y displayName. kind es customer, partner o house y por defecto customer. owner nombra la cuenta a notificar cuando cambia el nivel de confianza del agente.
Se emite una identidad
Cuando el runtime de identidad está vinculado, emite un DID para el agente, devuelto como issuedDid. Si el runtime rechaza o no responde, el registro se rechaza y no se guarda nada.
Se escriben el registro y un perfil
El agente entra en el registro del workspace, y su DID y su DID emitido reciben cada uno un perfil de confianza con puntuación 50.
Otras identidades se asocian
Un ID SPIFFE se vincula con identity/spiffe, los usuarios SCIM llegan por identity/scim, y las raíces de confianza y delegaciones A2A pasan por identity/a2a.
Pruébalo
Demo en vivo
Ejecútalo desde esta página
GET/api/v1/acp/identity/list
// Sin cuerpo: esto es un GET. Pulsa Ejecutar.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado. Docs de identity.enroll
Respuestas
Pulsa Ejecutar para enviar la solicitud de la izquierda al workspace de demostración compartido.
Se ejecuta en un workspace de demostración compartido con una clave de demostración: cualquiera puede ver lo que contiene, así que no envíes nada privado.
Código
Ejemplo en vivo
Una petición real
Una petición con la forma que acepta la API y una respuesta de ejemplo con la forma que devuelve el módulo.
Un agente de facturación se registra una vez. Toda admisión, lease y aprobación posterior nombra su DID, nunca una cuenta de servicio compartida.
Traer un directorio
Los recursos SCIM se convierten en agentes de cliente. Un desaprovisionamiento con active: false elimina el agente vinculado y recupera su DID emitido.
Dos agentes, un binario
Un DID nuevo es un agente nuevo, aunque el código sea el mismo. Tiene su propia puntuación de confianza y no hereda historial.
Autorizar a un agente suelto
Un agente visto en la pasarela MCP pero nunca registrado se registra con shadow: true para seguirlo, o sin ello para autorizarlo.
Cuándo usar otra cosa
Decidir qué puede hacer un agente. El registro da una identidad, no un grant; los grants salen de los mandatos compilados en mandates.compile.
Leer hasta dónde se confía en un agente. El registro parte de la puntuación base; trust.get muestra en qué punto está ahora.
Importar una flota entera desde una exportación. Usa onramp.sources para planificar y aplicar muchos agentes de una sola vez.
Evidencia
Garantías
Qué hace y qué no hace
Un módulo es una afirmación fuerte sobre algo acotado. Confía en él exactamente para lo que es.
Hace
Cada DID registrado tiene un registro en su workspace, y un workspace nunca resuelve los agentes de otro.
Con un runtime de identidad vinculado, un registro para el que no puede emitir un DID se rechaza en lugar de guardarse sin él.
El runtime nunca reemite un DID desactivado. El agente recibe el siguiente id nuevo derivado del suyo y un DID emitido propio.
El desaprovisionamiento por SCIM devuelve el perfil de confianza del agente a la base, así que un DID reciclado no hereda ninguna puntuación.
No hace
Que quien llama controle la clave tras el DID. El registro anota el DID presentado y no ejecuta ningún desafío.
Quién responde del agente. owner es la cuenta que nombre quien registra, y es opcional.
Que el agente se porte bien. Un agente nuevo parte de la puntuación base de 50, que no dice nada de su conducta.
Un historial de cambios de clave. El registro no guarda ninguno; la rotación corresponde al runtime de identidad.
Detalles
Notas de construcción
Antes de construir
Quién puede registrar
Registrar necesita el permiso agents.create. La matriz se lo da a propietarios y administradores, y un token lo lleva solo si sus scopes lo incluyen.
Límites del plan
Cuando la organización ya tiene los agentes que incluye su plan, el runtime de identidad rechaza el DID con un 402 y el registro se rechaza con él.
La baja se reintenta con seguridad
Si el runtime de identidad falla en un paso de un desaprovisionamiento SCIM, la petición falla con todos los agentes aún registrados. Cada paso es idempotente, así que el reintento del proveedor de identidad lo completa.
Límites y medición
Un enroll o llamada SCIM correctos cuentan contra el contador identity_active_agents.
displayName es obligatorio, y la acción MCP lo limita a 200 caracteres.
Cuando un DID emitido se desactivó, el registro prueba hasta 8 ids de agente derivados antes de rendirse.
Acceso
API y MCP
REST y MCP
Autentícate con una clave de API del workspace como token Bearer. La URL base es https://api.intramedial.com.
Endpoints REST
POST/api/v1/acp/identity/enrollRegistra un agente y devuelve su registro.
GET/api/v1/acp/identity/listLista los agentes registrados del workspace.
Acciones MCP
MCPcoordination.identity.enrollRegistra un agente como acción MCP.
MCPcoordination.identity.listLista los agentes registrados del workspace como acción MCP.
Módulo de la plataforma
