次の方法で共有


Azure Container Registry ロールのディレクトリ リファレンス

このディレクトリには、Azure Container Registry (ACR) で使用できるすべての組み込みロールの包括的なリファレンスが用意されています。 このドキュメントは、ID 管理、監査、セキュリティ、またはカスタム ロール設計のための組み込みロールの ACR アクセス許可に関する詳細な知識を必要とするエキスパート ユーザー向けに設計されています。 各 ACR 組み込みロールについては、そのコントロール プレーンとデータ プレーンのアクセス許可がここに記載されています。

次の組み込みロールの種類を使用できます。

サポートされているロールの割り当て ID の種類、ロールの割り当てを実行する手順、一般的なシナリオで推奨されるロールなど、これらの組み込みロールの概要については、 Azure Container Registry の組み込みロールを参照してください。

該当する組み込みロールとロールの動作は、レジストリの "ロール割り当てアクセス許可モード" によって異なります。これは、Azure portal の [プロパティ] ブレードに表示されます。

  • RBAC レジストリと ABAC リポジトリのアクセス許可: オプションの Microsoft Entra ABAC 条件を使用して標準の RBAC ロールの割り当てをサポートし、特定のリポジトリへの割り当てをスコープ指定します。
  • RBAC レジストリのアクセス許可: ABAC 条件のない標準の RBAC 割り当てのみがサポートされます。

Microsoft Entra ABAC および ABAC 対応ロールの詳細については、 Microsoft Entra ベースのリポジトリのアクセス許可を参照してください。

組み込みロール リファレンス

各組み込みロールには、レジストリで実行できる操作を制御する一連のアクセス許可 (アクションとデータ アクション) が含まれています。 これらのアクセス許可は、次の 2 つのカテゴリに分類されます。

  • コントロール プレーンのアクセス許可: ACR レジストリ、レジストリ全体の構成、およびレジストリ全体のポリシーを作成、管理、削除、および構成します。
  • データ プレーンのアクセス許可: レジストリ内のイメージ、成果物、タグのプッシュ、プル、変更、削除など、レジストリ内のデータの読み取り、変更、または削除を行う操作を実行します。 また、リポジトリ固有の構成とリポジトリ固有のポリシーを変更する操作も含まれます。

コントロール プレーンのロール

次の組み込みロールはコントロール プレーンのロールです。 レジストリを管理する必要があるが、データ プレーンのアクセス許可は必要ない ID にこれらのロールを割り当てます。

該当するロールとロールの動作は、レジストリの "ロール割り当てアクセス許可モード" によって異なります。これは、Azure portal の [プロパティ] ブレードに表示されます。 Entra ABAC の詳細については、「 Entra ベースのリポジトリのアクセス許可」を参照してください。

コンテナー レジストリ共同作成者およびデータ アクセス構成管理者
コンテナー レジストリ構成閲覧者とデータ アクセス構成閲覧者
Container Registry タスク共同作成者
  • ユース ケース: 他のレジストリ操作やイメージ データにアクセスせずに ACR タスクやタスク関連リソースを管理する必要がある ID (CI/CD パイプラインや自動化ツールなど) に割り当てます。
  • アクセス許可: タスク定義、実行、タスク エージェント プール、クイック タスク (を使用したクイック ビルド、az acr buildを使用したaz acr run)、タスク ログタスク ID など、ACR タスクを管理するためのコントロール プレーン アクセスを許可します。 データ プレーンのアクセス許可や、タスク以外のレジストリ構成へのアクセスは含まれません。
コンテナー レジストリ転送パイプライン共同作成者
  • ユース ケース: ネットワーク、テナント、またはエア ギャップの境界を越えて成果物を移動するために ACR 転送パイプライン を管理する必要がある CI/CD パイプラインまたは自動化プロセスに割り当てます。 このロールは、分離された環境をブリッジするために、転送が中間 Azure Storage アカウントを通過する必要がある場合に最適です。
  • アクセス許可: 中間ストレージ アカウントを使用して ACR インポート/エクスポート転送パイプライン を構成および操作するためのコントロール プレーン アクセスを許可します。これにより、切断された環境またはセグメント化された環境間での安全なアーティファクト転送が可能になります。 データ プレーンのアクセス許可、より広範なレジストリ アクセス、ストレージ アカウントやキー コンテナーなどの他の Azure リソースの種類を管理するためのアクセス許可は含まれません。
Container Registry Data Importer と Data Reader
  • ユース ケース: az acr importを使用して他のレジストリからイメージをインポートする必要がある ID (CI/CD パイプラインなど) に割り当てます。 このロールにより、レジストリ内のイメージと成果物を読み取って、インポート操作の成功を検証することもできます。
  • アクセス許可: az acr importを使用してイメージのインポートをトリガーするためのコントロール プレーン アクセスと、イメージと成果物のプル、リポジトリの内容の表示、Open Container Initiative (OCI) 参照元、タグ、成果物ストリーミング構成へのデータ プレーン アクセスを許可します。 レジストリ内のコンテンツのプッシュまたは変更を許可しません。
    • コントロール プレーンのアクセス許可:
    • データ プレーンのアクセス許可:
      • レジストリ内のリポジトリ内のイメージと成果物をプルする
      • OCI 参照元成果物の表示と一覧表示
      • 画像とアーティファクトのメタデータ (タグなど) を表示および一覧表示する
      • レジストリ内のリポジトリ (イメージ名) の表示と一覧表示
      • リポジトリとイメージの アーティファクト ストリーミング 構成の表示 (自動アーティファクト ストリーミング変換のリポジトリ ポリシーの表示、イメージのアーティファクト ストリーミング構成の表示など)

データプレーンの役割

次の組み込みロールは、データ プレーン ロールです。 レジストリ内に格納されているイメージや成果物を操作するためにデータ プレーン操作を実行する必要があるが、レジストリを管理するためにコントロール プレーンのアクセス許可は必要ない ID にこれらのロールを割り当てます。

該当するロールとロールの動作は、レジストリの "ロール割り当てアクセス許可モード" によって異なります。これは、Azure portal の [プロパティ] ブレードに表示されます。 Microsoft Entra ABAC の詳細については、 Microsoft Entra ベースのリポジトリのアクセス許可を参照してください。

コンテナレジストリリポジトリリーダー
  • ユース ケース: コンテナー ホスト ノード、オーケストレーター、脆弱性スキャナー、または開発者に割り当てます。イメージのプルとリポジトリ メタデータの読み取りのみが必要です。コンテンツをプッシュまたは変更するアクセス許可はありません。
  • アクセス許可: プル イメージと成果物、ビュー タグ、リポジトリ、Open Container Initiative (OCI) 参照元、成果物ストリーミング構成へのデータ プレーン読み取り専用アクセスを許可します。 コントロール プレーンまたは書き込み権限は含まれません。
    • コントロール プレーンのアクセス許可:
      • 無し
    • データ プレーンのアクセス許可:
      • レジストリ内のリポジトリ内のイメージと成果物をプルする
      • OCI 参照元成果物の表示と一覧表示
      • 画像とアーティファクトのメタデータ (タグなど) を表示および一覧表示する
      • レジストリ内のリポジトリ (イメージ名) の表示と一覧表示
      • リポジトリとイメージの アーティファクト ストリーミング 構成の表示 (自動アーティファクト ストリーミング変換のリポジトリ ポリシーの表示、イメージのアーティファクト ストリーミング構成の表示など)
      • リポジトリ カタログ リストのアクセス許可は付与されません。
    • ABAC サポート: ロールの割り当てを特定のリポジトリにスコープ設定するためのオプションの Microsoft Entra ABAC 条件をサポートします。
コンテナー レジストリ リポジトリ ライター
  • ユース ケース: レジストリの構成や設定を制御することなく、コンテナー イメージのプッシュとプル、タグの管理、成果物の操作を行う必要がある CI/CD パイプライン、自動化ツール、または開発者に割り当てます。 また、信頼できるサプライ チェーンの一部としてイメージに署名する自動化されたプロセスまたはサービスにも割り当てます。
  • アクセス許可: データ プレーンに、イメージと成果物のプッシュとプル、タグの読み取り/管理、OCI 参照元の読み取り/管理、リポジトリとイメージのアーティファクト ストリーミングの有効化 (無効ではない) を許可します。 コントロール プレーンのアクセス許可は含まれません。
    • コントロール プレーンのアクセス許可:
      • 無し
    • データ プレーンのアクセス許可:
      • レジストリ内のリポジトリ内のイメージと成果物をプッシュおよびプルする
      • OCI 参照元成果物を作成、表示、および一覧表示する
      • タグ (タグの作成、読み取り、一覧表示、再タグ付け、タグのタグ解除) などの画像と成果物のメタデータを管理する
      • レジストリ内のリポジトリ (イメージ名) の表示と一覧表示
      • リポジトリとイメージの アーティファクト ストリーミング を構成する (アーティファクト ストリーミングの自動変換用にリポジトリ ポリシーを設定する、特定のイメージのアーティファクト ストリーミング変換を有効にする (ただし無効にしない) など)
      • リポジトリ カタログ リストのアクセス許可は付与されません。
    • ABAC サポート: ロールの割り当てを特定のリポジトリにスコープ設定するためのオプションの Microsoft Entra ABAC 条件をサポートします。
コンテナレジストリリポジトリの寄稿者
  • ユース ケース: イメージのライフサイクルとクリーンアップの管理を担当する ID またはサービスに割り当てます。
  • アクセス許可: イメージ と成果物の読み取り、書き込み、更新、削除 、タグの読み取り/管理/削除、OCI 参照元の読み取り/管理/削除、リポジトリとイメージの成果物ストリーミングの有効化/無効化を行うアクセス許可を付与します。 コントロール プレーンのアクセス許可は含まれません。
    • コントロール プレーンのアクセス許可:
      • 無し
    • データ プレーンのアクセス許可:
      • レジストリ内のリポジトリを操作し、イメージやアーティファクトをプッシュ、プル、削除します。
      • OCI 参照元成果物の作成、表示、一覧表示、削除
      • タグ (タグの作成、読み取り、一覧表示、再タグ付け、タグのアンタグ、削除) などの画像と成果物のメタデータを管理および削除する
      • レジストリ内のリポジトリ (イメージ名) の表示と一覧表示
      • リポジトリとイメージの アーティファクト ストリーミング を構成する (アーティファクト ストリーミングの自動変換のためのリポジトリ ポリシーの設定、特定のイメージのアーティファクト ストリーミング変換の有効化/無効化 など)
      • リポジトリ カタログ リストのアクセス許可は付与されません。
    • ABAC サポート: ロールの割り当てを特定のリポジトリにスコープ設定するためのオプションの Microsoft Entra ABAC 条件をサポートします。
コンテナ・レジストリ・リポジトリ・カタログ・リスター
  • ユース ケース: CI/CD パイプライン、開発者、脆弱性スキャナー、レジストリ監視および監査ツールなど、レジストリ 内のすべてのリポジトリを一覧表示 する必要がある ID またはサービスに割り当てます。
  • アクセス許可: レジストリ 内のすべてのリポジトリを一覧表示 するためのデータ プレーン アクセスを許可します。 コントロール プレーンのアクセス許可やイメージをプッシュ/プルするためのアクセス許可は含まれません。
    • コントロール プレーンのアクセス許可:
      • 無し
    • データ プレーンのアクセス許可:
      • レジストリ内のすべてのリポジトリ (イメージ名) を一覧表示する
      • レジストリ内のすべてのリポジトリを一覧表示するために、 {loginServerURL}/acr/v1/_catalog または {loginServerURL}/v2/_catalog レジストリ API エンドポイントを呼び出すアクセス許可を付与します。
      • リポジトリ内のイメージ、成果物、タグ、または OCI 参照元を表示または一覧表示するアクセス許可は付与されません。
    • ABAC のサポート: このロール は Entra ABAC 条件をサポートしていません。 そのため、このロールの割り当てにより、レジストリ 内のすべてのリポジトリを一覧表示するアクセス許可が付与 されます。
アクルクアランティーンライター
  • ユース ケース: CI/CD パイプラインや脆弱性スキャナーなど、検疫されたイメージを管理する自動化されたプロセスまたはサービスに割り当てます。
  • アクセス許可: レジストリ内の検疫済みイメージを管理します。
    • コントロール プレーンのアクセス許可:
      • 無し
    • データ プレーンのアクセス許可:
    • ABAC サポート: Microsoft Entra ABAC 条件はサポートされていません。
AcrQuarantineReader
  • ユース ケース: CI/CD パイプラインや脆弱性スキャナーなど、検疫されたイメージを一覧表示、読み取り、プルする自動化されたプロセスまたはサービスに割り当てます。
  • アクセス許可: レジストリ内の検疫済みイメージを一覧表示、読み取り、プルします。
    • コントロール プレーンのアクセス許可:
      • 無し
    • データ プレーンのアクセス許可:
    • ABAC サポート: Microsoft Entra ABAC 条件はサポートされていません。

特権ロール

次の組み込みロールは特権ロールです。 これらのロールは、Azure Container Registry だけでなく、他のリソースの種類に対する幅広いリソースとアクセス許可へのアクセスを提供するため、信頼できる ID にのみ割り当てます。

Azure では、これらの特権ロールではなく、可能な限り特権の少ない コントロール プレーン ロール または データ プレーン ロール を使用することをお勧めします。

該当するロールとロールの動作は、レジストリの "ロール割り当てアクセス許可モード" によって異なります。これは、Azure portal の [プロパティ] ブレードに表示されます。 Microsoft Entra ABAC の詳細については、 Microsoft Entra ベースのリポジトリのアクセス許可を参照してください。

オーナー
投稿者
  • ユース ケース: レジストリを管理する必要があるが、ロールの割り当てアクセス許可は必要ない ID に割り当てます。
  • アクセス許可: ロールの割り当てアクセス許可を除く、すべてのレジストリ コントロール プレーン操作へのフル アクセス。
    • コントロール プレーンのアクセス許可:
      • レジストリのロールの割り当てを管理または実行する場合を除き、所有者と同じです。 レジストリのロールの割り当てを表示および一覧表示するためのアクセス許可のみが付与されます。
      • 注: レジストリのロールの割り当てを管理または実行するには、 Role Based Access Control Administrator ロールが必要です。 ロールの割り当てを管理するための Owner ロールの代わりに、この特権の低いロールをお勧めします。
    • データ プレーンのアクセス許可:
      • なし - ABAC 対応レジストリには、組み込みの共同作成者ロールに対するデータ プレーンアクセス許可がありません。
閲覧者

次のステップ