Skip to content

docs: explain external user lookup for Identity and CMS Kit#25118

Merged
ismcagdas merged 1 commit intorel-10.2from
issue-14079-external-user-lookup-docs
Mar 23, 2026
Merged

docs: explain external user lookup for Identity and CMS Kit#25118
ismcagdas merged 1 commit intorel-10.2from
issue-14079-external-user-lookup-docs

Conversation

@enisn
Copy link
Member

@enisn enisn commented Mar 19, 2026

Summary

  • document how the Identity module resolves external users and when IIdentityUserIntegrationService is used
  • add CMS Kit guidance for tiered and distributed setups that need remote user lookup with client credentials
  • clarify the current integration service entry point in the Identity application services section

Testing

  • git diff --check

Closes #14079

Copilot AI review requested due to automatic review settings March 19, 2026 10:03
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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 UserLookupService external 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 IdentityUserIntegrationService and noting IdentityUserLookupAppService’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 ismcagdas merged commit f337488 into rel-10.2 Mar 23, 2026
6 checks passed
@ismcagdas ismcagdas deleted the issue-14079-external-user-lookup-docs branch March 23, 2026 06:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants