ai-guardby OVPT
GitHub

TECHNIQUE / AI-GUARD

Comprendre
le cadre.

Ce qui décide. Ce qui exécute.
Ce qui laisse une trace.

Une lecture de l’architecture documentée, de ses limites et de la cible du projet.

Explorer le code sur GitHub ↗

Trois rôles.
Des limites distinctes.

Rust pour les mécanismes.
Une interface pour comprendre.
Des adaptateurs pour le terrain.

EXPLORER LE MODÈLE

Votre machine.
Vos règles.

Architecture locale documentée.
Docker / Podman, rootless par défaut.

SCHÉMA 01

Qui lance. Qui observe.

Le broker commande Docker ou Podman, qui crée et inspecte le worker. Le worker utilise une copie dans un volume de session. Le broker envoie les traces au collecteur Rust, qui conserve l’audit SQLite et expose la lecture au dashboard. Le dashboard ne lance aucune commande.
Flux logiques simplifiés du parcours local documenté. Le broker et le moteur restent de confiance ; la configuration du runtime doit être vérifiée sur l’hôte.
Sources et périmètre

README : « Ce que le produit fait », « Lire les actions et les événements » et « Exporter, vérifier et arrêter ». Le relais HTTP d’entrée est omis pour la lisibilité ; il est distinct du relais métier inter-workers cible.

Documentation fournie · 29 octobre 2026

Le cadre local documenté sépare le broker de confiance, le dashboard consultatif et les workers Docker / Podman. Rootless est le mode par défaut. Cette présentation ne remplace pas les tests du runtime et de sa configuration.

LOCAL DOCUMENTÉ
RUSTTYPESCRIPT / JSDOCKERPODMANKUBERNETES CIBLE CLOUD

Savoir ce qui
est contrôlé.

L’interface explique. Le broker décide du lancement. Le runtime porte les restrictions d’exécution.

Ces rôles ne sont pas interchangeables. Le choix de Rust, un journal ou une décision d’IA ne suffisent pas à prouver le confinement.

SCHÉMA 02

Avant d’exécuter, décider.

La demande authentifiée est transmise au broker. L’audit obligatoire et la politique précèdent le lancement. Une autorisation permet de préparer la copie et de lancer le worker via le runtime. Refus, attente d’approbation ou audit indisponible bloquent le lancement métier, sans repli sur l’hôte. Un résultat sans preuve reste inconnu.
Schéma du contrat de décision. Le contrôle porte sur l’invocation soumise au broker, pas sur chacune des commandes internes de l’agent. Les scénarios de panne demandent une qualification propre.
Sources et périmètre

README : « Ce que le produit fait », « Profils de sécurité », « Jev optionnel » et « Limites à connaître ». Architecture : section 6, cycle d’une action et reprise ; ce contrat documentaire ne constitue pas une preuve d’exécution.

Documentation fournie · 29 octobre 2026
01

Copie de travail & runtime

Le README décrit une copie filtrée dans un volume de session, un worker non privilégié, une racine en lecture seule et un réseau coupé par défaut. L’export vise une nouvelle destination.

À VÉRIFIER SUR L’HÔTE

Inspecter les montages, droits et restrictions sur le moteur choisi. Le broker, le moteur et leur administrateur restent de confiance.

02

Décision avant lancement

Les profils strict, review et observe encadrent l’invocation soumise au broker. La demande et sa décision sont tracées ; un refus ou un audit obligatoire indisponible bloque ce parcours.

PORTÉE DÉFINIE

Cette décision ne contrôle pas individuellement toutes les commandes internes d’un agent ou d’un script. Le réseau bridge optionnel ne fournit pas de filtrage applicatif.

03

Audit & observation

L’audit SQLite est indépendant du worker. Il distingue demandes, décisions, démarrages observés et résultats. Les déclarations des fournisseurs restent identifiées comme telles.

COUVERTURE VISIBLE

Les sorties Codex/Claude décrites sont normalisées après la session. Une valeur absente reste inconnue. Persistance, reprise et intégrations demandent leurs propres preuves.

04

Jev, en option

Le README décrit un client Jev en Rust, désactivé par défaut. Il apporte une aide à la décision ; un refus déterministe ne devient pas une autorisation.

SERVICE À QUALIFIER

Les essais auprès du service réel restent à confirmer. Jev ne remplace ni le broker ni le confinement du runtime.

SCHÉMA 03

Une copie pour agir. Un export pour choisir.

Le projet original alimente une copie filtrée dans un volume de session. L’agent travaille dans cette copie. L’export explicite écrit dans une destination neuve, hors du projet original, sans remplacement des fichiers existants. L’utilisateur décide ensuite de réintégrer les modifications.
Le projet original n’est pas monté dans le worker. Les contrôles d’import et d’export ont leurs limites ; la copie filtrée n’est pas un scanner universel de secrets.
Sources et périmètre

README : « Ce que le produit fait », « Exporter, vérifier et arrêter », « Limites à connaître ». Architecture : section 3, séparation des fichiers et des clients.

Documentation fournie · 29 octobre 2026

Une permission.
Un échange.

Deux workers pour le client A.
Un pour le client B.
Choisissez une route. Testez la règle.

SIMULATION PÉDAGOGIQUE
AI-GUARD / SANDBOX LABDONNÉES SIMULÉES
CLIENT A2 WORKERS
A1SOURCE
A2DESTINATION
CLIENT B1 WORKER
B1AUTRE TENANT
01 / CHOISIR UNE ROUTE
02 / AUTORISATION A1 → A2
Le cadre est posé.

Lancez un échange pour découvrir la décision et sa trace.

READY
JOURNAL DE DÉMONSTRATION
  1. Aucun échange simulé pour le moment.

Cette interaction explique le modèle d’autorisation cible, dont le relais n’est pas présenté comme livré. Elle ne démontre ni le confinement d’un runtime, ni la qualification de sécurité du produit.

Une direction claire.
Des preuves à établir.

Le projet est ouvert sous Apache-2.0 et poursuit son développement.

Le tableau sépare les mécanismes décrits dans la documentation des cibles et de leur qualification. Il ne remplace pas les résultats courants du dépôt.

DOCUMENTÉ

Parcours local

Copie, broker Rust, workers Docker/Podman, dashboard, audit et export sont décrits dans le README. La disponibilité et les limites d’une version se vérifient dans le dépôt.

À QUALIFIER

Exécution réelle

Chaque couple système/moteur, chaque intégration agent et les scénarios de panne doivent disposer de leurs propres résultats reproductibles.

CIBLE

Relais & cloud

Le registre multi-client, les quotas, le relais métier et le registre d’usage ne sont pas annoncés comme livrés. L’orchestration Kubernetes et l’offre cloud restent à construire et qualifier.

Le dossier de préparation à la production rectifie d’anciennes annonces de fonctions livrées. Les tests historiques ne qualifient pas automatiquement la version actuelle. Les fichiers docs/engineering/CURRENT_STATE.md et docs/engineering/VALIDATION.md sont les références d’avancement indiquées par le projet.