This article walks you through setting up single sign-on to Coder using Okta.
Configuring Coder's OpenID Connect feature requires you to provide three pieces of information from Okta:
This guide will show you how to set up an app on Okta and obtain the information you need to provide to Coder.
Log in to your Okta org (
<my-company>.okta.com) as an admin.
From the admin dashboard, go to Applications and select the Applications sub-menu.
Click Add Application.
Click Create New App.
Select OpenID Connect and click Create
Provide an Application name (i.e.,
Coder), (optionally) add a logo, and
add the Login redirect URIs for Coder (it will be formatted similarly to
Click Save to proceed.
When Okta has created your app, you'll be redirected to the General tab, which displays your app information.
Once you've saved your app, you can obtain your:
On your application's General tab, look for the Client Credentials section, which includes the Client secret.
On your app's Overview page, click the Sign On tab. Find the OpenID Connect ID Token section, and copy the Issuer.
On your app's Overview page, click the Assignments tab. Under Assign, you can choose to Assign to People or Assign to Group to provide users and groups access to Coder.
Once you've saved your Okta values, you can complete the remaining steps using the Coder UI.
When done, click Save Preferences.
At this point, Coder validates your configuration before proceeding. If successful, Coder will send OIDC login attempts to Okta.