[camel] branch main updated: CAMEL-19412: doc how to setting kerby file at camel-kafka (#10373)

[da...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git


The following commit(s) were added to refs/heads/main by this push:
     new 3b363213f8f CAMEL-19412: doc how to setting kerby file at camel-kafka (#10373)
3b363213f8f is described below

commit 3b363213f8fd99d47d6cecf3701ca94b2914e194
Author: Gilvan Filho <gi...@gmail.com>
AuthorDate: Wed Jun 14 02:05:11 2023 -0300

    CAMEL-19412: doc how to setting kerby file at camel-kafka (#10373)
---
 .../camel-kafka/src/main/docs/kafka-component.adoc | 28 ++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/components/camel-kafka/src/main/docs/kafka-component.adoc b/components/camel-kafka/src/main/docs/kafka-component.adoc
index 72df68e2531..7b60c6d772b 100644
--- a/components/camel-kafka/src/main/docs/kafka-component.adoc
+++ b/components/camel-kafka/src/main/docs/kafka-component.adoc
@@ -440,4 +440,32 @@ At the end of exchange routing, the kafka producer would commit the transaction
 
 It would work with JTA `camel-jta` by using `transacted()` and if it involves some resources (SQL or JMS) which supports XA, then they would work in tandem, where they both will either commit or rollback at the end of the exchange routing. In some cases, if the JTA transaction manager fails to commit (during the 2PC processing), but kafka transaction has been committed before and there is no chance to rollback the changes since the kafka transaction does not support JTA/XA spec. There is [...]
 
+== Setting Kerberos config file
+
+Since kafka clients do not expose a way to configure the `krb5.conf` file directly through their API, you can, if necessary, do this using the JVM system properties.
+
+Through command line:
+[source,bash]
+----
+java -jar myroute.jar -Djava.security.krb5.conf=/path/to/krb5.conf
+----
+
+Through java code:
+[source,java]
+----
+public class MyRoute extends RouteBuilder {
+    static {
+        System.setProperty("java.security.krb5.conf", "/path/to/krb5.conf");
+    }
+
+    // your route
+
+}
+----
+
+[WARNING]
+====
+Keep in mind that once using system properties that config will be applied to whole JVM so all routes will be affected by this.
+====
+
 include::spring-boot:partial$starter.adoc[]