Microsoft Entra ID サービスプリンシパルを使った PowerShell ログイン

[アーティクル]
03/06/2024

次の手順に従って、PowerShell を使用して Microsoft Entra ID サービスプリンシパルで Azure Databricks にログインします。 Azure Databricks サービスプリンシパルについて詳しくは、「サービスプリンシパルを管理する」をご参照ください。

重要

Azure Databricks マネージドサービスプリンシパルは、Azure Databricks 内で直接管理されます。 Microsoft Entra ID マネージドサービスプリンシパルは、追加のアクセス許可が必要とされる Microsoft Entra ID 内で管理されます。 Databricks では、ほとんどのユースケースで Azure Databricks マネージドサービスプリンシパルを使用することをお勧めします。ただし Databricks では、Azure Databricks と他の Azure リソースを同時に認証する必要がある場合には、Microsoft Entra ID マネージドサービスプリンシパルを使用することをお勧めします。

Microsoft Entra ID マネージドサービスプリンシパルではなく Azure Databricks マネージドサービスプリンシパルを作成するには、「サービスプリンシパルを管理する」をご覧ください。

次の情報を集めます。

パラメーター	説明
`Tenant ID`	Microsoft Entra ID に登録された関連するアプリケーションの `Directory (tenant) ID`。
`Client ID`	Microsoft Entra ID に登録された関連するアプリケーションの `Application (client) ID`。
`Client secret`	Microsoft Entra ID に登録された関連するアプリケーションのクライアントシークレットの `Value`。

PowerShell を使用して次のコード行を 1 行ずつ実行して、最後に Connect-AzAccount コマンドレットを呼び出すことで、サービスプリンシパルを Azure にサインインさせます。
```
$SecurePassword = ConvertTo-SecureString -String "<Client-secret>" -AsPlainText -Force
$TenantId = "<Tenant-ID>"
$ApplicationId = "<Client-ID>"
$Credential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $ApplicationId, $SecurePassword
Connect-AzAccount -ServicePrincipal -TenantId $TenantId -Credential $Credential
```
Note

Connect-AzAccount コマンドレットが認識されないことを示すエラーメッセージが表示された場合、次のコマンドレットを実行してインストールします。
```
Install-Module -Name Az -Repository PSGallery -Force
```
サインイン済みのサービスプリンシパルの正しいサブスクリプションにサインインしていることを確認します。サインイン済みのサブスクリプションの名前と ID、およびサブスクリプションに関連するテナント ID を取得するには、次のコマンドレットを実行します。
```
Get-AzContext | Select-Object -ExpandProperty Subscription
```
正しいサブスクリプションがわからない場合、たとえば、ワークスペースナビゲーションバーでユーザー名をクリックし、Azure portal をクリックすることで Azure Databricks ワークスペースのサブスクリプション ID を取得できます。 Azure Databricks ワークスペースリソースページが表示されたら、サイドバーの [概要] をクリックします。次に、サブスクリプション ID が含まれる [サブスクリプション ID] フィールドを探します。

Azure portal にアクセスできないが、Azure Databricks アカウントコンソールにアクセスできる場合、次のように Azure Databricks ワークスペースの正しいサブスクリプションを取得できます。
1. ワークスペースのプログラム名を書き留めてください。これはワークスペースナビゲーションバーのユーザー名の横にあります。
2. ワークスペースナビゲーションバーでユーザー名をクリックし、[アカウントの管理] をクリックします。
3. サイドバーで、[ワークスペース] をクリックします。
4. [フィルターワークスペース] ボックスにワークスペースのプログラム名を入力し、Enter を押します。
5. 結果の一覧でワークスペースのプログラム名をクリックします。
6. サブスクリプション ID が含まれる [サブスクリプション ID] フィールドを書き留めます。
別のサブスクリプションに切り替える必要がある場合、Set-AzContext コマンドレットを実行します。-Name または -Subscription パラメーターを使用して正しいサブスクリプション名または ID を指定します。
```
Set-AzContext -Name "<subscription-name>"

# Or ...

Set-AzContext -Subscription <subscription-id>
```
"The subscription of '<subscription-id>' doesn't exist in cloud 'AzureCloud'." というメッセージが表示された場合、間違ったテナントにサインインしています。正しいテナントにサインインするためには、Connect-AzAccount コマンドレットをもう一度実行する必要があります。-Tenant オプションを使用して正しいテナント ID を指定してください。

Azure Databricks ワークスペースのテナント ID は、curl -v <per-workspace-URL>/aad/auth コマンドを実行し、< location: https://login.microsoftonline.com/00000000-0000-0000-0000-000000000000 という出力で探すことで確認できます。00000000-0000-0000-0000-000000000000 の部分がテナント ID です。「Azure portal でサブスクリプションとテナントの ID を取得する」も参照してください。
```
Connect-AzAccount -Tenant <tenant-id>
```

Microsoft Entra ID サービス プリンシパルを使った PowerShell ログイン

その他のリソース