Intramedial è in beta ristretta. Alla registrazione o all’accesso devi fornire la password da beta tester che hai ricevuto oppure richiederne una a preview@intramedial.com. Grazie.
Caricamento…
identity.enrollModulo 12
Modulo della piattaforma
Agent identity registry
Dai a ogni agente la propria identità prima che agisca, così ogni azione ammessa risale a un solo agente e mai a un account condiviso.
identity.enroll registra un agente nel registro del workspace con il suo DID, un nome visualizzato e un tipo. Dove è associato un runtime di identità, emette anche il DID proprio dell’agente, e ogni agente parte con un profilo di fiducia al punteggio base di 50. SPIFFE ID e utenti SCIM si legano allo stesso registro.
Gli agenti agiscono quando il piano dice sì, e il registro dice perché.
Fai passare da Intramedial azioni di agenti, hash di contenuti, controlli API, lookup DNS, webhook, chiamate LLM e commit git. Ricevi una ricevuta firmata che chiunque verifica, senza fidarsi di noi.
Il DID che il runtime di identità ha emesso per questo agente, quando è stato emesso.
spiffeId
Lo SPIFFE ID associato con identity/spiffe, una volta associato.
owner
L’account avvisato quando cambia il livello di autonomia dell’agente. Opzionale.
enrolledAt
Quando l’agente è stato registrato, come timestamp ISO.
shadow
true quando l’agente è tracciato ma non ancora autorizzato, il contrassegno che offre mcp.shadow.
skipped
true quando non è stato emesso alcun DID, cosa che accade solo su un worker senza runtime di identità.
Meccanismo
Passo dopo passo
Come funziona
Dai un nome all’agente
Invia did e displayName. kind è customer, partner o house e per default è customer. owner indica l’account da avvisare quando cambia il livello di fiducia dell’agente.
Un’identità è emessa
Quando il runtime di identità è associato emette un DID per l’agente, restituito come issuedDid. Se il runtime rifiuta o non è raggiungibile, la registrazione è rifiutata e nulla viene registrato.
Si scrivono il record e un profilo
L’agente entra nel registro del workspace, e il suo DID e il DID emesso ottengono ciascuno un profilo di fiducia a punteggio 50.
Altre identità si legano
Uno SPIFFE ID si associa con identity/spiffe, gli utenti SCIM arrivano tramite identity/scim e radici attendibili e deleghe A2A passano da identity/a2a.
Provalo
Demo live
Eseguilo da questa pagina
GET/api/v1/acp/identity/list
// Nessun body: è una GET. Premi Esegui.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato. Docs di identity.enroll
Risposte
Premi Esegui per inviare la richiesta a sinistra al workspace demo condiviso.
Viene eseguito in un workspace demo condiviso con una chiave demo: chiunque può vedere cosa contiene, quindi non inviare nulla di privato.
Codice
Esempio live
Una richiesta reale
Una richiesta nella forma accettata dall’API e una risposta di esempio nella forma restituita dal modulo.
Un agente di fatturazione si registra una volta. Ogni ammissione, lease e approvazione successiva nomina il suo DID, mai un account di servizio condiviso.
Portare una directory
Le risorse SCIM diventano agenti cliente. Un deprovisioning con active: false rimuove l’agente collegato e riprende il suo DID emesso.
Due agenti, un solo binario
Un nuovo DID è un nuovo agente anche per lo stesso codice. Ottiene un proprio punteggio di fiducia e nessuna storia riportata.
Autorizzare un vagante
Un agente visto al gateway MCP ma mai registrato è registrato con shadow: true per tracciarlo, o senza per autorizzarlo.
Quando usare altro
Decidere cosa può fare un agente. La registrazione dà un’identità, non un grant; i grant vengono dai mandati compilati in mandates.compile.
Leggere quanta fiducia ha un agente. La registrazione parte dal punteggio base; trust.get mostra a che punto è ora.
Importare un’intera flotta da un export. Usa onramp.sources per pianificare e applicare molti agenti in un solo passaggio.
Prove
Garanzie
Cosa fa e cosa non fa
Un modulo è una promessa forte su una cosa circoscritta. Contaci esattamente per ciò che è.
Fa
Ogni DID registrato ha un record nel registro del suo workspace, e un workspace non risolve mai gli agenti di un altro.
Con un runtime di identità associato, una registrazione per cui non può emettere un DID è rifiutata invece di essere registrata senza.
Il runtime non riemette mai un DID disattivato. L’agente ottiene il successivo id nuovo derivato dal proprio e un DID emesso suo.
Il deprovisioning via SCIM riporta al punteggio base il profilo di fiducia dell’agente, così un DID riciclato non eredita alcun punteggio.
Non fa
Che il chiamante controlli la chiave dietro il DID. La registrazione registra il DID presentato e non esegue alcuna sfida.
Chi ne risponde. owner è l’account che l’iscrivente indica, ed è opzionale.
Che l’agente si comporti bene. Un nuovo agente parte dal punteggio base di 50, che non dice nulla sulla sua condotta.
Una storia dei cambi di chiave. Il registro non ne conserva; la rotazione spetta al runtime di identità.
Dettagli
Note di sviluppo
Prima di costruire
Chi può registrare
Registrare richiede il permesso agents.create. La matrice lo dà a proprietari e amministratori, e un token lo porta solo se lo portano i suoi ambiti.
Limiti del piano
Quando l’organizzazione ha già gli agenti inclusi nel suo piano, il runtime di identità rifiuta il DID con un 402 e la registrazione è rifiutata con esso.
L’offboarding si riprova in sicurezza
Se il runtime di identità salta un passo di un deprovisioning SCIM, la richiesta fallisce con tutti gli agenti ancora registrati. Ogni passo è idempotente, quindi il nuovo tentativo dell’identity provider lo completa.
Limiti e misurazione
Una registrazione o chiamata SCIM riuscita conta nel contatore identity_active_agents.
displayName è obbligatorio, e l’azione MCP lo limita a 200 caratteri.
Quando un DID emesso è stato disattivato, la registrazione prova fino a 8 id di agente derivati prima di arrendersi.
Accesso
API e MCP
REST e MCP
Autenticati con una chiave API del workspace come token Bearer. L’URL di base è https://api.intramedial.com.
Endpoint REST
POST/api/v1/acp/identity/enrollRegistra un agente e restituisci il suo record.
GET/api/v1/acp/identity/listElenca gli agenti registrati del workspace.
Azioni MCP
MCPcoordination.identity.enrollRegistra un agente come azione MCP.
MCPcoordination.identity.listElenca gli agenti registrati del workspace come azione MCP.
Modulo della piattaforma
