io.enterpriseai.resources.ServiceIdentitiesClient
Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/ServiceIdentitiesClient.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 ServiceIdentitiesClient
Identité. Qui appelle l'API et avec quels droits. Ce tag couvre l'identité de l'appelant (whoami), les clés d'API des scripts et des services, les identités de service (charges de travail SPIFFE) qu'un utilisateur peut endosser temporairement, et les correspondances de groupes de l'annuaire qui transforment les groupes Keycloak en appartenances à des projets et en quotas.
Constructeur ServiceIdentitiesClient
ServiceIdentitiesClient(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. |
ServiceIdentitiesClient.assume
JsonNode assume(String identityId, Object body)
Endosser une identité de service. Renvoie un ExecutionContext signé et de courte durée dont le sujet est l'identité de service, pour l'appelant. Ce n'est pas un identifiant d'API : les services en aval le vérifient (POST /v1/context/verify ou le JWKS) et l'appelant le révoque avec POST /v1/context/{context_id}/revoke.
Route : /v1/service-identities/{identity_id}/assume (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
identityId | String | oui | Identifiant (UUID) de l'identité de service. | |
body | Object | oui | Finalité, audiences, durée de vie et portées du contexte demandé. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Endosser une identité de service ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ServiceIdentitiesClient.assume
JsonNode assume(String identityId, Object body, RequestOptions options)
Endosser une identité de service. Renvoie un ExecutionContext signé et de courte durée dont le sujet est l'identité de service, pour l'appelant. Ce n'est pas un identifiant d'API : les services en aval le vérifient (POST /v1/context/verify ou le JWKS) et l'appelant le révoque avec POST /v1/context/{context_id}/revoke.
Route : /v1/service-identities/{identity_id}/assume (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
identityId | String | oui | Identifiant (UUID) de l'identité de service. | |
body | Object | oui | Finalité, audiences, durée de vie et portées du contexte demandé. | |
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 « Endosser une identité de service ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ServiceIdentitiesClient.create
JsonNode create(Object body)
Créer une identité de service. Enregistre une identité de charge de travail du tenant avec son identifiant SPIFFE, ses rôles, ses portées et son habilitation. Exige tenant_admin ou security_officer ; les rôles et portées accordés suivent les mêmes règles que les clés d'API (uniquement ce que l'appelant détient). Un identifiant SPIFFE déjà enregistré répond 409 conflict. Écrit l'événement d'audit service_identity.create. Endosser l'identité exige en plus la relation explicite can_assume (voir la route d'endossement).
Route : /v1/service-identities (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Nom, identifiant SPIFFE et droits de l'identité. |
Retour : JsonNode. Réponse JSON décodée de l'opération « Créer une identité de service ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ServiceIdentitiesClient.create
JsonNode create(Object body, RequestOptions options)
Créer une identité de service. Enregistre une identité de charge de travail du tenant avec son identifiant SPIFFE, ses rôles, ses portées et son habilitation. Exige tenant_admin ou security_officer ; les rôles et portées accordés suivent les mêmes règles que les clés d'API (uniquement ce que l'appelant détient). Un identifiant SPIFFE déjà enregistré répond 409 conflict. Écrit l'événement d'audit service_identity.create. Endosser l'identité exige en plus la relation explicite can_assume (voir la route d'endossement).
Route : /v1/service-identities (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
body | Object | oui | Nom, identifiant SPIFFE et droits de l'identité. | |
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 « Créer une identité de service ».
Erreurs levées : les erreurs typées du transport (Erreurs).
ServiceIdentitiesClient.delete
void delete(String id)
Supprimer une identité de service. Supprime l'identité de service ; elle ne peut plus être endossée ni s'authentifier avec son identifiant SPIFFE. Exige tenant_admin ou security_officer. Écrit l'événement d'audit service_identity.delete. Répond 204, ou 404 not_found.
Route : /v1/service-identities/{identity_id} (DELETE).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
id | String | oui | Identifiant (UUID) de l'identité de service. |
Retour : void.
Erreurs levées : les erreurs typées du transport (Erreurs).
ServiceIdentitiesClient.list
Page<JsonNode> list()
Lister les identités de service. Liste les identités de service du tenant, triées par nom, avec leur identifiant SPIFFE, leurs rôles, leurs portées et leur habilitation. Ouvert à tout membre du tenant. Non paginé : next_cursor vaut toujours null.
Route : /v1/service-identities (GET).
Cet élément ne prend aucun paramètre.
Retour : Page<JsonNode>. Réponse JSON décodée de l'opération « Lister les identités de service ».
Erreurs levées : les erreurs typées du transport (Erreurs).