Aller au contenu

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