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 et les flux à autoriser dans vos pare-feu.
Interfaces exposées
| Interface | Port | Clients | Exposition par défaut | Certificat |
|---|---|---|---|---|
| Frontend | HTTPS 9000 |
Postes utilisateurs, ou reverse proxy | Toutes les interfaces du serveur (0.0.0.0) |
Autosigné par défaut, ou le vôtre |
| API Publique | HTTPS 8000 |
Applications ; Frontend service lors de son rattachement | Boucle locale ; adresse du serveur pour des applications ou un Frontend service distant | Autosigné par défaut, ou le vôtre |
| Gateway | HTTPS 8001 |
Clients IA autorisés, si AI Gateway est déployé | Toutes les interfaces du serveur (0.0.0.0) |
Autosigné par défaut, ou le vôtre |
| Lien interne | mTLS 8010 |
Frontend service seulement | Boucle locale ; entre serveurs, ouvert aux seuls Frontend services | SmartAGT, renouvelé automatiquement |
Ces interfaces restent sur votre réseau privé : Exposition réseau.
L’API Publique se règle sous smartagt.http.public, la Gateway sous smartagt.gateway.server. Les certificats et les responsabilités sont détaillés dans Sécurité.
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.
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, admission 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 |
| Connecteurs | API et processus concernés | API métier HTTPS autorisées pour le projet |
| Modèles locaux | Poste de préparation ou processus autorisé | Dépôt HTTPS des poids, uniquement si les fichiers ne sont pas prépositionnés |
| 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 depuis leur origine HTTPS. 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.