====== oAuthKeycloak Plugin ======

---- plugin ----
description: Keycloak Service for use with the oAuth Plugin
author     : Naoto Kobayashi 
email      : naoto.kobayashi4c@gmail.com 
type       : action
lastupdate : 2024-05-06
compatible : Hogfather, Jack Jackrum
depends    : oauth
conflicts  : 
similar    : 
tags       : oauth, authentication

downloadurl: https://github.com/YoitoFes/dokuwiki-plugin-oauthkeycloak/zipball/master
bugtracker : https://github.com/YoitoFes/dokuwiki-plugin-oauthkeycloak/issues
sourcerepo : https://github.com/YoitoFes/dokuwiki-plugin-oauthkeycloak/
donationurl: 

screenshot_img : 
----

This plugin implements the oAuth workflow needed to authenticate users with Keycloak.

===== Installation =====

:!: **External requirements:** This plugin requires the [[plugin:oauth|oAuth Plugin]] 2021-12-19 or above.

Install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Configuration =====

You need to set the client ID, client secret and discovery URL of your Keycloak. Discovery URL is:

  https://<keycloakserver>/auth/realms/<realm>/.well-known/openid-configuration
  
For newer keycloak versions, it is:
  
  https://<keycloakserver>/realms/<realm>/.well-known/openid-configuration

Additionally you can set label and color of the login button if you want. The default label/color are 'Keycloak'/'#333333' 

=== Change Log ===

{{rss>https://github.com/YoitoFes/dokuwiki-plugin-oauthkeycloak/commits/master.atom date}}