Génération d'une CSR sur Ubiquiti UniFi

Une CSR (Certificate Signing Request, ou demande de signature de certificat) est un bloc de code que vous soumettez lors de l’activation du certificat SSL dans votre compte Ruachost. Elle contient des informations chiffrées sur votre entreprise ou activité et sur votre nom de domaine.

La procédure standard de génération d’une CSR sur le logiciel de contrôleur UniFi est assez simple ; elle se fait avec quelques commandes standard :

1. Connectez-vous en ligne de commande au serveur sur lequel le contrôleur est installé.\

   • Sur les serveurs Linux, vous pouvez utiliser Putty (pour les machines Linux ou Windows) ou une application similaire
   • Sur macOS, lancez l’application Terminal
   • Sur un serveur Windows, connectez-vous via le bureau à distance (si nécessaire) et lancez cmd ou PowerShell

   IMPORTANT : veillez à lancer l’application avec les droits d’administrateur sous Windows, ou à disposer d’un accès utilisateur root ou sudo sous Linux/macOS.

   Pour lancer l’application en tant qu’administrateur sous Windows, vous pouvez faire un clic droit sur l’icône du programme et choisir l’option Run as administrator (exécuter en tant qu’administrateur), ou procéder ainsi :

   Properties > Compatibility > cochez Run this program as an administrator > OK.

   Pour activer l’accès sudo sur les systèmes Linux, exécutez :

   sudo su -

2. Pour accéder au dossier principal du contrôleur UniFi, exécutez :

   cd Unifi base folder

   Remplacez Unifi base folder (dossier de base UniFi) par :

   • Sur UniFi Cloud Key, Ubuntu et les autres distributions Linux basées sur Debian : /usr/lib/unifi/
   • Sur CentOS, RedHat, Fedora et les autres distributions Linux RHEL : /opt/unifi/
   • Sur macOS : ~/Library/Application Support/UniFi
   • Sous Windows : “%USERPROFILE%/Ubiquiti Unifi”

   Vous pouvez également utiliser : “C:\Users*account username*\Ubiquiti UniFi” (en remplaçant account username par le nom d’utilisateur du compte)

3. Pour générer le code CSR, exécutez :

   java -jar lib/ace.jar new_cert example.com “Company name” “Locality” “State” CC

   • Remplacez example.com par votre nom de domaine ou sous-domaine réel pour UniFi (le nom commun du certificat)
   • Company name : indiquez le nom de votre entreprise ou organisation, ou mettez NA (non applicable)
   • Locality : indiquez votre ville, commune ou autre localité
   • State : indiquez le nom de votre État ou province, ou reprenez la même valeur que Locality
   • CC (code pays) : utilisez le code pays à 2 lettres approprié, disponible [ici
     ](https://countrycode.org/)

   ASTUCE : si une valeur contient plusieurs mots, mettez-la entre guillemets. Sinon, UniFi considérera le deuxième mot comme la valeur du champ suivant (sans afficher d’erreur).

   IMPORTANT : lorsque vous créez une CSR wildcard sur UniFi (avec un nom de domaine comme .example.com), UniFi place le nom de domaine (sous-domaine) indiqué dans la valeur d’hôte dans le champ Organization unit (unité d’organisation). Cela peut poser problème lors de l’activation, car “” n’est pas considéré comme un caractère alphanumérique.

   Le fichier CSR nommé unifi_certificate.csr.pem sera créé dans le sous-dossier data du dossier de base UniFi.

   • Sous Linux/macOS, vous pouvez l’ouvrir avec la commande : cat /data/unifi_certificate.csr.pem
   • Sous Windows, allez dans le sous-dossier data > faites un clic droit sur le fichier > Open with > choisissez Notepad ou tout autre éditeur de texte.

   REMARQUE : sur les distributions Linux basées sur Debian, tous les fichiers associés sont également dupliqués dans le dossier /var/lib/unifi.

   IMPORTANT : la clé privée du certificat sera enregistrée dans le keystore UniFi par défaut, dans le fichier /data/keystore/ (ou simplement keystore, selon le système).

   Utilisez le texte du fichier lors de l’activation du certificat.