io.enterpriseai.resources.BreakGlassClient
Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/BreakGlassClient.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 BreakGlassClient
Délégation, mandats et accès d'urgence. Comment un agent, une application ou un sous-agent agit pour le compte de quelqu'un, et comment des droits exceptionnels sont accordés.
Constructeur BreakGlassClient
BreakGlassClient(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. |
BreakGlassClient.get
JsonNode get(String grantId)
Lire un accès d'urgence. Renvoie un accès : demandeur, bénéficiaire, rôles, portées, raison, incident, durée, statut, validation et dates. Visible par son demandeur, son bénéficiaire et par tenant_admin, security_officer et auditor ; toute autre personne reçoit 404 break_glass_not_found.
Route : /v1/break-glass/{grant_id} (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
grantId | String | oui | Identifiant (UUID) de l'accès d'urgence. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Lire un accès d'urgence ».
Erreurs levées : les erreurs typées du transport (Erreurs).
BreakGlassClient.issueContext
JsonNode issueContext(String grantId, Object body)
Obtenir un contexte d'exécution pour un accès d'urgence. Renvoie un ExecutionContext signé portant l'élévation active, dont la durée de vie ne dépasse jamais l'expiration de l'accès. Seul le bénéficiaire peut le demander (403 forbidden) ; l'accès doit être actif (409 break_glass_not_active) ; chaque audience doit être connue (400 context_wrong_audience). Les services en aval le vérifient comme tout contexte d'exécution.
Route : /v1/break-glass/{grant_id}/context (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
grantId | String | oui | Identifiant (UUID) de l'accès d'urgence. | |
body | Object | oui | Audiences et durée de vie facultatives du contexte. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Obtenir un contexte d'exécution pour un accès d'urgence ».
Erreurs levées : les erreurs typées du transport (Erreurs).
BreakGlassClient.issueContext
JsonNode issueContext(String grantId, Object body, RequestOptions options)
Obtenir un contexte d'exécution pour un accès d'urgence. Renvoie un ExecutionContext signé portant l'élévation active, dont la durée de vie ne dépasse jamais l'expiration de l'accès. Seul le bénéficiaire peut le demander (403 forbidden) ; l'accès doit être actif (409 break_glass_not_active) ; chaque audience doit être connue (400 context_wrong_audience). Les services en aval le vérifient comme tout contexte d'exécution.
Route : /v1/break-glass/{grant_id}/context (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
grantId | String | oui | Identifiant (UUID) de l'accès d'urgence. | |
body | Object | oui | Audiences et durée de vie facultatives du contexte. | |
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 « Obtenir un contexte d'exécution pour un accès d'urgence ».
Erreurs levées : les erreurs typées du transport (Erreurs).
BreakGlassClient.list
JsonNode list()
Lister les accès d'urgence. Liste les accès d'urgence, les plus récents d'abord : tous pour tenant_admin, security_officer et auditor, sinon ceux que l'appelant a demandés ou dont il bénéficie. Les accès actifs dont l'expiration est passée sont marqués expired (audité une fois). Un statut inconnu répond 400.
Route : /v1/break-glass (GET).
Cet élément ne prend aucun paramètre.
Retour : JsonNode. Réponse JSON décodée de l'opération « Lister les accès d'urgence ».
Erreurs levées : les erreurs typées du transport (Erreurs).
BreakGlassClient.list
JsonNode list(Map<String, ?> query)
Lister les accès d'urgence. Liste les accès d'urgence, les plus récents d'abord : tous pour tenant_admin, security_officer et auditor, sinon ceux que l'appelant a demandés ou dont il bénéficie. Les accès actifs dont l'expiration est passée sont marqués expired (audité une fois). Un statut inconnu répond 400.
Route : /v1/break-glass (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 accès d'urgence ».
Erreurs levées : les erreurs typées du transport (Erreurs).
BreakGlassClient.request
JsonNode request(Object body)
Demander un accès d'urgence. Demande une élévation exceptionnelle et limitée dans le temps pour le bénéficiaire (l'appelant par défaut). Ouvert à tout membre du tenant.
Route : /v1/break-glass (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Rôles, portées, raison, durée, bénéficiaire et référence d'incident. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Demander un accès d'urgence ».
Erreurs levées : les erreurs typées du transport (Erreurs).
BreakGlassClient.request
JsonNode request(Object body, RequestOptions options)
Demander un accès d'urgence. Demande une élévation exceptionnelle et limitée dans le temps pour le bénéficiaire (l'appelant par défaut). Ouvert à tout membre du tenant.
Route : /v1/break-glass (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Rôles, portées, raison, durée, bénéficiaire et référence d'incident. | |
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 « Demander un accès d'urgence ».
Erreurs levées : les erreurs typées du transport (Erreurs).
BreakGlassClient.revoke
JsonNode revoke(String grantId, Object body)
Révoquer un accès d'urgence. Met fin à un accès en attente ou actif et révoque les délégations créées sous lui. Autorisé au demandeur, à un tenant_admin ou à un security_officer (403 forbidden). Un accès déjà clos répond 409 break_glass_closed. Écrit l'événement d'audit break_glass.revoke.
Route : /v1/break-glass/{grant_id}/revoke (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
grantId | String | oui | Identifiant (UUID) de l'accès d'urgence. | |
body | Object | oui | Raison facultative. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Révoquer un accès d'urgence ».
Erreurs levées : les erreurs typées du transport (Erreurs).
BreakGlassClient.revoke
JsonNode revoke(String grantId, Object body, RequestOptions options)
Révoquer un accès d'urgence. Met fin à un accès en attente ou actif et révoque les délégations créées sous lui. Autorisé au demandeur, à un tenant_admin ou à un security_officer (403 forbidden). Un accès déjà clos répond 409 break_glass_closed. Écrit l'événement d'audit break_glass.revoke.
Route : /v1/break-glass/{grant_id}/revoke (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
grantId | String | oui | Identifiant (UUID) de l'accès d'urgence. | |
body | Object | oui | Raison facultative. | |
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 « Révoquer un accès d'urgence ».
Erreurs levées : les erreurs typées du transport (Erreurs).