Restreindre l'accès réseau

Sers-t'en quand tes chaînes doivent rester sur ton propre réseau, par exemple avec un modèle auto-hébergé derrière openai-compatible ou un serveur LibreTranslate derrière libretranslate. Une baseUrl mal tapée, un OPENAI_BASE_URL oublié ou le passage à un fournisseur hébergé enverraient sinon les chaînes vers un point de terminaison public. Avec une politique réseau, verbatra refuse un hôte que la politique n'autorise pas avant qu'aucune requête ne quitte la machine. Le contenu d'une requête est décrit dans Traitement des données et confidentialité.

Définir une politiqueCopier le lien vers cette section

Ajoute un bloc network à la config (network dans la référence) :

network: {
  policy: "local-only",
}

Chaque entrée de allowedHosts est un nom d'hôte (llm.internal, sans tenir compte de la casse), un joker (*.corp.example, sous-domaines seulement, au moins deux labels après *.), une adresse IP ou une plage CIDR comme 100.64.0.0/10. N'écris ni schéma, ni port, ni chemin. Un octet supérieur à 255, un préfixe plus long que l'adresse (au-delà de /32 ou /128) ou une adresse IPv6 malformée est rejeté dès le chargement de la configuration ou de l'environnement.

local-only exclut les adresses link-local (169.254.0.0/16, qui contient l'adresse de métadonnées du cloud, et fe80::/10), la plage NAT d'opérateur 100.64.0.0/10, ainsi que 0.0.0.0 et ::. Si ton serveur écoute sur 0.0.0.0, pointe baseUrl vers 127.0.0.1 ; si tu utilises une plage VPN, ajoute-la à allowedHosts.

Fournisseurs hébergésCopier le lien vers cette section

Sous local-only, anthropic, openai, gemini, deepl, google-translate et opencode sont refusés, car leurs points de terminaison sont publics. Pour en autoriser un, liste son hôte :

network: {
  policy: "local-only",
  allowedHosts: ["api.deepl.com"],
}

Les hôtes sont api.anthropic.com, api.openai.com, generativelanguage.googleapis.com, api.deepl.com (api-free.deepl.com pour une clé qui finit par :fx), translation.googleapis.com et opencode.ai. Si ANTHROPIC_BASE_URL, OPENAI_BASE_URL ou GOOGLE_GEMINI_BASE_URL est définie, verbatra vérifie ce point de terminaison à la place. Gemini en mode Vertex AI (GOOGLE_GENAI_USE_VERTEXAI ou GOOGLE_GENAI_USE_ENTERPRISE à true) est toujours refusé sous une politique restrictive.

Imposer une politique depuis l'environnementCopier le lien vers cette section

Pour imposer une politique en CI, quoi que dise la config du dépôt :

export VERBATRA_NETWORK_POLICY=local-only
export VERBATRA_NETWORK_ALLOWED_HOSTS=gpu.lan,10.20.0.0/16

VERBATRA_NETWORK_ALLOWED_HOSTS est une liste d'entrées allowedHosts séparées par des virgules. Quand la config et l'environnement définissent tous deux une politique, un hôte doit satisfaire les deux, donc une config ne peut jamais assouplir ce que l'environnement impose.

Une valeur inconnue, comme local_only, ou la liste d'hôtes sans la variable de politique fait échouer l'exécution avec CONFIG_INVALID au lieu d'autoriser tous les hôtes. translate --dry-run et --estimate vérifient aussi ces variables, sauf avec le fournisseur none.

Vérifier la politiqueCopier le lien vers cette section

Lance verbatra doctor : il indique la politique effective, l'origine de chaque partie, l'hôte du fournisseur et si cet hôte est autorisé. Il ne résout aucun nom et n'envoie rien, et la liste des langues que récupère doctor --live est soumise à la même politique.

Un hôte refusé arrête translate, watch au démarrage, la retraduction dans Studio et MCP, et retranslateEntry du SDK avec NETWORK_POLICY_VIOLATION et le code de sortie 2, avant qu'aucune clé ne soit lue. Une exécution à blanc et --estimate n'appellent aucun fournisseur, donc ils ne sont pas refusés.

Savoir quand les requêtes sont vérifiéesCopier le lien vers cette section

La première vérification ne résout aucun nom, donc un nom d'hôte qu'elle ne sait pas classer seule, comme llm.internal, la passe. Chaque requête de anthropic, openai, gemini, google-translate, opencode, openai-compatible et libretranslate est vérifiée de nouveau juste avant l'envoi :

• un nom d'hôte est résolu, et chaque adresse vers laquelle il résout doit être autorisée ;
• seul un 307 ou 308 vers la même origine est suivi, jusqu'à cinq d'affilée ; une redirection vers une autre origine, y compris de https vers http, fait échouer la requête.

Une requête refusée ici fait échouer son sous-lot avec l'erreur de fournisseur NETWORK_POLICY_VIOLATION, qui ne nomme que l'hôte, et n'est jamais relancée.

LimitesCopier le lien vers cette section

• DNS rebinding. Le nom est résolu une fois pour la vérification et de nouveau pour la connexion, donc un serveur DNS qui répond autrement peut passer. Écris une adresse IP, ou liste le nom dans allowedHosts, auquel on fait confiance sans le résoudre.
• DeepL est vérifié une seule fois, avant la construction du fournisseur, pas à chaque requête ni redirection.
• Proxys. Sous une politique restrictive, chaque proxy que le fournisseur utiliserait doit lui-même être autorisé, comme adresse IP ou nom listé. DeepL utilise HTTPS_PROXY, HTTP_PROXY et ALL_PROXY, ou leur forme en minuscules ; les autres fournisseurs ne les utilisent que sous Node 24 avec NODE_USE_ENV_PROXY=1 ou --use-env-proxy. NO_PROXY est ignoré.
• Fournisseurs personnalisés. Un fournisseur passé via createProvider du SDK est vérifié avant sa construction et reçoit la politique effective ; l'appliquer à ses propres requêtes revient à ce code.

Traduction automatique sans modèle de langageCopier le lien vers cette section

Certains NDA interdisent les modèles de langage mais acceptent la traduction automatique classique sur ton propre matériel. LibreTranslate, c'est exactement ça : un serveur open source avec des modèles Argos Translate. Lance-le avec les langues dont tu as besoin :

docker run -d -p 5000:5000 libretranslate/libretranslate --load-only en,de,fr

Puis pointe verbatra dessus et verrouille le réseau :

provider: {
  id: "libretranslate",
  options: { baseUrl: "http://127.0.0.1:5000" },
},
network: { policy: "local-only" },

verbatra doctor --locales --live vérifie chaque locale cible par rapport aux modèles installés. Ses valeurs sont tout de même enregistrées avec l'origine machine.

Voir aussiCopier le lien vers cette section

• network : la clé de config.
• verbatra doctor : vérifier la politique sans traduire.
• Traitement des données et confidentialité : ce qui quitte la machine, et quand.