Pré-requis

La messagerie dépend très fortement des certificats et de leur bonne gestion. Par exemple, elle ne fonctionnera plus si vos certificats expirent.
Il est indispensable de maîtriser parfaitement leur gestion (voir le chapitre Liens Externes si nécessaire).

Installation du certificat

Vous devez vous assurer qu'une URL externe a été définie pour le système global ou le domaine concerné par cette installation de certificat (voir le chapitre Configuration des url externes si nécessaire).

Fichiers nécessaires

Vous devez vous assurer que les certificats correspondent à l'URL externe (external-url) de votre messagerie, sans quoi cette messagerie ne sera pas opérationnelle.

Afin de mettre en place un certificat SSL, il faut être en possession des 3 fichiers suivants :

1. un fichier contenant le nouveau certificat SSL
2. un fichier contenant la clé privée du nouveau certificat, elle ne doit pas être protégée par mot de passe
3. un fichier contenant le certificat de l'autorité de certification ayant servie à délivrer le nouveau certificat SSL. Dans le cas où cette autorité est une autorité intermédiaire, il faut concaténer au fichier le certificat racine de cette autorité.

Si votre certificat est au format P12, il vous faut générer le certificat et la clé privée au format PEM en utilisant les commandes :

openssl pkcs12  -nocerts -in cert.p12 -out privatekey.pem
openssl pkcs12 -clcerts  -nokeys -in cert.p12 -out cert.pem 

openssl x509 -noout -subject -in cert.pem

Installation du certificat pour le système global

• Se connecter à BlueMind en tant qu'administrateur système admin0
• Se rendre sur la page Sécurité > Modifier le certificat
• Choisir "Files" dans la liste déroulante
• Au moyen des 3 boutons «Parcourir» rechercher les fichiers correspondants afin de les envoyer sur le serveur :
  
• Cliquer sur «Enregistrer» afin de téléverser les fichiers et prendre en compte le nouveau certificat.

Installation du certificat pour un domaine

• Se connecter à BlueMind en tant qu'administrateur système admin0
• Se rendre sur la page Gestion du Système > Domaines supervisés
• Selectionner le domaine concerné
• Cliquer sur l'onglet "Certificat et chiffrement"
• Choisir "Files" dans la liste déroulante
• Au moyen des 3 boutons «Parcourir» rechercher les fichiers correspondants afin de les envoyer sur le serveur :
  
• Cliquer sur «Enregistrer» afin de téléverser les fichiers et prendre en compte le nouveau certificat.

Génération Let's Encrypt

• Se connecter à BlueMind en tant qu'administrateur système admin0
• Se rendre sur la page Sécurité > Modifier le certificat
• Choisir "Let's Encrypt" dans la liste déroulante

 Accepter les conditions

Il est nécessaire d'accepter les conditions de Let's Encrypt avant de pouvoir générer le certificat.

L'action sur le bouton acceptera automatiquement les conditions et ouvrira un onglet les présentant. 

Une fois l'action effectuée, le bouton permettant la génération du certificat sera débloqué.

Générer le certificat pour le système global

Il est possible de saisir une adresse email qui sera utilisée par Let's Encrypt pour communiquer à propos de l'expiration du certificat généré.

Si elle n'est pas renseignée une adresse par défaut no-reply@<default-domain> sera utilisée (pour cela un domaine par défaut devra être défini au préalable).

Générer le certificat pour un domaine

• Se connecter à BlueMind en tant qu'administrateur système admin0
• Se rendre sur la page Gestion du Système > Domaines supervisés
• Selectionner le domaine concerné
• Cliquer sur l'onglet "Certificat et chiffrement"
• Choisir "Let's Encrypt" dans la liste déroulante

Répéter les opérations décrites en 4.1 et 4.2

Renouveler un certificat

Une tache programmée se chargera de renouveler automatiquement le certificat Let's Encrypt, si celui ci a déjà été généré une première fois.

Cependant il est possible de renouveler manuellement le certificat, en suivant la même procédure que le lors de la génération:

• 4.2 Générer le certificat pour le système global

• 4.3 Générer le certificat pour un domaine

Supprimer un certificat de domaine

Cette opération aura pour effet de supprimer les certificats de domaine des serveurs.

• Se connecter à BlueMind en tant qu'administrateur système admin0
• Se rendre sur la page Gestion du Système > Domaines supervisés
• Selectionner le domaine concerné
• Cliquer sur l'onglet "Certificat et chiffrement"
• Choisir "Disable" dans la liste déroulante

• Cliquer sur «Enregistrer» afin de supprimer les fichiers du serveur.

Ancre
liensexternes liensexternes

Liens externes

• SSL & TLS : Guide du débutant pour tout savoir sur les certificats : https://www.isicca.com/fr/certificat-ssl-tls-guide-debutant/

Environment

Email relies heavily on certificates and their proper management. For example, your email will not work if your certificates expire.
It is paramount that you know how to manage them well (please refer to the chapter on Externals links if necessary).

You must also make sure that the certificates correspond to your email's external-url, otherwise this email will not work.

Certificate installation

You must ensure an external URL has been defined for your system, or for the domain concern by this certificate installation.

You can check this in the System Management > System Configuration > Reverse Proxy for the system, and System Management, Manage Domains > <YourDomain> > Generalfor the domain.

Files required

To set up an SSL certificate, you need the following files:

1. a file containing the new SSL certificate
2. a file containing the private key for the new certificate – it must not be password protected
3. a file containing the certificate from the certificate authority responsible for issuing the new SSL certificate. If this authority is a subordinate authority, that authority's root certificate has to be concatenated to the file. 

If your certificate is in P12 format, you must generate the certificate and the private key in PEM format using the commands:

openssl pkcs12  -nocerts -in cert.p12 -out privatekey.pem
openssl pkcs12 -clcerts  -nokeys -in cert.p12 -out cert.pem 

openssl x509 -noout -subject -in cert.pem

Installing the certificate for the system

• Connect to BlueMind as admin0 and access the admin console 
• Go to the page Security > Modify Certificate
• Choose "Files" in the drop-down list, and use the three "Browse" ("Parcourir") buttons to find the files required and send them to the server:
  
  
  
  
  
  
  
  
  
  
  
• Click "Save" to upload the files and apply the new certificate.

Installing the certificate for a domain

• Connect to BlueMind as admin0 and access the admin console
• Go to the page System Management > Managed Domains
• Select the domain you wants to configure
• Click on "Certificate and Encryption" tab
• Choose "Files" in the drop-down list
• Use the 3 "Browse..." buttons to search for the corresponding files and send them to the server

• Click "Save" to upload the files and apply the new certificate.

Let's Encrypt certificate generation

• Connect to BlueMind as admin0 and access the admin console 
• Go to the page Security > Modify Certificate
• Choose "Let's Encrypt"  in the drop-down list

Accept the conditions

Accepting the Let's Encrypt conditions is mandatory before being able to generate the certificate.

Click on "Let’s Encrypt conditions" will open them in a new tab, and the "Accept Let's Encrypt terms" button will automatically accept Let's Encrypt terms & conditions.

Once done, the grey-ed button allowing the creation of the certificate will be unlocked.

Generate the certificate for your system

You may enter an email address that will be used by Let's Encrypt to communicate about the expiration date of the generated certificate.

if not provided, a default address 'no-reply@<default-domain>' will be used (a default domain must be define in the System Management beforehand).

Generate a certificate for a domain

• Connect to BlueMind as admin0 and access the admin console
• Go to the page System Management > Managed Domains
• Select the domain you wants to configure
• Click on "Certificate and Encryption" tab

Repeat operations described in 4.1 and 4.2

Renew a certificate

A programmed task will automatically renew the Let's Encrypt certificate, if it has already been generated once.

However, it is possible to renew the certificate manually, following the same procedure as the one used for the generation.

Delete a domain certificate

This operation will remove the domain certificates from the servers.

• Connect to BlueMind as admin0 and access the admin console
• Go to the page System Management > Managed Domains
• Select the domain you wants to configure
• Click on "Certificate and Encryption" tab
• Choose "Disable" in the drop-down list and click "Disable SSL Certificate"

• Click on "Save" to delete the files on the server

Ancre
externallinks externallinks

External links

• SSL & TLS: A beginner's guide to certificates: https://www.isicca.com/en/ssl-tls-certificate-beginner-guide/

Voraussetzungen

Um ein SSL-Zertifikat einrichten zu können, müssen Sie über folgende 3 Dateien verfügen:

1. eine Datei, die das neue SSL-Zertifikat enthält
2. eine Datei, die den privaten Schlüssel des neuen Zertifikats enthält, sie darf nicht passwortgeschützt sein
3. eine Datei, die das Zertifikat von der Zertifizierungsstelle enthält, die das neue SSL-Zertifikat ausgestellt hat. Wenn es sich bei dieser Zertifizierungsstelle um eine Zwischenstelle handelt, muss das Stammzertifikat dieser Zertifizierungsstelle an die Datei angehängt werden.

Wenn Ihr Zertifikat im P12-Format vorliegt, müssen Sie das Zertifikat und den privaten Schlüssel im PEM-Format mit den Befehlen erzeugen:

openssl pkcs12  -nocerts -in cert.p12 -out privatekey.pem
openssl pkcs12 -clcerts  -nokeys -in cert.p12 -out cert.pem 

openssl x509 -noout -subject -in cert.pem

Installieren des Zertifikats

• Anmeldung bei BlueMind als Systemadministrator admin0
• Gehen Sie auf die Seite Sicherheit > Zertifikat ändern
• Mit den 3 „Durchsuchen“ Schaltflächen können Sie die entsprechenden Dateien suchen, um sie an den Server zu senden:
  
• Klicken Sie auf „Speichern“, um die Dateien hochzuladen und das neue Zertifikat zu berücksichtigen.