演習 - サービスプリンシパルとキーを作成する - Training

3 分

重要

この演習を行うには、独自の Azure サブスクリプションが必要です。また、料金が発生することがあります。 Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

玩具会社の Web サイトのデプロイパイプラインを作成する前に、サービスプリンシパルを作成し、それに Azure 環境へのアクセス権を付与する必要があります。この演習では、デプロイパイプラインに使用するサービスプリンシパルを作成します。

このプロセスでは、次のことを行います。

アプリケーション、サービスプリンシパル、キーを 1 回の操作で作成します。
キーを安全に処理します。
サービスプリンシパルが動作することを、その資格情報を使用して Azure にサインインすることで確認します。

この演習では、Microsoft Entra ディレクトリでアプリケーションとサービスプリンシパルを作成するためのアクセス許可が必要です。現在の Azure アカウントでこの要件を満たすことができない場合は、無料試用版を入手し、新しい Azure サブスクリプションとテナントを作成できます。また、この演習をスキップすることもできます。

Azure でサービスプリンシパルを使用するには、Visual Studio Code ターミナルから Azure アカウントにサインインする必要があります。

[ターミナル] メニューで、[新しいターミナル] を選択します。通常、ターミナルウィンドウは画面の下半分に表示されます。

ターミナルウィンドウの右側に示されているように、通常、既定のシェルは pwsh です。
[起動プロファイル] ドロップダウンリストを選択し、[Azure Cloud Shell (Bash)]を選択します。

新しいシェルが開きます。

Visual Studio Code ターミナルで、次のコマンドを実行して Azure にサインインします。
```
az login
```
開いたブラウザーで、Azure アカウントにサインインします。

このテンプレートを Azure にデプロイするには、Visual Studio Code ターミナルから Azure アカウントにサインインします。

[ターミナル] メニューで、[新しいターミナル] を選択します。通常、ターミナルウィンドウは画面の下半分に表示されます。

ターミナルウィンドウの右側に示されているように、通常、既定のシェルは pwsh です。
[起動プロファイル] ドロップダウンリストを選択し、[Azure Cloud Shell (PowerShell)]を選択します。

新しいシェルが開きます。

Visual Studio Code ターミナルで、次のコマンドを実行して Azure にサインインします。
```
Connect-AzAccount
```
開いたブラウザーで、Azure アカウントにサインインします。

サービスプリンシパルとキーを作成する

Visual Studio Code ターミナルで、この Azure CLI コマンドを実行してサービスプリンシパルを作成します。
```
az ad sp create-for-rbac --name ToyWebsitePipeline
```
Azure CLI に、別のアプリケーションが同じ表示名を持っているというエラーが表示される場合は、Microsoft Entra テナントを使用する他のユーザーが同じ名前のサービスプリンシパルを作成したことを意味します。 --name 値を他の一意な値に変更します。残りの演習に取り組む方法には影響しません。
前のコマンドの JSON 出力を確認します。次のプロパティがあります。
- appId: サービスプリンシパルのアプリケーション ID。
- password: サービスプリンシパルのキー。
- tenant:Microsoft Entra テナント ID。
これらの値を安全な場所にコピーします。後ほどこれらを使用します。

Visual Studio Code ターミナルで、これらの Azure PowerShell コマンドを実行してサービスプリンシパルを作成します。
```
$servicePrincipal = New-AzADServicePrincipal `
  -DisplayName ToyWebsitePipeline
```
次のコマンドを実行して、サービスプリンシパルのキーを取得します。
```
$servicePrincipalKey = $servicePrincipal.PasswordCredentials.SecretText
```
次のコマンドを実行して、サービスプリンシパルのアプリケーション ID、キー、Microsoft Entra テナント ID を表示します。
```
Write-Output "Service principal application ID: $($servicePrincipal.AppId)"
Write-Output "Service principal key: $servicePrincipalKey"
Write-Output "Your Azure AD tenant ID: $((Get-AzContext).Tenant.Id)"
```
値を安全な場所にコピーします。後ほどこれらを使用します。

警告

前述のコマンドの出力には、サービスプリンシパルのキーが含まれます。これらのコマンドを実行する場所に注意してください。たとえば、他のユーザーがそれらを表示できる可能性がある環境では実行しないでください。

サービスプリンシパルをテストする

サービスプリンシパルが作成されたので、資格情報を使用してサインインし、正常に作成されたことを確認できます。

サービスプリンシパルの資格情報を使用して、Visual Studio Code ターミナルでこの Azure CLI コマンドを実行してサインインします。プレースホルダーは、前の手順でコピーした値に置き換えてください。
```
az login --service-principal \
  --username APPLICATION_ID \
  --password PASSWORD \
  --tenant TENANT_ID \
  --allow-no-subscriptions
```
--allow-no-subscriptions 引数を含めることに注意してください。通常、az login コマンドを実行すると、アクセスできる Azure サブスクリプションが Azure CLI によって検索されます。サービスプリンシパルには、まだアクセス権が付与されていません。そのため、--allow-no-subscriptions 引数を使用して、Azure CLI がサブスクリプション一覧をチェックしてエラーを表示しないようにします。
前のコマンドの出力が JSON オブジェクトであり、これに、サービスプリンシパルのアプリケーション ID を示す user プロパティが含まれていることを確認します。この情報は、サービスプリンシパルが正常にサインインしたことを示します。
次のコマンドを使用して、サービスプリンシパルのアカウントからサインアウトします。
```
az logout
```

Visual Studio Code ターミナルで、この Azure PowerShell コマンドを実行します。これにより、サービスプリンシパルの資格情報の入力を求める安全なプロンプトが表示されます。ユーザー名とパスワードについては、前の手順のサービスプリンシパルのアプリケーション ID とキーをそれぞれ使用します。
```
$credential = Get-Credential
```
サービスプリンシパルの資格情報を使用して、Visual Studio Code ターミナルでこの Azure PowerShell コマンドを実行してサインインします。
```
Connect-AzAccount -ServicePrincipal `
  -Credential $credential `
  -Tenant TENANT_ID
```
前のコマンドの出力に、サービスプリンシパルのアプリケーション ID を示す Account プロパティと、空の SubscriptionName 値が含まれていることを確認します。この情報は、サービスプリンシパルが正常にサインインしたことを示します。
次のコマンドを使用して、サービスプリンシパルのアカウントからサインアウトします。
```
Logout-AzAccount
```

動作するサービスプリンシパルを用意できたので、これによる Azure 環境へのアクセスを承認する、次のステージに進むことができます。

続行

演習 - サービス プリンシパルとキーを作成する

Azure へのサインイン

Azure CLI を使用して Azure にサインインする

Azure PowerShell を使用して Azure にサインインする

サービス プリンシパルとキーを作成する

サービス プリンシパルをテストする

フィードバック

演習 - サービスプリンシパルとキーを作成する

サービスプリンシパルとキーを作成する

サービスプリンシパルをテストする