1. How to install keycloak on ubuntu wsl¶

Cette note décrit la mise en œuvre de KeyCloak dans dans une distribution Ubuntu tournant sous WSL.

1.1 Installation¶

Créez un nouvel utilisateur et un groupe en exécutant la commande suivante:

sudo useradd -U -d /opt/keycloak -s /bin/false keycloak

Télécharger l'archive de KeyCloak dans le dossier /tmp :

cd /tmp
wget https://github.com/keycloak/keycloak/releases/download/15.0.2/keycloak-15.0.2.tar.gz

Le lien de téléchargement des anciennes versions de KeyCloak peut s'obtenir à partir de cette page.

Décompresser le contenu de l'archive dans le dossier /opt :

sudo tar xvzf /tmp/keycloak-15.0.2.tar.gz -C /opt

Attribuer la propriété du dossier à l'utilisateur keycloak:

sudo chown -R keycloak:keycloak /opt/keycloak-15.0.2

Créer un lien symbolique vers Keycloak :

sudo ln -s /opt/keycloak-15.0.2 /opt/keycloak

Ce lien symbolique permet d'avoir plusieurs installations de KeyCloak ; il est particulièrement pratique en cas de mise à jour, il suffira alors de décompresser la version la plus récente et de modifier le lien symbolique pour qu'il pointe vers cette version.

1.2 Configuration¶

Copier le fichier de configuration KeyCloak par défaut :

sudo cp /opt/keycloak/docs/contrib/scripts/init.d/wildfly.conf /etc/default/keycloak.conf

Ajuster le fichier de configuration par défaut :

sudo sed -i 's/wildfly/keycloak/' /etc/default/keycloak.conf
sudo sed -i 's/WildFly/KeyCloak/' /etc/default/keycloak.conf

Copier le fichier de gestion du service KeyCloak :

sudo cp /opt/keycloak/docs/contrib/scripts/init.d/wildfly-init-debian.sh /etc/init.d/keycloak

Ajuster le script de gestion du service :

sudo sed -i 's/wildfly/keycloak/' /etc/init.d/keycloak
sudo sed -i 's/WildFly/KeyCloak/' /etc/init.d/keycloak

Modifier le port de fonctionnement du serveur :

sudo sed -i 's/jboss.http.port:8080/jboss.http.port:9080/' /opt/keycloak/standalone/configuration/standalone.xml

1.3 Tester l'installation¶

sudo service keycloak start

Ouvrez votre navigateur à l'adresse : [[http://localhost:9080/]]

Si tout est bon l'interface de Keycloak doit apparaitre :