Customer HubRenouveler le certificat SSL
Un certificat SSL du serveur arrivé à expiration a des répercussions sur la gestion des appareils inscrits. Il est donc important de mettre à jour le certificat SSL bien avant son expiration afin de garantir un fonctionnement sans heurts et un contrôle continu des appareils inscrits.
La procédure diffère selon l’installation, le proxy inverse et l’origine du certificat.
Guide selon l’installation
| Installation | Let’s Encrypt | Certificat acheté |
|---|---|---|
| Docker avec Traefik (standard) | Traefik : renouveler le certificat → | Traefik : renouveler le certificat → |
| Docker avec nginx | nginx : renouveler le certificat → | nginx : renouveler le certificat → |
| Installation native sous Windows ou Linux avec nginx (obsolète) | – | Installation native : renouveler le certificat → |
Un certificat acheté est préparé comme décrit dans Renouveler un certificat acheté → avant sa mise en place.
Le fichier Compose du répertoire /opt/relution (compose.yaml, dans les installations plus anciennes docker-compose.yml) indique le proxy inverse utilisé : il contient soit un bloc traefik:, soit un bloc nginx:.
Fichiers de certificat
Si une nouvelle paire de clés a été générée pour le nouveau certificat, le fichier server.key est en outre remplacé par la nouvelle clé privée, quelle que soit la variante. Si la clé privée existante a été réutilisée (p. ex. même CSR ou nouvelle CSR créée avec la clé existante), server.key reste inchangé. Le fichier server.pem contient le certificat du serveur ainsi que les certificats intermédiaires ; si le nouveau certificat est disponible sous forme de fichier PFX, il est d’abord converti, voir Convertir un certificat en PEM →.
Remarques complémentaires
Si le certificat SSL est également utilisé comme certificat de signature pour les appareils Apple (voir Certificat de signature iOS →), les fichiers sont également remplacés à l’emplacement qui y est configuré (Docker/Linux : sous /opt/relution, Windows : dans le répertoire d’installation, ou au chemin indiqué avec le préfixe file:). Relution ne lit le certificat de signature qu’au démarrage ; un redémarrage de Relution est donc nécessaire après le remplacement.
Si le certificat de signature est transmis via la variable d’environnement KEYSTORE_IOS_SIGNER_PEM, c’est son contenu qui est mis à jour avec la nouvelle clé privée et le nouveau certificat au format PEM. Comme docker compose restart ne prend pas en compte les variables d’environnement modifiées, le conteneur est ensuite recréé avec docker compose up -d.