Skip to content

docs:#583

Open
mintlify[bot] wants to merge 1 commit intomainfrom
docs/okta-cloud-sso-setup
Open

docs:#583
mintlify[bot] wants to merge 1 commit intomainfrom
docs/okta-cloud-sso-setup

Conversation

@mintlify
Copy link
Copy Markdown
Contributor

@mintlify mintlify Bot commented Apr 30, 2026

Adds a new dedicated page for setting up Okta SSO on Lightdash Cloud, so customers can be sent straight to a single page that:

  • Calls out clearly that Okta SSO is Cloud Enterprise only and they need to contact us to enable it
  • Lists exactly which values they need to share with us securely (Client ID, Client secret, Okta domain, Issuer URI, Authorization server ID, extra scopes)
  • Recommends a secure secret-sharing tool (e.g. 1Password) for the client secret
  • Walks through the Okta-side setup (creating the app, redirect URIs, optional groups configuration)
  • Links to the existing self-hosted guide for self-hosted users

Changes

  • New page: references/workspace/okta-sso-setup.mdx
  • Added to navigation under Workspace and user management → Admin
  • Updated references/workspace/sso-providers.mdx Okta section to point to both the new Cloud guide and the existing self-hosted guide

Closes the gap where customers were being sent to the self-hosted SSO doc, which didn't make it clear which values to send to Lightdash or that Okta SSO is enterprise-only.

@mintlify
Copy link
Copy Markdown
Contributor Author

mintlify Bot commented Apr 30, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Apr 30, 2026, 12:16 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 30, 2026

🤖 Documentation Bot

All checks passed! No issues found.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants