Parkerhiphop commented on code in PR #22907: URL: https://github.com/apache/kafka/pull/22907#discussion_r3808710077
########## clients/clients-integration-tests/src/test/java/org/apache/kafka/clients/security/SaslClientsWithInvalidCredentialsTest.java: ########## @@ -0,0 +1,335 @@ +/* + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed with + * this work for additional information regarding copyright ownership. + * The ASF licenses this file to You under the Apache License, Version 2.0 + * (the "License"); you may not use this file except in compliance with + * the License. You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ +package org.apache.kafka.clients.security; + +import org.apache.kafka.clients.CommonClientConfigs; +import org.apache.kafka.clients.admin.Admin; +import org.apache.kafka.clients.admin.NewTopic; +import org.apache.kafka.clients.admin.ScramCredentialInfo; +import org.apache.kafka.clients.admin.TopicDescription; +import org.apache.kafka.clients.admin.UserScramCredentialUpsertion; +import org.apache.kafka.clients.consumer.Consumer; +import org.apache.kafka.clients.consumer.ConsumerConfig; +import org.apache.kafka.clients.consumer.GroupProtocol; +import org.apache.kafka.clients.producer.KafkaProducer; +import org.apache.kafka.clients.producer.ProducerConfig; +import org.apache.kafka.clients.producer.ProducerRecord; +import org.apache.kafka.common.KafkaException; +import org.apache.kafka.common.TopicPartition; +import org.apache.kafka.common.config.SaslConfigs; +import org.apache.kafka.common.config.internals.BrokerSecurityConfigs; +import org.apache.kafka.common.errors.SaslAuthenticationException; +import org.apache.kafka.common.security.auth.SecurityProtocol; +import org.apache.kafka.common.security.scram.ScramLoginModule; +import org.apache.kafka.common.test.ClusterInstance; +import org.apache.kafka.common.test.api.ClusterConfigProperty; +import org.apache.kafka.common.test.api.ClusterTest; +import org.apache.kafka.common.test.api.ClusterTestDefaults; +import org.apache.kafka.common.test.api.Type; +import org.apache.kafka.coordinator.group.GroupCoordinatorConfig; +import org.apache.kafka.coordinator.transaction.TransactionLogConfig; +import org.apache.kafka.metadata.authorizer.StandardAuthorizer; +import org.apache.kafka.test.TestUtils; + +import org.junit.jupiter.api.BeforeEach; + +import java.time.Duration; +import java.util.List; +import java.util.Locale; +import java.util.Map; +import java.util.Set; +import java.util.concurrent.ExecutionException; +import java.util.concurrent.TimeUnit; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +@ClusterTestDefaults( + types = {Type.KRAFT}, + brokers = 1, + serverProperties = { + @ClusterConfigProperty(key = BrokerSecurityConfigs.SASL_ENABLED_MECHANISMS_CONFIG, value = SaslClientsWithInvalidCredentialsTest.ENABLED_MECHANISMS), + @ClusterConfigProperty(key = BrokerSecurityConfigs.SASL_MECHANISM_INTER_BROKER_PROTOCOL_CONFIG, value = "PLAIN"), + @ClusterConfigProperty(key = GroupCoordinatorConfig.OFFSETS_TOPIC_REPLICATION_FACTOR_CONFIG, value = "1"), + @ClusterConfigProperty(key = TransactionLogConfig.TRANSACTIONS_TOPIC_REPLICATION_FACTOR_CONFIG, value = "1"), + @ClusterConfigProperty(key = TransactionLogConfig.TRANSACTIONS_TOPIC_MIN_ISR_CONFIG, value = "1"), + @ClusterConfigProperty(key = StandardAuthorizer.ALLOW_EVERYONE_IF_NO_ACL_IS_FOUND_CONFIG, value = "true") + } +) +public class SaslClientsWithInvalidCredentialsTest { + public static final String SASL_MECHANISM = "SCRAM-SHA-256"; + public static final String ENABLED_MECHANISMS = "PLAIN," + SASL_MECHANISM; + + private static final String CLIENT_USER = "scram-user"; + private static final String CLIENT_PASSWORD = "scram-user-secret"; + private static final String TOPIC = "topic"; + private static final int NUM_PARTITIONS = 1; + private static final TopicPartition TP = new TopicPartition(TOPIC, 0); + + private final ClusterInstance cluster; + + public SaslClientsWithInvalidCredentialsTest(ClusterInstance cluster) { + this.cluster = cluster; + } + + @BeforeEach + public void setUp() throws Exception { + try (Admin admin = cluster.admin()) { + admin.createTopics(List.of(new NewTopic(TOPIC, NUM_PARTITIONS, (short) 1))).all().get(); + } + cluster.waitTopicCreation(TOPIC, NUM_PARTITIONS); + } + + @ClusterTest(brokerSecurityProtocol = SecurityProtocol.SASL_PLAINTEXT) + public void testIdempotentProducerWithAuthenticationFailure() throws Exception { + testProducerWithAuthenticationFailure(true); + } + + @ClusterTest(brokerSecurityProtocol = SecurityProtocol.SASL_PLAINTEXT) + public void testNonIdempotentProducerWithAuthenticationFailure() throws Exception { + testProducerWithAuthenticationFailure(false); + } + + private void testProducerWithAuthenticationFailure(boolean isIdempotenceEnabled) throws Exception { + KafkaProducer<byte[], byte[]> producer = createProducer(Map.of( + ProducerConfig.ENABLE_IDEMPOTENCE_CONFIG, Boolean.toString(isIdempotenceEnabled) + )); + + try { + KafkaProducer<byte[], byte[]> producerWithInvalidCredentials = producer; + verifyAuthenticationException(() -> sendOneRecord(producerWithInvalidCredentials, 10000)); + verifyAuthenticationException(() -> producerWithInvalidCredentials.partitionsFor(TOPIC)); + + createClientCredential(); + if (isIdempotenceEnabled) { + producer.close(); + producer = createProducer(Map.of( + ProducerConfig.ENABLE_IDEMPOTENCE_CONFIG, Boolean.toString(true) + )); + } + KafkaProducer<byte[], byte[]> producerToVerify = producer; + verifyWithRetry(() -> sendOneRecord(producerToVerify, 15000)); + } finally { + producer.close(); + } + } + + @ClusterTest(brokerSecurityProtocol = SecurityProtocol.SASL_PLAINTEXT) + public void testTransactionalProducerWithAuthenticationFailure() throws Exception { + try (KafkaProducer<byte[], byte[]> producer = createProducer(Map.of( + ProducerConfig.TRANSACTIONAL_ID_CONFIG, "txclient-1", + ProducerConfig.ENABLE_IDEMPOTENCE_CONFIG, "true" + ))) { + verifyAuthenticationException(producer::initTransactions); + + createClientCredential(); + assertThrows(KafkaException.class, producer::initTransactions); + } + } + + @ClusterTest(brokerSecurityProtocol = SecurityProtocol.SASL_PLAINTEXT) + public void testConsumerWithAuthenticationFailure() throws Exception { + for (GroupProtocol groupProtocol : cluster.supportedGroupProtocols()) { + String user = userFor(groupProtocol); + try (Consumer<byte[], byte[]> consumer = createConsumer(user, Map.of( + ConsumerConfig.GROUP_PROTOCOL_CONFIG, groupProtocol.name().toLowerCase(Locale.ROOT) + ))) { + consumer.subscribe(List.of(TOPIC)); + verifyConsumerWithAuthenticationFailure(consumer, user, true); + } + } + } + + @ClusterTest(brokerSecurityProtocol = SecurityProtocol.SASL_PLAINTEXT) + public void testManualAssignmentConsumerWithAuthenticationFailure() throws Exception { + for (GroupProtocol groupProtocol : cluster.supportedGroupProtocols()) { + String user = userFor(groupProtocol); + try (Consumer<byte[], byte[]> consumer = createConsumer(user, Map.of( + ConsumerConfig.GROUP_PROTOCOL_CONFIG, groupProtocol.name().toLowerCase(Locale.ROOT) + ))) { + consumer.assign(List.of(TP)); + verifyConsumerWithAuthenticationFailure(consumer, user, false); + } + } + } + + @ClusterTest(brokerSecurityProtocol = SecurityProtocol.SASL_PLAINTEXT) + public void testManualAssignmentConsumerWithAutoCommitDisabledWithAuthenticationFailure() throws Exception { + for (GroupProtocol groupProtocol : cluster.supportedGroupProtocols()) { + String user = userFor(groupProtocol); + try (Consumer<byte[], byte[]> consumer = createConsumer(user, Map.of( + ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG, "false", + ConsumerConfig.GROUP_PROTOCOL_CONFIG, groupProtocol.name().toLowerCase(Locale.ROOT) + ))) { + consumer.assign(List.of(TP)); + consumer.seek(TP, 0); + verifyConsumerWithAuthenticationFailure(consumer, user, false); + } + } + } + + private void verifyConsumerWithAuthenticationFailure( + Consumer<byte[], byte[]> consumer, + String user, + boolean usePollForInitialFailure + ) throws Exception { + long startMs = System.currentTimeMillis(); + if (usePollForInitialFailure) { + assertThrows(Exception.class, () -> consumer.poll(Duration.ofMillis(1000))); + } else { + assertThrows(Exception.class, () -> consumer.partitionsFor(TOPIC)); + } + long elapsedMs = System.currentTimeMillis() - startMs; + assertTrue(elapsedMs <= 5000, "Poll took too long, elapsed=" + elapsedMs); + + createScramCredential(user, CLIENT_PASSWORD); + try (KafkaProducer<byte[], byte[]> producer = createProducer(user, CLIENT_PASSWORD, Map.of())) { + verifyWithRetry(() -> sendOneRecord(producer, 15000)); + } + Set<TopicPartition> assignment = consumer.assignment(); + if (assignment.contains(TP)) { + consumer.seek(TP, 0); + } + TestUtils.waitForCondition( + () -> { + try { + return consumer.poll(Duration.ofMillis(1000)).count() >= 1; + } catch (Throwable t) { + return false; + } + }, + "Consumer.poll() did not read the expected number of records within the timeout" + ); + } + + @ClusterTest(brokerSecurityProtocol = SecurityProtocol.SASL_PLAINTEXT) + public void testKafkaAdminClientWithAuthenticationFailure() throws Exception { + try (Admin admin = createAdminClient(CLIENT_USER, CLIENT_PASSWORD)) { + verifyAuthenticationException(() -> describeTopic(admin)); + + createClientCredential(); + verifyWithRetry(() -> describeTopic(admin)); + } + } + + private void describeTopic(Admin admin) throws Exception { + try { + Map<String, TopicDescription> response = admin.describeTopics(List.of(TOPIC)).allTopicNames().get(); + assertEquals(1, response.size()); + response.forEach((topic, description) -> + assertEquals(NUM_PARTITIONS, description.partitions().size())); + } catch (ExecutionException e) { + throw (Exception) e.getCause(); + } + } + + private void createClientCredential() throws Exception { + createScramCredential(CLIENT_USER, CLIENT_PASSWORD); + } + + private void createScramCredential(String userName, String password) throws Exception { + try (Admin admin = cluster.admin()) { + admin.alterUserScramCredentials(List.of( + new UserScramCredentialUpsertion( + userName, + new ScramCredentialInfo(org.apache.kafka.clients.admin.ScramMechanism.SCRAM_SHA_256, 4096), + password + ) + )).all().get(); + } + } + + private KafkaProducer<byte[], byte[]> createProducer(Map<String, Object> configOverrides) { + return (KafkaProducer<byte[], byte[]>) cluster.<byte[], byte[]>producer(clientConfig(CLIENT_USER, CLIENT_PASSWORD, configOverrides)); + } + + private Consumer<byte[], byte[]> createConsumer(String user, Map<String, Object> configOverrides) { + Map<String, Object> configs = new java.util.HashMap<>(configOverrides); + configs.putIfAbsent(ConsumerConfig.AUTO_OFFSET_RESET_CONFIG, "earliest"); + return cluster.consumer(clientConfig(user, SaslClientsWithInvalidCredentialsTest.CLIENT_PASSWORD, configs)); + } + + private KafkaProducer<byte[], byte[]> createProducer(String user, String password, Map<String, Object> configOverrides) { + return (KafkaProducer<byte[], byte[]>) cluster.<byte[], byte[]>producer(clientConfig(user, password, configOverrides)); + } + + private Admin createAdminClient(String user, String password) { + return cluster.admin(clientConfig(user, password, Map.of())); + } + + private Map<String, Object> clientConfig(String user, String password, Map<String, Object> overrides) { + Map<String, Object> configs = new java.util.HashMap<>(overrides); + configs.put(CommonClientConfigs.SECURITY_PROTOCOL_CONFIG, SecurityProtocol.SASL_PLAINTEXT.name); + configs.put(SaslConfigs.SASL_MECHANISM, SASL_MECHANISM); + configs.put(SaslConfigs.SASL_JAAS_CONFIG, scramJaasConfig(user, password)); + return configs; + } + + private String scramJaasConfig(String user, String password) { + return ScramLoginModule.class.getName() + + " required username=\"" + user + "\" password=\"" + password + "\";"; + } + + private String userFor(GroupProtocol groupProtocol) { + return CLIENT_USER + "-" + groupProtocol.name().toLowerCase(Locale.ROOT); + } + + private void sendOneRecord(KafkaProducer<byte[], byte[]> producer, long maxWaitMs) throws Exception { + ProducerRecord<byte[], byte[]> record = new ProducerRecord<>( + TP.topic(), + TP.partition(), + 0L, + "key".getBytes(), + "value".getBytes() + ); + try { + producer.send(record).get(maxWaitMs, TimeUnit.MILLISECONDS); + producer.flush(); + } catch (ExecutionException e) { + throw (Exception) e.getCause(); + } + } + + private void verifyAuthenticationException(ThrowingRunnable action) { + long startMs = System.currentTimeMillis(); + assertThrows(Exception.class, action::run); + long elapsedMs = System.currentTimeMillis() - startMs; + assertTrue(elapsedMs <= 5000, "Authentication failure took too long, elapsed=" + elapsedMs); + } + + private void verifyWithRetry(ThrowingRunnable action) throws InterruptedException { + TestUtils.waitForCondition( + () -> { + try { + action.run(); + return true; + } catch (SaslAuthenticationException e) { + return false; + } catch (Throwable t) { + throw new RuntimeException(t); + } + }, + "Operation did not succeed within timeout" + ); + } + + @FunctionalInterface + private interface ThrowingRunnable { Review Comment: Updated: I found `TestUtils.retryOnExceptionWithTimeout` is more fit so I replaced `verifyWithRetry` with it. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
