Connexion Keycloak

Maarch Courrier permet de se connecter avec un portail Keycloak.

Paramètrage

Configuration Keycloak

La configuration se fait dans le fichier de configuration :

apps/maarch_entreprise/xml/keycloakConfig.xml

Voici la partie à configurer :

    <ROOT>
        <AUTH_SERVER_URL>http://your.keycloak.server/authentication/path</AUTH_SERVER_URL>
        <REALM>maarch_courrier</REALM>
        <CLIENT_ID>maarch</CLIENT_ID>
        <CLIENT_SECRET>secret</CLIENT_SECRET>
        <REDIRECT_URI>http://demo.maarchcourrier.com/apps/maarch_entreprise/index.php?display=true&amp;page=login</REDIRECT_URI> <!-- Should be the url of the login page -->
        <ENCRYPTION_ALGORITHM>RS256</ENCRYPTION_ALGORITHM>
        <ENCRYPTION_KEY_PATH>/path/to/key/file.pem</ENCRYPTION_KEY_PATH>
        <ENCRYPTION_KEY>key_content</ENCRYPTION_KEY>
    </ROOT>

• AUTH_SERVER_URL : URL d'authentification du portail Keycloak
• REALM : Le nom du "realm" contenant les utilisateurs de Maarch Courrier
• CLIENT_ID : L'identifiant du client utilisé par Maarch Courrier pour communiquer avec Keycloak, défini dans l'administration de Keycloak
• CLIENT_SECRET : Le secret du client utilisé par Maarch Courrier pour communiquer avec Keycloak, défini dans l'administration de Keycloak
• REDIRECT_URI : L'adresse de redirection après connexion sur le portail Keycloak. Ce paramètre doit être l'URL de la page de connexion de MaarchCourrier (avec les paramètres page=login)

Si vous avez paramétré votre instance Keycloak pour utiliser un algorithme de chiffrement, vous devez utiliser les paramètres suivant :

• ENCRYPTION_ALGORITHM : Le nom de l'algorithme de chiffrement utilisé
• ENCRYPTION_KEY_PATH : Le chemin vers la clé publique ou du certificat à utilisé
• ENCRYPTION_KEY : Le contenu de la clé publique ou du certificat à utilisé

Vous ne pouvez pas utiliser ENCRYPTION_KEY_PATH et ENCRYPTION_KEY en même temps.

Activation du mode d'authentificaton Keycloak

Il faut ensuite activer le mode d'authentification Keycloak dans le fichier

apps/maarch_entreprise/xml/login_method.xml

Il faut obtenir :

    <METHOD>
        <ID>keycloak</ID>
        <ENABLED>true</ENABLED>
    </METHOD>

Il faut également mettre ENABLED à false pour toutes les autres méthodes