Azure Queue Storage とのパスワードレス接続を使用するようにアプリケーションを移行する

[アーティクル]
05/16/2023

Azure サービスへのアプリケーション要求は、アカウントアクセスキーまたはパスワードレス接続などの構成を使用して認証される必要があります。ただしアプリケーションには、可能であればパスワードレス接続を優先的に使用することをお勧めします。パスワードや秘密鍵を使用する従来の認証方法は、セキュリティリスクと複雑さが生じます。パスワードレス接続に移行する利点の詳細については、「Azure サービスのパスワードレス接続」ハブを参照してください。

次のチュートリアルでは、既存のアプリケーションを、パスワードレス接続を使用して接続するように移行する方法について説明します。アクセスキー、接続文字列、または他のシークレットベースのアプローチのどれを使用しているかに関係なく、これと同じ移行手順が適用される必要があります。

ローカルの開発環境を構成する

パスワードレス接続は、ローカル環境と Azure ホステッド環境の両方で機能するように構成できます。このセクションでは、ローカル開発のために個々のユーザーが Azure Queue Storage の認証を受けられるようにする構成を適用します。

ユーザーにロールを割り当てる

ローカルで開発する場合は、Queue Storage にアクセスするユーザーアカウントに正しいアクセス許可があることを確認します。キューデータの読み取りと書き込みを行うには、ストレージキューデータ共同作成者のロールが必要です。このロールを自分に割り当てるには、ユーザーアクセス管理者ロール、または Microsoft.Authorization/roleAssignments/write アクションを含む別のロールに割り当てられている必要があります。 Azure portal、Azure CLI、または Azure PowerShell を使用して、ユーザーに Azure RBAC ロールを割り当てることができます。ロールの割り当てに使用できるスコープの詳細は、スコープの概要ページを参照してください。

次の例では、ストレージキューデータ共同作成者ロールをユーザーアカウントに割り当てます。このロールは、ストレージアカウント内のキューデータに対する読み取りと書き込みのアクセス権を付与します。

Azure portal で、メインの検索バーまたは左側のナビゲーションを使ってストレージアカウントを見つけます。
ストレージアカウントの概要ページで、左側のメニューから [アクセス制御 (IAM)] を選びます。
[アクセス制御 (IAM)] ページで、[ロールの割り当て] タブを選びます。
上部のメニューから [+ 追加] を選択し、次に結果のドロップダウンメニューから [ロールの割り当ての追加] を選択します。
検索ボックスを使って、結果を目的のロールに絞り込みます。この例では、「ストレージキューデータ共同作成者」を検索し、一致する結果を選び、[次へ] を選びます。
[アクセスの割り当て先] で、[ユーザー、グループ、またはサービスプリンシパル] を選び、[+ メンバーの選択] を選びます。
ダイアログで、自分の Microsoft Entra ユーザー名 (通常は user@domain メールアドレス) を検索し、ダイアログの下部にある [選択] を選びます。
[レビューと割り当て] を選んで最終ページに移動し、もう一度 [レビューと割り当て] を行ってプロセスを完了します。

Azure CLI を使ってリソースレベルでロールを割り当てるには、まず az storage account show コマンドを使ってリソース ID を取得する必要があります。 --query パラメーターを使って、出力プロパティをフィルター処理することができます。

az storage account show \
    --resource-group '<your-resource-group-name>' \
    --name '<your-storage-account-name>' \
    --query id

前のコマンドからの出力 Id をコピーします。これで、Azure CLI の az role コマンドを使ってロールを割り当てることができます。

az role assignment create --assignee "<user@domain>" \
    --role "Storage Queue Data Contributor" \
    --scope "<your-resource-id>"

Azure PowerShell を使ってリソースレベルでロールを割り当てるには、まず Get-AzResource コマンドを使ってリソース ID を取得する必要があります。

Get-AzResource -ResourceGroupName "<yourResourceGroupname>" -Name "<yourStorageAccountName>"

前のコマンドの出力から Id の値をコピーします。これで、PowerShell の New-AzRoleAssignment コマンドを使ってロールを割り当てることができます。

New-AzRoleAssignment -SignInName <user@domain> `
    -RoleDefinitionName "Storage Queue Data Contributor" `
    -Scope <yourStorageAccountId>

重要

ほとんどの場合、ロールの割り当てが Azure に反映されるまでの時間は 1 分から 2 分ですが、まれに 8 分程度までかかる場合があります。初めてコードを実行したときに認証エラーを受け取る場合は、しばらく待ってから再試行してください。

ローカル開発の場合は、ロールを割り当てたのと同じ Microsoft Entra アカウントで認証されていることを確認します。 Azure CLI や Azure PowerShell などの一般的な開発ツールを使用して認証できます。認証に使用できる開発ツールは、言語によって異なります。

Azure CLI で次のコマンドを使って Azure にサインインします。

az login

Visual Studio Code から DefaultAzureCredential を操作するには、Azure CLI をインストールする必要があります。

Visual Studio Code のメインメニューで、[ターミナル] > [新しいターミナル] に移動します。

Azure CLI で次のコマンドを使って Azure にサインインします。

az login

PowerShell で次のコマンドを使って Azure にサインインします。

Connect-AzAccount

パスワードレス接続を使用するようにアプリケーションコードを更新する

Azure Identity クライアントライブラリは、次のエコシステムごとに、Azure へのパスワードレス認証を処理する DefaultAzureCredential クラスを提供します。

DefaultAzureCredential は、複数の認証方法をサポートしています。使用するメソッドは実行時に決定されます。このアプローチを採用すると、環境固有のコードを実装することなく、異なる環境 (ローカルと運用環境) で異なる認証方法をアプリに使用できます。 DefaultAzureCredential が資格情報を検索する順序と場所については、上記のリンクを参照してください。

.NET アプリケーションで DefaultAzureCredential を使用するには、Azure.Identity パッケージをインストールします:
```
dotnet add package Azure.Identity
```
ファイルの先頭に、次のコードを追加します:
```
using Azure.Identity;
```

Azure Queue Storage に接続する QueueClient オブジェクトを作成する箇所を、コード内で識別します。次の例に合わせてコードを更新します。

DefaultAzureCredential credential = new();

QueueClient queueClient = new(
     new Uri($"https://{storageAccountName}.queue.core.windows.net/{queueName}"),
     new DefaultAzureCredential());

Go アプリケーションで DefaultAzureCredential を使用するには、azidentity モジュールをインストールします:
```
go get -u github.com/Azure/azure-sdk-for-go/sdk/azidentity
```

ファイルの先頭に、次のコードを追加します:

import (
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
)

Azure Queue Storage に接続する QueueClient インスタンスを作成する箇所を、コード内で識別します。次の例に合わせてコードを更新します。

cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
    // handle error
}

serviceURL := fmt.Sprintf("https://%s.queue.core.windows.net/", storageAccountName)
client, err := azqueue.NewQueueClient(serviceURL, cred, nil)
if err != nil {
    // handle error
}

Java アプリケーションで DefaultAzureCredential を使用するには、次のいずれかの方法で azure-identity パッケージをインストールします。
1. BOM ファイルを含める。
2. 直接依存関係を含める。
ファイルの先頭に、次のコードを追加します:
```
import com.azure.identity.DefaultAzureCredentialBuilder;
```

Azure Queue Storage に接続する QueueClient オブジェクトを作成する箇所を、コード内で識別します。次の例に合わせてコードを更新します。

DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
    .build();
String endpoint = 
    String.format("https://%s.queue.core.windows.net/", storageAccountName);

QueueClient queueClient = new QueueClientBuilder()
    .endpoint(endpoint)
    .queueName(queueName)
    .credential(credential)
    .buildClient();

Node.js アプリケーションで DefaultAzureCredential を使用するには、@azure/identity パッケージをインストールします。
```
npm install --save @azure/identity
```
ファイルの先頭に、次のコードを追加します:
```
import { DefaultAzureCredential } from "@azure/identity";
```
Azure Queue Storage に接続する QueueClient オブジェクトを作成する箇所を、コード内で識別します。次の例に合わせてコードを更新します。
```
const credential = new DefaultAzureCredential();

const queueClient = new QueueClient(
  `https://${storageAccountName}.queue.core.windows.net/${queueName}`,
  credential
);
```

Python アプリケーションで DefaultAzureCredential を使用するには、azure-identity パッケージをインストールします:
```
pip install azure-identity
```
ファイルの先頭に、次のコードを追加します:
```
from azure.identity import DefaultAzureCredential
```

Azure Queue Storage に接続する QueueClient オブジェクトを作成する箇所を、コード内で識別します。次の例に合わせてコードを更新します。

credential = DefaultAzureCredential()

queue_client = QueueClient(
    account_url = "https://%s.blob.core.windows.net" % storage_account_name,
    queue_name = queue_name,
    credential = credential
)

必ず、QueueClient オブジェクトの URI のストレージアカウント名を更新してください。ストレージアカウント名は、Azure portal の概要ページで確認できます。

アプリをローカルで実行する

これらの変更をコードに対して行った後、アプリケーションをローカルで実行します。新しい構成では、Azure CLI、Visual Studio、IntelliJ などのローカルの資格情報を取得する必要があります。 Azure でユーザーに割り当てられたロールを使用して、アプリは、Azure サービスにローカルから接続できます。

Azure ホスティング環境を構成する

パスワードレス接続を使用するようにアプリケーションを構成し、ローカルから実行しました。そのアプリケーションを Azure にデプロイすれば、同じコードで Azure サービスに対する認証を行うことができます。以下のセクションでは、マネージド ID を使用してAzure Queue Storage に接続するようにデプロイされたアプリケーションを構成する方法について説明します。マネージド ID により、Microsoft Entra ID 認証をサポートするリソースに接続するときに使用される Microsoft Entra のマネージド ID がアプリケーションに提供されます。マネージド ID の詳細を確認してください。

マネージド ID を作成する

ユーザー割り当てマネージド ID は、Azure portal または Azure CLI を使用して作成できます。アプリケーションでは、ID を使用して他のサービスに対する認証が行われます。

Azure Portal
Azure CLI

Azure portal の上部で、"マネージド ID" を検索します。 [マネージド ID] の結果を選択します。
[マネージド ID] 概要ページの上部にある [+ 作成] を選択します。
[基本] タブで、次の値を入力します。
- サブスクリプション: 目的のサブスクリプションを選択します。
- リソースグループ: 目的のリソースグループを選択します。
- リージョン: ご自分の場所に近いリージョンを選びます。
- 名前: MigrationIdentity など、ID のわかりやすい名前を入力します。
ページ下部にある [確認と作成] を選択します。
検証チェックが完了したら、[作成] を選択します。 Azure で、新しいユーザー割り当て ID が作成されます。

リソースが作成されたら、[Go to resource] (リソースに移動) を選択して、マネージド ID の詳細を表示します。

ユーザー割り当てマネージド ID を作成するには、az identity create コマンドを使用します。

az identity create --name MigrationIdentity --resource-group <your-resource-group>

マネージド ID を Web アプリに関連付ける

作成したマネージド ID を使用するように Web アプリを構成する必要があります。 Azure portal または Azure CLI を使用して、アプリに ID を割り当てます。

ID をアプリに関連付けるには、Azure portal で次の手順を実行します。これらの同じ手順は、次の Azure サービスに適用されます。

Azure Spring Apps
Azure Container Apps
Azure の仮想マシン
Azure Kubernetes Service

Web アプリの概要ページに移動します。
左側のナビゲーションから、[ID] を選択します。
[ID] ページで、[ユーザー割り当て済み] タブに切り替えます。
[+ 追加] を選択して、[ユーザー割り当てマネージド ID の追加] ポップアップを開きます。
ID を作成するために使用したサブスクリプションを選択します。
名前で MigrationIdentity を検索し、検索結果から選択します。
[追加] を選択して、ID をアプリに関連付けます。

次の Azure CLI コマンドを使用して、ID をアプリに関連付けます。

az identity show コマンドを使用して、作成したマネージド ID の ID を取得します。次の手順で使用する出力値をコピーします。

az identity show --name MigrationIdentity -g <your-identity-resource-group-name> --query id

Azure App Service インスタンスにマネージド ID を割り当てるには、az webapp identity assign コマンドを使用します。

az webapp identity assign \
    --resource-group <resource-group-name> \
    --name <webapp-name>
    --identities <managed-identity-id>

Azure Spring Apps インスタンスにマネージド ID を割り当てるには、az spring app identity assign コマンドを使用します。

az spring app identity assign \
    --resource-group <resource-group-name> \
    --name <app-name> \
    --service <service-name>
    --user-assigned <managed-identity-id>

仮想マシンにマネージド ID を割り当てるには、az containerapp identity assign コマンドを使用します。

az containerapp identity assign \
    --resource-group <resource-group-name> \
    --name <app-name>
    --user-assigned <managed-identity-id>

仮想マシンにマネージド ID を割り当てるには、az vm identity assign コマンドを使用します。

az vm identity assign \
    --resource-group <resource-group-name> \
    --name <virtual-machine-name>
    --identities <managed-identity-id>

Azure Kubernetes Service (AKS) インスタンスにマネージド ID を割り当てるには、az aks update コマンドを使用します。

az aks update \
    --resource-group <resource-group-name> \
    --name <cluster-name> \
    --enable-managed-identity \
    --assign-identity <managed-identity-id> \
    --assign-kubelet-identity <managed-identity-id>

Azure CLI を使用して、Azure Compute ホスティング環境とターゲットサービスとの間でサービス接続をできます。 Service Connector CLI コマンドは、ID に適切なロールを自動的に割り当てます。サービスコネクタの詳細とサポートされるシナリオについては、概要ページを参照してください。

az identity show コマンドを使用して、作成したマネージド ID のクライアント ID を取得します。後で使用するために値をコピーします。
```
az identity show \
    --name MigrationIdentity \
    --resource-group <your-resource-group> \
    --query clientId
```

適切な CLI コマンドを使用して、サービス接続を確立します。

Azure App Service を使用している場合は、az webapp connection コマンドを使用します。

az webapp connection create storage-queue \
    --resource-group <resource-group-name> \
    --name <webapp-name> \
    --target-resource-group <target-resource-group-name> \
    --account <target-storage-account-name> \
    --user-identity "client-id=<your-identity-client-id>" "subs-id=<your-subscription-id>"

Azure Spring Apps を使用している場合は、az spring-cloud connection コマンドを使用します。

az spring-cloud connection create storage-queue \
    --resource-group <resource-group-name> \
    --service <service-instance-name> \
    --app <app-name> \
    --deployment <deployment-name> \
    --target-resource-group <target-resource-group> \
    --account <target-storage-account-name> \
    --user-identity "client-id=<your-identity-client-id>" "subs-id=<your-subscription-id>"

Azure Container Apps を使用している場合は、az containerapp connection コマンドを使用します。

az containerapp connection create storage-queue \
    --resource-group <resource-group-name> \
    --name <containerapp-name> \
    --target-resource-group <target-resource-group-name> \
    --account <target-storage-account-name> \
    --user-identity "client-id=<your-identity-client-id>" "subs-id=<your-subscription-id>"

マネージド ID にロールを割り当てる

次に、作成したマネージド ID に、ストレージアカウントへのアクセス許可を付与する必要があります。ローカル開発ユーザーの場合と同じように、マネージド ID にロールを割り当ててアクセス許可を付与します。

ストレージアカウントの概要ページに移動し、左側のナビゲーションから [アクセス制御 (IAM)] を選択します。
[ロールの割り当ての追加] を選択します
[ロール] 検索ボックスで「ストレージキューデータ共同作成者」を検索します。これはキューのデータ操作を管理する目的で一般的に使用されるロールです。ユースケースに合った適切なロールであれば何でも割り当てることができます。一覧から [ストレージキューデータ共同作成者] を選択し、[次へ] を選択します。
[ロールの割り当てを追加] 画面の [アクセスの割り当て先] オプションで [マネージド ID] を選択します。次に、[+ メンバーの選択] を選択します。
ポップアップで、作成したマネージド ID を名前で検索し、結果から選択します。 [選択] を選択してポップアップメニューを閉じます。
[次へ] を何度か選択して [レビューと割り当て] を選択すれば、ロールの割り当ては完了です。

Azure CLI を使ってリソースレベルでロールを割り当てるには、まず az storage account show コマンドを使ってリソース ID を取得する必要があります。 --query パラメーターを使って、出力プロパティをフィルター処理することができます。

az storage account show \
    --resource-group '<your-resource-group-name>' \
    --name '<your-storage-account-name>' \
    --query id

前のコマンドからの出力 ID をコピーします。これで、Azure CLI の az role assignment コマンドを使ってロールを割り当てることができます。

az role assignment create \
    --assignee "<your-username>" \
    --role "Storage Queue Data Contributor" \
    --scope "<your-resource-id>"

アプリケーションコードを更新する

Azure にデプロイする際に作成した特定のマネージド ID を検索するように、アプリケーションコードを構成する必要があります。シナリオによっては、アプリのマネージド ID を明示的に設定することで、他の環境 ID が誤って検出されて自動的に使用されるのを防ぐこともできます。

マネージド ID の概要ページで、クライアント ID の値をクリップボードにコピーします。
次の言語固有の変更を適用します。
- .NET
- Go
- Java
- Node.js
- Python
DefaultAzureCredentialOptions オブジェクトを作成し、それを DefaultAzureCredential に渡します。 ManagedIdentityClientId プロパティをクライアント ID に設定します。
```
DefaultAzureCredential credential = new(
    new DefaultAzureCredentialOptions
    {
        ManagedIdentityClientId = managedIdentityClientId
    });
```
AZURE_CLIENT_ID 環境変数をマネージド ID クライアント ID に設定します。 DefaultAzureCredential は、この環境変数を読み取ります。
managedIdentityClientId メソッドを呼び出します。クライアント ID を渡します。
```
DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
    .managedIdentityClientId(managedIdentityClientId)
    .build();
```
managedIdentityClientId プロパティをクライアント ID に設定して、DefaultAzureCredentialClientIdOptions オブジェクトを作成します。そのオブジェクトを DefaultAzureCredential コンストラクターに渡します。
```
const credential = new DefaultAzureCredential({
  managedIdentityClientId
});
```
DefaultAzureCredential コンストラクターの managed_identity_client_id パラメーターをクライアント ID に設定します。
```
credential = DefaultAzureCredential(
    managed_identity_client_id = managed_identity_client_id
)
```
構成の更新を適用するために、この変更を行った後にコードを Azure に再デプロイします。

アプリをテストする

更新したコードをデプロイしたら、ホストされているアプリケーションにブラウザーでアクセスします。ストレージアカウントに対してアプリから正常に接続できるはずです。 Azure 環境にロールの割り当てが反映されるまでに数分かかる場合があることに留意してください。これでローカル環境と運用環境のどちらでも動作するようにアプリケーションが構成されました。開発者がアプリケーション自体でシークレットを管理する必要はありません。

次の手順

このチュートリアルでは、アプリケーションをパスワードレス接続に移行する方法について説明しました。

この記事で説明されている概念の詳細については、次のリソースを参照してください。

Microsoft Entra ID を使用して BLOB へのアクセスを認可する
.NET の詳細については、10 分ではじめる .NET に関するページを参照してください。

次の方法で共有

Azure Queue Storage とのパスワードレス接続を使用するようにアプリケーションを移行する

ローカルの開発環境を構成する

ユーザーにロールを割り当てる

パスワードレス接続を使用するようにアプリケーションコードを更新する

アプリをローカルで実行する

Azure ホスティング環境を構成する

マネージド ID を作成する

マネージド ID を Web アプリに関連付ける

マネージド ID にロールを割り当てる

アプリケーションコードを更新する

アプリをテストする

次の手順

フィードバック

その他のリソース

次の方法で共有

Azure Queue Storage とのパスワードレス接続を使用するようにアプリケーションを移行する

ローカルの開発環境を構成する

ユーザーにロールを割り当てる

Azure にローカルでサインインする

パスワードレス接続を使用するようにアプリケーション コードを更新する

アプリをローカルで実行する

Azure ホスティング環境を構成する

マネージド ID を作成する

マネージド ID を Web アプリに関連付ける

マネージド ID にロールを割り当てる

アプリケーション コードを更新する

アプリをテストする

次の手順

フィードバック

その他のリソース

パスワードレス接続を使用するようにアプリケーションコードを更新する

アプリケーションコードを更新する