Skip to content

Add OIDC SSO documentation and restructure SSO pages#47

Merged
FabianoEger merged 9 commits intomainfrom
page/sso-oidc
Mar 31, 2026
Merged

Add OIDC SSO documentation and restructure SSO pages#47
FabianoEger merged 9 commits intomainfrom
page/sso-oidc

Conversation

@vitorfdl
Copy link
Copy Markdown
Member

@vitorfdl vitorfdl commented Mar 30, 2026

Summary

  • Restructured the standalone SSO page into a folder with dedicated sub-pages for SAML and OIDC.
  • Added new OIDC SSO documentation covering setup process, configuration fields, claim mappings, query parameter forwarding, and enable/disable instructions.
  • Preserved the existing parent URL (/docs/tagoio/tagorun/single-sign-on-sso) via the new index.md overview page.

Changes

  • Deleted: single-sign-on-sso.md (old standalone page)
  • Created: single-sign-on-sso/index.md (SSO overview with SAML vs OIDC comparison)
  • Created: single-sign-on-sso/saml-sso.md (SAML-specific setup guide)
  • Created: single-sign-on-sso/oidc-sso.md (OIDC-specific setup guide)

Test plan

  • Verify the sidebar shows "Single Sign-On (SSO)" with collapsible sub-items (Overview, SAML SSO, OIDC SSO)
  • Navigate to /docs/tagoio/tagorun/single-sign-on-sso and confirm the overview page loads
  • Verify internal links between pages work (index to SAML, index to OIDC)
  • Review content accuracy against the OIDC feature in RUN Settings > Integrations > SSO OIDC

- Deleted outdated SSO article and replaced it with a new index file that provides an overview of SSO in TagoIO RUN, including SAML and OIDC protocols.
- Added detailed configuration guides for both SAML and OIDC SSO, outlining setup processes and supported identity providers.
- Introduced a new category JSON file for better organization in the documentation structure.
- Enhanced the table layout for SSO OIDC settings to improve readability.
- Maintained detailed descriptions for each field to assist users in configuration.
- Upgraded several packages including @mdx-js/react, clsx, prism-react-renderer, aws-cdk-lib, constructs, oxfmt, oxlint, tsx, and typescript to their latest versions for improved performance and security.
- Adjusted postman-code-generators version in overrides for consistency.
- Replaced the SSO integration image with a new version for better representation.
- Enhanced the descriptions of SAML and OIDC protocols by linking to their respective configuration guides.
- Adjusted the Last Name field in the OIDC SSO documentation to remove the 'required' label for improved accuracy.
@vitorfdl vitorfdl added new page Improvements or additions to documentation ready to merge update ready to be merged into the main doc waiting review Extra attention is needed labels Mar 30, 2026
- Introduced a new section detailing the automatic creation of user profiles with the tag `source: sso` when users sign in through SSO for the first time.
- Explained how this tag can be utilized for user identification, filtering, and automation setups.
- Updated language to clarify that RUN users are created through SSO with the tag `source: sso`.
- Improved descriptions of claim mappings to specify that they relate to RUN user fields.
- Removed outdated notes regarding SSO plan requirements and simultaneous protocol activation for better accuracy.
@vitorfdl vitorfdl requested a review from cotrin March 30, 2026 20:59
@vitorfdl vitorfdl self-assigned this Mar 30, 2026
@FabianoEger FabianoEger merged commit 5927a80 into main Mar 31, 2026
1 check passed
@FabianoEger FabianoEger deleted the page/sso-oidc branch March 31, 2026 17:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

new page Improvements or additions to documentation ready to merge update ready to be merged into the main doc waiting review Extra attention is needed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants