Skip to content

docs: improve SSO/IDP configuration pages#95

Open
nsaronson wants to merge 1 commit intomainfrom
docs/improve-idp-sso-pages
Open

docs: improve SSO/IDP configuration pages#95
nsaronson wants to merge 1 commit intomainfrom
docs/improve-idp-sso-pages

Conversation

@nsaronson
Copy link
Contributor

Summary

  • Overview page (get-started.mdx): full rewrite of the Configuration section with tabbed Web App/API instructions, field reference tables for OIDC and SAML 2.0, expanded troubleshooting (groups not syncing, callback errors, opaque tokens, lockout recovery), fixed prose, removed stale content
  • All six provider pages: added a consistent "Configure Hoop Gateway" section with Web App and API tabs showing provider-specific values
  • Deprecated references removed: replaced all IDP_* env var references (Google groups scope, Azure/Google admin role warnings) with Web App/API instructions
  • Azure M2M: replaced deprecated hoop admin CLI commands with POST /api/serviceaccounts and GET /api/userinfo API calls
  • Okta: clarified _userinfo=1 with a concrete Issuer URL example; simplified the groups "Configure Hoop Gateway" step
  • JumpCloud: documented the groups_claim value (https://app.hoop.dev/groups) and moved the userinfo endpoint note into the Configure section

Test plan

  • Verify Mintlify renders tabs correctly on all updated provider pages
  • Confirm field reference tables render correctly in the overview
  • Check all internal links still resolve
  • Review SAML SP endpoint values against gateway source (/api/saml/callback, /saml/acs)

🤖 Generated with Claude Code

- Rewrote get-started overview: tabbed Web App/API configuration,
  field reference tables for OIDC and SAML, expanded troubleshooting
  (groups not syncing, callback errors, opaque tokens, lockout recovery),
  fixed prose throughout, removed stale tip
- Added "Configure Hoop Gateway" section (Web App + API tabs) to all
  six provider pages (Auth0, Okta, Azure, Google, AWS Cognito, JumpCloud)
- Replaced all deprecated IDP_* env var references with Web App/API
  instructions (Google groups scope, Azure/Google admin role warning)
- Replaced deprecated hoop CLI commands in Azure M2M section with API
  calls (POST /api/serviceaccounts, GET /api/userinfo)
- Clarified Okta _userinfo=1 usage with concrete Issuer URL example
- Documented JumpCloud groups_claim value and userinfo endpoint behavior
- Added SAML 2.0 SP endpoints (ACS URL, Entity ID) to overview

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@netlify
Copy link

netlify bot commented Mar 2, 2026

Deploy Preview for decap-documentation ready!

Name Link
🔨 Latest commit 9fd4cc7
🔍 Latest deploy log https://app.netlify.com/projects/decap-documentation/deploys/69a5bee6ba020f0008da4e26
😎 Deploy Preview https://deploy-preview-95--decap-documentation.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

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.

1 participant