Documentation d’utilisation OpenSSL

OpenSSL est une puissante suite open source permettant la communication sécurisée. Il offre des fonctionnalités de chiffrement, de déchiffrement et la gestion des protocoles SSL/TLS. ServBay inclut en natif OpenSSL ; ce document détaille l’installation, la configuration et l’utilisation d’OpenSSL.

Installation et configuration

Installation

OpenSSL est inclus d’office avec ServBay, aucune installation supplémentaire n’est nécessaire.

Configuration

Le fichier de configuration d’OpenSSL se trouve généralement dans le répertoire /Applications/ServBay/package/common/openssl/3.2 (pour les puces Intel : /Applications/ServBay/package/common/openssl/1.1.1u). Le fichier de configuration par défaut est openssl.cnf. Vous pouvez modifier ce fichier pour adapter le comportement d’OpenSSL à vos besoins.

Exemple de contenu de fichier de configuration :

[ req ]
default_bits        = 2048
default_keyfile     = privkey.pem
distinguished_name  = req_distinguished_name
attributes          = req_attributes
x509_extensions     = v3_ca

[ req_distinguished_name ]
countryName         = Nom du pays (code à 2 lettres)
countryName_default = US
stateOrProvinceName = État ou province (nom complet)
localityName        = Localité (par exemple, ville)
0.organizationName  = Nom de l’organisation (ex : entreprise)
organizationalUnitName = Unité organisationnelle (ex : département)
commonName          = Nom commun (ex : nom d’hôte complet)
commonName_max      = 64

[ req_attributes ]
challengePassword   = Un mot de passe de défi
challengePassword_min = 4
challengePassword_max = 20

[ v3_ca ]
subjectKeyIdentifier=hash
authorityKeyIdentifier=keyid:always,issuer
basicConstraints = CA:true

Utilisation de base

OpenSSL propose de nombreux outils en ligne de commande pour divers usages liés au chiffrement et à la gestion des certificats. Voici quelques exemples d’utilisation courante :

Générer une clé privée et une clé publique

Générer une clé privée RSA

openssl genpkey -algorithm RSA -out private_key.pem

Générer la clé publique à partir de la clé privée

openssl rsa -pubout -in private_key.pem -out public_key.pem

Générer une demande de signature de certificat (CSR)

Générer une CSR

openssl req -new -key private_key.pem -out request.csr

Certificat auto-signé

Générer un certificat auto-signé

openssl req -x509 -days 365 -key private_key.pem -in request.csr -out certificate.crt

Gestion des certificats

Afficher les informations d’un certificat

Afficher les informations d’une CSR

openssl req -text -noout -verify -in request.csr

Afficher les informations d’un certificat

openssl x509 -text -noout -in certificate.crt

Conversion de format de certificat

PEM vers DER

openssl x509 -outform der -in certificate.pem -out certificate.der

DER vers PEM

openssl x509 -inform der -in certificate.der -out certificate.pem

Chiffrement et déchiffrement

Chiffrement symétrique

Chiffrer un fichier avec AES

openssl enc -aes-256-cbc -salt -in plaintext.txt -out encrypted.txt

Déchiffrer un fichier avec AES

openssl enc -d -aes-256-cbc -in encrypted.txt -out decrypted.txt

Chiffrement asymétrique

Chiffrer un fichier avec une clé publique

openssl rsautl -encrypt -inkey public_key.pem -pubin -in plaintext.txt -out encrypted.txt

Déchiffrer un fichier avec une clé privée

openssl rsautl -decrypt -inkey private_key.pem -in encrypted.txt -out decrypted.txt

Problèmes fréquents

1. La commande OpenSSL ne fonctionne pas

• Solution : Veuillez vérifier que les variables d’environnement de ServBay sont bien configurées. Si le problème persiste, ouvrez « Réglages » → « Outils en ligne de commande » dans ServBay, configurez respectivement pour zsh et bash, puis relancez votre terminal.

2. Le certificat généré est invalide

• Solution : Vérifiez que les informations dans le fichier de demande de certificat (CSR) et le fichier de configuration sont correctes. Assurez-vous que tous les champs obligatoires sont complétés.

3. Échec du chiffrement ou du déchiffrement

• Solution : Vérifiez que la clé utilisée et l’algorithme sont adéquats et compatibles. Assurez-vous également de la justesse des chemins vers les fichiers d’entrée et de sortie.

Conclusion

OpenSSL est une suite d’outils puissante et polyvalente, idéale pour tous types de communications sécurisées et de tâches de chiffrement. Grâce à ce guide, vous avez désormais toutes les clés pour installer, configurer et utiliser OpenSSL sur ServBay, afin de gérer vos certificats et protéger vos données.