Enabling Okta SSO - Workspace
To enable Okta SSO for your Workspace, you'll first need to configure ClickUp in your Okta application dashboard.
Retrieve ClickUp Configuration URL's
As an admin or owner, visit your Workspace's settings
Under the Single Sign-On section, click Okta to reveal a list of fields
Keep this page open as you'll need these URLs to set up the Okta application
Configure Okta Application
Navigate to your Okta dashboard and make sure that you are viewing the Classic UI
Under the Applications tab, hit New Application and search for ClickUp
Add the application to your organization
Click on the app you just created, navigate to the Sign On tab and click on the edit button
Copy and paste the Audience URI (SP Entity ID) and the Single Sign-On URL that were provided to you in the previous step into the matching fields in the Okta configuration
Make sure to add yourself and any other Okta users who should have access to the application via the Assignments page
Copy and paste the link labeled Identity Provider metadata inside the yellow box underneath 'View Setup Instructions'. You will need this URL in the next step
Paste the metadata URL you copied in the last section in the field labeled Identity Provider Metadata
Sign in with the Okta account you want linked to your ClickUp account
Navigate to the user preferences page
Scroll to the bottom of the page
A banner will indicate your account is successfully linked to Okta
Enforcing Okta SSO
Workspace admins will be able to control if Okta auth is required. When enforced, your Workspace will be prompted to link their Okta account to ClickUp the next time they try to sign in. At any time, you can check which users in your Workspace have linked their Okta accounts (seen in section below).
When logging in, users will be forced to sign in with their Okta account in order to access your Workspace.
Enabling Okta SSO - User
Once a Workspace admin has enabled Okta SSO, each user must link their account to use it.
Navigate to your Preferences
Scroll down to Single Sign-On
If the Workspace has had Okta SSO enabled successfully, an option to link the ClickUp account with an Okta account will be available
Hit Link to sign in with Okta
Signing in with Okta SSO
On the sign in page, if Okta SSO is required for the Workspace to sign in, the Login With Okta button will appear right after the user inputs their email.
If SSO is not required for the Workspace, you can access this button by clicking Sign in with SSO button or by bookmarking
https://app.clickup.com/login/sso as your login page.
How to check who in your Workspace is using SSO
Admins can easily see who all on their Workspace has linked their Okta account to ClickUp.
Open your Workspace settings page
Users with an Okta icon have setup SSO
Okta support for Custom Roles
For Enterprise teams that rely on Okta for provisioning, Custom Roles fully integrate with Okta! Any role created in ClickUp can be added as an option within Okta, making it easy to integrate Custom Roles into existing workflows.
Learn how to use Okta for Custom Roles here.
Removing Okta from your account
Go to your profile settings and scroll to the bottom
Unlink you account
Optional: Use the relink button to associate your ClickUp account with a different Okta account than is currently attached
If you have any questions regarding Okta SSO or how ClickUp can boost your Workspace's productivity, reach out to us anytime here!