docs: explain external user lookup for Identity and CMS Kit#25118
Merged
docs: explain external user lookup for Identity and CMS Kit#25118
Conversation
2 tasks
Contributor
There was a problem hiding this comment.
Pull request overview
Adds documentation explaining how ABP resolves “external” users for module-to-module scenarios, and how to configure remote (tiered/distributed) user lookup between CMS Kit and Identity using Identity integration services.
Changes:
- Document
UserLookupServiceexternal lookup flow in the Identity module docs, including the relevant provider implementations and remote setup prerequisites. - Add CMS Kit guidance for remote user lookup against Identity in tiered/distributed deployments (RemoteServices + client credentials + exposed integration services).
- Clarify Identity’s current integration-service entry point by documenting
IdentityUserIntegrationServiceand notingIdentityUserLookupAppService’s backward-compat delegation.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| docs/en/modules/identity.md | Adds an “External User Lookup Service” section and updates the application-services list to highlight the integration service entry point. |
| docs/en/modules/cms-kit/index.md | Adds a new section describing when/how CMS Kit performs user lookups via Identity integration endpoints in distributed setups. |
|
|
||
| ### External User Lookup Service | ||
|
|
||
| `UserLookupService<TUser, TUserRepository>` first queries the local user store. If an `IExternalUserLookupServiceProvider` implementation is available, it can also query an external source, create the local copy of the user and keep the local data synchronized. |
|
|
||
| If the CMS Kit and Identity modules run in the same application, no extra configuration is typically needed. | ||
|
|
||
| If the Identity module runs in another application or service (for example, in a tiered or distributed solution), CMS Kit may need to call the Identity integration endpoints remotely to create or update `CmsUser` records. |
ismcagdas
approved these changes
Mar 23, 2026
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
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.
Summary
IIdentityUserIntegrationServiceis usedTesting
Closes #14079