Title: docs(sso): correct callback host and issuer guidance, document Entra SAML and IdP-initiated behavior by waleedlatif1 · Pull Request #6334 · simstudioai/sim · GitHub
Open Graph Title: docs(sso): correct callback host and issuer guidance, document Entra SAML and IdP-initiated behavior by waleedlatif1 · Pull Request #6334 · simstudioai/sim
X Title: docs(sso): correct callback host and issuer guidance, document Entra SAML and IdP-initiated behavior by waleedlatif1 · Pull Request #6334 · simstudioai/sim
Description: Summary Corrections and gaps found while walking a live customer through SAML setup. Every claim below was verified against the code or against the working provider row in production, not assumed. Incorrect guidance, now fixed Callback URLs printed https://sim.ai/... while the app emits https://www.sim.ai/.... Identity providers match these character for character, so following the docs instead of copying from the settings page produced a 404 after authentication. The ADFS tab told users to set Issuer URL to Sim's own URL. That field is the identity provider's identifier — with no IdP metadata, createSP/createIdP fall back to it as the IdP entity ID (idpData?.entityID || config.issuer). The working Entra provider in production confirms the intended shape: its issuer is the IdP's sts.windows.net/{tenant}/, not Sim's URL. Sim's own identifier is the separate SP Entity ID field. Sim's form requires an https issuer, but ADFS commonly defaults its Federation Service identifier to http://. Noted, since the previous example would have been rejected on save. Provider ID was described as changeable ("changing it later means redoing that step"). It is read-only once saved. Missing, now documented A SAML guide for Microsoft Entra. SAML was only covered for ADFS, yet Entra + SAML is what a customer just configured. Values are taken from the working provider row. IdP-initiated sign-in is rejected. Launching from Microsoft My Apps or an Okta tile sends an unsolicited assertion, which we refuse by design. Testing must start from Sim. Without this, a correct configuration looks broken. Linking matches on the exact email address. If the IdP asserts a different address than the existing account — a privileged variant like p-alice@company.com, or an alias — a second account is created instead of linking. Observed live today. Removing a verified domain immediately disables SSO for that domain until it is verified again. Type of Change Bug fix (documentation) Testing Docs-only. fumadocs-mdx compiles the content cleanly ([MDX] generated files in 34ms); the next build step then fails on a missing DATABASE_URL in this environment, which is unrelated to content. Verified no sim.ai/api/auth occurrence remains without the www. host, that no other page under apps/docs/content references these endpoints, and that the Tab/Tabs tags balance (5 and 5) after adding the new tab. Checklist Code follows project style guidelines Self-reviewed my changes Tests added/updated and passing No new warnings introduced I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)
Open Graph Description: Summary Corrections and gaps found while walking a live customer through SAML setup. Every claim below was verified against the code or against the working provider row in production, not assumed. ...
X Description: Summary Corrections and gaps found while walking a live customer through SAML setup. Every claim below was verified against the code or against the working provider row in production, not assumed. ...
Opengraph URL: https://github.com/simstudioai/sim/pull/6334
X: @github
Domain: github.com
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react-reconciler,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@d5750093facf |
| route-pattern | /:user_id/:repository/pull/:id/files(.:format) |
| route-controller | pull_requests |
| route-action | files |
| fetch-nonce | v2:e484d7f5-bc43-0f83-4458-3f6d9263f6ce |
| current-catalog-service-hash | ae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b |
| request-id | C472:3B3600:AD8ADA:EE6934:6AFB508D |
| html-safe-nonce | 29e3356a4dd6c4e31bc67e0faa1a1b7229f522fc98109c062b2ad02c78ce46c7 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJDNDcyOjNCMzYwMDpBRDhBREE6RUU2OTM0OjZBRkI1MDhEIiwidmlzaXRvcl9pZCI6IjIyMjkwNjU0MTAwOTQ5MDA2MSIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 35d5d1247eb5f5a9a9ae45c65c60c09ad99446d1c3f6cc616fc8fe03e5d5d424 |
| hovercard-subject-tag | pull_request:4223278489 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/simstudioai/sim/pull/6334/files |
| twitter:image | https://avatars.githubusercontent.com/u/40672544?s=400&v=4 |
| twitter:card | summary_large_image |
| og:image | https://avatars.githubusercontent.com/u/40672544?s=400&v=4 |
| og:image:alt | Summary Corrections and gaps found while walking a live customer through SAML setup. Every claim below was verified against the code or against the working provider row in production, not assumed. ... |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | 7122bb414b542dba14d71a3f0b9f6fd2abce715b9f5912d082800563e6c806d1 |
| turbo-cache-control | no-preview |
| diff-view | unified |
| go-import | github.com/simstudioai/sim git https://github.com/simstudioai/sim.git |
| octolytics-dimension-user_id | 199344406 |
| octolytics-dimension-user_login | simstudioai |
| octolytics-dimension-repository_id | 912559512 |
| octolytics-dimension-repository_nwo | simstudioai/sim |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 912559512 |
| octolytics-dimension-repository_network_root_nwo | simstudioai/sim |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | true |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | cbf66c024bb6d10e6955baa7413c54cf13a201bb |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width