O Intramedial está em beta restrito. Ao se cadastrar ou entrar, você precisa informar a senha de beta tester que recebeu ou solicitar uma em preview@intramedial.com. Obrigado.
Carregando…
identity.enrollMódulo 12
Módulo da plataforma
Agent identity registry
Dê a cada agente sua própria identidade antes de agir, para que toda ação admitida remonte a um agente e nunca a uma conta compartilhada.
identity.enroll registra um agente no registro do workspace por seu DID, um nome de exibição e um tipo. Onde um runtime de identidade está vinculado, também emite o DID do próprio agente, e cada agente começa com um perfil de confiança na pontuação-base de 50. SPIFFE IDs e usuários SCIM se anexam ao mesmo registro.
Os agentes agem quando o plano diz sim, e o registo diz porquê.
Passe ações de agentes, hashes de conteúdo, checagens de API, DNS, webhooks, chamadas de LLM e commits git pela Intramedial. Receba um recibo assinado que todos verificam – sem confiar em nós.
O DID que o runtime de identidade emitiu para este agente, quando um foi emitido.
spiffeId
O SPIFFE ID vinculado com identity/spiffe, uma vez vinculado.
owner
A conta notificada quando o nível de autonomia do agente muda. Opcional.
enrolledAt
Quando o agente foi registrado, como carimbo ISO.
shadow
true quando o agente é acompanhado mas ainda não autorizado, a marca que mcp.shadow oferece.
skipped
true quando nenhum DID foi emitido, o que só acontece em um worker sem runtime de identidade.
Mecanismo
Passo a passo
Como funciona
Nomeie o agente
Envie did e displayName. kind é customer, partner ou house e assume customer. owner nomeia a conta a notificar quando o nível de confiança do agente muda.
Uma identidade é emitida
Quando o runtime de identidade está vinculado, ele emite um DID para o agente, devolvido como issuedDid. Se o runtime recusa ou não pode ser alcançado, o registro é recusado e nada é gravado.
O registro e um perfil são gravados
O agente entra no registro do workspace, e seu DID e seu DID emitido recebem cada um um perfil de confiança com pontuação 50.
Outras identidades se anexam
Um SPIFFE ID é vinculado com identity/spiffe, usuários SCIM chegam por identity/scim, e raízes e delegações A2A confiáveis passam por identity/a2a.
Experimente
Demo ao vivo
Execute a partir desta página
GET/api/v1/acp/identity/list
// Sem corpo: isto é um GET. Clique em Executar.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado. Docs de identity.enroll
Respostas
Clique em Executar para enviar a requisição à esquerda ao workspace de demonstração compartilhado.
Executa em um workspace de demonstração compartilhado com uma chave de demonstração: qualquer pessoa pode ver o que ele contém, então não envie nada privado.
Código
Exemplo ao vivo
Uma requisição real
Uma requisição no formato que a API aceita e um exemplo de resposta no formato que o módulo devolve.
Um agente de cobrança se registra uma vez. Toda admissão, lease e aprovação posterior nomeia seu DID, nunca uma conta de serviço compartilhada.
Trazer um diretório
Recursos SCIM viram agentes de clientes. Um desprovisionamento com active: false remove o agente vinculado e recolhe seu DID emitido.
Dois agentes, um binário
Um novo DID é um novo agente mesmo para o mesmo código. Ele recebe sua própria pontuação de confiança e nenhum histórico herdado.
Autorizar um extraviado
Um agente visto no gateway MCP mas nunca registrado é registrado com shadow: true para acompanhá-lo, ou sem isso para autorizá-lo.
Quando usar outra coisa
Decidir o que um agente pode fazer. O registro dá uma identidade, não uma concessão; as concessões vêm de mandatos compilados em mandates.compile.
Ler quanto um agente é confiável. O registro inicia a pontuação na base; trust.get mostra onde ela está agora.
Importar uma frota inteira a partir de uma exportação. Use onramp.sources para planejar e aplicar muitos agentes de uma vez.
Evidência
Garantias
O que faz e o que não faz
Um módulo é uma afirmação forte sobre algo estreito. Confie nele exatamente pelo que ele é.
Faz
Cada DID registrado tem um registro no seu workspace, e um workspace nunca resolve os agentes de outro.
Com um runtime de identidade vinculado, um registro para o qual ele não consegue emitir um DID é recusado em vez de gravado sem um.
O runtime nunca reemite um DID desativado. O agente recebe o próximo id novo derivado do seu e um DID emitido próprio.
O desprovisionamento por SCIM redefine o perfil de confiança do agente para a base, então um DID reciclado não herda pontuação.
Não faz
Que quem chama controla a chave por trás do DID. O registro grava o DID apresentado e não faz nenhum desafio.
Quem responde. owner é a conta que quem registra nomeia, e é opcional.
Que o agente se comporte. Um novo agente começa na pontuação-base de 50, o que nada diz sobre sua conduta.
Um histórico de trocas de chave. O registro não guarda nenhum; a rotação pertence ao runtime de identidade.
Detalhes
Notas de construção
Antes de construir
Quem pode registrar
Registrar exige a permissão agents.create. A matriz a dá a donos e administradores, e um token a leva só quando seus escopos a levam.
Limites do plano
Quando a organização já tem os agentes que seu plano inclui, o runtime de identidade recusa o DID com 402 e o registro é recusado junto.
O desligamento é repetido com segurança
Se o runtime de identidade perde uma etapa de um desprovisionamento SCIM, a requisição falha com todos os agentes ainda registrados. Cada etapa é idempotente, então a nova tentativa do provedor de identidade a conclui.
Limites e medição
Um registro ou chamada SCIM bem-sucedido conta no medidor identity_active_agents.
displayName é obrigatório, e a ação MCP o limita a 200 caracteres.
Quando um DID emitido foi desativado, o registro tenta até 8 ids de agente derivados antes de desistir.
Acesso
API e MCP
REST e MCP
Autentique-se com uma chave de API do workspace como token Bearer. A URL base é https://api.intramedial.com.
Endpoints REST
POST/api/v1/acp/identity/enrollRegistre um agente e devolva seu registro.
GET/api/v1/acp/identity/listListe os agentes registrados do workspace.
Ações MCP
MCPcoordination.identity.enrollRegistre um agente como ação MCP.
MCPcoordination.identity.listListe os agentes registrados do workspace como ação MCP.
Módulo da plataforma
