docs: fix self-hosted SCIM Tenant URL and explain duplicate users (embedded Entra SCIM) - #925
Draft
SunsetDrifter wants to merge 1 commit into
Draft
docs: fix self-hosted SCIM Tenant URL and explain duplicate users (embedded Entra SCIM)#925SunsetDrifter wants to merge 1 commit into
SunsetDrifter wants to merge 1 commit into
Conversation
The embedded Entra SCIM page showed the NetBird Cloud Tenant URL (api.netbird.io) on a self-hosted page; a reader who copies it points Entra at Cloud and provisioning silently fails. Use the reader's own management domain instead. Add a section explaining why externalId must map to objectId: NetBird matches users by stable ID, not email, so a mailNickname externalId creates a same-email duplicate of an existing sign-in user. Includes remediation for accounts that already have duplicates.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
|
Important Review skippedDraft detected. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Plus Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
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. Comment |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Two changes to the embedded Entra ID SCIM sync page (
manage/team/idp-sync/embedded/microsoft-entra-id-scim-sync):Tenant URL: the page showed the NetBird Cloud endpoint (
https://api.netbird.io/api/scim/v2?aadOptscim062020) on a self-hosted page. A reader who copies it verbatim points Entra provisioning at NetBird Cloud instead of their own server, and sync silently fails. Changed tohttps://YOUR_NETBIRD_DOMAIN/...with a note explaining it must be the reader's own management domain. (A customer hit exactly this and had to work it out themselves.)New section: "Why this mapping prevents duplicate users" after the User Attribute Mapping step. NetBird matches users by the Entra
objectId, never by email. Entra's defaultexternalIdsource ismailNickname, so anyone who syncs before correcting the mapping gets a second account for every user who already signed in, showing the identical email as the original. This is a recurring support case; the page previously said objectId is "the correct stable identifier" without naming the failure mode. The section explains the mechanism and includes remediation guidance for accounts that already have duplicates.Both behaviors reproduced on a self-hosted Enterprise install (v0.76.3) with a real Entra tenant and enterprise-app provisioning.
Follow-ups (not in this PR)
manage/team/idp-sync/microsoft-entra-id-scim-sync) shares the externalId text and could take the same duplicate-users section.EntraSCIMSetup.tsx); the docs fix here covers the page, but the product string needs the same treatment.