Aller au contenu

Certificats

Cette étape est facultative. Par défaut, le Frontend (9000), l’API Publique (8000) et la Gateway (8001) répondent en HTTPS avec un certificat autosigné généré par SmartAGT. Le flux est chiffré, mais les clients ne reconnaissent pas ce certificat : le navigateur affiche une alerte et curl demande l’option -k. Cette procédure pose vos propres certificats.

Tant qu’aucun certificat de confiance n’est installé, le chiffrement ne garantit pas l’identité du serveur : un tiers placé sur le réseau pourrait se faire passer pour lui. Ce compromis convient à un PoC. Pour un usage durable, posez vos certificats.

En cluster, chaque nœud Frontend reçoit son certificat à l'installation : SmartAGT ne le génère qu'en serveur unique. L’API Publique (8000) et la Gateway (8001) répondent par défaut avec un certificat autosigné généré par SmartAGT pour chaque nœud. Cette procédure pose vos certificats sur les nœuds, ou les renouvelle.

Les clients joignent SmartAGT par le reverse proxy et les load balancers. Le certificat du nom public s'installe sur eux, selon leur documentation. Ceux des nœuds authentifient chaque nœud auprès du reverse proxy et des load balancers.

Le lien interne entre le Frontend et l’API est géré par SmartAGT et ne demande aucun certificat. Le chiffrement de PostgreSQL se prépare avec PostgreSQL SSL.

Prérequis

  • Composants installés : Installer le Backend, Installer le Frontend et, si vous l’utilisez, Activer AI Gateway.
  • Pour chaque interface à équiper, un certificat PEM émis par votre autorité, avec sa chaîne intermédiaire, et sa clé privée PEM utilisable sans saisie interactive.
  • Un champ SAN qui couvre le nom DNS utilisé par les clients, par exemple smartagt.example.test.
  • Des postes et applications clientes qui font confiance à votre autorité.
  • Console avec sudo (Linux) ou PowerShell 64 bits administrateur (Windows).
  • Composants installés sur leurs nœuds : Installer le Backend, Installer le Frontend et, si vous l’utilisez, Activer AI Gateway.
  • Pour chaque nœud et chaque interface à équiper, un certificat PEM émis par votre autorité, avec sa chaîne intermédiaire, et sa clé privée PEM utilisable sans saisie interactive.
  • Un champ SAN qui couvre le nom par lequel le reverse proxy ou le load balancer joint ce nœud, par exemple platform-1.example.test.
  • Un reverse proxy et des load balancers qui font confiance à votre autorité.
  • Console avec sudo (Linux) ou PowerShell 64 bits administrateur (Windows).

Procédure

1. Déposer les fichiers

Copiez chaque certificat et sa clé dans le dossier TLS du composant, sans modifier les droits de ce dossier :

Sur chaque nœud, copiez le certificat de ce nœud et sa clé dans le dossier TLS du composant :

Interface Dossier Fichiers
Frontend 9000 /app/config/bff/tls/ ou C:\app\config\bff\tls\ server.crt, server.key
API Publique 8000 /app/config/backend/tls/ ou C:\app\config\backend\tls\ server.crt, server.key
Gateway 8001 /app/config/backend/tls/ ou C:\app\config\backend\tls\ gateway.crt, gateway.key

Chaque fichier .crt contient le certificat serveur, puis ses certificats intermédiaires dans l'ordre de la chaîne. L'autorité racine est une ancre de confiance à installer côté client ; SmartAGT ne demande pas de fichier ca.crt pour servir ces interfaces.

Exemple pour le Frontend :

sudo install -d -o svc-smartagt-bff -g svc-smartagt-bff -m 700 /app/config/bff/tls
sudo install -o svc-smartagt-bff -g svc-smartagt-bff -m 600 server.crt server.key /app/config/bff/tls/

Pour l'API Publique et la Gateway, utilisez le dossier /app/config/backend/tls et le compte svc-smartagt-backend. Copiez alors les fichiers du tableau.

New-Item -ItemType Directory -Force C:\app\config\bff\tls | Out-Null
Copy-Item server.crt, server.key C:\app\config\bff\tls\

Les services créés par la procédure d'installation utilisent SYSTEM. Restreignez l'accès à la clé privée à SYSTEM et aux administrateurs ; si vous utilisez un autre compte de service, accordez-lui aussi la lecture. Pour l'API Publique et la Gateway, utilisez le dossier Backend et les fichiers du tableau.

Résultat attendu : chaque interface a son certificat et sa clé dans le dossier du tableau.

Exemple pour un nœud Platform :

sudo install -d -o svc-smartagt-backend -g svc-smartagt-backend -m 700 /app/config/backend/tls
sudo install -o svc-smartagt-backend -g svc-smartagt-backend -m 600 server.crt server.key /app/config/backend/tls/

Les fichiers sont réservés au compte du service. Sur un nœud Frontend, utilisez le dossier Frontend et le compte svc-smartagt-bff.

New-Item -ItemType Directory -Force C:\app\config\backend\tls | Out-Null
Copy-Item server.crt, server.key C:\app\config\backend\tls\

Restreignez l'accès à la clé privée au compte du service, à SYSTEM et aux administrateurs. Pour un nœud Frontend ou une Gateway, adaptez le dossier et les noms du tableau.

Résultat attendu : sur chaque nœud, chaque interface qu'il porte a son certificat et sa clé dans le dossier du tableau.

2. Déclarer les certificats

Dans le YAML du composant, indiquez les chemins des fichiers. Fusionnez ces clés avec le bloc smartagt existant.

Sur chaque nœud, dans le YAML du composant, indiquez les chemins des fichiers. Les chemins sont les mêmes sur tous les nœuds, chacun lisant ses propres fichiers. Fusionnez ces clés avec le bloc smartagt existant. Les nœuds Frontend les déclarent depuis leur installation.

Dans /app/config/bff/smartagt-bff-core.yaml :

smartagt:
  http:
    server:
      certfile: /app/config/bff/tls/server.crt
      keyfile: /app/config/bff/tls/server.key

Dans /app/config/backend/smartagt-backend-core.yaml :

smartagt:
  http:
    public:
      certfile: /app/config/backend/tls/server.crt
      keyfile: /app/config/backend/tls/server.key

Dans /app/config/backend/smartagt-backend-core.yaml :

smartagt:
  gateway:
    server:
      certfile: /app/config/backend/tls/gateway.crt
      keyfile: /app/config/backend/tls/gateway.key

Sous Windows, les YAML sont sous C:\app\config\ ; écrivez les chemins avec des /, par exemple C:/app/config/bff/tls/server.crt.

Résultat attendu : chaque YAML modifié déclare une seule fois certfile et keyfile.

3. Redémarrer le composant

Redémarrez seulement les composants modifiés.

sudo systemctl restart smartagt-frontend-service      # Frontend
sudo systemctl restart SmartAGT-Platform-Service      # API Publique
sudo systemctl restart SmartAGT-AI-Gateway-Service    # Gateway
Restart-Service smartagt-frontend-service      # Frontend
Restart-Service SmartAGT-Platform-Service      # API Publique
Restart-Service SmartAGT-AI-Gateway-Service    # Gateway

Résultat attendu : le navigateur ouvre https://smartagt.example.test:9000 sans alerte de certificat.

Redémarrez les services modifiés, un nœud après l'autre : les autres nœuds continuent de servir.

sudo systemctl restart smartagt-frontend-service      # Frontend
sudo systemctl restart SmartAGT-Platform-Service      # API Publique
sudo systemctl restart SmartAGT-AI-Gateway-Service    # Gateway
Restart-Service smartagt-frontend-service      # Frontend
Restart-Service SmartAGT-Platform-Service      # API Publique
Restart-Service SmartAGT-AI-Gateway-Service    # Gateway

Résultat attendu : sur chaque nœud, curl --cacert <autorité de vos certificats> https://<nom du nœud>:<port>/ (curl.exe sous Windows) aboutit sans erreur de certificat.

Cas particuliers

Faire reconnaître le certificat généré par SmartAGT

Un outil ou une application vérifie ce certificat avec la racine propre à votre installation. Exportez-la sur un serveur Backend :

read -rsp 'Mot de passe du rôle smartagt : ' SMARTAGT_CORE_DATABASE_PASSWORD; echo
export SMARTAGT_CORE_DATABASE_PASSWORD
cd /app/smartagt-backend-core
sudo --preserve-env=SMARTAGT_CORE_DATABASE_PASSWORD ./run.bin pki export-ca --output ~/smartagt-ca.pem --config /app/config/backend/smartagt-backend-core.yaml
$env:SMARTAGT_CORE_DATABASE_PASSWORD = [Net.NetworkCredential]::new('', (Read-Host 'Mot de passe du rôle smartagt' -AsSecureString)).Password
Set-Location C:\app\smartagt-backend-core
.\run.exe pki export-ca --output $HOME\smartagt-ca.pem --config C:\app\config\backend\smartagt-backend-core.yaml

Résultat attendu : smartagt-ca.pem contient la racine, sans clé privée, et la commande affiche son empreinte SHA-256.

Remettez ce fichier à chaque outil plutôt qu'au magasin global d'un poste : curl --cacert, paramètre verify des SDK, proxy_ssl_trusted_certificate de NGINX. Le certificat couvre le nom et les adresses du serveur : un alias DNS, un NAT ou un nom public demandent vos certificats.