Skip to content

docs: add Okta OIDC SSO step-by-step guide#5316

Merged
victorvhs017 merged 6 commits intomainfrom
devin/PLATFRM-185-1769717049-okta-oidc-guide
Feb 3, 2026
Merged

docs: add Okta OIDC SSO step-by-step guide#5316
victorvhs017 merged 6 commits intomainfrom
devin/PLATFRM-185-1769717049-okta-oidc-guide

Conversation

@devin-ai-integration
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot commented Jan 29, 2026 •
edited
Loading

Context

Adds a step-by-step guide for setting up Okta OIDC SSO with Infisical. This complements the existing Okta SAML guide and follows the same structure as other OIDC guides (Auth0, Keycloak, PingOne).

Related: PLATFRM-185

Changes

  • Added new documentation file docs/documentation/platform/sso/okta-oidc.mdx with 7 steps covering:
    1. Preparing OIDC configuration in Infisical
    2. Creating an OIDC application in Okta
    3. Retrieving IdP information (Client ID, Client Secret, Discovery URL)
    4. Configuring OIDC in Infisical
    5. Assigning users in Okta
    6. Enabling OIDC SSO
    7. Enforcing OIDC SSO
  • Updated docs/docs.json to add the new page to the OIDC navigation section
  • Added 7 screenshots under docs/images/sso/okta-oidc/:
    • create-app-integration.png - Okta Applications page
    • create-oidc-app.png - OIDC app integration dialog
    • app-settings.png - App configuration settings
    • client-credentials.png - Client ID and Secret
    • okta-domain.png - Okta domain in browser
    • infisical-oidc-config.png - Infisical OIDC configuration form
    • assignment.png - User assignment dropdown

Updates since last revision

  • Added all 7 Okta-specific screenshots to the guide (previously were placeholders)
  • Updated mdx file to reference the new images
  • Wrapped URL in backticks per Greptile suggestion to prevent @ being interpreted as user mention

Steps to verify the change

  1. Preview the page at the Mintlify deployment to ensure screenshots render correctly
  2. Verify the Okta OIDC configuration steps are technically accurate
  3. Confirm the Discovery URL format (https://<okta-domain>/.well-known/openid-configuration) is correct for Okta
  4. Check navigation placement in docs.json
  5. Review screenshot quality and ensure they match the described steps

Human review checklist

  • Screenshots accurately represent the Okta OIDC setup flow
  • Callback URL format is correct for Infisical OIDC
  • Self-hosting notes are accurate (AUTH_SECRET, SITE_URL)

Type

  • Fix
  • Feature
  • Improvement
  • Breaking
  • Docs
  • Chore

Checklist

Requested by: @0xArshdeep
Link to Devin run: https://app.devin.ai/sessions/80d49bc7d917489eb8cb4ad22b8fa083

@devin-ai-integration @0xArshdeep
docs: add Okta OIDC SSO step-by-step guide
e056a37 
Co-Authored-By: arsh@infisical.com <arshsb1998@gmail.com>
@devin-ai-integration
Copy link
Contributor Author

devin-ai-integration bot commented Jan 29, 2026

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@maidul98
Copy link
Collaborator

maidul98 commented Jan 29, 2026 •
edited
Loading

✅ Snyk checks have passed. No issues have been found so far.

Status Scanner Critical High Medium Low Total (0)
✅ Open Source Security 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

@greptile-apps
Copy link
Contributor

greptile-apps bot commented Jan 29, 2026

Greptile Overview

Greptile Summary

Added a comprehensive step-by-step guide for configuring Okta OIDC SSO with Infisical. The documentation follows the established structure and style of existing OIDC guides (Auth0, Keycloak, PingOne) and provides clear instructions for setting up the integration.

Key changes:

  • Created new documentation file covering 7 steps: preparing OIDC config in Infisical, creating Okta app, retrieving IdP info, configuring OIDC, assigning users, enabling SSO, and enforcing SSO
  • Added navigation entry in docs.json under the OIDC section
  • Uses consistent formatting with proper warnings about lockout scenarios and self-hosting configuration requirements
  • References placeholder images (directory /images/sso/okta-oidc/ doesn't exist yet) and reuses shared OIDC images

Note: As mentioned in the PR description, screenshots are placeholders and the images/sso/okta-oidc/ directory needs to be created with actual screenshots before the documentation is complete.

Confidence Score: 5/5

  • This PR is safe to merge - it only adds documentation with no code changes
  • Score reflects that this is a documentation-only change with no impact on production code. The documentation follows established patterns, is technically accurate, and properly integrates into the existing navigation structure. Only minor style improvement suggested.
  • No files require special attention - documentation is well-structured and follows existing patterns

Important Files Changed

Filename Overview
docs/documentation/platform/sso/okta-oidc.mdx Added comprehensive Okta OIDC SSO setup guide with 7 steps, following existing OIDC documentation structure
docs/docs.json Added Okta OIDC page to navigation under OIDC section

greptile-apps[bot]
greptile-apps bot reviewed Jan 29, 2026
View reviewed changes
Copy link
Contributor

@greptile-apps greptile-apps bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

2 files reviewed, 1 comment

Edit Code Review Agent Settings | Greptile

@devin-ai-integration @0xArshdeep
fix: remove non-existent image references to fix parsing error
2e40819 
Co-Authored-By: arsh@infisical.com <arshsb1998@gmail.com>
@devin-ai-integration @0xArshdeep
docs: add screenshots for Okta OIDC guide
2b1693c 
Co-Authored-By: arsh@infisical.com <arshsb1998@gmail.com>
@devin-ai-integration @0xArshdeep
docs: wrap URL in backticks per Greptile suggestion
8e3fec2 
Co-Authored-By: arsh@infisical.com <arshsb1998@gmail.com>
victorvhs017
victorvhs017 approved these changes Feb 3, 2026
View reviewed changes
Copy link
Contributor

@victorvhs017 victorvhs017 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested the docs flow and updated some things, all good now!

@victorvhs017 victorvhs017 merged commit f8f1e42 into main Feb 3, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@victorvhs017 victorvhs017 victorvhs017 approved these changes

+1 more reviewer

@greptile-apps greptile-apps[bot] greptile-apps[bot] left review comments

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@maidul98 @victorvhs017