Zum Hauptinhalt springen
POST
MAIP-Richtlinie bewerten

MAIP-Richtlinie bewerten

POST /v1/maip/policies/evaluate Bewertet alle aktiven MAIP-Richtlinien für den authentifizierten Mandanten anhand eines bestimmten Agenten und des angeforderten Geltungsbereichs. Gibt zurück, ob die Aktion erlaubt, verweigert oder menschliche Genehmigung erfordert. Dies ist der Laufzeit-Durchsetzungskontrollpunkt, den Agenten vor der Durchführung sensibler Operationen aufrufen.
Die Richtlinienbewertung verwendet ein Deny-Overrides-Modell: Wenn eine aktive Richtlinie mit einem übereinstimmende deny Regel-Trigger, wird die Aktion blockiert, unabhängig von jeglichen allow Regeln. Das Flag requires_approval ist additiv – es kann auch dann gesetzt werden, wenn die Aktion ist erlaubt.

Authentifizierung

Erfordert X-API-Key Header oder Bearer JWT Token. Mandantenbezogen über Cookie oder JWT Claim.

Bewertungslogik

Die Bewertung führt drei sequentielle Prüfungen durch:
  1. Agenten-Statusprüfung – Der Agent muss status: "active" sein. Gesperrte oder widerrufene Agenten werden immer abgelehnt.
  2. Bereichszugriffsprüfung – Der angeforderte Bereich muss in den gewährten Bereichen des Agenten vorhanden sein. Explizit verweigerte Bereiche (mit dem Präfix !) blockieren immer den Zugriff.
  3. Richtlinienregeln prüfen – Alle aktiven Mandantenrichtlinien werden in der Reihenfolge ihrer Priorität ausgewertet. Die Bedingungen jeder Regel werden mit UND verknüpft. Wenn eine deny-Regel übereinstimmt, wird die Aktion blockiert.

Antwort

boolean
true, wenn die Aktion erlaubt ist, false, wenn sie durch eine Prüfung verweigert wird.
string[]
Namen der Richtlinien, die die Aktion abgelehnt haben. Leeres Array, wenn erlaubt.
string
Menschenlesbarer Grund für die Ablehnung. Einer von: - "agent is not active" — Agent ist gesperrt oder widerrufen – "scope not granted to agent" – Bereich nicht in gewährte Bereiche des Agenten – "denied by policy" – Eine oder mehrere Richtlinien blockiert die Aktion
boolean
true, wenn eine übereinstimmende Richtlinienregel requires_approval: true hat, selbst wenn die Aktion anderweitig erlaubt ist. Der Aufrufer sollte eine menschliche Genehmigung vorlegen Workflow, bevor Sie fortfahren.

Beispiel

Autorisierungen

X-API-Key
string
header
erforderlich

API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung

Body

application/json
agent_id
string
erforderlich

MAIP-konformer Agenten-Identifikator

scope
string
erforderlich

Angefragter Berechtigungsumfang

action
string

Spezifische Aktion, die ausgeführt wird

resource
string

Spezifische Ressource, auf die zugegriffen wird

Antwort

Evaluationsergebnis

allowed
boolean

Ob die Aktion erlaubt ist

denied_by
string[]

Namen der Richtlinien, die die Aktion verweigert haben

reason
string

Menschenlesbarer Ablehnungsgrund

requires_approval
boolean

Ob eine menschliche Genehmigung erforderlich ist