org.apache.kafka.connect.connector.policy

Interface ConnectorClientConfigOverridePolicy

All Superinterfaces:

AutoCloseable, org.apache.kafka.common.Configurable

public interface ConnectorClientConfigOverridePolicy
extends org.apache.kafka.common.Configurable, AutoCloseable

An interface for enforcing a policy on overriding of Kafka client configs via the connector configs.

Common use cases are ability to provide principal per connector, sasl.jaas.config and/or enforcing that the producer/consumer configurations for optimizations are within acceptable ranges.

Kafka Connect discovers implementations of this interface using the Java ServiceLoader mechanism. To support this, implementations of this interface should also contain a service provider configuration file in META-INF/services/org.apache.kafka.connect.connector.policy.ConnectorClientConfigOverridePolicy.

Method Summary

Modifier and Type	Method and Description
List<org.apache.kafka.common.config.ConfigValue>	validate(ConnectorClientConfigRequest connectorClientConfigRequest) Workers will invoke this before configuring per-connector Kafka admin, producer, and consumer client instances to validate if all the overridden client configurations are allowed per the policy implementation.

Methods inherited from interface org.apache.kafka.common.Configurable

configure

Methods inherited from interface java.lang.AutoCloseable

close

Method Detail

validate

List<org.apache.kafka.common.config.ConfigValue> validate(ConnectorClientConfigRequest connectorClientConfigRequest)

Workers will invoke this before configuring per-connector Kafka admin, producer, and consumer client instances to validate if all the overridden client configurations are allowed per the policy implementation. This would also be invoked during the validation of connector configs via the REST API.

If there are any policy violations, the connector will not be started.

Parameters:

connectorClientConfigRequest - an instance of ConnectorClientConfigRequest that provides the configs to be overridden and its context; never null

Returns:

list of ConfigValue instances that describe each client configuration in the request and includes an error if the configuration is not allowed by the policy; never null