Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions docs/structured-streaming-kafka-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -1004,6 +1004,14 @@ Delegation tokens can be obtained from multiple clusters and <code>${cluster}</c
</td>
<td>3.0.0</td>
</tr>
<tr>
<td><code>spark.kafka.clusters.${cluster}.ssl.truststore.type</code></td>
<td>None</td>
<td>
The file format of the trust store file. For further details please see Kafka documentation. Only used to obtain delegation token.
</td>
<td>3.2.0</td>
</tr>
<tr>
<td><code>spark.kafka.clusters.${cluster}.ssl.truststore.location</code></td>
<td>None</td>
Expand All @@ -1021,6 +1029,15 @@ Delegation tokens can be obtained from multiple clusters and <code>${cluster}</c
</td>
<td>3.0.0</td>
</tr>
<tr>
<td><code>spark.kafka.clusters.${cluster}.ssl.keystore.type</code></td>
<td>None</td>
<td>
The file format of the key store file. This is optional for client.
For further details please see Kafka documentation. Only used to obtain delegation token.
</td>
<td>3.2.0</td>
</tr>
<tr>
<td><code>spark.kafka.clusters.${cluster}.ssl.keystore.location</code></td>
<td>None</td>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,10 @@ private[spark] case class KafkaTokenClusterConf(
targetServersRegex: String,
securityProtocol: String,
kerberosServiceName: String,
trustStoreType: Option[String],
trustStoreLocation: Option[String],
trustStorePassword: Option[String],
keyStoreType: Option[String],
keyStoreLocation: Option[String],
keyStorePassword: Option[String],
keyPassword: Option[String],
Expand All @@ -44,8 +46,10 @@ private[spark] case class KafkaTokenClusterConf(
s"targetServersRegex=$targetServersRegex, " +
s"securityProtocol=$securityProtocol, " +
s"kerberosServiceName=$kerberosServiceName, " +
s"trustStoreType=$trustStoreType, " +
s"trustStoreLocation=$trustStoreLocation, " +
s"trustStorePassword=${trustStorePassword.map(_ => REDACTION_REPLACEMENT_TEXT)}, " +
s"keyStoreType=$keyStoreType, " +
s"keyStoreLocation=$keyStoreLocation, " +
s"keyStorePassword=${keyStorePassword.map(_ => REDACTION_REPLACEMENT_TEXT)}, " +
s"keyPassword=${keyPassword.map(_ => REDACTION_REPLACEMENT_TEXT)}, " +
Expand Down Expand Up @@ -77,8 +81,10 @@ private [kafka010] object KafkaTokenSparkConf extends Logging {
DEFAULT_SECURITY_PROTOCOL_CONFIG),
sparkClusterConf.getOrElse(SaslConfigs.SASL_KERBEROS_SERVICE_NAME,
KafkaTokenSparkConf.DEFAULT_SASL_KERBEROS_SERVICE_NAME),
sparkClusterConf.get(SslConfigs.SSL_TRUSTSTORE_TYPE_CONFIG),
sparkClusterConf.get(SslConfigs.SSL_TRUSTSTORE_LOCATION_CONFIG),
sparkClusterConf.get(SslConfigs.SSL_TRUSTSTORE_PASSWORD_CONFIG),
sparkClusterConf.get(SslConfigs.SSL_KEYSTORE_TYPE_CONFIG),
sparkClusterConf.get(SslConfigs.SSL_KEYSTORE_LOCATION_CONFIG),
sparkClusterConf.get(SslConfigs.SSL_KEYSTORE_PASSWORD_CONFIG),
sparkClusterConf.get(SslConfigs.SSL_KEY_PASSWORD_CONFIG),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -162,6 +162,9 @@ private[spark] object KafkaTokenUtil extends Logging {
private def setTrustStoreProperties(
clusterConf: KafkaTokenClusterConf,
properties: ju.Properties): Unit = {
clusterConf.trustStoreType.foreach { truststoreType =>
properties.put(SslConfigs.SSL_TRUSTSTORE_TYPE_CONFIG, truststoreType)
}
clusterConf.trustStoreLocation.foreach { truststoreLocation =>
properties.put(SslConfigs.SSL_TRUSTSTORE_LOCATION_CONFIG, truststoreLocation)
}
Expand All @@ -173,6 +176,9 @@ private[spark] object KafkaTokenUtil extends Logging {
private def setKeyStoreProperties(
clusterConf: KafkaTokenClusterConf,
properties: ju.Properties): Unit = {
clusterConf.keyStoreType.foreach { keystoreType =>
properties.put(SslConfigs.SSL_KEYSTORE_TYPE_CONFIG, keystoreType)
}
clusterConf.keyStoreLocation.foreach { keystoreLocation =>
properties.put(SslConfigs.SSL_KEYSTORE_LOCATION_CONFIG, keystoreLocation)
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,8 +51,10 @@ trait KafkaDelegationTokenTest extends BeforeAndAfterEach {
protected val bootStrapServers = "127.0.0.1:0"
protected val matchingTargetServersRegex = "127.0.0.*:0"
protected val nonMatchingTargetServersRegex = "127.0.intentionally_non_matching.*:0"
protected val trustStoreType = "customTrustStoreType"
protected val trustStoreLocation = "/path/to/trustStore"
protected val trustStorePassword = "trustStoreSecret"
protected val keyStoreType = "customKeyStoreType"
protected val keyStoreLocation = "/path/to/keyStore"
protected val keyStorePassword = "keyStoreSecret"
protected val keyPassword = "keySecret"
Expand Down Expand Up @@ -124,8 +126,10 @@ trait KafkaDelegationTokenTest extends BeforeAndAfterEach {
KafkaTokenSparkConf.DEFAULT_TARGET_SERVERS_REGEX,
securityProtocol,
KafkaTokenSparkConf.DEFAULT_SASL_KERBEROS_SERVICE_NAME,
Some(trustStoreType),
Some(trustStoreLocation),
Some(trustStorePassword),
Some(keyStoreType),
Some(keyStoreLocation),
Some(keyStorePassword),
Some(keyPassword),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,8 +29,10 @@ class KafkaTokenSparkConfSuite extends SparkFunSuite with BeforeAndAfterEach {
private val targetServersRegex = "127.0.0.*:0"
private val securityProtocol = SSL.name
private val kerberosServiceName = "kafka1"
private val trustStoreType = "customTrustStoreType"
private val trustStoreLocation = "/path/to/trustStore"
private val trustStorePassword = "trustStoreSecret"
private val keyStoreType = "customKeyStoreType"
private val keyStoreLocation = "/path/to/keyStore"
private val keyStorePassword = "keyStoreSecret"
private val keyPassword = "keySecret"
Expand Down Expand Up @@ -60,8 +62,10 @@ class KafkaTokenSparkConfSuite extends SparkFunSuite with BeforeAndAfterEach {
assert(clusterConfig.securityProtocol === SASL_SSL.name)
assert(clusterConfig.kerberosServiceName ===
KafkaTokenSparkConf.DEFAULT_SASL_KERBEROS_SERVICE_NAME)
assert(clusterConfig.trustStoreType === None)
assert(clusterConfig.trustStoreLocation === None)
assert(clusterConfig.trustStorePassword === None)
assert(clusterConfig.keyStoreType === None)
assert(clusterConfig.keyStoreLocation === None)
assert(clusterConfig.keyStorePassword === None)
assert(clusterConfig.keyPassword === None)
Expand All @@ -75,8 +79,10 @@ class KafkaTokenSparkConfSuite extends SparkFunSuite with BeforeAndAfterEach {
sparkConf.set(s"spark.kafka.clusters.$identifier1.security.protocol", securityProtocol)
sparkConf.set(s"spark.kafka.clusters.$identifier1.sasl.kerberos.service.name",
kerberosServiceName)
sparkConf.set(s"spark.kafka.clusters.$identifier1.ssl.truststore.type", trustStoreType)
sparkConf.set(s"spark.kafka.clusters.$identifier1.ssl.truststore.location", trustStoreLocation)
sparkConf.set(s"spark.kafka.clusters.$identifier1.ssl.truststore.password", trustStorePassword)
sparkConf.set(s"spark.kafka.clusters.$identifier1.ssl.keystore.type", keyStoreType)
sparkConf.set(s"spark.kafka.clusters.$identifier1.ssl.keystore.location", keyStoreLocation)
sparkConf.set(s"spark.kafka.clusters.$identifier1.ssl.keystore.password", keyStorePassword)
sparkConf.set(s"spark.kafka.clusters.$identifier1.ssl.key.password", keyPassword)
Expand All @@ -88,8 +94,10 @@ class KafkaTokenSparkConfSuite extends SparkFunSuite with BeforeAndAfterEach {
assert(clusterConfig.targetServersRegex === targetServersRegex)
assert(clusterConfig.securityProtocol === securityProtocol)
assert(clusterConfig.kerberosServiceName === kerberosServiceName)
assert(clusterConfig.trustStoreType === Some(trustStoreType))
assert(clusterConfig.trustStoreLocation === Some(trustStoreLocation))
assert(clusterConfig.trustStorePassword === Some(trustStorePassword))
assert(clusterConfig.keyStoreType === Some(keyStoreType))
assert(clusterConfig.keyStoreLocation === Some(keyStoreLocation))
assert(clusterConfig.keyStorePassword === Some(keyStorePassword))
assert(clusterConfig.keyPassword === Some(keyPassword))
Expand Down Expand Up @@ -127,8 +135,10 @@ class KafkaTokenSparkConfSuite extends SparkFunSuite with BeforeAndAfterEach {
assert(clusterConfig.securityProtocol === SASL_SSL.name)
assert(clusterConfig.kerberosServiceName ===
KafkaTokenSparkConf.DEFAULT_SASL_KERBEROS_SERVICE_NAME)
assert(clusterConfig.trustStoreType === None)
assert(clusterConfig.trustStoreLocation === None)
assert(clusterConfig.trustStorePassword === None)
assert(clusterConfig.keyStoreType === None)
assert(clusterConfig.keyStoreLocation === None)
assert(clusterConfig.keyStorePassword === None)
assert(clusterConfig.keyPassword === None)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -64,8 +64,10 @@ class KafkaTokenUtilSuite extends SparkFunSuite with KafkaDelegationTokenTest {
=== bootStrapServers)
assert(adminClientProperties.get(CommonClientConfigs.SECURITY_PROTOCOL_CONFIG)
=== SASL_PLAINTEXT.name)
assert(!adminClientProperties.containsKey(SslConfigs.SSL_TRUSTSTORE_TYPE_CONFIG))
assert(!adminClientProperties.containsKey(SslConfigs.SSL_TRUSTSTORE_LOCATION_CONFIG))
assert(!adminClientProperties.containsKey(SslConfigs.SSL_TRUSTSTORE_PASSWORD_CONFIG))
assert(!adminClientProperties.containsKey(SslConfigs.SSL_KEYSTORE_TYPE_CONFIG))
assert(!adminClientProperties.containsKey(SslConfigs.SSL_KEYSTORE_LOCATION_CONFIG))
assert(!adminClientProperties.containsKey(SslConfigs.SSL_KEYSTORE_PASSWORD_CONFIG))
assert(!adminClientProperties.containsKey(SslConfigs.SSL_KEY_PASSWORD_CONFIG))
Expand All @@ -80,10 +82,12 @@ class KafkaTokenUtilSuite extends SparkFunSuite with KafkaDelegationTokenTest {
=== bootStrapServers)
assert(adminClientProperties.get(CommonClientConfigs.SECURITY_PROTOCOL_CONFIG)
=== SASL_SSL.name)
assert(adminClientProperties.get(SslConfigs.SSL_TRUSTSTORE_TYPE_CONFIG) === trustStoreType)
assert(adminClientProperties.get(SslConfigs.SSL_TRUSTSTORE_LOCATION_CONFIG)
=== trustStoreLocation)
assert(adminClientProperties.get(SslConfigs.SSL_TRUSTSTORE_PASSWORD_CONFIG)
=== trustStorePassword)
assert(!adminClientProperties.containsKey(SslConfigs.SSL_KEYSTORE_TYPE_CONFIG))
assert(!adminClientProperties.containsKey(SslConfigs.SSL_KEYSTORE_LOCATION_CONFIG))
assert(!adminClientProperties.containsKey(SslConfigs.SSL_KEYSTORE_PASSWORD_CONFIG))
assert(!adminClientProperties.containsKey(SslConfigs.SSL_KEY_PASSWORD_CONFIG))
Expand All @@ -99,10 +103,12 @@ class KafkaTokenUtilSuite extends SparkFunSuite with KafkaDelegationTokenTest {
=== bootStrapServers)
assert(adminClientProperties.get(CommonClientConfigs.SECURITY_PROTOCOL_CONFIG)
=== SSL.name)
assert(adminClientProperties.get(SslConfigs.SSL_TRUSTSTORE_TYPE_CONFIG) === trustStoreType)
assert(adminClientProperties.get(SslConfigs.SSL_TRUSTSTORE_LOCATION_CONFIG)
=== trustStoreLocation)
assert(adminClientProperties.get(SslConfigs.SSL_TRUSTSTORE_PASSWORD_CONFIG)
=== trustStorePassword)
assert(adminClientProperties.get(SslConfigs.SSL_KEYSTORE_TYPE_CONFIG) === keyStoreType)
assert(adminClientProperties.get(SslConfigs.SSL_KEYSTORE_LOCATION_CONFIG) === keyStoreLocation)
assert(adminClientProperties.get(SslConfigs.SSL_KEYSTORE_PASSWORD_CONFIG) === keyStorePassword)
assert(adminClientProperties.get(SslConfigs.SSL_KEY_PASSWORD_CONFIG) === keyPassword)
Expand Down