Jenkins (OIDC)
Use Hanzo IAM as the OIDC IdP for Jenkins sign-in.
Use Hanzo IAM as the OIDC identity provider for Jenkins so users sign in with their Hanzo IAM accounts.
Terms: IAM_HOSTNAME — Hanzo IAM server URL; JENKINS_HOSTNAME — Jenkins server URL.
Step 1: Deploy Hanzo IAM and Jenkins
Deploy Hanzo IAM and Jenkins. Then:
- Set the Jenkins URL (Manage Jenkins -> Configure System -> Jenkins Location) to
JENKINS_HOSTNAME.
- Ensure that Hanzo IAM can be logged in and used normally.
- Set Hanzo IAM's
originvalue (conf/app.conf) toIAM_HOSTNAME.
Step 2: Configure the Hanzo IAM application
- Create or edit a Hanzo IAM application.
- Add redirect URL:
http://JENKINS_HOSTNAME/securityRealm/finishLogin. - Add providers as needed. Note the Client ID and Client secret from the application page.
OIDC discovery URL: http://IAM_HOSTNAME/.well-known/openid-configuration

Step 3: Configure Jenkins
Install the OpenId Connect Authentication plugin (Jenkins does not support OIDC by default).
After the installation is complete, go to Manage Jenkins -> Configure Global Security.

:::tip
Make sure to back up the Jenkins config.xml file to recover in case of any setup errors.
:::
- In Access Control, select
Login with Openid Connectas the Security Realm. - Specify the
Client IDnoted above in the Client ID field. - Specify the
Client secretnoted above in the Client secret field. - In the Configuration mode, select
Automatic configurationand enter http://IAM_HOSTNAME/.well-known/openid-configuration as the Well-known configuration endpoint.
If your Hanzo IAM is deployed locally, you may need to select Manual configurationand provide the following information:- Token server URL: http://
IAM_HOSTNAME/oauth/token - Authorization server URL: http://
IAM_HOSTNAME/oauth/authorize - UserInfo server URL: http://
IAM_HOSTNAME/api/get-account - Scopes:
address phone openid profile offline_access email
- Token server URL: http://
- Click on Advanced settings and fill in the following:
- In the User name field, specify
name. - In the Full name field, specify
displayName. - In the Email field, specify
email.

- In the User name field, specify
- In the Authorization section, enable “Logged-in users can do anything” and disable “Allow anonymous read access”. You can configure more complex authorization later, but for now, check if OpenID works correctly.
Log out of Jenkins, and it should redirect you to Hanzo IAM for authentication.

How is this guide?
Last updated on