Skip to content

docs: add proxy-url property to OIDC configuration reference#3273

Open
cvidaillac wants to merge 1 commit into2023.2from
doc/add-oidc-proxy-url-property
Open

docs: add proxy-url property to OIDC configuration reference#3273
cvidaillac wants to merge 1 commit into2023.2from
doc/add-oidc-proxy-url-property

Conversation

@cvidaillac
Copy link
Copy Markdown
Contributor

Add documentation for the proxy-url property in keycloak-oidc.json, which configures an HTTP proxy for outbound connections to the OIDC identity provider.

This property is required in hardened network environments where the Bonita server cannot reach the OIDC provider directly. Standard JVM proxy properties (-Dhttp.proxyHost, -Dhttps.proxyHost) set via CATALINA_OPTS do not apply, as the OIDC adapter manages its own HTTP client.

Applies to versions: 2023.2, 2024.1, 2024.2, 2024.3, 2025.1, 2025.2

Ref: Customer feedback from support case #392035

Add documentation for the proxy-url property in keycloak-oidc.json, which configures an HTTP proxy for outbound connections to the OIDC identity provider.

This property is required in hardened network environments where the Bonita server cannot reach the OIDC provider directly. Standard JVM proxy properties (-Dhttp.proxyHost, -Dhttps.proxyHost) set via CATALINA_OPTS do not apply, as the OIDC adapter manages its own HTTP client.

Applies to versions: 2023.2, 2024.1, 2024.2, 2024.3, 2025.1, 2025.2

Ref: Customer feedback from support case #392035
@cvidaillac cvidaillac requested a review from ugaston March 24, 2026 13:53
@github-actions
Copy link
Copy Markdown
Contributor

📝 Contribution Summary

To merge this Pull Request, you need to check your updates with the following URL.

🔗 Updated pages

Note

The following pages were updated, please ensure that the display is correct:

@bonita-ci
Copy link
Copy Markdown
Contributor

bonita-ci commented Mar 24, 2026

🎊 PR Preview 74e1b69 has been successfully built and deployed to https://bonitasoft-bonita-doc-deploy-pr-3273.surge.sh

🕐 Build time: 0.011s

🤖 By surge-preview

Copy link
Copy Markdown
Contributor

@ugaston ugaston left a comment

Choose a reason for hiding this comment

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

Looks good to me.

Good catch.

Copy link
Copy Markdown
Contributor

@abirembaut abirembaut left a comment

Choose a reason for hiding this comment

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

Good catch !
The contents looks good to me but the Note appears as a code snippet. it would be better to display it as text rather than code:

Image

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.

4 participants