Registre de gouvernance
L'écran Registre de gouvernance permet de lire l'inventaire des agents, modèles et outils connus de la plateforme, avec leur version, leur propriétaire, leur niveau de risque, leur statut et leur portée. Chemin dans le portail : /security/governance, menu Sécurité et gouvernance > Registre de gouvernance. Il sert aux responsables sécurité, aux responsables de la gouvernance de l'IA et aux auditeurs qui vérifient que chaque actif a un propriétaire et une évaluation de risque.
Ce que montre l'écran
L'écran (Governance dans portal/src/screens/security.tsx) lit une fois GET /v1/governance/registry et montre trois onglets, chacun avec son nombre entre parenthèses : Agents (n), Modèles (n), Outils (n).
Chaque onglet contient un tableau :
| Colonne | Contenu |
|---|---|
| Nom | Nom de l'actif. |
| Version | Version enregistrée dans le registre de l'actif. |
| Propriétaire | Propriétaire de l'actif ; vide si aucun n'est enregistré. |
| Risque | Catégorie AI Act de la dernière évaluation de risque de l'actif, sinon le niveau de risque que l'actif déclare. |
| Statut | Statut de l'actif dans son propre registre. |
| Portée | platform pour un actif partagé, tenant pour un actif du tenant. |
| Mis à jour | Dernière mise à jour. |
Un onglet vide affiche « Rien d'enregistré », « Les actifs apparaissent ici une fois enregistrés via un manifeste. » La réponse de l'API contient aussi les fournisseurs, skills, plugins, connecteurs et un summary (nombres par statut, par risque, actifs sans propriétaire) ; l'écran ne montre que les trois onglets ci-dessus.
Actions
| Bouton ou action | Effet | Appel API | Rôles |
|---|---|---|---|
| Onglets Agents, Modèles, Outils | Changent de tableau, sans autre appel. | Aucun | Tout utilisateur du tenant |
| Réessayer (état d'erreur) | Relit le registre. | GET /v1/governance/registry | Tout utilisateur du tenant |
L'écran est en lecture seule : un actif est enregistré, modifié ou retiré depuis son propre écran (registre des agents, registre des modèles, outils), et son niveau de risque vient de l'écran Risque et conformité.
Rôles
Le portail ne demande aucun rôle. Le Control Plane exige seulement un tenant (tenant_of dans services/control-plane/src/eai/domains/governance/__init__.py) : tout utilisateur du tenant lit le registre. platform_admin passe tous les contrôles de rôle.
Tâches courantes
Trouver les agents sans propriétaire
- Ouvrir le registre. Il réunit tous les actifs en un seul endroit. Menu Sécurité et gouvernance > Registre de gouvernance. Résultat attendu : l'onglet Agents avec son nombre. En cas d'échec :
tenant_required(HTTP 403) signifie que le compte n'a pas de tenant. - Lire la colonne Propriétaire. Un actif sans propriétaire n'a personne de responsable. Repérez les cellules vides de Propriétaire. Résultat attendu : la liste des agents à attribuer. En cas d'échec : « Rien d'enregistré » signifie qu'aucun agent n'est encore enregistré.
- Attribuer un propriétaire. Le propriétaire se règle sur l'actif lui-même. Sur l'écran du registre des agents, utilisez l'action Modifier de l'agent et remplissez Propriétaire. Résultat attendu : après Réessayer ou un rechargement, le propriétaire apparaît ici. En cas d'échec : voir la page du registre des agents.
Vérifier le niveau de risque des modèles
- Ouvrir l'onglet Modèles. Cliquez Modèles. Résultat attendu : les modèles avec leur Risque et leur Portée. En cas d'échec : un onglet vide signifie qu'aucun modèle n'est enregistré.
- Repérer les évaluations manquantes. Un modèle sans niveau de risque n'a jamais été évalué. Notez les lignes dont Risque est vide. Résultat attendu : les modèles à évaluer. En cas d'échec : rien à relancer.
- Les évaluer. Créez une évaluation pour chacun sur l'écran Risque et conformité, cible
model:<nom>. Résultat attendu : l'évaluation y est listée. En cas d'échec : voir la page Risque et conformité.
Dépannage
| Symptôme | Cause | Correction |
|---|---|---|
État d'erreur tenant_required (HTTP 403) | Le compte agit sans tenant. | Connectez-vous avec un compte du tenant. |
État d'erreur invalid_request (HTTP 400) avec kind | Un paramètre kind hors des sources connues a été envoyé à l'API. | L'écran n'en envoie pas ; appelez la route sans kind ou avec des types connus. |
| « Rien d'enregistré » dans un onglet | Aucun actif de ce type n'est enregistré pour le tenant. | Enregistrez l'actif avec son manifeste depuis son propre écran. |
| Un niveau de risque reste vide | Aucune évaluation de risque ne vise l'actif. | Créez une évaluation sur l'écran Risque et conformité. |
| « L'API Control Plane est injoignable » | L'API est arrêtée ou l'adresse de l'API du portail est fausse. | Vérifiez le Control Plane et le réglage NEXT_PUBLIC_EAI_API_URL du portail. |