Skip to content

docs: add OIDC callback URL and external provider configuration notes#1451

Open
elyerr wants to merge 1 commit into
nextcloud:mainfrom
elyerr:main
Open

docs: add OIDC callback URL and external provider configuration notes#1451
elyerr wants to merge 1 commit into
nextcloud:mainfrom
elyerr:main

Conversation

@elyerr
Copy link
Copy Markdown
Contributor

@elyerr elyerr commented Jun 8, 2026

🤖 AI (if applicable)

  • [x ] The content of this PR was partly or fully generated using AI

Summary

This PR improves the documentation for OpenID Connect integrations by documenting a few configuration requirements that may not be immediately obvious during the initial setup.

Changes

  • Added documentation for the callback URL used by user_oidc:

    https://<nextcloud-domain>/apps/user_oidc/code
    
  • Added notes about the allow_local_remote_servers configuration option, which may be required when connecting Nextcloud to an external Identity Provider.

  • Added notes regarding trusted_domains, as some deployments require the Identity Provider domain to be trusted in order to avoid connectivity or authentication issues.

Motivation

While testing integrations with external OpenID Connect providers, I found that these requirements are easy to overlook and can lead to authentication failures even when the provider configuration appears correct.

Documenting these details should help administrators complete the setup process more smoothly and reduce troubleshooting time.

AI Disclosure

The documentation text included in this PR was partially assisted by AI for wording and formatting purposes. All technical findings, validation, testing, and documentation content were reviewed and verified before submission.

Signed-off-by: Elvis Yerel Roman <yerel9212@yahoo.es>
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