Passer au contenu principal
POST
Évaluer la politique MAIP

Évaluer la politique MAIP

POST /v1/maip/policies/evaluate Évalue toutes les politiques MAIP actives pour le locataire authentifié par rapport à un agent spécifique et à la portée demandée. Indique si l’action est autorisée, refusée ou nécessite une approbation humaine. Il s’agit du point de contrôle d’application d’exécution que les agents appellent avant d’effectuer des opérations sensibles.
L’évaluation des politiques utilise un modèle refus-prioritaire : si une politique active avec un correspondant aux déclencheurs de règle deny, l’action est bloquée quelle que soit la règle allow règles. Le drapeau requires_approval est additif — il peut être défini même lorsque le action est autorisée.

Authentification

Nécessite l’en-tête X-API-Key ou un jeton JWT Bearer. Portée au locataire via un cookie ou une revendication JWT.

Logique d’évaluation

L’évaluation effectue trois vérifications séquentielles :
  1. Vérification du statut de l’agent — L’agent doit avoir status: "active". Les agents suspendus ou révoqués sont toujours refusés.
  2. Vérification d’accès à la portée — La portée demandée doit être présente dans les portées accordées à l’agent. Les portées explicitement refusées (préfixées par !) bloquent toujours l’accès.
  3. Vérification des règles de politique — Toutes les politiques de locataire actives sont évaluées par ordre de priorité. Les conditions de chaque règle sont liées par un ET. Si une règle deny correspond, l’action est bloquée.

Réponse

boolean
true si l’action est autorisée, false si refusée par une vérification.
string[]
Noms des politiques qui ont refusé l’action. Tableau vide si autorisé.
string
Raison du refus lisible par l’homme. L’une des suivantes : - "agent is not active" — Agent est suspendu ou révoqué - "scope not granted to agent" — Portée non dans portées accordées à l’agent - "denied by policy" — Une ou plusieurs politiques bloquées l’action
boolean
true si une règle de politique correspondante a requires_approval: true, même si le action est autrement autorisée. L’appelant doit présenter une approbation humaine flux de travail avant de continuer.

Exemple

Autorisations

X-API-Key
string
header
requis

Clé API pour l'authentification machine-à-machine

Corps

application/json
agent_id
string
requis

Identifiant d'agent conforme à MAIP

scope
string
requis

Portée de la permission demandée

action
string

Action spécifique effectuée

resource
string

Ressource spécifique accédée

Réponse

Résultat de l'évaluation

allowed
boolean

Si l'action est autorisée

denied_by
string[]

Noms des politiques qui ont refusé l'action

reason
string

Raison de refus lisible par l'homme

requires_approval
boolean

Si une approbation humaine est requise