ファイアウォールの内側から Azure Container Registry にアクセスする規則を構成する

[アーティクル]
09/28/2024

この記事では、Azure コンテナーレジストリへのアクセスを許可するようにファイアウォールの規則を構成する方法について説明します。たとえば、ファイアウォールまたはプロキシサーバーの背後にある Azure IoT Edge デバイスは、コンテナーのイメージをプルするためにコンテナーレジストリにアクセスする必要がある場合があります。または、オンプレミスネットワーク内のロックダウンされたサーバーが、イメージをプッシュするためのアクセスを必要とする場合があります。

代わりに、Azure 仮想ネットワーク内でのみコンテナーレジストリへの着信ネットワークアクセスを構成する場合は、「Azure コンテナーレジストリ用に Azure Private Link を構成する」を参照してください。

レジストリエンドポイントについて

イメージまたはその他の成果物を Azure コンテナーレジストリにプルまたはプッシュするには、Docker デーモンなどのクライアントが 2 つの異なるエンドポイントを使用して HTTPS 経由でやり取りする必要があります。ファイアウォールの内側からレジストリにアクセスするクライアントでは、両方のエンドポイントのアクセス規則を構成する必要があります。どちらのエンドポイントもポート 443 経由でアクセスされます。

レジストリ REST API エンドポイント - 認証およびレジストリ管理操作は、レジストリのパブリック REST API エンドポイントを介して処理されます。このエンドポイントは、レジストリのログインサーバー名です。例: myregistry.azurecr.io
- 証明書のレジストリ REST API エンドポイント - Azure コンテナーレジストリでは、すべてのサブドメインにワイルドカード SSL 証明書が使用されます。 SSL を使用して Azure コンテナーレジストリに接続する場合、クライアントは TLS ハンドシェイク用の証明書をダウンロードできる必要があります。このような場合は、azurecr.io にもアクセスできる必要があります。
ストレージ (データ) エンドポイント - Azure では、コンテナーイメージやその他の成果物のデータを管理するために、各レジストリに代わって Azure Storage アカウントに BLOB ストレージが割り当てられます。クライアントは、Azure コンテナーレジストリ内のイメージレイヤーにアクセスするときに、レジストリによって提供されるストレージアカウントのエンドポイントを使用して要求を行います。

レジストリが geo レプリケートされている場合、クライアントは、特定のリージョンまたは複数のレプリケートされたリージョンでデータエンドポイントを操作する必要がある場合があります。

REST エンドポイントとデータエンドポイントへのアクセスを許可する

REST エンドポイント - レジストリログインサーバーの完全修飾名 (<registry-name>.azurecr.io) または関連付けられた IP アドレス範囲へのアクセスを許可します
ストレージ (データ) エンドポイント - ワイルドカード (*.blob.core.windows.net) または関連付けられた IP アドレス範囲を使用して、すべての Azure BLOB ストレージアカウントへのアクセスを許可します。

Note

Azure Container Registry には専用データエンドポイントが導入されています。これにより、レジストリストレージのクライアントファイアウォール規則のスコープを厳密に設定できます。必要に応じて、<registry-name>.<region>.data.azurecr.io の形式を使用して、レジストリが配置またはレプリケートされているすべてのリージョンで、データエンドポイントを有効にします。

レジストリ FQDN について

レジストリには、 ログイン URL と データエンドポイントの 2 つの FQDN があります。

プライベートリンクを有効にすることで、プライベート IP を使用して、 ログイン URL と データエンドポイント の両方に仮想ネットワーク内からアクセスできます。
データエンドポイントを使用しないレジストリは、フォーム *.blob.core.windows.net のエンドポイントからデータにアクセスする必要があり、ファイアウォール規則を構成するときに必要な分離を提供しません。
プライベートリンクが有効になっているレジストリでは、専用データエンドポイントが自動的に取得されます。
専用データエンドポイントは、レジストリのリージョンごとに作成されます。
データエンドポイントが有効か無効かに関係なく、ログイン URL は変わりません。

IP アドレス範囲によりアクセスを許可する

組織に特定の IP アドレスまたはアドレス範囲のみへのアクセスを許可するポリシーがある場合は、Azure の IP 範囲とサービスタグ – パブリッククラウドをダウンロードしてください。

アクセスを許可する必要がある ACR REST エンドポイントの IP 範囲を検索するには、JSON ファイル内で AzureContainerRegistry を検索します。

重要

Azure サービスの IP アドレス範囲は変更でき、更新は毎週公開されます。 JSON ファイルを定期的にダウンロードし、アクセス規則で必要な更新を行います。実際のシナリオで、Azure 仮想ネットワークでネットワークセキュリティグループの規則を構成する必要がある場合、または Azure Firewall を使用する場合、代わりに AzureContainerRegistry のサービスタグを使用します。

すべてのリージョンの REST IP アドレス

{
  "name": "AzureContainerRegistry",
  "id": "AzureContainerRegistry",
  "properties": {
    "changeNumber": 10,
    "region": "",
    "platform": "Azure",
    "systemService": "AzureContainerRegistry",
    "addressPrefixes": [
      "13.66.140.72/29",
    [...]

特定のリージョンの REST IP アドレス

特定のリージョン (AzureContainerRegistry.AustraliaEast など) を検索します。

{
  "name": "AzureContainerRegistry.AustraliaEast",
  "id": "AzureContainerRegistry.AustraliaEast",
  "properties": {
    "changeNumber": 1,
    "region": "australiaeast",
    "platform": "Azure",
    "systemService": "AzureContainerRegistry",
    "addressPrefixes": [
      "13.70.72.136/29",
    [...]

すべてのリージョンのストレージ IP アドレス

{
  "name": "Storage",
  "id": "Storage",
  "properties": {
    "changeNumber": 19,
    "region": "",
    "platform": "Azure",
    "systemService": "AzureStorage",
    "addressPrefixes": [
      "13.65.107.32/28",
    [...]

特定のリージョンのストレージ IP アドレス

特定のリージョン (Storage.AustraliaCentral など) を検索します。

{
  "name": "Storage.AustraliaCentral",
  "id": "Storage.AustraliaCentral",
  "properties": {
    "changeNumber": 1,
    "region": "australiacentral",
    "platform": "Azure",
    "systemService": "AzureStorage",
    "addressPrefixes": [
      "52.239.216.0/23"
    [...]

サービスタグによるアクセスを許可する

Azure 仮想ネットワークでは、ネットワークセキュリティ規則を使用して、仮想マシンなどのリソースからコンテナーレジストリへのトラフィックをフィルター処理します。 Azure ネットワーク規則の作成を簡略化するには、AzureContainerRegistry のサービスタグを使用します。サービスタグは、グローバルまたは Azure リージョンごとに Azure サービスにアクセスするための IP アドレスプレフィックスのグループを表します。アドレスが変更されると、タグは自動的に更新されます。

たとえば、Azure コンテナーレジストリへのトラフィックを許可するために、宛先が AzureContainerRegistry の送信ネットワークセキュリティグループの規則を作成します。特定のリージョンでのみサービスタグへのアクセスを許可するには、次の形式でリージョンを指定します。AzureContainerRegistry.[リージョン名]

専用データエンドポイントを有効にする

警告

既存の *.blob.core.windows.net エンドポイントへのクライアントファイアウォールアクセスを以前に構成した場合、専用データエンドポイントへの切り替えによってクライアント接続が影響を受け、プルエラーが発生します。クライアントが一貫してアクセスできるようにするには、新しいデータエンドポイント規則をクライアントのファイアウォール規則に追加します。完了したら、Azure CLI またはその他のツールを使用して、レジストリの専用データエンドポイントを有効にします。

専用データエンドポイントは、Premium コンテナーレジストリサービスレベルのオプション機能です。レジストリサービスのレベルと制限については、「Azure Container Registry のサービスレベル」を参照してください。

Azure portal または Azure CLI を使用して、専用のデータエンドポイントを有効にすることができます。データエンドポイントは、リージョンのパターン <registry-name>.<region>.data.azurecr.io に従います。 Geo レプリケートされたレジストリでは、データエンドポイントを有効にすると、すべてのレプリカリージョンでエンドポイントが有効になります。

ポータル

ポータルを使用してデータエンドポイントを有効にするには:

お使いのコンテナーレジストリに移動します。
[ネットワーク]>[パブリックアクセス] を選択します。
[Enable dedicated data endpoint](専用データエンドポイントを有効にする) チェックボックスを選択します。
[保存] を選択します。

データエンドポイントがポータルに表示されます。

ポータルの専用データエンドポイント

Azure CLI

Azure CLI を使用してデータエンドポイントを有効にするには、Azure CLI バージョン 2.4.0 以降を使用します。インストールまたはアップグレードする必要がある場合は、Azure CLI のインストールに関するページを参照してください。

次の az acr update コマンドを使用すると、レジストリ myregistry の専用データエンドポイントが有効になります。

az acr update --name myregistry --data-endpoint-enabled

データエンドポイントを表示するには、az acr show-endpoints コマンドを使用します。

az acr show-endpoints --name myregistry

デモンストレーション目的での出力には、2 つのリージョンエンドポイントが示されています

{
    "loginServer": "myregistry.azurecr.io",
    "dataEndpoints": [
        {
            "region": "eastus",
            "endpoint": "myregistry.eastus.data.azurecr.io",
        },
        {
            "region": "westus",
            "endpoint": "myregistry.westus.data.azurecr.io",
        }
    ]
}

レジストリの専用データエンドポイントを設定した後、データエンドポイントのクライアントファイアウォールアクセス規則を有効にすることができます。必要なすべてのレジストリリージョンについて、データエンドポイントアクセス規則を有効にします。

MCR 用のクライアントファイアウォール規則を構成する

ファイアウォールの内側から Microsoft Container Registry (MCR) にアクセスする必要がある場合は、MCR クライアントファイアウォール規則を構成するためのガイダンスを参照してください。 MCR は、Microsoft が公開しているすべての docker イメージ (Windows Server イメージなど) のプライマリレジストリです。

次のステップ

Azure のネットワークセキュリティのベストプラクティスについて学習する
Azure 仮想ネットワークのセキュリティグループについて学習する
コンテナーレジストリの Private Link の設定について学習する
Azure Container Registry の専用データエンドポイントについて学習する

次の方法で共有

ファイアウォールの内側から Azure Container Registry にアクセスする規則を構成する

レジストリエンドポイントについて

REST エンドポイントとデータエンドポイントへのアクセスを許可する

レジストリ FQDN について

IP アドレス範囲によりアクセスを許可する

すべてのリージョンの REST IP アドレス

特定のリージョンの REST IP アドレス

すべてのリージョンのストレージ IP アドレス

特定のリージョンのストレージ IP アドレス

サービスタグによるアクセスを許可する

専用データエンドポイントを有効にする

ポータル

Azure CLI

MCR 用のクライアントファイアウォール規則を構成する

次のステップ

フィードバック

その他のリソース

次の方法で共有

ファイアウォールの内側から Azure Container Registry にアクセスする規則を構成する

レジストリ エンドポイントについて

REST エンドポイントとデータ エンドポイントへのアクセスを許可する

レジストリ FQDN について

IP アドレス範囲によりアクセスを許可する

すべてのリージョンの REST IP アドレス

特定のリージョンの REST IP アドレス

すべてのリージョンのストレージ IP アドレス

特定のリージョンのストレージ IP アドレス

サービス タグによるアクセスを許可する

専用データ エンドポイントを有効にする

ポータル

Azure CLI

MCR 用のクライアント ファイアウォール規則を構成する

次のステップ

フィードバック

その他のリソース

レジストリエンドポイントについて

REST エンドポイントとデータエンドポイントへのアクセスを許可する

サービスタグによるアクセスを許可する

専用データエンドポイントを有効にする

MCR 用のクライアントファイアウォール規則を構成する