Azure Container Instances でマネージド ID を使用する方法

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

Azure リソース用のマネージド ID を使用して、他の Azure サービスと対話する Azure Container Instances 内のコードを実行します。こうするとシークレットや資格情報をコード内に保持する必要がありません。この機能により、Microsoft Entra ID で自動管理される ID が Azure Container Instances のデプロイに提供されます。

この記事では、Azure Container Instances でのマネージド ID の詳細について、および次の点について説明します。

コンテナーグループでユーザー割り当て ID またはシステム割り当て ID を有効にする
ID に Azure Key Vault へのアクセス権を付与する
マネージド ID を使用して、実行中のコンテナーから Key Vault にアクセスする

サンプルを調整することにより、Azure Container Instances 内の ID を有効にし、それを使って他の Azure サービスにアクセスします。これらのサンプルは対話型です。ただし実際には、コンテナーイメージがコードを実行して Azure サービスにアクセスします。

マネージド ID を使用する理由

実行中のコンテナーでマネージド ID を使用すると、資格情報をコンテナーコード内で管理しなくても、Microsoft Entra 認証をサポートするサービスに対して認証することができます。 AD 認証をサポートしないサービスについては、Azure Key Vault の中にシークレットを格納し、マネージド ID を使って Key Vault にアクセスして資格情報を取得できます。マネージド ID の使用法の詳細については、「Azure リソースのマネージド ID とは」を参照してください。

マネージド ID の有効化

コンテナーグループを作成するときに、ContainerGroupIdentity プロパティを設定することで 1 つまたは複数のマネージド ID を有効にできます。また、コンテナーグループが実行状態になった後でマネージド ID を有効化または更新できます。どちらの場合も、それによりコンテナーグループが再起動します。新規または既存のコンテナーグループで ID を設定するには、Azure CLI、Resource Manager テンプレート、YAML ファイル、または別の Azure ツールを使用します。

Azure Container Instances は、ユーザー割り当て、システム割り当ての両方の種類の Azure マネージド ID をサポートしています。各コンテナーグループで、1 つのシステム割り当て ID、1 つまたは複数のユーザー割り当て ID、または両方の種類の ID を有効化できます。 Azure リソースのマネージド ID の基本点な事柄については、概要を参照してください。

マネージド ID の使用

マネージド ID を使用するには、サブスクリプション内の 1 つ以上の Azure サービスリソース (Web アプリ、キーコンテナー、ストレージアカウントなど) へのアクセス権を ID に付与する必要があります。実行中のコンテナーでマネージド ID を使用することは、Azure 仮想マシン (VM) で ID を使用することと似ています。トークン、Azure PowerShell または Azure CLI、または Azure SDK の使用に関する VM ガイダンス資料を参照してください。

前提条件

Azure Cloud Shell で Bash 環境を使用します。詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。
CLI リファレンスコマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。
- ローカルインストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。認証プロセスを完了するには、ターミナルに表示される手順に従います。その他のサインインオプションについては、Azure CLI でのサインインに関するページを参照してください。
- 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。
- az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。最新バージョンにアップグレードするには、az upgrade を実行します。

この記事では、Azure CLI のバージョン 2.0.49 以降が必要です。 Azure Cloud Shell を使用している場合は、最新バージョンが既にインストールされています。

Azure Key Vault を作成する

この記事の例では、Azure Container Instances でマネージド ID を使用して Azure Key Vault シークレットにアクセスします。

まず、次の az group create コマンドを使用して、myResourceGroup という名前のリソースグループを eastus の場所に作成します。

az group create --name myResourceGroup --location eastus

キーコンテナーを作成するには、az keyvault create コマンドを使います。必ず一意のキーコンテナー名を指定してください。

az keyvault create \
  --name mykeyvault \
  --resource-group myResourceGroup \
  --location eastus

az keyvault secret set コマンドを使って、サンプルのシークレット例をキーコンテナーに格納します。

az keyvault secret set \
  --name SampleSecret \
  --value "Hello Container Instances" \
  --description ACIsecret --vault-name mykeyvault

次に示す例に従い、Azure Container Instances のユーザー定義/システム定義のいずれかのマネージド ID を使って Key Vault にアクセスします。

例 1:ユーザー割り当ての ID を使用して Azure Key Vault にアクセスする

ID の作成

まず az identity create コマンドを使用して、サブスクリプション内で ID を作成します。 Key Vault の作成に使ったのと同じリソースグループを使用することも、別のものを使用することもできます。

az identity create \
  --resource-group myResourceGroup \
  --name myACIId

後続のステップで ID を使用するために、az identity show コマンドを使って ID のサービスプリンシパル ID とリソース ID を変数に格納します。

# Get service principal ID of the user-assigned identity
SP_ID=$(az identity show \
  --resource-group myResourceGroup \
  --name myACIId \
  --query principalId --output tsv)

# Get resource ID of the user-assigned identity
RESOURCE_ID=$(az identity show \
  --resource-group myResourceGroup \
  --name myACIId \
  --query id --output tsv)

Key Vault へのアクセス権をユーザー割り当て ID に付与する

次の az keyvault set-policy コマンドを実行して、キーコンテナーに対するアクセスポリシーを設定します。次の例では、ユーザー割り当て ID にキーコンテナーからのシークレットの取得を許可します。

 az keyvault set-policy \
    --name mykeyvault \
    --resource-group myResourceGroup \
    --object-id $SP_ID \
    --secret-permissions get

コンテナーグループでユーザー割り当て ID を有効にする

次の az container create コマンドを実行して、Microsoft の azure-cli イメージに基づくコンテナーインスタンスを作成します。この例で作成される単一コンテナーのグループを使用すると、Azure CLI を実行して他の Azure サービスに対話的にアクセスできます。このセクションでは、基本のオペレーティングシステムのみが使用されます。コンテナーで Azure CLI を使用する例については、「コンテナーグループでシステム割り当て ID を有効にする」を参照してください。

--assign-identity パラメーターは、ユーザー割り当てのマネージド ID をグループに渡します。実行時間の長いこのコマンドにより、コンテナーの実行状態が続きます。この例では、Key Vault の作成に使ったのと同じリソースグループを使用していますが、別のものを指定することもできます。

az container create \
  --resource-group myResourceGroup \
  --name mycontainer \
  --image mcr.microsoft.com/azure-cli \
  --assign-identity $RESOURCE_ID \
  --command-line "tail -f /dev/null"

数秒以内に、デプロイが完了したことを示す応答が Azure CLI から得られます。 az container show コマンドを使用して、その状態を確認します。

az container show \
  --resource-group myResourceGroup \
  --name mycontainer

出力の identity セクションが次のように表示されたら、コンテナーグループで ID が設定されています。 userAssignedIdentities の下の principalID は、Microsoft Entra ID で作成した ID のサービスプリンシパルです。

[...]
"identity": {
    "principalId": "null",
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourcegroups/danlep1018/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myACIId": {
        "clientId": "00001111-aaaa-2222-bbbb-3333cccc4444",
        "principalId": "aaaaaaaa-bbbb-cccc-1111-222222222222"
      }
    }
  },
[...]

ユーザー定義 ID を使用して Key Vault からシークレットを取得する

これで、実行中のコンテナーインスタンス内でマネージド ID を使って Key Vault にアクセスすることができます。まずコンテナーで bash シェルを次のように起動します。

az container exec \
  --resource-group myResourceGroup \
  --name mycontainer \
  --exec-command "/bin/bash"

コンテナーの bash シェルで、次のコマンドを実行します。 Microsoft Entra ID を使用して Key Vault に認証するためのアクセストークンを取得するには、次のコマンドを実行します。

client_id="00001111-aaaa-2222-bbbb-3333cccc4444"
curl "http://169.254.169.254/metadata/identity/oauth2/token?api-version=2018-02-01&resource=https%3A%2F%2Fvault.azure.net&client_id=$client_id" -H Metadata:true -s

出力:

{"access_token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx1QiLCJhbGciOiJSUzI1NiIsIng1dCI6Imk2bEdrM0ZaenhSY1ViMkMzbkVRN3N5SEpsWSIsImtpZCI6Imk2bEdrM0ZaenhSY1ViMkMzbkVRN3N5SEpsWSJ9......xxxxxxxxxxxxxxxxx","refresh_token":"","expires_in":"28799","expires_on":"1539927532","not_before":"1539898432","resource":"https://vault.azure.net/","token_type":"Bearer"}

後続のコマンドで認証に使うためにアクセストークンを変数に格納するには、次のコマンドを実行します。

TOKEN=$(curl 'http://169.254.169.254/metadata/identity/oauth2/token?api-version=2018-02-01&resource=https%3A%2F%2Fvault.azure.net' -H Metadata:true | jq -r '.access_token')

次に、アクセストークンを使って Key Vault に対して認証し、シークレットを読み取ります。 URL 内のキーコンテナー名を必ず置き換えてください (https://mykeyvault.vault.azure.net/...)。

curl https://mykeyvault.vault.azure.net/secrets/SampleSecret/?api-version=7.4 -H "Authorization: Bearer $TOKEN"

応答では次のようにシークレットが表示されます。コードの中でこの出力を解析して、シークレットを取得できます。その後、後続の操作でシークレットを使用して、別の Azure リソースにアクセスします。

{"value":"Hello Container Instances","contentType":"ACIsecret","id":"https://mykeyvault.vault.azure.net/secrets/SampleSecret/xxxxxxxxxxxxxxxxxxxx","attributes":{"enabled":true,"created":1539965967,"updated":1539965967,"recoveryLevel":"Purgeable"},"tags":{"file-encoding":"utf-8"}}

例 2:システム割り当ての ID を使用して Azure Key Vault にアクセスする

コンテナーグループでシステム割り当て ID を有効にする

次の az container create コマンドを実行して、Microsoft の azure-cli イメージに基づくコンテナーインスタンスを作成します。この例で作成される単一コンテナーのグループを使用すると、Azure CLI を実行して他の Azure サービスに対話的にアクセスできます。

--assign-identity パラメーター (他の値なし) を指定すると、システム割り当てのマネージド ID がグループで有効になります。この ID は、コンテナーグループのリソースグループにスコープが設定されています。実行時間の長いこのコマンドにより、コンテナーの実行状態が続きます。この例では、ID のスコープ内にある、キーコンテナーの作成に使用したものと同じリソースグループを使用します。

# Get the resource ID of the resource group
RG_ID=$(az group show --name myResourceGroup --query id --output tsv)

# Create container group with system-managed identity
az container create \
  --resource-group myResourceGroup \
  --name mycontainer \
  --image mcr.microsoft.com/azure-cli \
  --assign-identity --scope $RG_ID \
  --command-line "tail -f /dev/null"

数秒以内に、デプロイが完了したことを示す応答が Azure CLI から得られます。 az container show コマンドを使用して、その状態を確認します。

az container show \
  --resource-group myResourceGroup \
  --name mycontainer

出力の identity セクションが次のように表示され、システム割り当て ID が Microsoft Entra ID で作成されたことを示します。

[...]
"identity": {
    "principalId": "bbbbbbbb-cccc-dddd-2222-333333333333",
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "type": "SystemAssigned",
    "userAssignedIdentities": null
},
[...]

後続のステップで使用するために、この ID の変数の値を principalId (サービスプリンシパル ID) に設定します。

SP_ID=$(az container show \
  --resource-group myResourceGroup \
  --name mycontainer \
  --query identity.principalId --out tsv)

Key Vault へのアクセス権をコンテナーグループに付与する

次の az keyvault set-policy コマンドを実行して、キーコンテナーに対するアクセスポリシーを設定します。次の例により、システム定義 ID が Key Vault からシークレットを取得できるようになります。

 az keyvault set-policy \
   --name mykeyvault \
   --resource-group myResourceGroup \
   --object-id $SP_ID \
   --secret-permissions get

コンテナーグループ ID を使用して Key Vault からシークレットを取得する

az container exec \
  --resource-group myResourceGroup \
  --name mycontainer \
  --exec-command "/bin/bash"

コンテナーの bash シェルで、次のコマンドを実行します。まず、マネージド ID を使用して Azure CLI にサインインします。

az login --identity

実行中のコンテナーから、キーコンテナーのシークレットを取得します。

az keyvault secret show \
  --name SampleSecret \
  --vault-name mykeyvault --query value

シークレットの値が取得されます。

"Hello Container Instances"

Resource Manager テンプレートを使用してマネージド ID を有効にする

Resource Manager テンプレートを使用してコンテナーグループのマネージド ID を有効にするには、ContainerGroupIdentity オブジェクトを使って Microsoft.ContainerInstance/containerGroups オブジェクトの identity プロパティを設定します。次のスニペットは、さまざまなシナリオ別の identity プロパティの構成を示しています。 Resource Manager テンプレートリファレンスを参照してください。 2018-10-01 を apiVersion 以上指定します。

ユーザー割り当て ID

ユーザー割り当て ID は、次の形式のリソース ID です。

"/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}"

1 つまたは複数のユーザー割り当て ID を有効にすることができます。

"identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
        "myResourceID1": {
            }
        }
    }

システム割り当て ID

"identity": {
    "type": "SystemAssigned"
    }

システム割り当て/ユーザー割り当て ID

各コンテナーグループで、1 つのシステム割り当て ID と、1 つまたは複数のユーザー割り当て ID の両方を有効化できます。

"identity": {
    "type": "SystemAssigned, UserAssigned",
    "userAssignedIdentities": {
        "myResourceID1": {
            }
        }
    }
...

マネージド ID を有効にするには YAML ファイルを使用します。

YAML ファイルを使ってデプロイされるコンテナーグループでマネージド ID を有効にするには、次の YAML を含めます。 2018-10-01 を apiVersion 以上指定します。

ユーザー割り当て ID

ユーザー割り当て ID は次の形式のリソース ID です

'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'

1 つまたは複数のユーザー割り当て ID を有効にすることができます。

identity:
  type: UserAssigned
  userAssignedIdentities:
    {'myResourceID1':{}}

システム割り当て ID

identity:
  type: SystemAssigned

システム割り当て/ユーザー割り当て ID

各コンテナーグループで、1 つのシステム割り当て ID と、1 つまたは複数のユーザー割り当て ID の両方を有効化できます。

identity:
  type: SystemAssigned, UserAssigned
  userAssignedIdentities:
   {'myResourceID1':{}}

Windows コンテナー上のマネージド ID

Windows コンテナーグループのマネージド ID は、Linux コンテナーグループとは動作が異なります。 Windows コンテナーの場合、メタデータサーバー (169.254.169.254) は Microsoft Entra ID トークンを取得できません。お客様は別のパターンに従って、Windows コンテナーでアクセストークンを取得できます。このパターンでは、次に示すように、トークン要求を IDENTITY_ENDPOINT に送信し、プリンシパル ID やシークレットなどの追加情報を送信します。 IDENTITY_ENDPOINT と IDENTITY_HEADER は、コンテナーに環境変数として挿入されます。

curl -G -v %IDENTITY_ENDPOINT% --data-urlencode resource=https://vault.azure.net --data-urlencode principalId=<principal id> -H secret:%IDENTITY_HEADER%

PowerShell スクリプトのサンプル

identityEndpoint = $env:IDENTITY_ENDPOINT
$identityHeader = $env:IDENTITY_HEADER
$resource = "https://vault.azure.net"
$principalId = "b2ee9347-623c-4794-85af-2d5261356f67"
 
Invoke-RestMethod -Uri "$identityEndpoint" `
    -Method Get `
    -Headers @{secret = $identityHeader} `
    -Body @{resource = $resource; principalId = $principalId} `
    -ContentType "application/x-www-form-urlencoded"

Az Login モジュールと、メタデータサーバー (169.254.169.254) に依存するその他のクライアントライブラリは、Windows コンテナーでは機能しません。さらに、vNet 内の Windows コンテナーはエンドポイントに接続できません。そのため、Windows 仮想ネットワークコンテナーでマネージド ID トークンを生成することはできません。

次のステップ

この記事では、Azure Container Instances でのマネージド ID について、および次の方法について説明しました。

コンテナーグループでユーザー割り当て ID またはシステム割り当て ID を有効にする
ID に Azure Key Vault へのアクセス権を付与する
マネージド ID を使用して、実行中のコンテナーから Key Vault にアクセスする

詳細については、「Azure リソースの管理 ID について」を参照してください。
マネージド ID を使って Azure Container Instances から Key Vault にアクセスする例については、Azure Go SDK サンプルを参照してください。

次の方法で共有

Azure Container Instances でマネージド ID を使用する方法

マネージド ID を使用する理由

マネージド ID の有効化

マネージド ID の使用

前提条件

Azure Key Vault を作成する

例 1:ユーザー割り当ての ID を使用して Azure Key Vault にアクセスする

ID の作成

Key Vault へのアクセス権をユーザー割り当て ID に付与する

コンテナーグループでユーザー割り当て ID を有効にする

ユーザー定義 ID を使用して Key Vault からシークレットを取得する

例 2:システム割り当ての ID を使用して Azure Key Vault にアクセスする

コンテナーグループでシステム割り当て ID を有効にする

Key Vault へのアクセス権をコンテナーグループに付与する

コンテナーグループ ID を使用して Key Vault からシークレットを取得する

Resource Manager テンプレートを使用してマネージド ID を有効にする

ユーザー割り当て ID

システム割り当て ID

システム割り当て/ユーザー割り当て ID

マネージド ID を有効にするには YAML ファイルを使用します。

ユーザー割り当て ID

システム割り当て ID

システム割り当て/ユーザー割り当て ID

Windows コンテナー上のマネージド ID

次のステップ

フィードバック

その他のリソース

次の方法で共有

Azure Container Instances でマネージド ID を使用する方法

マネージド ID を使用する理由

マネージド ID の有効化

マネージド ID の使用

前提条件

Azure Key Vault を作成する

例 1:ユーザー割り当ての ID を使用して Azure Key Vault にアクセスする

ID の作成

Key Vault へのアクセス権をユーザー割り当て ID に付与する

コンテナー グループでユーザー割り当て ID を有効にする

ユーザー定義 ID を使用して Key Vault からシークレットを取得する

例 2:システム割り当ての ID を使用して Azure Key Vault にアクセスする

コンテナー グループでシステム割り当て ID を有効にする

Key Vault へのアクセス権をコンテナー グループに付与する

コンテナー グループ ID を使用して Key Vault からシークレットを取得する

Resource Manager テンプレートを使用してマネージド ID を有効にする

ユーザー割り当て ID

システム割り当て ID

システム割り当て/ユーザー割り当て ID

マネージド ID を有効にするには YAML ファイルを使用します。

ユーザー割り当て ID

システム割り当て ID

システム割り当て/ユーザー割り当て ID

Windows コンテナー上のマネージド ID

次のステップ

フィードバック

その他のリソース

コンテナーグループでユーザー割り当て ID を有効にする

コンテナーグループでシステム割り当て ID を有効にする

Key Vault へのアクセス権をコンテナーグループに付与する

コンテナーグループ ID を使用して Key Vault からシークレットを取得する