Project

SSO via Gitlab

Tickets

• MOG-4199 — Add GitLab admin setup guide on docs.mogenius.com

Summary

Customer-facing setup guide for the new GitLab Organization SSO provider. Covers gitlab.com and self-hosted GitLab, OIDC application creation with required scopes, the redirect-URI round-trip, and troubleshooting.

Changes

• cluster-management/sso-gitlab.mdx — new page (61 lines).
• docs.json — adds the new page to the "Setup & Administration" navigation group, immediately after single-sign-on (Entra).

Mirrors the existing Entra page structure (no frontmatter, ## step headings, <Note> callouts) for consistency.

Type

• Documentation

Acceptance Criteria

• New .mdx page under Organization SSO section
• Covers Overview / Register / Configure / Test / Troubleshooting
• Self-hosted steps clearly separated from gitlab.com steps
• Listed in docs.json navigation
• No screenshot fabrication (none added; can be added by hand later)
• Mintlify content-only — no local build to verify (this repo has no package.json)

Cross-Repo Impact

Should publish after the user-facing UI change (mo-frontend PR) is deployed to production, otherwise customers reading the doc will not find the GitLab option in the form yet.

Risk Assessment

• Size: 2 files, +61/0
• Risk areas: none — content only
• Confidence: high

How to Test

• Render locally with mintlify dev and verify the page appears in the sidebar under Setup & Administration.
• Check the page renders without MDX errors.