Jump to English version

Il est très simple de configurer JMap pour utiliser des connexions HTTP encryptées (HTTPS/SSL).

Cette configuration nécessite un certificat compatible en format JKS ou PFX (PKCS12 keystore). Si vous ne possédez pas de certificat, il est possible de créer un certificat non-authentifié avec les outils du JDK ou OpenSSL.

Pour convertir un certificat RSA de format PEM en format JKS, veuillez utiliser la procédure décrite dans ce site : https://docs.oracle.com/cd/E35976_01/server.740/es_admin/src/tadm_ssl_convert_pem_to_jks.html

Pour faire la conversion d'un certificat du format PFX (PKCS12 keystores) au format JKS, utilisez la commande suivante (nécessite JDK 1.6+) :

keytool -importkeystore -srckeystore mypfxfile.pfx -srcstoretype pkcs12 -destkeystore clientcert.jks -deststoretype JKS

Guide étape par étape

1. Création d'un certificat non authentifié (auto-signé)

Format JKS

Le programme keytool est situé dans le répertoire bin de votre JDK.  La commande à utiliser pour générer le certificat est :

Lors de la création du certificat, le nom de domaine visé par HTTPS doit être entré dans: 'What is your first and last name?'. 

Seule cette resource sera sécurisée et donc tout accès via un autre nom (ex: localhost, 127.0.0.1, etc.,) retournera une erreur de sécurité. 

Format PFX (PKCS12 keystore)

1. Installer OpenSSL.

2. Créer le private key : openssl genrsa 2048 > private.pem

3. Créer le self signed certificate : openssl req -x509 -days 1000 -new -key private.pem -out public.pem

4. Créer le PFX : openssl pkcs12 -export -in public.pem -inkey private.pem -out mycert.pfx

2. Configuration du certificat

1. Une fois le certificat créé, changez les paramètres suivants dans  /chemin/vers/jmap/conf/jmapserver.properties 
   
   

   1. Le certificat créé :
      server.https.keystore.file=/chemin/vers/jmap/conf/certificat.keystore (Exemples : server.https.keystore.file=../conf/star_jmaponline_net.jks ou server.https.keystore.file=../conf/star_jmaponline_net.pfx)
      
      

   2. La valeur 'encrypted' indique si le mot de passe est encrypté, donc lorsque vous le configurez pour la première fois, vous devrez utiliser la fonction password(). Lorsque JMap Server sera démarré pour la première fois, votre mot de passe devrait être encrypté :
      server.https.keystore.password=password(put_your_keystore_password_here)
      server.https.keystore.password.encrypted=true
      
      

   3. Le port à utiliser pour HTTPS (443 par défaut) :
      server.https.port=443
      
      

2. Une fois ces étapes effectuées, redémarrez JMap Server et lancez JMap Admin en HTTPS:  https://xxx.xxx.xxx.xxx:443/jmapadmin.

Exemples

Exemple de configuration format JKS

Exemple de configuration format PFX (PKCS12 keystore)

English version

It is very easy to configure JMap to use encrypted HTTP connections (HTTPS/SSL).

This configuration requires a compatible certificate in JKS or PFX format (PKCS12 keystore). If you do not have a certificate, it is possible to create an unauthenticated certificate with the JDK or OpenSSL tools.

To convert an RSA certificate from PEM format to JKS format, please use the procedure described in this site: https://docs.oracle.com/cd/E35976_01/server.740/es_admin/src/tadm_ssl_convert_pem_to_jks.html

To convert a certificate from PFX format (PKCS12 keystores) to JKS format, use the following command (requires JDK 1.6+):

keytool -importkeystore -srckeystore mypfxfile.pfx -srcstoretype pkcs12 -destkeystore clientcert.jks -deststoretype JKS

Step-by-step guide

1. Creating a self-signed certificate

JKS format

The keytool program is located in the bin directory of your JDK. The command to use to generate the certificate is:

(certificat.keystore is the name of the file that will be generated)

When generating the certificate, the domain name targeted by HTTPS must be entered in: 'What is your first and last name?'.

Only through this name will you be able to securely access JMap via HTTPS, any other URL (ex: localhost, 127.0.0.1, etc.) will return a security error.

PFX format (PKCS12 keystore)

1. Install OpenSSL.

2. Create the private key : openssl genrsa 2048 > private.pem

3. Create the self-signed certificate: openssl req -x509 -days 1000 -new -key private.pem -out public.pem

4. Create the PFX : openssl pkcs12 -export -in public.pem -inkey private.pem -out mycert.pfx

2. Configuring the Certificate

1. Once the certificate is created, change the following parameters in:  /chemin/vers/jmap/conf/jmapserver.properties 
   
   

   1. The certificate created:
      server.https.keystore.file=/chemin/vers/jmap/conf/certificat.keystore (Examples : server.https.keystore.file=../conf/star_jmaponline_net.jks ou server.https.keystore.file=../conf/star_jmaponline_net.pfx)
      
      

   2. The 'encrypted' value indicates whether the password is encrypted, so when you first set it up you will need to use the password() function. When JMap Server is started for the first time, your password should be encrypted:
      server.https.keystore.password=password(put_your_keystore_password_here)
      server.https.keystore.password.encrypted=true
      
      

   3. The port to use for HTTPS (443 by default):
      server.https.port=443
      
      

2. Once these steps have been completed, restart JMap Server and launch JMap Admin in HTTPS:  https://xxx.xxx.xxx.xxx:443/jmapadmin.

Examples

Example of JKS format configuration

Example of PFX format (PKCS12 keystore) configuration