logstash-integration-kafka 11.6.0-java → 11.6.1-java

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d342010bbdc6c64b7380374583eb1d33648c5cd9e8b948e6d40c9c62c120963
-  data.tar.gz: 3bcf9b167d4cb7cc6d2857d6f81dce26bf09120fed71a2a75d7a54137f6d4a0a
+  metadata.gz: 5dd14bd1f2219bc6c12f2e880648a3f5101a2735a0a6b5b223fd9c38b5979a6a
+  data.tar.gz: 80902b49827a7127b8b7b4e4e7266738624093cfed80d59fd4b840402df198c1
 SHA512:
-  metadata.gz: 1d0097a7d05bbc52065e1f32f6fc8f600052f6eeb75a782bfd270763d73df8150fa74fdadb705bc1eb6e448ed725420642cb6aaeb016bfae058718ec3b8fe0ea
-  data.tar.gz: 99487e99f6fbfdb52f2b103a2f9fa9504a67253f9591ef3650ccbbcc7eac5cd5ca5170c841e692b17ac9b02d17c356519d6e4a3b7caf3e1a24825e65e3b9aee5
+  metadata.gz: c9e51ace320c2c5505f9cce929e5b483e0d9d40193f4a629e337ddec7427fd9a1906b9cd9b4cdbf6a072a1add7ef85b7e8aa00035b1f983317559d3c832ce852
+  data.tar.gz: fd49cf285a490cc3b94371dadbca0301d7efea5e34348d908d5f84d4213a6ad77d4d4d0e96b7556518d60f71165af7054ce085eca4bf9c46be2bc95853c17e1c

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 11.6.1
+  - Expose the SASL client callback class setting to the Logstash configuration [#177](https://github.com/logstash-plugins/logstash-integration-kafka/pull/177)
+  - Adds a mechanism to load AWS IAM authentication as SASL client libraries at startup [#178](https://github.com/logstash-plugins/logstash-integration-kafka/pull/178)
+
 ## 11.6.0
   - Support additional `oauth` and `sasl` configuration options for configuring kafka client [#189](https://github.com/logstash-plugins/logstash-integration-kafka/pull/189)
 

data/docs/input-kafka.asciidoc

@@ -65,6 +65,23 @@ For more information see https://kafka.apache.org/{kafka_client_doc}/documentati
 
 Kafka consumer configuration: https://kafka.apache.org/{kafka_client_doc}/documentation.html#consumerconfigs
 
+[id="plugins-{type}s-{plugin}-aws_msk_iam_auth"]
+==== AWS MSK IAM authentication
+If you use AWS MSK, the AWS MSK IAM access control enables you to handle both authentication and authorization for your MSK cluster with AWS IAM.
+For more information on this AWS MSK feature see the https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html[AWS documentation].
+
+To use this Kafka input with AWS MSK IAM authentication, download the uber jar which contains the client library for
+this specific cloud vendor and all the transitive dependencies from this https://github.com/elastic/logstash-kafka-iams-packages/releases[repository].
+Configure the following setting:
+```
+security_protocol => "SASL_SSL"
+sasl_mechanism => "AWS_MSK_IAM"
+sasl_iam_jar_paths => ["/path/to/aws_iam_uber.jar"]
+sasl_jaas_config => "software.amazon.msk.auth.iam.IAMLoginModule required;"
+sasl_client_callback_handler_class => "software.amazon.msk.auth.iam.IAMClientCallbackHandler"
+```
+For more IAM authentication configurations, see the https://github.com/aws/aws-msk-iam-auth[AWS MSK IAM authentication library documentation].
+
 ==== Metadata fields
 
 The following metadata from Kafka broker are added under the `[@metadata]` field:
@@ -133,6 +150,7 @@ See the https://kafka.apache.org/{kafka_client_doc}/documentation for more detai
 | <<plugins-{type}s-{plugin}-sasl_client_callback_handler_class>> |<<string,string>>|No
 | <<plugins-{type}s-{plugin}-sasl_oauthbearer_token_endpoint_url>> |<<string,string>>|No
 | <<plugins-{type}s-{plugin}-sasl_oauthbearer_scope_claim_name>> |<<string,string>>|No
+| <<plugins-{type}s-{plugin}-sasl_iam_jar_paths>> |<<array,array>>|No
 | <<plugins-{type}s-{plugin}-sasl_login_callback_handler_class>> |<<string,string>>|No
 | <<plugins-{type}s-{plugin}-sasl_login_connect_timeout_ms>> |<<number,number>>|No
 | <<plugins-{type}s-{plugin}-sasl_login_read_timeout_ms>> |<<number,number>>|No
@@ -584,6 +602,14 @@ The URL for the OAuth 2.0 issuer token endpoint.
 
 (optional) The override name of the scope claim.
 
+[id="plugins-{type}s-{plugin}-sasl_iam_jar_paths"]
+===== `sasl_iam_jar_paths`
+* Value type is <<arrays,array>>
+* There is no default value for this setting.
+
+Contains the list of paths to jar libraries that contains cloud providers MSK IAM's clients.
+There is one jar per provider and can be retrieved as described in <<"plugins-{type}s-{plugin}-aws_msk_iam_auth">>.
+
 [id="plugins-{type}s-{plugin}-sasl_login_callback_handler_class"]
 ===== `sasl_login_callback_handler_class`
   * Value type is <<string,string>>
@@ -654,6 +680,7 @@ This can be defined either in Kafka's JAAS config or in Kafka's config.
 
 http://kafka.apache.org/documentation.html#security_sasl[SASL mechanism] used for client connections. 
 This may be any mechanism for which a security provider is available.
+For AWS MSK IAM authentication use `AWS_MSK_IAM`.
 GSSAPI is the default mechanism.
 
 [id="plugins-{type}s-{plugin}-schema_registry_key"]

data/docs/output-kafka.asciidoc

@@ -66,6 +66,23 @@ https://kafka.apache.org/{kafka_client_doc}/documentation.html#producerconfigs
 
 NOTE:  This plugin does not support using a proxy when communicating to the Kafka broker.
 
+[id="plugins-{type}s-{plugin}-aws_msk_iam_auth"]
+==== AWS MSK IAM authentication
+If you use AWS MSK, the AWS MSK IAM access control enables you to handle both authentication and authorization for your MSK cluster with AWS IAM.
+For more information on this AWS MSK feature see the https://docs.aws.amazon.com/msk/latest/developerguide/iam-access-control.html[AWS documentation].
+
+To use this Kafka input with AWS MSK IAM authentication, download the uber jar which contains the client library for
+this specific cloud vendor and all the transitive dependencies from this https://github.com/elastic/logstash-kafka-iams-packages/releases[repository].
+Configure the following setting:
+```
+security_protocol => "SASL_SSL"
+sasl_mechanism => "AWS_MSK_IAM"
+sasl_iam_jar_paths => ["/path/to/aws_iam_uber.jar"]
+sasl_jaas_config => "software.amazon.msk.auth.iam.IAMLoginModule required;"
+sasl_client_callback_handler_class => "software.amazon.msk.auth.iam.IAMClientCallbackHandler"
+```
+For more IAM authentication configurations, see the https://github.com/aws/aws-msk-iam-auth[AWS MSK IAM authentication library documentation].
+
 [id="plugins-{type}s-{plugin}-options"]
 ==== Kafka Output Configuration Options
 
@@ -104,6 +121,7 @@ See the https://kafka.apache.org/{kafka_client_doc}/documentation for more detai
 | <<plugins-{type}s-{plugin}-sasl_client_callback_handler_class>> |<<string,string>>|No
 | <<plugins-{type}s-{plugin}-sasl_oauthbearer_token_endpoint_url>> |<<string,string>>|No
 | <<plugins-{type}s-{plugin}-sasl_oauthbearer_scope_claim_name>> |<<string,string>>|No
+| <<plugins-{type}s-{plugin}-sasl_iam_jar_paths>> |<<array,array>>|No
 | <<plugins-{type}s-{plugin}-sasl_login_callback_handler_class>> |<<string,string>>|No
 | <<plugins-{type}s-{plugin}-sasl_login_connect_timeout_ms>> |<<number,number>>|No
 | <<plugins-{type}s-{plugin}-sasl_login_read_timeout_ms>> |<<number,number>>|No
@@ -420,6 +438,14 @@ The URL for the OAuth 2.0 issuer token endpoint.
 
 (optional) The override name of the scope claim.
 
+[id="plugins-{type}s-{plugin}-sasl_iam_jar_paths"]
+===== `sasl_iam_jar_paths`
+* Value type is <<arrays,array>>
+* There is no default value for this setting.
+
+Contains the list of paths to jar libraries that contains cloud providers MSK IAM's clients.
+There is one jar per provider and can be retrieved as described in <<"plugins-{type}s-{plugin}-aws_msk_iam_auth">>.
+
 [id="plugins-{type}s-{plugin}-sasl_login_callback_handler_class"]
 ===== `sasl_login_callback_handler_class`
   * Value type is <<string,string>>
@@ -490,6 +516,7 @@ This can be defined either in Kafka's JAAS config or in Kafka's config.
 
 http://kafka.apache.org/documentation.html#security_sasl[SASL mechanism] used for client connections. 
 This may be any mechanism for which a security provider is available.
+For AWS MSK IAM authentication use `AWS_MSK_IAM`.
 GSSAPI is the default mechanism.
 
 [id="plugins-{type}s-{plugin}-security_protocol"]

data/lib/logstash/inputs/kafka.rb

@@ -216,6 +216,8 @@ class LogStash::Inputs::Kafka < LogStash::Inputs::Base
   config :sasl_oauthbearer_scope_claim_name, :validate => :string, :default => 'scope' # Kafka default
   # SASL login callback handler class
   config :sasl_login_callback_handler_class, :validate => :string
+  # Path to the jar containing client and all dependencies for SASL IAM authentication of specific cloud vendor
+  config :sasl_iam_jar_paths, :validate => :array
   # (optional) The duration, in milliseconds, for HTTPS connect timeout
   config :sasl_login_connect_timeout_ms, :validate => :number
   # (optional) The duration, in milliseconds, for HTTPS read timeout.
@@ -224,7 +226,7 @@ class LogStash::Inputs::Kafka < LogStash::Inputs::Base
   config :sasl_login_retry_backoff_ms, :validate => :number, :default => 100 # Kafka default
   # (optional) The maximum duration, in milliseconds, for HTTPS call attempts.
   config :sasl_login_retry_backoff_max_ms, :validate => :number, :default => 10000 # Kafka default
-  # http://kafka.apache.org/documentation.html#security_sasl[SASL mechanism] used for client connections. 
+  # http://kafka.apache.org/documentation.html#security_sasl[SASL mechanism] used for client connections.
   # This may be any mechanism for which a security provider is available.
   # GSSAPI is the default mechanism.
   config :sasl_mechanism, :validate => :string, :default => "GSSAPI"

data/lib/logstash/outputs/kafka.rb

@@ -149,6 +149,8 @@ class LogStash::Outputs::Kafka < LogStash::Outputs::Base
   config :security_protocol, :validate => ["PLAINTEXT", "SSL", "SASL_PLAINTEXT", "SASL_SSL"], :default => "PLAINTEXT"
   # SASL client callback handler class
   config :sasl_client_callback_handler_class, :validate => :string
+  # Path to the jar containing client and all dependencies for SASL IAM authentication of specific cloud vendor
+  config :sasl_iam_jar_paths, :validate => :array
   # The URL for the OAuth 2.0 issuer token endpoint.
   config :sasl_oauthbearer_token_endpoint_url, :validate => :string
   # (optional) The override name of the scope claim.

data/lib/logstash/plugin_mixins/kafka/common.rb

@@ -49,6 +49,7 @@ module LogStash module PluginMixins module Kafka
       props.put("sasl.login.read.timeout.ms", sasl_login_read_timeout_ms.to_s) unless sasl_login_read_timeout_ms.nil?
       props.put("sasl.login.retry.backoff.ms", sasl_login_retry_backoff_ms.to_s) unless sasl_login_retry_backoff_ms.nil?
       props.put("sasl.login.retry.backoff.max.ms", sasl_login_retry_backoff_max_ms.to_s) unless sasl_login_retry_backoff_max_ms.nil?
+      sasl_iam_jar_paths&.each {|jar_path| require jar_path }
     end
 
     def reassign_dns_lookup

data/logstash-integration-kafka.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name            = 'logstash-integration-kafka'
-  s.version         = '11.6.0'
+  s.version         = '11.6.1'
   s.licenses        = ['Apache-2.0']
   s.summary         = "Integration with Kafka - input and output plugins"
   s.description     = "This gem is a Logstash plugin required to be installed on top of the Logstash core pipeline "+

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: logstash-integration-kafka
 version: !ruby/object:Gem::Version
-  version: 11.6.0
+  version: 11.6.1
 platform: java
 authors:
 - Elastic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-07 00:00:00.000000000 Z
+date: 2025-05-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement