Certificats SSL

Toutes les connexions utilisateurs passent par un service Traefik. L’infrastructure utilise des certificats SSL pour l’exposition du Portail à travers Traefik ainsi que pour les communications internes de la plateforme des différents services.

Important

Il est conseillé d’utiliser une PKI différente pour les communications internes de celle utilisée pour Traefik.

Traefik

Trois modes sont disponibles :

Certificat par défaut

Par défaut, un certificat autosigné est généré automatiquement lors de la création du conteneur Traefik. Ce mode est adapté pour des environnements de test, mais il n’est pas recommandé en production.

Certificat local

Vous pouvez fournir un certificat et une clé stockés sur la machine Ansible. Le rôle reemo-infra se charge de déployer ces fichiers sur les serveurs hébergeant Traefik.

TRAEFIK_SSL_CERTS est une liste : vous pouvez déclarer plusieurs paires certificat/clé, par exemple un certificat distinct pour l’URL du portail utilisateur et pour celle du portail d’administration. Traefik sélectionne le certificat correspondant au nom de domaine demandé.

Exemple d’inventaire :

TRAEFIK_SSL_CERTS:
    - cert_file: "/localpath/to/portal.crt"
      key_file: "/localpath/to/portal.key"
    - cert_file: "/localpath/to/admin.crt"
      key_file: "/localpath/to/admin.key"

Certificat déjà présent sur le serveur

Si les certificats sont déjà installés sur les serveurs cibles, vous pouvez indiquer leurs chemins locaux. Ils seront ensuite montés directement dans le conteneur Traefik.

Comme TRAEFIK_SSL_CERTS, TRAEFIK_SSL_CERTS_REMOTE accepte plusieurs paires certificat/clé.

Exemple d’inventaire :

TRAEFIK_SSL_CERTS_REMOTE:
    - cert_file_remotepath: "/remotepath/to/portal.crt"
      key_file_remotepath: "/remotepath/to/portal.key"
    - cert_file_remotepath: "/remotepath/to/admin.crt"
      key_file_remotepath: "/remotepath/to/admin.key"

Communication internes

L’ensemble des micro-services discute entre eux en mTLS imposant une gestion des certificats.
Vous avez 3 choix possibles:

PKI par défaut

Le rôle Ansible reemo-infra embarque une PKI dédiée complète et prête à l’emploi. Elle permet un déploiement simple avec des communications internes chiffrées et authentifiées.

CA générée automatiquement

Il est possible d’utiliser une autorité de certification (CA) générée automatiquement lors de l’exécution du rôle reemo-infra.

Étapes à suivre :

  1. Créer un répertoire local sur la machine Ansible, accessible en écriture par l’utilisateur exécutant Ansible.

  2. Ajouter dans le fichier d’inventaire les options nécessaires pour activer cette fonctionnalité.

all:
    vars:
        LOCAL_PATH: "/opt/reemo/ssl"
        INITCA_ENABLE: "true"
    infra_manager:
        hosts:
            infra_manager1:
                ansible_host: "10.0.0.1"
            infra_manager2:
                ansible_host: "10.0.0.2"
            infra_manager3:
                ansible_host: "10.0.0.3"

Lors du lancement du rôle, une CA sera créée automatiquement dans ce répertoire. Les clés et certificats associés seront ensuite exportés vers le cluster Docker Swarm sous forme de Secrets et montés dans les différents conteneurs qui en ont besoin.

Persistance et renouvellement automatique via Git

La PKI générée automatiquement (CA, clés et certificats) peut être conservée dans un dépôt Git. À chaque exécution du rôle reemo-infra, la PKI est récupérée depuis le dépôt (git pull) dans LOCAL_PATH avant la vérification des certificats, puis les artefacts mis à jour y sont republiés (git commit et git push) après génération.

Combiné à une exécution planifiée (CRON), ce mode assure le renouvellement automatique des certificats : la CA est renouvelée dès qu’elle approche de son expiration (30 jours avant), et la PKI mise à jour est republiée dans le dépôt.

Ce mode complète la CA générée automatiquement : INITCA_ENABLE doit être activé. L’accès au dépôt se fait en SSH, via un agent SSH dont la variable d’environnement SSH_AUTH_SOCK est renseignée.

Exemple d’inventaire :

all:
    vars:
        LOCAL_PATH: "/opt/reemo/ssl"
        INITCA_ENABLE: "true"
        INITCA_GIT_ENABLE: "true"
        INITCA_GIT_SSH_URL: "git@example.com:your-org/reemo-pki.git"
        INITCA_GIT_BRANCH: "main"
    infra_manager:
        hosts:
            infra_manager1:
                ansible_host: "10.0.0.1"
            infra_manager2:
                ansible_host: "10.0.0.2"
            infra_manager3:
                ansible_host: "10.0.0.3"

Options disponibles :

  • INITCA_GIT_ENABLE : active la persistance de la PKI dans un dépôt Git (false par défaut).

  • INITCA_GIT_SSH_URL : URL SSH du dépôt Git hébergeant la PKI.

  • INITCA_GIT_BRANCH : branche utilisée pour le pull et le push (main par défaut).

Lancer le renouvellement de la PKI

La génération et le renouvellement des certificats sont pilotés par le tag initca du rôle reemo-infra. Relancer le rôle est idempotent : un certificat n’est régénéré que lorsqu’il entre dans ses 30 derniers jours de validité, lorsque la CA interne a elle-même été renouvelée (tous les certificats qu’elle a signés sont alors ré-émis), ou lorsque les SAN (Subject Alternative Name, la liste des noms d’hôte couverts) d’un certificat ont changé ; sinon rien n’est modifié.

Cette procédure concerne la PKI interne générée automatiquement (INITCA_ENABLE). Pour vérifier la PKI interne et renouveler les certificats proches de l’expiration, exécutez le rôle avec le tag initca :

ansible-playbook -i inventory.yml playbooks/reemo-infra.yml --tags initca

Lorsque INITCA_GIT_ENABLE est activé, cette seule commande récupère également la PKI depuis le dépôt Git avant la vérification, puis y republie les artefacts renouvelés après génération.

Tags disponibles :

  • initca : la chaîne PKI complète : git pull (si activé), vérification/renouvellement de la CA et des certificats par service, puis git push (si activé).

  • initca_git : uniquement les étapes Git (pull puis push), sans régénérer les certificats.

Pour rendre le renouvellement totalement automatique, planifiez cette commande (par exemple avec CRON). Comme l’exécution est idempotente, elle peut être lancée aussi souvent que souhaité ; une exécution quotidienne permet de renouveler chaque certificat dans la fenêtre de 30 jours précédant son expiration :

# Chaque jour à 03h00 : renouvelle la PKI interne si nécessaire
0 3 * * * cd /path/to/ansible && ansible-playbook -i inventory.yml playbooks/reemo-infra.yml --tags initca >> /var/log/reemo-initca.log 2>&1

Note

La persistance Git (INITCA_GIT_ENABLE) est ce qui rend un renouvellement planifié durable : la CA et les certificats renouvelés sont republiés dans le dépôt au lieu de n’exister que sur la machine Ansible. Sans elle, la PKI renouvelée n’est conservée que dans LOCAL_PATH sur l’hôte qui exécute le playbook. Lorsque INITCA_GIT_ENABLE est activé, la tâche planifiée doit également avoir accès à un agent SSH dont la variable d’environnement SSH_AUTH_SOCK est renseignée.

Configuration manuelle

Il est aussi possible de générer soi-même les certificats SSL, puis de renseigner dans l’inventaire Ansible les chemins locaux des clés et certificats. Ils seront copiés automatiquement vers le cluster Docker Swarm par le rôle reemo-infra.

Pour chaque URL, les variables suivent le même schéma : <URL>_SSL_CRT_LOCALPATH et <URL>_SSL_KEY_LOCALPATH (nom de l’URL en majuscules, sans le préfixe reemo_). Par exemple, reemo_provision utilise PROVISION_SSL_CRT_LOCALPATH et PROVISION_SSL_KEY_LOCALPATH.

URLs du socle (toujours requises) :

  • reemo_api

  • reemo_apicron

  • reemo_portal

  • reemo_portaladmin

  • reemo_signal

  • reemo_proapi

  • reemo_prorelayapi

  • reemo_procloudapi

  • reemo_traefik

Selon la topologie et les options activées, d’autres URLs sont nécessaires :

  • Nœuds de provisioning (HAProxy) : reemo_provision

  • Relais WebSocket : reemo_relayws

  • Base de données avec SSL (DB_SSL_REQUIRE) : reemo_db (ou reemo_mariadb selon le moteur) et reemo_ndbmonitor

  • Record API (RECORDAPI_ENABLED) : reemo_recordapi, reemo_recordportal, reemo_recorddb et reemo_recordapicron

  • Module Appliance (APPLIANCE_ENABLED) : reemo_applianceapi et reemo_applianceportal

  • Identity (IDENTITY_ENABLED) : reemo_identityapi, reemo_identityportal et reemo_applianceidentity

  • Vault (VAULT_ENABLED) : reemo_vault

  • CredentialAPI (CREDENTIAL_ENABLED) : reemo_credentialapi et reemo_credentialportal

  • Wake-on-LAN (WOLAPI_ENABLE) : reemo_wolapi

  • Journaux (LogAPI) : reemo_logapi

  • Mode maintenance : reemo_maintenance

Exemple :

all:
    vars:
        API_LICENSE: "ewogICAg ... Uw5NXhGVDF0NFU2TkxOdjQvZU53PT0iCiAgICC9Cn0="
        ...
    infra_manager:
        hosts:
            infra_manager1:
                ansible_host: "10.0.0.1"
            infra_manager2:
                ansible_host: "10.0.0.2"
            infra_manager3:
                ansible_host: "10.0.0.3"
        vars:
            CA_SSL_CRT_LOCALPATH: "/local/path/ca.crt"
            API_SSL_CRT_LOCALPATH: "/local/path/reemo_api.crt"
            API_SSL_KEY_LOCALPATH: "/local/path/reemo_api.key"
            PROAPI_SSL_CRT_LOCALPATH: "/local/path/reemo_proapi.crt"
            PROAPI_SSL_KEY_LOCALPATH: "/local/path/reemo_proapi.key"
            PRORELAYAPI_SSL_CRT_LOCALPATH: "/local/path/reemo_prorelayapi.crt"
            PRORELAYAPI_SSL_KEY_LOCALPATH: "/local/path/reemo_prorelayapi.key"
            SIGNAL_SSL_CRT_LOCALPATH: "/local/path/reemo_signal.crt"
            SIGNAL_SSL_KEY_LOCALPATH: "/local/path/reemo_signal.key"
            PORTAL_SSL_CRT_LOCALPATH: "/local/path/reemo_portal.crt"
            PORTAL_SSL_KEY_LOCALPATH: "/local/path/reemo_portal.key"
            PORTALADMIN_SSL_CRT_LOCALPATH: "/local/path/reemo_portaladmin.crt"
            PORTALADMIN_SSL_KEY_LOCALPATH: "/local/path/reemo_portaladmin.key"
            PROVISION_SSL_CRT_LOCALPATH: "/local/path/reemo_provision.crt"
            PROVISION_SSL_KEY_LOCALPATH: "/local/path/reemo_provision.key"
            TRAEFIK_SSL_CERTS:
                - cert_file: "/local/path/domain.crt"
                  key_file: "/local/path/domain.key"