관리형 Kafka ACL에 ACL 항목 추가

이 문서에서는 ACL 항목을 만들고 관리형 Kafka ACL 리소스에 추가하는 방법을 설명합니다. 관리형 Kafka ACL 리소스가 없으면 이 작업은 ACL 리소스도 생성합니다.

이 작업은 단일 Apache Kafka ACL 바인딩을 만드는 것과 유사합니다. 업데이트 작업과 달리 동시 실행 제어를 위한 ETag가 필요하지 않습니다.

필수 역할 및 권한

ACL 항목을 추가하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 관리형 Kafka ACL 편집자 (roles/managedkafka.aclEditor) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 ACL 항목을 추가하는 데 필요한 managedkafka.acls.updateEntries 권한이 포함되어 있습니다.

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 가져올 수도 있습니다.

ACL 항목 추가

콘솔

  1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. ACL 항목을 추가할 클러스터의 이름을 클릭합니다.

  3. 액세스 제어 탭을 클릭합니다.

  4. ACL 항목 만들기를 클릭합니다.

  5. ACL 항목 만들기 패널에 ACL 항목의 세부정보를 입력합니다.

    1. 리소스 유형 목록에서 이 ACL이 적용되는 클러스터 리소스의 유형을 선택합니다. 자세한 내용은 ACL ID를 참고하세요.

    2. 리소스 유형이 Topic, Consumer group 또는 Transactional ID인 경우 리소스의 ID를 선택하거나 입력합니다.

    3. 리소스 유형이 Topic prefix, Consumer group prefix 또는 Transactional ID prefix인 경우 ACL과 일치하는 접두사를 입력합니다.

    4. 주 구성원 필드에 ACL 항목의 주 구성원을 입력합니다.

    5. 권한 유형 목록에서 ALLOW 또는 DENY를 선택합니다.

    6. 작업 목록에서 ACL 항목의 작업 유형을 선택합니다.

  6. 만들기를 클릭합니다.

gcloud

gcloud managed-kafka acls add-acl-entry 명령어를 실행합니다.

gcloud managed-kafka acls add-acl-entry ACL_ID \
  --cluster=CLUSTER_ID \
  --location=LOCATION \
  --principal=PRINCIPAL \
  --operation=OPERATION \
  --permission-type=PERMISSION_TYPE \
  --host=*

다음을 바꿉니다.

  • ACL_ID. 업데이트할 관리형 Kafka ACL 리소스의 ID입니다. 자세한 내용은 ACL ID를 참고하세요. 이 ID의 관리형 Kafka ACL이 없으면 자동으로 생성됩니다.

  • CLUSTER_ID: Kafka 클러스터의 ID입니다.

  • LOCATION: Kafka 클러스터의 리전입니다.

  • PRINCIPAL: 새 ACL 항목의 주 구성원입니다.

  • OPERATION: READ 또는 CREATE과 같은 작업 유형입니다.

  • PERMISSION_TYPE: 주 구성원이 작업에 대해 보유한 권한입니다. ALLOW 또는 DENY를 지정합니다.

명령어 샘플

다음 명령어를 실행하여 특정 서비스 계정이 us-central1 리전의 클러스터 test-cluster에서 test-topic라는 주제를 읽을 수 있도록 허용합니다.

gcloud managed-kafka acls add-acl-entry topic/test-topic \
  --cluster=test-cluster \
  --location=us-central1 \
  --principal='User:service-account@test-project.iam.gserviceaccount.com' \
  --operation=READ \
  --permission-type=ALLOW \
  --host='*'

샘플 출력은 다음과 같습니다.

acl:
  aclEntries:
  - host: '*'
    operation: READ
    permissionType: ALLOW
    principal: 'User:service-account@test-project.iam.gserviceaccount.com'
  etag: W/another-new-etag
  name: projects/test-project/locations/us-central1/clusters/test-cluster/acls/topic/test-topic
  patternType: LITERAL
  resourceName: test-topic
  resourceType: TOPIC
aclCreated: false

add-acl-entry 명령어의 출력은 결과 ACL 상태에 관한 정보를 제공합니다.

  • acl: 이 섹션에서는 새 항목이 추가된 후 업데이트된 ACL 리소스를 설명합니다.

    • aclEntries: 이 ACL의 모든 액세스 제어 항목이 포함된 목록입니다. 이 예시에서는 이제 방금 추가된 항목이 포함됩니다. 각 항목에는 다음 필드가 있습니다.

      • host: ACL 항목의 호스트입니다.
      • operation: 이 항목이 적용되는 Kafka 작업입니다.
      • permissionType: 액세스가 ALLOW인지 DENY인지 여부입니다.
      • principal: 이 항목이 적용되는 사용자 또는 서비스 계정입니다.
    • etag: 업데이트된 ACL의 항목 태그입니다. 후속 업데이트 중에 낙관적 동시 실행 제어에 사용됩니다. 항목이 추가되면 값이 변경됩니다.

    • name: ACL 리소스의 고유 식별자입니다. 형식은 projects/{project}/locations/{location}/clusters/{cluster}/acls/{acl_id}입니다.

    • patternType: 이 ACL의 리소스 패턴 유형입니다.

    • resourceName: 이 ACL이 적용되는 Kafka 리소스의 이름입니다.

    • resourceType: Kafka 리소스 유형입니다.

  • aclCreated: 이 항목을 추가한 결과로 ACL 리소스가 생성되었는지 여부를 나타내는 불리언 값입니다.

다음 단계

Apache Kafka®는 미국 및/또는 다른 국가에서 사용되는 Apache Software Foundation 또는 해당 계열사의 등록 상표입니다.