Aller au contenu

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.

Serveur uniqueUne VM porte tous les composants, chacun relié à ses clients
VM SmartAGT
Backend
NavigateurPostes utilisateurs
Applications
Clients IA
FrontendInterface et sessions
APIAgents et logique métier
GatewayAccès aux modèles
WorkersIngestion, indexation et tâches différées
PostgreSQLDonnées, sessions et vecteurs
SeaweedFSFichiers
ModèlesPrivés ou SaaS
FrontendHTTPS :9000 API PubliqueHTTPS :8000 GatewayHTTPS :8001 Lien internemTLS :8010 TLS :5432 TLS :5432 mTLS :8888 HTTPS

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.

ClusterUn bloc par nœud, PostgreSQL et S3 partagés
Backend
NavigateurPostes utilisateurs
Applications
Clients IA
Load balancerEntrée web
VM FrontendInterface et sessions
Load balancerPassage TCP (L4)
VM PlatformAPI Publique, lien interne et Gateway
VM worker(s)Ingestion et indexation
PostgreSQLService partagé
S3Bucket privé commun
ModèlesPrivés ou SaaS
HTTPS :443 FrontendHTTPS :9000 API PubliqueHTTPS :8000 GatewayHTTPS :8001 Lien internemTLS :8010 TLS :5432 TLS :5432 HTTPS HTTPS

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.

KubernetesPostgreSQL et S3 restent des services externes aux conteneurs
Conteneurs applicatifs
Backend
NavigateurPostes utilisateurs
Applications
Clients IA
Ingress ou proxyEntrée web
FrontendService interne
PlatformAPI Publique, lien interne et Gateway
WorkersIngestion et indexation
PostgreSQLService externe
S3Bucket privé externe
ModèlesServices HTTPS
HTTPS :443 FrontendHTTPS :9000 API PubliqueHTTPS :8000 GatewayHTTPS :8001 Lien internemTLS :8010 TLS :5432 TLS :5432 HTTPS HTTPS

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, avec url et local_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.