Primeros pasos
Inicio rápido
Registra un agente, emite una credencial delimitada, haz una llamada gobernada y revócala — en unos diez minutos.
Antes de empezar
Necesitas un espacio de trabajo de Mandavo, una clave de API de administrador desde Configuración, y un sistema al que quieras que un agente acceda. Todo el flujo toma unos diez minutos y no deja nada permanente detrás.
Configura tu clave como MANDAVO_API_KEY en tu entorno. Cada ejemplo a continuación la lee de ahí.
1. Registrar el agente
Crea una identidad en el directorio y vincúlala a un patrocinador humano. El patrocinador es la persona responsable en tu equipo; cada acción que el agente toma se atribuye a ambos.
POST /v1/identities con un nombre, un correo de patrocinador, y los alcances que el agente podrá solicitar alguna vez. La respuesta devuelve un id de identidad que usarás en todo lo demás.
2. Emitir una credencial delimitada
Pídele al Motor de Emisión una credencial delimitada a la tarea exacta. Otorga solo lo que esta tarea requiere — un agente no alcanza nada más allá de su alcance actual.
POST /v1/credentials con el id de identidad, el alcance, y un tiempo de vida. El TTL por defecto es cinco minutos; la credencial expira antes de poder filtrarse.
3. Hacer una llamada gobernada
Usa la credencial como token portador contra el conector para el sistema objetivo. El Grafo de Políticas verifica la acción en el momento en que ocurre: los permisos de bajo riesgo se ejecutan de forma autónoma, los de alto riesgo requieren aprobación.
Cada llamada queda registrada en el registro de auditoría con la identidad, el patrocinador, el alcance, y la decisión de política.
4. Revocarla
POST /v1/identities/{id}/revoke para invalidar las credenciales y alcances del agente en todas partes a la vez. La contención se completa en segundos y queda registrada.
Ese es el ciclo completo: identidad designada, emisión delimitada, política en tiempo de ejecución, revocación en una acción — sin claves permanentes restantes.