Aller au contenu principal

io.enterpriseai.resources.SecurityClient

Source : sdks/java/enterprise-ai-java/src/main/java/io/enterpriseai/resources/SecurityClient.java. Retour à l'index de la référence du SDK Java.

remarque

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 SecurityClient​

Sécurité. Posture de sécurité du déploiement et réglages de sécurité du tenant.

Constructeur SecurityClient​

SecurityClient(Transport transport)

Crée le client sur le transport partagé ; EnterpriseAIClient le construit, on y accède par l'accesseur du même nom.

NomTypeDéfautRequisDescription
transportTransportouiTransport partagé par les sous-clients d'un même client.

SecurityClient.getSettings​

JsonNode getSettings()

Lire les réglages de sécurité. Renvoie tenant_id et settings : les réglages de sécurité du tenant, valeurs par défaut comprises. Exige tenant_admin ou security_officer et un tenant (403 tenant_required).

Route : /v1/security/settings (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire les réglages de sécurité ».

Erreurs levées : les erreurs typées du transport (Erreurs).

SecurityClient.posture​

JsonNode posture()

Lire la posture de sécurité. Renvoie environment, generated_at, protections (méthodes d'authentification et autres protections en vigueur), checks (chacun avec son statut pass, warn ou fail, sa gravité et son message) et summary (nombre de contrôles par statut). Pour un appelant rattaché à un tenant, renvoie aussi tenant avec les réglages de sécurité du tenant, dont certains contrôles tiennent compte. Exige security_officer ou tenant_admin. En lecture seule.

Route : /v1/security/posture (GET).

Cet élément ne prend aucun paramètre.

Retour : JsonNode. Réponse JSON décodée de l'opération « Lire la posture de sécurité ».

Erreurs levées : les erreurs typées du transport (Erreurs).

SecurityClient.updateSettings​

JsonNode updateSettings(Object body)

Modifier les réglages de sécurité. Mise à jour partielle : seuls les réglages envoyés changent, les autres gardent leur valeur. Exige tenant_admin ou security_officer et un tenant.

Route : /v1/security/settings (PUT).

NomTypeDéfautRequisDescription
bodyObjectouiObjet JSON avec les réglages à modifier, par exemple {"prompt_injection_mode": "block"}.

Retour : JsonNode. Réponse JSON décodée de l'opération « Modifier les réglages de sécurité ».

Erreurs levées : les erreurs typées du transport (Erreurs).

SecurityClient.updateSettings​

JsonNode updateSettings(Object body, RequestOptions options)

Modifier les réglages de sécurité. Mise à jour partielle : seuls les réglages envoyés changent, les autres gardent leur valeur. Exige tenant_admin ou security_officer et un tenant.

Route : /v1/security/settings (PUT).

NomTypeDéfautRequisDescription
bodyObjectouiObjet JSON avec les réglages à modifier, par exemple {"prompt_injection_mode": "block"}.
optionsRequestOptionsouiOptions 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 « Modifier les réglages de sécurité ».

Erreurs levées : les erreurs typées du transport (Erreurs).