PostgreSQL SSL
Cette procédure impose SSL aux connexions des composants SmartAGT vers PostgreSQL, et leur fait vérifier le certificat du serveur, en trois étapes.
Prérequis
- PostgreSQL préparé : Préparer PostgreSQL.
- SSL activé sur le serveur PostgreSQL, avec un certificat qui porte le nom utilisé par SmartAGT pour le joindre : documentation PostgreSQL.
- Le certificat de l'autorité (CA) qui a signé ce certificat, au format PEM.
- PostgreSQL préparé : Préparer PostgreSQL.
- SSL activé sur chaque serveur PostgreSQL de l'instance, avec un certificat qui porte le nom de l'adresse virtuelle, par exemple
postgres.example.test: documentation PostgreSQL. - Le certificat de l'autorité (CA) qui a signé ces certificats, au format PEM.
Procédure
1. Exiger SSL pour les rôles SmartAGT
Dans pg_hba.conf, remplacez les règles SmartAGT posées à Préparer PostgreSQL par celles-ci, toujours avant les autorisations générales existantes :
hostnossl smartagt,smartagt_vector,smartagt_bff all 0.0.0.0/0 reject
hostnossl smartagt,smartagt_vector,smartagt_bff all ::/0 reject
hostssl smartagt,smartagt_vector smartagt 127.0.0.1/32 scram-sha-256
hostssl smartagt,smartagt_vector smartagt ::1/128 scram-sha-256
hostssl smartagt_bff smartagt_bff 127.0.0.1/32 scram-sha-256
hostssl smartagt_bff smartagt_bff ::1/128 scram-sha-256
host all smartagt,smartagt_bff 0.0.0.0/0 reject
host all smartagt,smartagt_bff ::/0 reject
Les deux premières règles refusent toute connexion sans SSL aux bases SmartAGT ; les deux rejets finaux empêchent les rôles SmartAGT de retomber sur une autorisation générale.
Sur chaque serveur PostgreSQL de l'instance, dans pg_hba.conf, remplacez les règles SmartAGT posées à Préparer PostgreSQL par celles-ci, toujours avant les autorisations générales existantes :
hostnossl smartagt,smartagt_vector,smartagt_bff all 0.0.0.0/0 reject
hostnossl smartagt,smartagt_vector,smartagt_bff all ::/0 reject
hostssl smartagt,smartagt_vector smartagt <CIDR des nœuds Backend> scram-sha-256
hostssl smartagt_bff smartagt_bff <CIDR des nœuds Frontend> scram-sha-256
host all smartagt,smartagt_bff 0.0.0.0/0 reject
host all smartagt,smartagt_bff ::/0 reject
Les deux premières règles refusent toute connexion sans SSL aux bases SmartAGT. Les deux rejets finaux empêchent les rôles SmartAGT de retomber sur une autorisation générale.
Rechargez ensuite la configuration :
sudo -u postgres psql -X -c 'SELECT pg_reload_conf();' -c 'SHOW ssl;'
& 'C:\app\PostgreSQL\18\bin\psql.exe' -X -h localhost -U postgres -d postgres -c 'SELECT pg_reload_conf();' -c 'SHOW ssl;'
Résultat attendu : ssl vaut on.
2. Placer l'autorité
Copiez le certificat de l'autorité dans /app/cert, où le Backend et le Frontend le lisent :
Sur chaque nœud Backend et Frontend, copiez le certificat de l'autorité dans /app/cert, où les services le lisent :
sudo install -D -m 644 <certificat de l'autorité> /app/cert/postgresql-ca.crt
New-Item -ItemType Directory -Force C:\app\cert | Out-Null
Copy-Item <certificat de l'autorité> C:\app\cert\postgresql-ca.crt
Si l'autorité est déjà dans le magasin de certificats du système, passez cette étape.
Résultat attendu : postgresql-ca.crt est dans /app/cert (C:\app\cert sous Windows).
3. Déclarer SSL dans le YAML
Ajoutez ces clés sous smartagt.core.database, dans le YAML du Backend et dans celui du Frontend :
smartagt:
core:
database:
host: postgres.example.test # nom porté par le certificat du serveur
sslmode: verify-full # SSL imposé, nom du serveur vérifié
sslrootcert: /app/cert/postgresql-ca.crt # autorité, facultative si elle est dans le magasin du système
Redémarrez ensuite les services :
sudo systemctl restart SmartAGT-Platform-Service smartagt-rag-ingestor-worker smartagt-rag-embed-worker smartagt-scheduler-worker SmartAGT-AI-Gateway-Service smartagt-frontend-service
smartagt:
core:
database:
host: postgres.example.test # nom porté par le certificat du serveur
sslmode: verify-full # SSL imposé, nom du serveur vérifié
sslrootcert: C:/app/cert/postgresql-ca.crt # autorité, facultative si elle est dans le magasin du système
Redémarrez ensuite les services :
Restart-Service SmartAGT-Platform-Service, smartagt-rag-ingestor-worker, smartagt-rag-embed-worker, smartagt-scheduler-worker, SmartAGT-AI-Gateway-Service, smartagt-frontend-service
Résultat attendu : les services redémarrent et se connectent ; un nom hors du certificat ou une autorité inconnue les arrête avec une erreur de vérification SSL.
Sur chaque nœud, ajoutez ces clés sous smartagt.core.database, dans le YAML du Backend ou dans celui du Frontend :
smartagt:
core:
database:
host: postgres.example.test # adresse virtuelle, portée par le certificat
sslmode: verify-full # SSL imposé, nom du serveur vérifié
sslrootcert: /app/cert/postgresql-ca.crt # autorité, facultative si elle est dans le magasin du système
Redémarrez ensuite les services de ce nœud, un nœud après l'autre :
sudo systemctl restart <services de ce nœud>
smartagt:
core:
database:
host: postgres.example.test # adresse virtuelle, portée par le certificat
sslmode: verify-full # SSL imposé, nom du serveur vérifié
sslrootcert: C:/app/cert/postgresql-ca.crt # autorité, facultative si elle est dans le magasin du système
Redémarrez ensuite les services de ce nœud, un nœud après l'autre :
Restart-Service <services de ce nœud, séparés par des virgules>
Résultat attendu : sur chaque nœud, les services redémarrent et se connectent. Un nom hors du certificat ou une autorité inconnue les arrête avec une erreur de vérification SSL.
Cas particuliers
Composants SmartAGT sur d’autres serveurs
Ajoutez des règles hostssl avec les adresses ou CIDR précis des hôtes autorisés, avant les deux rejets finaux :
hostssl smartagt,smartagt_vector smartagt <CIDR des hôtes Backend> scram-sha-256
hostssl smartagt_bff smartagt_bff <CIDR des hôtes Frontend> scram-sha-256
Le certificat du serveur doit couvrir le nom DNS de PostgreSQL utilisé par ces hôtes. Placez l'autorité sur chaque hôte SmartAGT.
Bascule de l'instance
Après une bascule, les nœuds rejoignent le nouveau primaire par la même adresse virtuelle. Son certificat doit porter ce nom et être signé par la même autorité, sans quoi verify-full refuse la connexion.
Références PostgreSQL 18 : SSL côté serveur, vérification par le client, règles d’authentification.