Aller au contenu

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

Liste de contrôle

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