Skip to content

procedures: Update OpenShift Keycloak OIDC installation to reflect automatic detection#3114

Closed
tolusha wants to merge 1 commit into
eclipse-che:mainfrom
tolusha:auto-detect-openshift-oidc-che-operator-2127
Closed

procedures: Update OpenShift Keycloak OIDC installation to reflect automatic detection#3114
tolusha wants to merge 1 commit into
eclipse-che:mainfrom
tolusha:auto-detect-openshift-oidc-che-operator-2127

Conversation

@tolusha
Copy link
Copy Markdown
Contributor

@tolusha tolusha commented May 29, 2026

What does this pull request change?

This PR updates the procedure for installing Eclipse Che on OpenShift with Keycloak as an external OIDC provider to reflect the automatic detection capabilities added in eclipse-che/che-operator#2127.

The procedure has been simplified by removing manual configuration steps that are now automatically detected from the OpenShift cluster authentication configuration:

  • Removed manual environment variable setup (KEYCLOAK_URL, OPENSHIFT_REALM)
  • Removed manual certificate ConfigMap creation (now auto-detected from authentication.config/cluster)
  • Removed manual claim mapping configuration (CHE_OIDC_GROUPS__CLAIM, CHE_OIDC_GROUPS__PREFIX, CHE_OIDC_USERNAME__CLAIM, CHE_OIDC_USERNAME__PREFIX)
  • Simplified CheCluster patch to only include required OAuth client configuration

The operator now automatically reads authentication configuration from the OpenShift cluster's authentication.config/cluster resource, eliminating the need for manual configuration of issuer URL, CA certificates, and claim mappings.

What issues does this pull request fix or reference?

Specify the version of the product this pull request applies to

next

Pull Request checklist

The author and the reviewers validate the content of this pull request with the following checklist, in addition to the automated tests.

  • Any procedure:
    • Successfully tested.
  • Any page or link rename:
    • The page contains a redirection for the previous URL.
    • Propagate the URL change in:
  • Builds on Eclipse Che hosted by Red Hat.
  • the Validate language on files added or modified step reports no vale warnings.

…tomatic detection

Update the installation procedure to reflect automatic detection and configuration
of OpenShift's external OIDC authentication added in che-operator PR eclipse-che#2127.

Changes:
- Remove manual environment variable setup (KEYCLOAK_URL, OPENSHIFT_REALM)
- Remove manual certificate ConfigMap creation (now auto-detected)
- Remove manual claim mapping configuration (CHE_OIDC_*__CLAIM/PREFIX)
- Simplify CheCluster patch to only include required OAuth client configuration
- Add note about automatic detection of identity provider settings

The operator now automatically reads authentication configuration from the
OpenShift cluster's authentication.config/cluster resource, eliminating the
need for manual configuration of issuer URL, CA certificates, and claim mappings.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown

⚡️ Deploying pull request preview...

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 29, 2026

Click here to review and test in web IDE: Contribute

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.

2 participants