From 642bd696dd1a8ab327db2415f169538c0672ea0c Mon Sep 17 00:00:00 2001 From: Chris Bono Date: Mon, 19 Feb 2024 21:56:55 -0600 Subject: [PATCH] Add link to Pulsar env var workaround There is a section in the Pulsar client authentication reference guide that warns users of the lack of relaxed binding for authentication parameter map keys. This lack of relaxed binding prevents users from setting these auth parameters directly via env var as the casing is lost in translation. The commit adds a link in this area of the reference guide to a workaround in the Spring Pulsar framework reference guide. See gh-39630 --- .../spring-boot-docs/src/docs/asciidoc/messaging/pulsar.adoc | 3 +++ 1 file changed, 3 insertions(+) diff --git a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/messaging/pulsar.adoc b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/messaging/pulsar.adoc index 4a4d435bb5f..4e0da8a8779 100644 --- a/spring-boot-project/spring-boot-docs/src/docs/asciidoc/messaging/pulsar.adoc +++ b/spring-boot-project/spring-boot-docs/src/docs/asciidoc/messaging/pulsar.adoc @@ -50,6 +50,9 @@ Spring Boot will not attempt any kind of relaxed binding for these entries. For example, if you want to configure the issuer url for the `AuthenticationOAuth2` auth plugin you must use `+spring.pulsar.client.authentication.param.issuerUrl+`. If you use other forms, such as `issuerurl` or `issuer-url`, the setting will not be applied to the plugin. + +This lack of relaxed binding also makes using environment variables for authentication parameters problematic because the case sensitivity is lost during translation. +If you use environment variables for the parameters then you will need to follow {spring-pulsar-docs}reference/pulsar.html#client-authentication-env-vars[these steps] in the Spring for Apache Pulsar reference documentation for it to work properly. ====