Architecture & Concepts Fondamentaux
Boundry est une passerelle de sécurité d'exécution (Execution Firewall) et un système de gouvernance cryptographique dédié aux agents autonomes et aux applications pilotées par des modèles de langage (LLM).
Contrairement aux outils de supervision passive (APM) qui se bornent à journaliser des événements a posteriori, Boundry s'interpose rigoureusement en amont de l'exécution des outils. La passerelle intercepte les arguments d'appels, applique le filtrage DLP à la volée, neutralise les attaques SSRF vers l'intranet ou les métadonnées Cloud, désamorce les injections de prompt indirectes et scelle chaque action dans un registre HMAC immuable.
Accès Rapide aux Guides
Instrumentez un agent en 3 minutes via le SDK Python ou le proxy transparent.
Règles du Pare-feuDéfinissez vos whitelists d'outils, plafonds financiers, fenêtres horaires et quotas.
Injections de PromptDétection heuristique et blocage des tentatives de jailbreak directes et indirectes.
Référence API RESTSpécifications OpenAPI des endpoints de télémétrie, quarantaine et proxy LLM.
Schéma d'Interception du Flux d'Exécution
Le diagramme suivant présente le cycle d'inspection synchrone exécuté lors de chaque appel d'outil déclenché par un agent :
+------------------------------------------------------------------------+
| ENVIRONNEMENT D'EXECUTION (Serveur applicatif, Cluster K8s, Worker) |
| |
| +----------------+ 1. Invocation d'Outil |
| | Agent IA | ---------------------------------+ |
| | (LangChain, | | |
| | CrewAI, etc.) | <--------------------------+ | |
| +----------------+ 4. Execution Autorisee | | |
| | | |
| +----------------------------+ |
| | Boundry Sensor SDK | |
| | - Hook natif in-process | |
| | - Overhead < 3.8ms (p95) | |
| | - Fail-Secure configurable |
| +--------------+-------------+ |
+------------------------------------------------------|-----------------+
| 2. TLS 1.3 / mTLS
| Payload chiffre
v
+------------------------------------------------------------------------+
| PASSERELLE SECOPS BOUNDRY (api.boundry.cloud) |
| |
| +----------------------------------------------------------------+ |
| | Pipeline d'Inspection & Filtrage Pre-Execution | |
| | | |
| | [A] Authentification d'Organisation (Cle API sk_org_...) | |
| | | | |
| | [B] Protection Reseau SSRF (IPs Privees, Metadonnees Cloud) | |
| | | | |
| | [C] Detection d'Injection de Prompt (Directe & Indirecte) | |
| | | | |
| | [D] Caviardage Automatique DLP (Cartes, IBAN, Cles API, PII) | |
| | | | |
| | [E] Validation de Frontieres Metier (Plafonds, Allowlist) | |
| +--------------------------------+-------------------------------+ |
| | |
| +-----------------+-----------------+ |
| v v |
| [Decision : ALLOW] [Decision : BLOCK] |
| | | |
| | 3. Scellement | 3. Alerte |
| | HMAC-SHA256 | Quarantaine |
| v v |
| +----------------------------+ +----------------------------+ |
| | Registre Cryptographique | | Console SecOps & Webhooks | |
| | (Merkle Audit - Art. 12) | | - Notification Slack/Email | |
| +----------------------------+ | - Approbation humaine HITL | |
| +----------------------------+ |
+------------------------------------------------------------------------+
Les Trois Piliers Fondamentaux
1. Le Sensor SDK (Hook In-Process)
Distribué sous forme de paquet standard pour Python (boundry-sensor) et Node.js (@boundry/sensor), le Sensor s'installe directement dans le runtime de vos agents.
- Interception déterministe pré-exécution : Capture les arguments d'outils avant qu'ils ne soient transmis aux couches basses (moteur SQL, API de paiement, terminal shell, système de fichiers).
- Latence maîtrisée : Un overhead mesuré inférieur à 3.8ms (p95) grâce à la mise en cache locale des règles et à l'asynchronisme de la télémétrie.
- Politique de résilience : En cas de défaillance réseau temporaire, vous configurez la passerelle en mode
fail_secure(rejet préventif par défaut) oufail_open(continuité de service avec alerte locale).
2. Le Moteur d'Évaluation de Politiques (Execution Firewall)
Chaque requête transitant par la passerelle est soumise à un pipeline séquentiel d'évaluation sans compromis :
- Authentification & Quotas : Validation cryptographique de l'organisation et contrôle des plafonds d'appels par fenêtre glissante (Token Bucket).
- SSRF & Network Shield : Blocage immédiat de toute tentative d'accès aux adresses de loopback (
127.0.0.1), aux sous-réseaux privés (RFC1918) et aux points de terminaison de métadonnées d'instances Cloud (169.254.169.254). - Détection d'Injections de Prompt : Analyse heuristique et canonique des payloads (détection de base64 obfusqué, homoglyphes cyrilliques, balises de contournement et instructions cachées).
- Filtre DLP (Data Loss Prevention) : Caviardage automatique et immédiat des données sensibles (
[REDACTED_CARD],[REDACTED_API_KEY],[REDACTED_EMAIL]). - Validation des Frontières Opérationnelles (Boundaries) : Contrôle d'autorisation explicite de l'outil et application des plages horaires autorisées.
3. La Chaîne d'Audit Cryptographique (Merkle Proofs)
Chaque décision rendue produit un événement scellé par une clé HMAC-SHA256 propre à votre organisation. Les empreintes numériques sont liées de manière chaînée pour garantir l'intégrité absolue des journaux, répondant directement aux impératifs de traçabilité de l'Article 12 de l'EU AI Act (Règlement UE 2024/1689).
Comparatif des Modes d'Intégration
| Propriété | Sensor SDK (Recommandé) | Proxy Transparent (/v1/chat/completions) |
|---|---|---|
| Environnement | In-process dans le code de l'agent | Passerelle réseau HTTP intermédiaire |
| Frameworks compatibles | LangChain, LangGraph, CrewAI, AutoGPT, LlamaIndex, SDK natif | Tout client HTTP ou SDK officiel OpenAI (openai.OpenAI()) |
| Granularité d'inspection | Paramètres des outils, variables d'état, contexte métier | Corps des prompts et des réponses des modèles |
| Impact sur la latence | Négligeable (< 3.8ms) | Saut réseau standard (~10 à 20ms) |
| Effort de déploiement | 3 lignes de code Python ou TypeScript | Redirection d'URL (OPENAI_BASE_URL) |
Continuer la Lecture
- Modèle de Menaces pour Agents Autonomes : Cartographie des risques d'exécution, du RAG poisoning et des fuites de privilèges.
- Guide d'Installation & Déploiement : Procédures de mise en œuvre sous Docker, Kubernetes et environnements serverless.
- Démarrage Rapide en 3 Minutes : Instrumentez et protégez votre première exécution d'agent.