OpenID Connect with KeyCloak on RHEL7¶
This tutorial shows installing Keycloak as an OpenID Connect Identity Provider and configuring OnDemand as an OpenID Client to authenticate with this provider.
https://ondemand-dev.hpc.osc.edu as the example host with OnDemand installed, at the end of the tutorial:
- Keycloak is running and accessible at
- In both cases Apache is handling requests. Apache proxies requests for
https://ondemand-idpdev.hpc.osc.eduto the Keycloak server running on the default port of 8080.
- Attempting to access OnDemand at
https://ondemand-dev.hpc.osc.eduredirects the user to
https://ondemand-idpdev.hpc.osc.eduto first authenticate.
At OSC in production we do two things differently from this tutorial:
- we keep Keycloak on a separate host from OnDemand
- we configure Keycloak to use MySQL for Keycloak’s database instead of the default H2 file database
These steps have been omitted from the tutorial. For most cases for OnDemand, the default H2 database is probably sufficient. Also by installing Keycloak on the same host as OnDemand, we don’t need to provision separate SSL certificates and host, which simplifies the tutorial.
If your site is interested in either of these things and needs assistance, please let us know by contacting us on the OnDemand Discourse at https://discourse.osc.edu/c/open-ondemand.
In production we recommend installing Keycloak on a separate host from OnDemand.
This tutorial has only been verified to work with Keycloak 9.0.0.
- 1. Install Keycloak
- 2. Configure Keycloak
- 3. Configure OnDemand to authenticate with Keycloak
- 4. Add Custom Theme
- 5. Configure Keycloak with CILogon