External OIDC setup docs is confusing for customers
zalanszak opened this issue · 2 comments
On this page: https://docs.camunda.io/docs/self-managed/setup/guides/connect-to-an-oidc-provider/
At the configuration section there are environment variables and Helm values offered. However, it is not explicitly specified that they are in a XOR relation - i.e. the customer should not use both at the same time, but either the helm values or the environment variables. This confusion lead to incorrect setups in customer environments, e.g.: https://jira.camunda.com/browse/SUPPORT-24589
Please append an additional note that only one of these options should be used: either helm values or env variables, but not both!
@conceptualshark can you please review and PR?
Left an open question with distribution on how to best handle this, as it seems related to either updating the Connectors docs for a better experience, or may need additional info on how/when env vars do not override Helm values. I think the ultimate impact may need to be in the Connectors config guide vs the OIDC docs.