Feat/sso via portal

[clairekinde11]

Draft PR for docs review by Dave.

Summary by CodeRabbit

• Documentation
  • Added comprehensive guide for customers to set up SSO via the self-serve portal, including prerequisites, domain verification, configuration, and lifecycle management.
  • Introduced developer guide to manage, enable/disable, and delete customer-created SSO connections, with troubleshooting steps.
  • Added instructions to enable the self-serve SSO portal per organization.
  • Noted availability on the Kinde Scale plan.
  • Updated sidebar navigation with a new “Self-serve SSO” section for easier access.

[coderabbitai]

Warning

Rate limit exceeded

@clairekinde11 has exceeded the limit for the number of commits or files that can be reviewed per hour. Please wait 23 minutes and 19 seconds before requesting another review.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

📥 Commits

Reviewing files that changed from the base of the PR and between a4618ae and 775de82.

📒 Files selected for processing (1)

• src/content/docs/authenticate/self-serve-sso/add-sso-self-serve.mdx (1 hunks)

Walkthrough

Adds three new documentation pages for self-serve SSO setup and management and updates the sidebar to include a “Self-serve SSO” section. Content covers enabling per-organization access, adding/configuring SSO via a self-serve portal, and managing/troubleshooting connections. No code logic changes.

Changes

Cohort / File(s)	Summary of Changes
Self-serve SSO Docs src/content/docs/authenticate/self-serve-sso/add-sso-self-serve.mdx, src/content/docs/authenticate/self-serve-sso/manage-self-serve-connections.mdx, src/content/docs/authenticate/self-serve-sso/self-manage-sso-per-org.mdx	Added three MDX documentation pages with metadata and step-by-step guidance for enabling, configuring, and managing self-serve SSO (including per-organization enablement and troubleshooting).
Sidebar Navigation src/data/sidebarData.ts	Added “Self-serve SSO” under “Auth and access” with autogenerate for authenticate/self-serve-sso/, placed after “Enterprise connections.”

Sequence Diagram(s)

sequenceDiagram
  autonumber
  actor CustomerAdmin as Customer Admin
  participant App as Self-serve Portal (App)
  participant IdP as Identity Provider
  participant Kinde as Kinde

  CustomerAdmin->>App: Open self-serve portal (SSO section)
  App->>CustomerAdmin: Prompt for verified domain + IdP config
  CustomerAdmin->>IdP: Create app, get metadata (issuer, cert, etc.)
  CustomerAdmin->>App: Enter domain + IdP details
  App-->>Kinde: Create enterprise connection (pending)
  Kinde-->>App: Connection created (requires enablement)

  CustomerAdmin->>Kinde: Admin reviews and finishes setup
  Kinde-->>CustomerAdmin: Connection ready
  CustomerAdmin->>Kinde: Enable connection for org/users
  Note over Kinde,App: Users can authenticate via configured IdP

Loading

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• Feat/how to b2b b2c auth #198 — Also adds authentication docs and updates sidebarData.ts; similar navigation changes.
• Fix/move self serve portal docs #566 — Updates self-serve portal documentation; thematically aligned with self-serve SSO pages.

Suggested labels

sdk

Suggested reviewers

• DaveOrDead
• oliwolff1

Poem

I hop through docs with gentle glee,
New paths for SSO, clear to see.
Flip the switch, the portals sing,
Orgs invite the IdP spring.
With whiskers twitch and links aligned—
Self-serve stars are now defined.
(_/)>✨

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Title Check	⚠️ Warning	The pull request title “Feat/sso via portal” is terse and uses ambiguous shorthand without clearly describing the addition of self-serve SSO portal documentation and thus fails to convey the primary documentation changes in a concise sentence.	Please update the title to a clear, descriptive sentence such as “Add self-serve SSO portal documentation” that succinctly summarizes the main change.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[cloudflare-workers-and-pages]

Deploying kinde-docs-previews with    Cloudflare Pages

Latest commit:	bd907f3
Status:	✅  Deploy successful!
Preview URL:	https://dfac230b.kinde-docs-previews.pages.dev
Branch Preview URL:	https://feat-sso-via-portal.kinde-docs-previews.pages.dev

View logs

[oliwolff1]

I got the attached screen when clicking on either of Cloudlfare links

• https://dfac230b.kinde-docs-previews.pages.dev/
• https://feat-sso-via-portal.kinde-docs-previews.pages.dev/

Maybe it's showing this because it's in draft - if that's the case then we can ignore this.

[cloudflare-workers-and-pages]

Deploying kinde-docs-preview with    Cloudflare Pages

Latest commit:	775de82
Status:	✅  Deploy successful!
Preview URL:	https://a0ebf26f.kinde-docs-preview.pages.dev
Branch Preview URL:	https://feat-sso-via-portal.kinde-docs-preview.pages.dev

View logs

[coderabbitai]

Actionable comments posted: 2

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between d4a263a and a4618ae.

📒 Files selected for processing (4)

• src/content/docs/authenticate/self-serve-sso/add-sso-self-serve.mdx (1 hunks)
• src/content/docs/authenticate/self-serve-sso/manage-self-serve-connections.mdx (1 hunks)
• src/content/docs/authenticate/self-serve-sso/self-manage-sso-per-org.mdx (1 hunks)
• src/data/sidebarData.ts (1 hunks)

🔇 Additional comments (3)

src/data/sidebarData.ts (1)

154-158: Self-serve SSO nav placement looks spot on.

The label matches what folks will search for and the directory slug lines up cleanly with the new doc set. Nice positioning between Enterprise connections and MFA.

src/content/docs/authenticate/self-serve-sso/self-manage-sso-per-org.mdx (1)

32-36: Upgrade gating callout is clear.

Thanks for flagging Scale-plan availability up front; that saves readers guesswork before diving into the flow.

src/content/docs/authenticate/self-serve-sso/manage-self-serve-connections.mdx (1)

41-49: Solid troubleshooting checklist.

This covers the usual SAML gotchas (ACS URL, domain, certs, upstream params) and gives support plenty to run through before escalating—nicely done.