Gateway IA

Distribuisci, configura e instrada il traffico LLM di backend attraverso il reverse proxy Gateway IA di Orthalon.

Requisito del piano: Il monitoraggio e il rilevamento sono inclusi in tutti i piani. Protect, Business ed Enterprise possono applicare policy attive (Oscura, Avvisa, Richiedi approvazione, Blocca).

Il Gateway IA di Orthalon è un reverse proxy a zero ritenzione progettato per microservizi server e backend di applicazioni LLM. Intercetta le richieste prima dei provider a monte (OpenAI, Anthropic, Gemini), valuta le regole DLP e registra i metadati di controllo.

1. Distribuire il Gateway

Scaricare il pacchetto di distribuzione

Scarica Gateway IA Orthalon 0.1.0 (.tar.gz) · Scarica (.zip)
(Facoltativo: verifica con il Checksum SHA-256)

Estrarre il pacchetto

Accedi alla cartella Download (o alla directory in cui è stato salvato il file) ed estrai l'archivio:

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

Configurare le variabili d'ambiente

In Orthalon, vai su Operazioni → Sensori e chiavi e fai clic su Crea chiave.
Seleziona Gateway IA come ambito e copia la tua Chiave del sensore (sk_orthalon_...) insieme al tuo ID organizzazione.
Configura l'ambiente del tuo gateway:

macOS / Linux:

cp gateway.env.example gateway.env

Windows (Prompt dei comandi):

copy gateway.env.example gateway.env

Suggerimento: È possibile eseguire questo passaggio anche senza il terminale: nel tuo gestore file (Finder o Esplora file), duplica gateway.env.example nella cartella del gateway, rinomina la copia in gateway.env, aprila in un editor di testo (Blocco note, VS Code o TextEdit) e incolla la tua chiave del sensore e l'ID organizzazione.

In gateway.env, imposta le tue credenziali:

ORTHALON_SENSOR_KEY=sk_orthalon_tua_chiave_gateway_qui
ORTHALON_ORGANIZATION_ID=org_tuo_id_organizzazione
PORT=4000

Avviare con Docker Compose

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

(In alternativa, esegui direttamente tramite Node.js: pnpm start / node server.cjs)

2. Indirizzare i servizi di backend verso il Gateway

Instrada le applicazioni di backend verso il Gateway Orthalon:

OpenAI (Node.js / Python)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "http://localhost:4000/v1", // Instrada tramite il Gateway Orthalon
});

Anthropic (SDK Python)

import anthropic

client = anthropic.Anthropic(
    api_key="tua_chiave_anthropic",
    base_url="http://localhost:4000" # Instrada tramite il Gateway Orthalon
)

3. Testare e convalidare la protezione

Verificare lo stato del Gateway:
```
curl http://localhost:4000/health
```

Inviare una richiesta di 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"}]
  }'

Esaminare i log di controllo: Apri Rilevamento → Violazioni nella console web di Orthalon.

Gateway IA

On this page