Secrets
Cette page liste les secrets à conserver et la façon de les protéger sur les serveurs.
Secrets à conserver
Conservez ces secrets dans un coffre.
| Secret | Usage |
|---|---|
| KEK Backend | Protéger les clés de chiffrement utilisées par Platform et ses workers |
| KEK Frontend | Protéger les clés propres au Frontend |
| Mots de passe PostgreSQL | Authentifier le rôle de chaque composant sur ses bases |
| Clés fournisseurs | Authentifier les appels aux modèles et aux services raccordés |
Mot de passe du compte admin défini à l’activation |
Administrer SmartAGT. Le mot de passe à usage unique d’init est remplacé à la première connexion |
Les processus Backend partagent la KEK Backend, le Frontend possède la sienne. Ces clés doivent être conservées entre les démarrages : un remplacement du package doit retrouver les bases, les fichiers et les clés de chiffrement.
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.
Pour aller plus loin
- La KEK peut être lue depuis un coffre : Vault.
- Pour changer le mot de passe d’un rôle : Changer un mot de passe PostgreSQL.