io.enterpriseai.resources.EvidenceClient
Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/EvidenceClient.java. Retour à l'index de la référence du SDK Java.
Cette page est générée par tools/docs/gen_sdk_reference.py depuis les sources du SDK et les dossiers de textes OpenAPI. Ne la modifiez pas à la main : changez la source et régénérez.
Classe EvidenceClient
Preuves. Couche de preuve du journal d'audit : sceaux signés, paquets vérifiables hors ligne, moniteur d'intégrité, Audit Gateway, charges utiles chiffrées, accès audités, gels juridiques et preuves de purge, et configuration d'exécution des exécutions d'agents.
Constructeur EvidenceClient
EvidenceClient(Transport transport)
Crée le client sur le transport partagé ; EnterpriseAIClient le construit, on y accède par l'accesseur du même nom.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
transport | Transport | oui | Transport partagé par les sous-clients d'un même client. |
EvidenceClient.accessLog
JsonNode accessLog()
Lire le journal d'accès à l'audit. Renvoie les derniers accès au journal d'audit, les plus récents d'abord : acteur, rôles, type (read, search, verify, export, payload_decrypt, seal_read), requête, nombre de résultats, raison et événement d'audit écrit. Exige auditor ou security_officer. La lecture du journal est elle-même enregistrée.
Route : /v1/evidence/access-log (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Lire le journal d'accès à l'audit ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.accessLog
JsonNode accessLog(Map<String, ?> query)
Lire le journal d'accès à l'audit. Renvoie les derniers accès au journal d'audit, les plus récents d'abord : acteur, rôles, type (read, search, verify, export, payload_decrypt, seal_read), requête, nombre de résultats, raison et événement d'audit écrit. Exige auditor ou security_officer. La lecture du journal est elle-même enregistrée.
Route : /v1/evidence/access-log (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
query | Map<String, ?> | oui | Paramètres de la chaîne de requête de la route. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lire le journal d'accès à l'audit ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.alerts
JsonNode alerts()
Lister les alertes d'intégrité. Liste les alertes d'intégrité du tenant ouvertes par le moniteur : chain_broken, sequence_gap, seal_invalid, outbox_missing ou clock_skew, rafraîchies tant que le problème persiste. Exige auditor, security_officer ou tenant_admin.
Route : /v1/evidence/alerts (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les alertes d'intégrité ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.alerts
JsonNode alerts(Map<String, ?> query)
Lister les alertes d'intégrité. Liste les alertes d'intégrité du tenant ouvertes par le moniteur : chain_broken, sequence_gap, seal_invalid, outbox_missing ou clock_skew, rafraîchies tant que le problème persiste. Exige auditor, security_officer ou tenant_admin.
Route : /v1/evidence/alerts (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
query | Map<String, ?> | oui | Paramètres de la chaîne de requête de la route. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les alertes d'intégrité ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.bundle
JsonNode bundle()
Exporter un paquet de preuves hors ligne. Renvoie bundle (événements, sceaux et clés publiques du tenant) et manifest (format, nombres, SHA-256 du paquet canonique, alg: Ed25519, identifiant de clé, clé publique et signature par la clé de scellement). Un auditeur externe le vérifie hors ligne avec python -m eai.domains.evidence.verify. Exige auditor ou security_officer. Répond 503 audit_seal_key_unavailable sans clé de signature. L'export est inscrit dans le journal d'accès.
Route : /v1/evidence/bundle (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Exporter un paquet de preuves hors ligne ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.createHold
JsonNode createHold(Object body)
Poser un gel juridique de preuves. Pose un gel juridique sur les charges utiles du tenant pour un dossier et une période facultative de date d'événement : tant qu'il est actif, la purge des charges utiles et les effacements ignorent les événements qu'il couvre. time_to doit suivre time_from (400 invalid_request). Exige auditor, security_officer ou tenant_admin. Écrit l'événement d'audit audit.legal_hold.create. Répond 201 avec le gel.
Route : /v1/evidence/holds (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Dossier, raison et période facultative du gel. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Poser un gel juridique de preuves ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.createHold
JsonNode createHold(Object body, RequestOptions options)
Poser un gel juridique de preuves. Pose un gel juridique sur les charges utiles du tenant pour un dossier et une période facultative de date d'événement : tant qu'il est actif, la purge des charges utiles et les effacements ignorent les événements qu'il couvre. time_to doit suivre time_from (400 invalid_request). Exige auditor, security_officer ou tenant_admin. Écrit l'événement d'audit audit.legal_hold.create. Répond 201 avec le gel.
Route : /v1/evidence/holds (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Dossier, raison et période facultative du gel. | |
options | RequestOptions | oui | Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation). |
Retour : JsonNode. Réponse JSON décodée de l'opération « Poser un gel juridique de preuves ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.eventPayload
JsonNode eventPayload(String eventId, Object body)
Déchiffrer la charge utile d'un événement d'audit. Renvoie dans payload les champs sensibles déchiffrés d'un événement, avec access_event_id, l'événement d'audit qui enregistre cet accès. Uniquement auditor ou security_officer détenus explicitement : platform_admin ne suffit pas (403 forbidden). Une reason est obligatoire. Erreurs : 404 not_found (pas de charge utile), 410 audit_payload_purged (expirée ou effacée), 409 audit_payload_tampered (empreinte du chiffré différente), 503 audit_payload_key_unavailable.
Route : /v1/evidence/events/{event_id}/payload (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
eventId | String | oui | Identifiant (UUID) de l'événement d'audit. | |
body | Object | oui | Raison du déchiffrement, inscrite dans le journal d'accès. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Déchiffrer la charge utile d'un événement d'audit ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.eventPayload
JsonNode eventPayload(String eventId, Object body, RequestOptions options)
Déchiffrer la charge utile d'un événement d'audit. Renvoie dans payload les champs sensibles déchiffrés d'un événement, avec access_event_id, l'événement d'audit qui enregistre cet accès. Uniquement auditor ou security_officer détenus explicitement : platform_admin ne suffit pas (403 forbidden). Une reason est obligatoire. Erreurs : 404 not_found (pas de charge utile), 410 audit_payload_purged (expirée ou effacée), 409 audit_payload_tampered (empreinte du chiffré différente), 503 audit_payload_key_unavailable.
Route : /v1/evidence/events/{event_id}/payload (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
eventId | String | oui | Identifiant (UUID) de l'événement d'audit. | |
body | Object | oui | Raison du déchiffrement, inscrite dans le journal d'accès. | |
options | RequestOptions | oui | Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation). |
Retour : JsonNode. Réponse JSON décodée de l'opération « Déchiffrer la charge utile d'un événement d'audit ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.gateway
JsonNode gateway()
Lire l'état de l'Audit Gateway. Renvoie l'état de livraison des événements d'audit du tenant vers le SIEM : targets configurées, nombres pending et delivered, max_attempts d'un événement en attente et oldest_pending. Exige auditor, security_officer ou tenant_admin.
Route : /v1/evidence/gateway (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Lire l'état de l'Audit Gateway ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.listHolds
JsonNode listHolds()
Lister les gels juridiques de preuves. Liste les gels juridiques du tenant avec leur dossier, leur période, leur raison, leur statut et leurs approbations de levée. Exige auditor, security_officer ou tenant_admin.
Route : /v1/evidence/holds (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les gels juridiques de preuves ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.listSeals
JsonNode listSeals()
Lister les sceaux d'audit. Liste les sceaux de la chaîne du tenant : numéro, plage de séquences, racine de Merkle, premières et dernières empreintes, empreinte du sceau précédent, identifiant de clé, signature et date. Exige auditor, security_officer ou tenant_admin. La lecture est inscrite dans le journal d'accès.
Route : /v1/evidence/seals (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les sceaux d'audit ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.recordComponents
JsonNode recordComponents(String runId, Object body)
Enregistrer les composants d'une exécution. Enregistre, en ajout seul, les versions des composants utilisés par une exécution d'agent, ou par l'une de ses étapes avec step_seq (appel d'outil, appel de modèle). Chaque déclaration est auditée avec le champ versions de l'événement d'audit. Exige tenant_admin, agent_operator ou developer. Répond 201 avec les éléments enregistrés, ou 404 not_found pour une exécution inconnue.
Route : /v1/evidence/runs/{run_id}/components (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
runId | String | oui | Identifiant (UUID) de l'exécution d'agent. | |
body | Object | oui | Étape facultative et 1 à 100 composants. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Enregistrer les composants d'une exécution ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.recordComponents
JsonNode recordComponents(String runId, Object body, RequestOptions options)
Enregistrer les composants d'une exécution. Enregistre, en ajout seul, les versions des composants utilisés par une exécution d'agent, ou par l'une de ses étapes avec step_seq (appel d'outil, appel de modèle). Chaque déclaration est auditée avec le champ versions de l'événement d'audit. Exige tenant_admin, agent_operator ou developer. Répond 201 avec les éléments enregistrés, ou 404 not_found pour une exécution inconnue.
Route : /v1/evidence/runs/{run_id}/components (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
runId | String | oui | Identifiant (UUID) de l'exécution d'agent. | |
body | Object | oui | Étape facultative et 1 à 100 composants. | |
options | RequestOptions | oui | Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation). |
Retour : JsonNode. Réponse JSON décodée de l'opération « Enregistrer les composants d'une exécution ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.releaseHold
JsonNode releaseHold(String holdId, Object body)
Approuver la levée d'un gel juridique. Enregistre une approbation de levée avec sa raison. Le gel est levé à la seconde approbation par un approbateur distinct ; la même personne deux fois répond 409 audit_hold_same_approver, un gel qui n'est plus actif 409 audit_hold_not_active, un gel inconnu 404. Exige auditor, security_officer ou tenant_admin. Écrit audit.legal_hold.release_approve, puis audit.legal_hold.release.
Route : /v1/evidence/holds/{hold_id}/release (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
holdId | String | oui | Identifiant (UUID) du gel juridique. | |
body | Object | oui | Raison de l'approbation. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Approuver la levée d'un gel juridique ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.releaseHold
JsonNode releaseHold(String holdId, Object body, RequestOptions options)
Approuver la levée d'un gel juridique. Enregistre une approbation de levée avec sa raison. Le gel est levé à la seconde approbation par un approbateur distinct ; la même personne deux fois répond 409 audit_hold_same_approver, un gel qui n'est plus actif 409 audit_hold_not_active, un gel inconnu 404. Exige auditor, security_officer ou tenant_admin. Écrit audit.legal_hold.release_approve, puis audit.legal_hold.release.
Route : /v1/evidence/holds/{hold_id}/release (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
holdId | String | oui | Identifiant (UUID) du gel juridique. | |
body | Object | oui | Raison de l'approbation. | |
options | RequestOptions | oui | Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation). |
Retour : JsonNode. Réponse JSON décodée de l'opération « Approuver la levée d'un gel juridique ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.retentionEvidence
JsonNode retentionEvidence()
Lister les preuves de purge. Liste les preuves de purge du tenant : type, date limite, nombres purgés et gelés, séquences purgées et racine de Merkle des empreintes des chiffrés purgés, jamais les contenus. Exige auditor, security_officer ou tenant_admin.
Route : /v1/evidence/retention/evidence (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les preuves de purge ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.runConfiguration
JsonNode runConfiguration(String runId)
Lire la configuration d'exécution d'une exécution. Reconstitue la configuration d'exécution d'une exécution d'agent : version de l'agent et empreinte du manifeste, composants déclarés par type (modèle, prompt, outil, compétence, plugin) avec leurs versions et empreintes, et décisions de politique enregistrées pour l'exécution. Exige auditor, security_officer ou tenant_admin, agent_operator ou developer. La lecture est inscrite dans le journal d'accès. Répond 404 not_found pour une exécution inconnue.
Route : /v1/evidence/runs/{run_id}/configuration (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
runId | String | oui | Identifiant (UUID) de l'exécution d'agent. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lire la configuration d'exécution d'une exécution ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.runRetention
JsonNode runRetention(Object body)
Purger les charges utiles d'audit expirées. Supprime des charges utiles d'audit chiffrées ; les événements, la chaîne et les sceaux restent et continuent de se vérifier.
Route : /v1/evidence/retention/run (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Type de purge, date limite, événements et indicateur de simulation. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Purger les charges utiles d'audit expirées ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.runRetention
JsonNode runRetention(Object body, RequestOptions options)
Purger les charges utiles d'audit expirées. Supprime des charges utiles d'audit chiffrées ; les événements, la chaîne et les sceaux restent et continuent de se vérifier.
Route : /v1/evidence/retention/run (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Type de purge, date limite, événements et indicateur de simulation. | |
options | RequestOptions | oui | Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation). |
Retour : JsonNode. Réponse JSON décodée de l'opération « Purger les charges utiles d'audit expirées ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.seal
JsonNode seal()
Sceller la chaîne d'audit maintenant. Écrit un sceau sur les événements écrits depuis le sceau précédent (jusqu'au maximum par sceau de la plateforme) et le renvoie (201). Exige security_officer ou auditor. Répond 409 audit_nothing_to_seal quand aucun événement n'attend, 503 audit_seal_key_unavailable sans clé de signature.
Route : /v1/evidence/seals (POST).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Sceller la chaîne d'audit maintenant ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.seal
JsonNode seal(RequestOptions options)
Sceller la chaîne d'audit maintenant. Écrit un sceau sur les événements écrits depuis le sceau précédent (jusqu'au maximum par sceau de la plateforme) et le renvoie (201). Exige security_officer ou auditor. Répond 409 audit_nothing_to_seal quand aucun événement n'attend, 503 audit_seal_key_unavailable sans clé de signature.
Route : /v1/evidence/seals (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
options | RequestOptions | oui | Options de l'appel (clé d'idempotence, traceparent, en-têtes, signal d'annulation). |
Retour : JsonNode. Réponse JSON décodée de l'opération « Sceller la chaîne d'audit maintenant ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.verify
JsonNode verify()
Vérifier la chaîne et tous les sceaux. Vérifie toute la chaîne du tenant et tous ses sceaux et renvoie tenant_id, valid, chain (résultat de la chaîne de hachage), seals (nombre et échecs), clock (échecs d'horodatage) et events (nombre vérifié). Exige auditor, security_officer ou tenant_admin. La vérification est inscrite dans le journal d'accès.
Route : /v1/evidence/verify (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Vérifier la chaîne et tous les sceaux ».
Erreurs levées : les erreurs typées du transport (Erreurs).
EvidenceClient.verifySeal
JsonNode verifySeal(String sealId)
Vérifier un sceau d'audit. Recalcule le sceau à partir des événements qu'il couvre et des sceaux qui le précèdent et vérifie sa signature. Renvoie seal, valid et failures. Exige auditor, security_officer ou tenant_admin. Répond 404 not_found pour un sceau inconnu. La vérification est inscrite dans le journal d'accès.
Route : /v1/evidence/seals/{seal_id}/verify (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
sealId | String | oui | Identifiant (UUID) du sceau. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Vérifier un sceau d'audit ».
Erreurs levées : les erreurs typées du transport (Erreurs).