Réseau
SmartAGT expose quatre interfaces : trois servent vos utilisateurs et vos applications, la quatrième relie le Frontend à l’API. Cette page indique leur placement selon la topologie, leurs réglages par défaut et les flux à autoriser dans vos pare-feu.
Topologies
Le choix de topologie est expliqué dans Préparer un projet.
Accès par défautAccès applications et IAFlux internes et sortants
Les bases et le stockage restent locaux. Les postes utilisateurs accèdent au Frontend service, directement ou via un reverse proxy. Les modèles distants sont des destinations sortantes.
Accès par défautAccès applications et IAFlux entre nœuds et sortants
Les hôtes utilisent des noms DNS internes. Les navigateurs passent par un load balancer placé devant les nœuds Frontend. Les nœuds Backend atteignent directement PostgreSQL et le stockage S3 commun. Le Frontend service joint l’API par le lien interne 8010, directement ou par un load balancer. Sur ce lien, le load balancer fait un simple passage TCP (L4) et ne termine pas le TLS : un intermédiaire qui le termine rompt l’authentification mutuelle. Le pare-feu n’autorise que les clients prévus dans la topologie.
Accès par défautAccès applications et IAFlux entre services et sortants
Le proxy ou l’ingress publie le point d’entrée web. PostgreSQL et S3 ont leurs propres règles d’accès ; seuls les rôles concernés peuvent les joindre. Les certificats sont vérifiés aussi entre conteneurs.
Interfaces exposées
Ces interfaces doivent rester sur votre réseau privé, sans exposition à Internet : voir Exposition réseau.
| Interface | Port | Clients | Défaut | Certificat |
|---|---|---|---|---|
| Frontend | HTTPS 9000 |
Postes utilisateurs Reverse proxy |
0.0.0.0 |
Autosigné, remplaçable |
| API Publique | HTTPS 8000 |
Applications tierces Automatisation Frontend service |
127.0.0.1 |
Autosigné, remplaçable |
| Gateway | HTTPS 8001 |
Clients IA | 0.0.0.0 |
Autosigné, remplaçable |
| Lien interne | mTLS 8010 |
Frontend service | 127.0.0.1 |
Interne SmartAGT |
L’ensemble de ces interfaces se personnalise dans le YAML de leur composant :
- Lien interne : bloc
smartagt.http.internal, avecurletlocal_enrollment_port. - Frontend : bloc
smartagt.http.server. - API Publique : bloc
smartagt.http.public. - Gateway, si AI Gateway est déployé : bloc
smartagt.gateway.server.
Pour ces trois dernières interfaces, les paramètres suivants se personnalisent : host, port, certfile, keyfile et trusted_proxies. host fixe l’interface d’écoute : 0.0.0.0 pour toutes celles du serveur, ou l’adresse IP d’une interface précise.
Plus d’informations : Configuration, Flux entrants et Sécurité.
Matrice des flux
Toutes les liaisons applicatives sont chiffrées en TLS, y compris sur une même VM. Le certificat et le nom du service sont vérifiés sur les liaisons internes gérées par SmartAGT. Le chiffrement vers PostgreSQL s’active avec PostgreSQL SSL ; il est attendu en production. Sur les interfaces exposées, la vérification est complète une fois vos certificats posés avec Installer vos certificats. Les ports ci-dessous correspondent aux procédures ; adaptez les règles aux adresses et ports réellement choisis.
| Source | Destination | Protocole / port | Utilité |
|---|---|---|---|
| Navigateur | Frontend service direct | HTTPS 9000 |
Interface et sessions du PoC |
| Navigateur | Reverse proxy, si retenu | HTTPS 443 |
Origine publique du projet |
| Reverse proxy | Frontend service | HTTPS 9000 |
Interface et streaming |
| Frontend service | API · lien interne | mTLS 8010 |
Tout le trafic applicatif, routes publiques relayées comprises |
| Frontend service | API Publique | HTTPS 8000 |
Rattachement par secret de déploiement, retour après une longue absence et réadmission |
| Application | API Publique | HTTPS 8000 |
Appels à l’API SmartAGT |
| API, workers, Gateway | PostgreSQL | PostgreSQL/TLS 5432 |
Données Platform et index vectoriels |
| Frontend service | PostgreSQL | PostgreSQL/TLS 5432 |
Base propre au Frontend service |
| API et processus concernés | Modèles de conversation | HTTPS, 443 par défaut |
Inférence distante |
API et worker rag-embed |
Modèles d’embedding | HTTPS, 443 par défaut |
Indexation et recherche documentaire |
Les workers attendent le schéma de la base avant de démarrer, sans appel HTTP vers l’API.
| Stockage | Source | Destination | Protocole / port |
|---|---|---|---|
| Intégré (SeaweedFS), sur une VM | API et workers | Stockage local géré par SmartAGT | HTTPS mTLS 8888, local au serveur |
| Intégré (SeaweedFS), sur une VM | Stockage intégré | PostgreSQL | PostgreSQL/TLS 5432 |
| S3 | API et workers | Endpoint du bucket | HTTPS, 443 par défaut |
Sur une VM, les échanges du stockage intégré restent locaux et utilisent TLS avec authentification mutuelle, sous une autorité interne SmartAGT : aucun de vos certificats n’intervient. Le bucket S3 reste privé et son accès est réservé aux identifiants applicatifs. Pour plusieurs nœuds, les flux de stockage se fixent au cadrage du projet.
| Source | Destination | Protocole / port | Utilité |
|---|---|---|---|
| Client IA ou navigateur autorisé | Gateway, direct ou par son proxy | HTTPS 8001 ou 443 |
API JSON/SSE et sonde de la console |
| Proxy Gateway | Processus Gateway | HTTPS 8001 |
Transmission des requêtes et du streaming |
| Gateway | PostgreSQL Platform | PostgreSQL/TLS 5432 |
Droits, clés, nœuds en service et heartbeat |
| Gateway | Fournisseurs autorisés | HTTPS | Exécution des modèles |
AI Gateway partage la base et la KEK Platform. Il ne dépend d’aucune liaison HTTP vers le Frontend service ou l’API Platform. Le pare-feu et la liste des adresses autorisées dans la console Gateway s’appliquent tous deux.
| Service | Source | Destination à autoriser |
|---|---|---|
| SSO OIDC / Entra ID | Navigateur et API | Origines HTTPS du fournisseur d’identité ; URL de retour HTTPS exacte |
| Annuaire Entra ID | API et scheduler |
login.microsoftonline.com, graph.microsoft.com, HTTPS 443 |
| LDAP | API | LDAPS 636 ou STARTTLS obligatoire sur 389 |
| Courriels | API et scheduler |
Relais SMTP avec TLS implicite 465 ou STARTTLS obligatoire 587 |
| Recherche web | API | Origines HTTPS du moteur retenu et, si la lecture de page est activée, des sites autorisés. Le moteur intégré cherche aussi des images sur www.bing.com |
| Connecteurs d’API | API et processus concernés | API métier HTTPS autorisées pour le projet |
| Connecteurs SQL | API et processus concernés | Bases autorisées pour le projet, TLS du moteur : PostgreSQL 5432, MySQL 3306, SQL Server 1433 |
| Connecteurs de partage de fichiers | API et processus concernés | Partages autorisés pour le projet, SMB 3 chiffré et signé 445 |
| Modèles locaux | Poste de préparation ou processus autorisé | HTTPS vers huggingface.co et les sous-domaines de hf.co, CDN des poids compris, uniquement si les poids ne sont pas déposés à la main |
| Catalogue éditeur | API | Référentiel HTTPS communiqué dans la livraison ; import signé possible hors ligne |
| Dépendances | Poste de préparation / hôte d’installation | Dépôts HTTPS autorisés pour le système et les livrables |
Le navigateur peut charger les images de sources et celles de la recherche web depuis leur origine HTTPS, dont *.mm.bing.net pour le moteur intégré. Les domaines des fournisseurs dépendent de l’accès configuré : relevez les endpoints effectivement remis, notamment pour les services privés et régionaux.
Dans le PoC, les postes utilisateurs accèdent au Frontend service sur 9000. Ouvrez au pare-feu l’API Publique 8000 et la Gateway 8001 seulement si des applications ou des clients IA doivent les joindre. Le lien interne 8010, PostgreSQL et le stockage restent locaux au serveur. En projet, autorisez les nœuds clients identifiés dans votre architecture, sans exposer les bases ou le stockage aux postes utilisateurs. Ouvrez 8010 entre serveurs seulement depuis les Frontend services.
Réseau sortant
- Proxy : le proxy sortant et les CA des services externes se règlent dans Plateforme > Réseau sortant (voir Configuration). PostgreSQL, le stockage intégré, LDAP et SMTP ne passent pas par un proxy HTTP. La licence se vérifie localement, sans ouverture Internet générale.
- DNS : la résolution des noms passe par les services d’infrastructure internes.
- Heure : la synchronisation NTP passe par ces mêmes services.