Premiers pas
Démarrage rapide
Enregistrez un agent, émettez un identifiant ciblé, effectuez un appel gouverné, et révoquez-le — en environ dix minutes.
Avant de commencer
Vous avez besoin d'un espace de travail Mandavo, d'une clé API administrateur depuis Settings, et d'un système que vous voulez qu'un agent atteigne. Le flux complet prend environ dix minutes et ne laisse rien de permanent derrière lui.
Définissez votre clé comme MANDAVO_API_KEY dans votre environnement. Chaque exemple ci-dessous la lit.
1. Enregistrer l'agent
Créez une identité dans l'annuaire et liez-la à un sponsor humain. Le sponsor est la personne responsable au sein de votre équipe ; chaque action de l'agent est attribuée aux deux.
POST /v1/identities avec un nom, un e-mail de sponsor, et les périmètres que l'agent pourra jamais demander. La réponse renvoie un identifiant d'identité que vous utiliserez partout ailleurs.
2. Émettre un identifiant ciblé
Demandez au moteur d'émission un identifiant ciblé sur la tâche exacte. N'accordez que ce que cette tâche exige — un agent n'atteint rien au-delà de son périmètre actuel.
POST /v1/credentials avec l'identifiant d'identité, le périmètre, et une durée de vie. La durée de vie par défaut est de cinq minutes ; l'identifiant expire avant de pouvoir fuiter.
3. Effectuer un appel gouverné
Utilisez l'identifiant comme jeton porteur contre le connecteur du système cible. Le graphe de politiques vérifie l'action au moment où elle se produit : les autorisations à faible risque s'exécutent de manière autonome, celles à haut risque nécessitent une approbation.
Chaque appel atterrit dans le journal d'audit avec l'identité, le sponsor, le périmètre, et la décision de politique.
4. Le révoquer
POST /v1/identities/{id}/revoke pour invalider les identifiants et périmètres de l'agent partout à la fois. Le confinement se termine en quelques secondes et est consigné dans les registres.
C'est la boucle complète : identité nommée, émission ciblée, politique au moment de l'exécution, révocation en une action — aucune clé permanente qui subsiste.