Documentation
Environnements ProtégésPasserelle IA

Passerelle IA

Déployez, configurez et acheminez le trafic LLM backend via le proxy inverse Passerelle IA Orthalon.

Exigence du plan : La surveillance et la découverte sont incluses dans tous les forfaits. Protect, Business et Enterprise peuvent appliquer des politiques actives (Biffer, Guider, Approuver, Bloquer).

La Passerelle IA Orthalon est un proxy inverse sans rétention pour les microservices serveur, les backends applicatifs et les pipelines d'agents. Elle intercepte les requêtes avant les fournisseurs en amont (OpenAI, Anthropic, Gemini), applique les règles DLP et consigne les métadonnées d'audit.


1. Déployer la passerelle

Télécharger le package de déploiement

Télécharger la Passerelle IA Orthalon 0.1.0 (.tar.gz) · Télécharger (.zip)
(Facultatif : vérifier avec la Somme de contrôle SHA-256)

Extraire le package

Accédez à votre dossier Téléchargements (ou le dossier où votre navigateur a enregistré le fichier) et extrayez l'archive :

macOS / Linux (.tar.gz) :

cd ~/Downloads
tar -xzf orthalon-ai-gateway-0.1.0.tar.gz
cd orthalon-ai-gateway-0.1.0

Windows (PowerShell) :

cd $HOME\Downloads
Expand-Archive -Path orthalon-ai-gateway-0.1.0.zip -DestinationPath .
cd orthalon-ai-gateway-0.1.0

Configurer les variables d'environnement

  1. Dans Orthalon, accédez à Opérations → Capteurs et clés et cliquez sur Créer une clé.
  2. Sélectionnez Passerelle IA comme portée et copiez votre Clé de capteur (sk_orthalon_...) et votre Identifiant d'organisation.
  3. Configurez votre environnement de passerelle :

macOS / Linux :

cp gateway.env.example gateway.env

Windows (Invite de commandes) :

copy gateway.env.example gateway.env

Astuce : Vous pouvez également effectuer cette étape sans le terminal : dans votre explorateur de fichiers (Finder ou Explorateur Windows), dupliquez gateway.env.example dans le dossier de la passerelle, renommez la copie en gateway.env, ouvrez-la dans un éditeur de texte (Bloc-notes, VS Code ou TextEdit) et collez votre clé de capteur ainsi que votre identifiant d'organisation.

  1. Dans gateway.env, renseignez vos identifiants :
ORTHALON_SENSOR_KEY=sk_orthalon_votre_cle_passerelle_ici
ORTHALON_ORGANIZATION_ID=org_votre_identifiant_org
PORT=4000

Lancer avec Docker Compose

docker compose --env-file gateway.env up -d

(Alternativement, lancez directement via Node.js : pnpm start / node server.cjs)


2. Pointer vos services backend vers la passerelle

Acheminez vos appels d'API vers la passerelle Orthalon :

OpenAI (Node.js / Python)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "http://localhost:4000/v1", // Achemine via la Passerelle Orthalon
});

Anthropic (SDK Python)

import anthropic

client = anthropic.Anthropic(
    api_key="votre_cle_anthropic",
    base_url="http://localhost:4000" # Achemine via la Passerelle Orthalon
)

3. Tester et valider la protection

  1. Vérifier l'état de la passerelle :
    curl http://localhost:4000/health
  2. Envoyer un appel de test :
    curl http://localhost:4000/v1/chat/completions \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer sk-openai-test-key" \
      -d '{
        "model": "gpt-4o",
        "messages": [{"role": "user", "content": "Internal secret token: AKIAIOSFODNN7EXAMPLE"}]
      }'
  3. Consulter les journaux d'audit : Ouvrez Découverte → Violations dans la console web Orthalon.