Sécuriser l'installation
L'installation de base chiffre toutes les interfaces avec des certificats générés par SmartAGT. Avant un usage durable, appliquez cette liste de contrôle.
Prérequis
- Backend et Frontend installés : Installer le Backend, Installer le Frontend.
Liste de contrôle
- Garder SmartAGT sur un réseau privé : aucune exposition directe à Internet. Exposition réseau
- Installer vos certificats : authentification du serveur par les clients. Installer vos certificats
- PostgreSQL SSL : connexions chiffrées et serveur vérifié. PostgreSQL SSL
- Protéger les secrets : accès réservé aux administrateurs. Protéger les secrets
- Filtrer les flux : ports ouverts aux seuls clients autorisés. Filtrer les flux
Protéger les secrets
Les KEK et les mots de passe des rôles PostgreSQL ne vivent que dans l'environnement des services :
- jamais dans un YAML, un script ou un fichier partagé ;
- saisis sans affichage, jamais en argument de commande, qui resterait dans l'historique ;
- dans une console fermée une fois l'opération terminée ;
- lisibles par les seuls administrateurs.
Les fichiers d'environnement sont réservés à root à l'installation. Vérifiez-le :
sudo stat -c '%a %U %n' /etc/smartagt/backend.env /etc/smartagt/bff.env
Résultat attendu : chaque fichier affiche 600 root.
L'environnement d'un service est enregistré dans sa clé de registre, lisible par défaut par tous les utilisateurs du serveur. Réservez ces clés aux administrateurs et au système :
$names = 'SmartAGT-Platform-Service', 'smartagt-rag-ingestor-worker', 'smartagt-rag-embed-worker', 'smartagt-scheduler-worker', 'SmartAGT-AI-Gateway-Service', 'smartagt-frontend-service'
foreach ($name in $names) {
$key = [Microsoft.Win32.Registry]::LocalMachine.OpenSubKey("SYSTEM\CurrentControlSet\Services\$name", 'ReadWriteSubTree', 'ChangePermissions, ReadPermissions')
$acl = $key.GetAccessControl()
$acl.SetAccessRuleProtection($true, $false)
foreach ($rule in @($acl.Access)) { [void]$acl.RemoveAccessRule($rule) }
foreach ($sid in 'S-1-5-32-544', 'S-1-5-18') {
$acl.AddAccessRule((New-Object Security.AccessControl.RegistryAccessRule((New-Object Security.Principal.SecurityIdentifier $sid), 'FullControl', 'ContainerInherit', 'None', 'Allow')))
}
$key.SetAccessControl($acl)
$key.Close()
}
Résultat attendu : (Get-Acl HKLM:\SYSTEM\CurrentControlSet\Services\SmartAGT-Platform-Service).Access ne liste que BUILTIN\Administrateurs et AUTORITE NT\Système.
Appliquez ce contrôle sur chaque nœud, pour les services qu'il porte.
Les fichiers d'environnement sont réservés à root à l'installation : backend.env sur les nœuds Backend, bff.env sur les nœuds Frontend. Vérifiez-le :
sudo stat -c '%a %U %n' /etc/smartagt/*.env
Résultat attendu : chaque fichier affiche 600 root.
L'environnement d'un service est enregistré dans sa clé de registre, lisible par défaut par tous les utilisateurs du serveur. Réservez ces clés aux administrateurs et au système. La boucle ne traite que les services présents sur le nœud :
$names = 'SmartAGT-Platform-Service', 'smartagt-rag-ingestor-worker', 'smartagt-rag-embed-worker', 'smartagt-scheduler-worker', 'SmartAGT-AI-Gateway-Service', 'smartagt-frontend-service'
foreach ($name in $names | Where-Object { Test-Path "HKLM:\SYSTEM\CurrentControlSet\Services\$_" }) {
$key = [Microsoft.Win32.Registry]::LocalMachine.OpenSubKey("SYSTEM\CurrentControlSet\Services\$name", 'ReadWriteSubTree', 'ChangePermissions, ReadPermissions')
$acl = $key.GetAccessControl()
$acl.SetAccessRuleProtection($true, $false)
foreach ($rule in @($acl.Access)) { [void]$acl.RemoveAccessRule($rule) }
foreach ($sid in 'S-1-5-32-544', 'S-1-5-18') {
$acl.AddAccessRule((New-Object Security.AccessControl.RegistryAccessRule((New-Object Security.Principal.SecurityIdentifier $sid), 'FullControl', 'ContainerInherit', 'None', 'Allow')))
}
$key.SetAccessControl($acl)
$key.Close()
}
Résultat attendu : sur chaque nœud, Get-Acl sur la clé d'un service SmartAGT ne liste que BUILTIN\Administrateurs et AUTORITE NT\Système.
Filtrer les flux
Ouvrez chaque port, en entrée sur le pare-feu du serveur, aux seuls clients prévus. La matrice complète des flux figure dans Réseau.
| Port | Écoute par défaut | À ouvrir à |
|---|---|---|
9000 Frontend |
Toutes les adresses | Postes des utilisateurs, ou reverse proxy seul |
8000 API Publique |
Boucle locale | Applications, si l'API est exposée (YAML Avancé du Backend) |
8001 AI Gateway |
Toutes les adresses | Outils raccordés, aussi autorisés dans la liste Réseau de la console |
8010 Lien interne |
Boucle locale | Serveurs du Frontend, en installation répartie |
Ouvrez chaque port, en entrée sur le pare-feu des nœuds qui le portent, aux seuls clients prévus. Les postes des utilisateurs et les outils raccordés passent par le reverse proxy et les load balancers, jamais directement par un nœud. La matrice complète des flux figure dans Réseau.
| Port | Nœuds | À ouvrir à |
|---|---|---|
9000 Frontend |
Nœuds Frontend | Reverse proxy seul |
8000 API Publique |
Nœuds Platform | Nœuds Frontend, pour le rattachement, et load balancer de l'API si des applications l'appellent |
8001 AI Gateway |
Nœuds du rôle gateway |
Load balancer de la Gateway seul |
8010 Lien interne |
Nœuds Platform | Load balancer du lien interne seul |