Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

mTLS 문제 해결

이 섹션에서는 Managed Service for Apache Kafka로 mTLS를 구성하고 사용할 때 발생하는 일반적인 문제의 문제 해결 안내를 제공합니다.

클러스터 업데이트 시 오류

gcloud managed-kafka clusters update 또는 gcloud managed-kafka clusters create 명령어를 실행할 때 다음과 같은 오류가 발생할 수 있습니다.

SSL 주 구성원 매핑 규칙이 잘못됨

다음 중 하나와 유사한 오류 메시지가 표시됩니다.

INVALID_ARGUMENT: The request was invalid: invalid SSL principal mapping
rule: \"RULE:INVALID-RULE\". The rule must be of the format DEFAULT or
RULE:pattern/replacement/[LU]

INVALID_ARGUMENT: The request was invalid: invalid SSL principal mapping
rules: \"RULE:\\nRULE:,DEFAULT\" contains a newline

ssl-principal-mapping-rules 플래그에 제공된 값이 잘못된 형식으로 지정되었거나 잘못된 문자가 포함되어 오류 메시지가 발생합니다.

필수 형식에 맞게 규칙을 수정하고 규칙 문자열에 줄바꿈 문자가 포함되어 있지 않은지 확인합니다. ssl-principal-mapping-rules 플래그에 대한 자세한 내용은 주 구성원 매핑을 참고하세요.

CA 풀 구성이 잘못됨

다음 중 하나와 유사한 오류 메시지가 표시됩니다.

INVALID_ARGUMENT: The request was invalid:
ca_pool: project/managed-kafka-test/locations/us-central1/test-ca-pool
doesn't match the expected format: projects/{project}/locations/{location}/caPools/{caPool}

INVALID_ARGUMENT: The request was invalid: maximum of 10 CA pools can be specified

INVALID_ARGUMENT: The request was invalid: duplicate CA pool:
projects/managed-kafka-test/locations/us-central1/caPools/test-ca-pool.
All CA pools must be unique

mtls-ca-pools 플래그에 제공된 CA 풀 목록이 잘못되어 오류 메시지가 발생합니다. CA 풀 목록을 확인하고 다음을 확인합니다.

모든 CA 풀 이름은 전체 리소스 형식(projects/PROJECT_ID/locations/LOCATION/caPools/CA_POOL_ID)을 사용합니다.
목록에 중복된 CA 풀이 없습니다.
총 CA 풀 수가 10개를 초과하지 않습니다.

클러스터에서 mTLS를 지원하지 않음

다음과 유사한 오류 메시지가 표시됩니다.

FAILED_PRECONDITION: Invalid resource state for \"tls_config\": mTLS is not
supported for this cluster because it was created before the mTLS feature
was added. Please create a new cluster to use mTLS.

이 오류 메시지는 이 기능이 제공되기 전에 생성된 클러스터에서 mTLS를 사용 설정하려고 시도할 때 발생합니다. 오류 메시지에서 제안하는 것처럼 mTLS를 사용하려면 새 클러스터를 만들어야 합니다. 2025년 6월 24일 전에 생성된 기존의 부적격 클러스터에서는 mTLS를 사용 설정할 수 없습니다.

클라이언트 연결 실패

클라이언트 애플리케이션이 클러스터의 mTLS 엔드포인트에 연결할 수 없는 경우 다음의 일반적인 구성 문제를 확인하세요.

잘못된 부트스트랩 주소: 올바른 부트스트랩 주소를 사용하고 있는지 확인합니다. 9092이 아닌 9192로 끝나는 mTLS 부트스트랩 주소를 사용해야 합니다.
잘못되었거나 올바르지 않은 클라이언트 인증서: 클라이언트 인증서가 유효하고, 만료되지 않았으며, 클러스터에 구성된 CA 풀 중 하나에 있는 CA에서 발급되었는지 확인합니다.
잘못된 클라이언트 키 저장소 구성: 클라이언트 애플리케이션의 구성이 키 저장소 및 트러스트 저장소 파일을 올바르게 가리키고 비밀번호가 올바른지 확인합니다.
잘못된 Kafka ACL: 인증된 주체에 필요한 Kafka ACL을 만들었는지 확인합니다. 주 구성원은 User:이 접두사로 붙은 인증서의 주체 이름 (또는 매핑된 별칭)입니다. 예를 들어 주체 이름이 test-user이면 주체는 User:test-user입니다.

Cloud Logging의 오류

클러스터의 로그에 다음 오류가 표시될 수 있으며, 이는 Logging에서 확인할 수 있습니다. 로깅에 대한 자세한 내용은 로그 탐색기를 사용하여 로그 보기를 참고하세요.

트러스트 저장소 크기가 최대값을 초과함

다음과 같은 로그 항목이 표시됩니다.

Trust store size X bytes exceeds the maximum allowed size of 1000 KiB
and cannot be updated.

이 오류 메시지는 구성된 CA 풀의 모든 CA 인증서의 총 크기가 1000KiB 한도보다 크기 때문에 발생합니다.

CA 풀의 인증서를 검토하여 총 크기를 줄입니다. 여기에는 크거나 불필요한 인증서를 삭제하거나 CA 체인을 최적화하는 것이 포함될 수 있습니다.

CA 풀에서 인증서를 가져올 수 없습니다.