マネージド Kafka ACL に ACL エントリを追加する

このドキュメントでは、ACL エントリを作成して、マネージド Kafka ACL リソースに追加する方法について説明します。マネージド Kafka ACL リソースが存在しない場合、このオペレーションは ACL リソースも作成します。

このオペレーションは、単一の Apache Kafka ACL バインディングの作成に似ています。更新オペレーションとは異なり、同時実行制御に ETag は必要ありません。

必要なロールと権限

ACL エントリを追加するために必要な権限を取得するには、プロジェクトに対する Managed 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 または米国その他の諸国における関連会社の商標です。