Zum Hauptinhalt springen
POST
Compliance-Prüfung erstellen
Führt eine automatisierte Compliance-Bewertung für eine bestimmte Entität (Agent, Modell, Datensatz oder Workflow) gegen eine unterstützte Regulierung durch. Die Prüfung bewertet die Konfiguration, Zugriffsmuster, Datenverarbeitung und den Audit-Trail der Entität anhand der Anforderungen der Regulierung und erstellt eine Compliance-Bestimmung mit detaillierten Feststellungen. Compliance-Prüfungen sind für dasselbe Entitäts-Regulierungs-Paar innerhalb eines 24-Stunden-Fensters idempotent. Wiederholte Aufrufe innerhalb dieses Fensters geben das zwischengespeicherte Ergebnis zurück.

Authentifizierung

Erfordert X-API-Key Header oder Bearer JWT Token. Der Arbeitsbereich wird aus den authentifizierten Anmeldeinformationen abgeleitet; senden Sie X-Tenant-ID nicht.

Antwort

string
Eindeutiger Identifikator für den Compliance-Check-Datensatz. Format: maip-cc:ULID.
string
Der Typ der bewerteten Entität.
string
Der Bezeichner der bewerteten Entität.
string
Die bewertete Vorschrift.
string
Der Umfang der Bewertung. full, wenn kein Umfang angegeben wurde.
string
Die Konformitätsbestimmung. Eine von: - compliant — Entität erfüllt alle bewertete Anforderungen – non_compliant – Entität erfüllt eine oder mehrere kritische Anforderungen nicht Anforderungen - partial — Entität erfüllt einige, aber nicht alle Anforderungen
object[]
Detaillierte Liste der einzelnen Ergebnisse der Bewertung.
string
Der MAIP-Beleg, der für diese Compliance-Prüfung erstellt wurde und eine unveränderliche Audit-Datensatz.
string
ISO 8601 Zeitstempel, wann die Bewertung durchgeführt wurde.

Unterstützte Vorschriften

Autorisierungen

X-API-Key
string
header
erforderlich

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

Body

application/json
auditor_id
string
erforderlich
entity_id
string
erforderlich
regulation
string
erforderlich
requirement_id
string
erforderlich
result
string
erforderlich
check_type
string
entity_type
string
evidence_hash
string | null
metadata
any
notes
string
ttl_days
integer

Antwort

Compliance-Prüfung erstellt

check_id
string<uuid>
agent_id
string<uuid>
framework
enum<string>
Verfügbare Optionen:
soc2,
iso27001,
hipaa,
gdpr
scope
object
status
enum<string>
Verfügbare Optionen:
pending,
passed,
failed,
partial
findings
object[]
created_at
string<date-time>