Zum Hauptinhalt springen
GET
MAIP-Richtlinien auflisten

MAIP-Richtlinien auflisten

GET /v1/maip/policies Gibt alle für den authentifizierten Mandanten konfigurierten MAIP-Agentenrichtlinien zurück. Richtlinien definieren Laufzeit-Durchsetzungsregeln, die festlegen, was Agenten basierend auf Vertrauensscores, Scopes, Delegierungstiefe und Agententyp tun können.

Authentifizierung

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

Antwort

Gibt ein Array von Richtlinienobjekten zurück.
string
UUID Primärschlüssel der Richtlinie.
string
UUID des besitzenden Mandanten.
string
Menschenlesbarer Richtlinienname. Wird in Ablehnungsmeldungen und Audit-Logs verwendet.
string
Detaillierte Beschreibung dessen, was die Richtlinie durchsetzt.
string
Richtlinienkategorie. Eine von: "scope", "trust", "rate", "custom".
string
Lebenszyklusstatus der Richtlinie. Einer von: "active", "disabled", "archived". Nur active Richtlinien werden bei Richtlinienprüfungen ausgewertet.
integer
Bewertungspriorität. Kleinere Zahlen werden zuerst bewertet. Standard: 100.
object
JSON-Array von Richtlinienregeln. Jede Regel enthält Bedingungen, einen Effekt ("allow", "deny", "require_approval") und ein optionales requires_approval Flag. Siehe Richtlinie erstellen für die vollständige Regelschema.
string
ISO 8601 Erstellungszeitstempel.
string
ISO 8601 Zeitstempel der letzten Aktualisierung.

Beispiel

Autorisierungen

X-API-Key
string
header
erforderlich

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

Antwort

Array von Richtlinien

id
string<uuid>

UUID Primärschlüssel

tenant_id
string<uuid>

UUID des besitzenden Mandanten

name
string

Menschenlesbarer Richtlinienname

description
string

Detaillierte Richtlinienbeschreibung

category
enum<string>

Richtlinienkategorie

Verfügbare Optionen:
scope,
trust,
rate,
custom
status
enum<string>

Lebenszyklusstatus der Richtlinie

Verfügbare Optionen:
active,
disabled,
archived
priority
integer

Evaluationspriorität (niedriger = zuerst)

rules
object[]

Array von Richtlinienregeln

created_at
string<date-time>
updated_at
string<date-time>