Per iniziare
Avvio rapido
Registra un agente, emetti una credenziale con ambito definito, effettua una chiamata governata, e revocala — in circa dieci minuti.
Prima di iniziare
Ti serve uno workspace Mandavo, una chiave API amministrativa da Impostazioni, e un sistema che vuoi far raggiungere a un agente. L'intero flusso richiede circa dieci minuti e non lascia nulla di permanente dietro di sé.
Imposta la tua chiave come MANDAVO_API_KEY nel tuo ambiente. Ogni esempio seguente la legge da lì.
1. Registra l'agente
Crea un'identità nella directory e legala a uno sponsor umano. Lo sponsor è la persona responsabile nel tuo team; ogni azione che l'agente compie è attribuita a entrambi.
POST /v1/identities con un nome, un'email dello sponsor, e gli ambiti che l'agente potrà mai richiedere. La risposta restituisce un id dell'identità che userai ovunque altro.
2. Emetti una credenziale con ambito definito
Chiedi al motore di emissione una credenziale con ambito legato esattamente al task. Concedi solo ciò che questo task richiede — un agente non raggiunge nulla oltre il suo ambito attuale.
POST /v1/credentials con l'id dell'identità, l'ambito, e una durata (time-to-live). Il TTL predefinito è cinque minuti; la credenziale scade prima di poter trapelare.
3. Effettua una chiamata governata
Usa la credenziale come token bearer contro il connettore per il sistema di destinazione. Il Policy Graph verifica l'azione nel momento in cui avviene: le concessioni a basso rischio corrono in autonomia, quelle ad alto rischio richiedono un'approvazione.
Ogni chiamata finisce nel log di audit con l'identità, lo sponsor, l'ambito, e la decisione di policy.
4. Revocala
POST /v1/identities/{id}/revoke per invalidare ovunque, in un colpo solo, le credenziali e gli ambiti dell'agente. Il contenimento si completa in pochi secondi ed è scritto a verbale.
Questo è l'intero ciclo: identità nominata, emissione con ambito definito, policy a tempo di esecuzione, revoca in un'azione — nessuna chiave permanente rimasta.