Passer au contenu principal
POST
Créer une vérification de conformité
Exécute une évaluation de conformité automatisée pour une entité spécifique (agent, modèle, ensemble de données ou flux de travail) par rapport à une réglementation prise en charge. La vérification évalue la configuration de l’entité, les modèles d’accès, la gestion des données et la piste d’audit par rapport aux exigences de la réglementation et produit une détermination de conformité avec des constatations détaillées. Les vérifications de conformité sont idempotentes pour la même paire entité-réglementation dans une fenêtre de 24 heures. Les appels répétés dans cette fenêtre renvoient le résultat mis en cache.

Authentification

Nécessite l’en-tête X-API-Key ou un jeton JWT Bearer. L’espace de travail est dérivé de l’identifiant authentifié ; n’envoyez pas X-Tenant-ID.

Réponse

string
Identifiant unique de l’enregistrement de vérification de conformité. Format : maip-cc:ULID.
string
Le type d’entité qui a été évalué.
string
L’identifiant de l’entité évaluée.
string
La réglementation qui a été évaluée.
string
La portée de l’évaluation. full si aucune portée n’a été spécifiée.
string
La détermination de la conformité. L’un des éléments suivants : - compliant — l’entité répond à toutes les exigences exigences évaluées - non_compliant — l’entité échoue à une ou plusieurs exigences critiques exigences - partial — l’entité satisfait à certaines mais pas à toutes les exigences
object[]
Liste détaillée des constatations individuelles de l’évaluation.
string
Le reçu MAIP émis pour cette vérification de conformité, fournissant un enregistrement d’audit.
string
Horodatage ISO 8601 du moment où l’évaluation a été effectuée.

Réglementations prises en charge

Autorisations

X-API-Key
string
header
requis

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

Corps

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

Réponse

Vérification de conformité créée

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