Jenkins Okta Integration

Introduction:

Integrating Jenkins with Okta provides centralized authentication and authorization, allowing users to log in using their corporate credentials. This improves security, simplifies user management, and enables Single Sign-On (SSO).

Prerequisites:

  • Jenkins Server installed and running
  • Administrator access to Jenkins
  • Administrator access to Okta
  • HTTPS enabled on Jenkins (recommended)
  • Internet connectivity between Jenkins and Okta

Architecture:

User
|
v
Okta Login Page
|
v
Authentication
|
v
Jenkins Dashboard

Step 1: Install Required Jenkins Plugin

Login to Jenkins.

Navigate to:

Manage Jenkins
→
Manage Plugins

Search for:

OpenID Connect Authentication Plugin

Install:

OpenID Connect Authentication Plugin

Restart Jenkins after installation.

Step 2: Create Application in Okta

Login to:

Okta Admin Console

Navigate to:

Applications
→
Applications
→
Create App Integration

Select:

OIDC - OpenID Connect

Click:

Next

Step 3: Configure Application

Select:

Web Application

Fill details:

App Name:
jenkins
Sign-in Redirect URI:
http://localhost:8080/securityRealm/finishLogin
Sign-out Redirect URI
http://localhost:8080/logout

Click:

Save

Step 4: Collect Okta Credentials

After application creation, note:

Client ID
Client Secret
Issuer URL
These values will be required in Jenkins.

Step 5: Configure Jenkins Security

Navigate:

Manage Jenkins
→
Security
→
Security Realm

Select:

Login with OpenID Connect

Fill:

Client ID
Client Secret
Well Known OpenID Configuration URL

User Name Field:

preferred_username

Full Name Field:

name

Email Field:

email

Save configuration.

Step 6: Configure Authorization

Logout jenkins

Browser me:

http://localhost:8080/logout
http://localhost:8080/securityRealm/commenceLogin

Step 7: Test Login

open incognato mode in browzer:

Open Jenkins:

localhost:8080

You should see:

Login with Okta

You will be redirected to Okta:

Username
Password

After successful authentication:

Jenkins Dashboard Appears.

Mahesh Wabale

Leave a Comment