Aller au contenu

Installer vos 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, activez TLS et indiquez les chemins des fichiers. Fusionnez ces clés avec le bloc smartagt existant.

Sur chaque nœud, dans le YAML du composant, activez TLS et 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:
      tls_enabled: true
      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:
      tls_enabled: true
      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:
      tls_enabled: true
      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 tls_enabled, 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.