Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add null default value for advertised protocol and notice that the old REST configuration will be deprecated.

...

ParameterDefault valueNote
listenersnullList of REST listeners in the format protocol://host:port,protocol2://host2:port2 where the protocol is one of HTTP and HTTPS.
rest.advertised.security.protocol null

Configures the protocol used for communication between workers. Valid values are either HTTP or HTTPS.

When the listeners configuration is not defined or when it contains HTTP listener, the default value for this field will be HTTP. When the listeners option is configured and contains only HTTPS listener, the default value will be HTTPS.

ssl.client.authnoneValid values are none, requested and required. It will controls whether:
  • the connecting client is required to do SSL/TLS client authentication (required
  • it can decide to skip the SSL/TLS client authentication (requested
  • the SSL/TLS authentication will be completely disabled (none)

This is the only authentication option suggested as part of this KIP.

listeners.https.ssl.* The listeners.https. prefix can be used with any SSL configuration option mentioned below to override the default SSL configuration which is shared with the connections to Kafka broker.

...

ParameterDefault valueNote
rest.host.namenullWhen listeners option is defined, this field will be ignored.
rest.port8083When listeners option is defined, this field will be ignored.

The rest.host.name and rest.port will be marked as deprecated. The listeners field would be the one preferred for the long term future.

 

Following existing options will be reused by this KIP without any changes:

...