Aller au contenu

PostgreSQL

Cette procédure impose SSL aux connexions des composants SmartAGT vers PostgreSQL, et leur fait vérifier le certificat du serveur, en trois étapes.

  1. Règles d'accèsSSL exigé pour SmartAGT
  2. AutoritéCertificat de la CA
  3. YAMLBackend et Frontend

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.