Keycloak - jean/wekan GitHub Wiki

OIDC Integration

Outstanding Bug: Create the first user (admin) with the regular process. Then the remaining users can use the Register with OIDC process.

Environment Variables that need to be set in your Wekan environment:

  • OAUTH2_ENABLED = TRUE
  • OAUTH2_CLIENT_ID = <Keycloak create Client ID>
  • OAUTH2_SERVER_URL = <Keycloak server name>/auth
  • OAUTH2_AUTH_ENDPOINT = /realms/<keycloak realm>/protocol/openid-connect/auth
  • OAUTH2_USERINFO_ENDPOINT = /realms/<keycloak realm>/protocol/openid-connect/userinfo
  • OAUTH2_TOKEN_ENDPOINT = /realms/<keycloak realm>/protocol/openid-connect/token
  • OAUTH2_SECRET = <keycloak client secret>
  • OAUTH2_ID_MAP = preferred_username
  • OAUTH2_USERNAME_MAP = preferred_username
  • OAUTH2_FULLNAME_MAP = given_name
  • OAUTH2_EMAIL_MAP = email

When creating a Client in keycloak, ensure the access type is confidential under the settings tab. After clicking save, you will have a Credentials tab. You can retrieve the secret from that location.