获取服务主体的 Microsoft Entra ID 令牌

2025-06-05

重要

本部分介绍如何为服务主体手动获取Microsoft Entra ID 令牌。

Azure Databricks 托管服务主体直接在 Azure Databricks 中进行管理。 Microsoft Entra ID 托管服务主体在 Microsoft Entra ID 中进行管理，这需要其他权限。 Databricks 建议在大多数用例中使用 Azure Databricks 托管服务主体。但是，Databricks 建议在必须同时向 Azure Databricks 和其他 Azure 资源进行身份验证的情况下使用 Microsoft Entra ID 托管服务主体。

若要创建 Azure Databricks 托管服务主体而不是 Microsoft Entra ID 托管服务主体，请参阅服务主体。

Databricks 不建议手动为 Microsoft Entra ID 服务主体创建 Microsoft Entra ID 令牌。这是因为每个 Microsoft Entra ID 令牌的生存期很短，通常在一小时内就会过期。在此时间之后，必须手动生成替换 Microsoft Entra ID 令牌。请改用实现 Databricks 客户端统一身份验证标准的参与工具或 SDK 之一。这些工具和 SDK 可以利用以下 Databricks 身份验证类型，自动生成并替换过期的 Microsoft Entra ID 令牌：

如果您没有服务主体，可以根据以下一组说明来创建一个：

在 Azure 门户中预配服务主体
使用 Azure CLI 预配服务主体

本文介绍在 Microsoft Entra ID 中定义的服务主体如何充当可在 Azure Databricks 中强制执行身份验证和授权策略的主体。 Azure Databricks 工作区中的服务主体可以具有与常规用户（用户主体）不同的精细访问控制。

服务主体充当客户端角色，并使用 OAuth 2.0 客户端凭据流来授权访问 Azure Databricks 资源。

可以在 Databricks 中或使用 Azure 门户中的以下过程管理服务主体。

还可以使用Microsoft身份验证库（MSAL）以编程方式为用户而不是服务主体获取Microsoft Entra ID 访问令牌。请参阅使用 MSAL 为用户获取Microsoft Entra ID 令牌。

在 Azure 门户中预配服务主体

登录到 Azure 门户。

注释

要使用的门户根据 Microsoft Entra ID 应用程序是在 Azure 公有云中运行还是在国家云或主权云中运行而异。有关详细信息，请参阅国家云。
如果有权访问多个租户、订阅或目录，请单击顶部菜单中的“目录 + 订阅”（目录包含筛选器）图标，以切换到要预配服务主体的目录。
在 “搜索资源”、“服务和文档”中，搜索并选择 “Microsoft Entra ID”。
单击“ + 添加 ”并选择 “应用注册”。
对于“名称”，请输入应用程序的名称。
在“支持的帐户类型”部分中，选择“仅组织目录中的帐户(单一租户)”。
单击“注册”。
在应用程序页的“概述”页上的“概要”部分中，复制以下值：
- 应用程序（客户端）ID
- 目录（租户）ID
若要生成客户端密码，请在 “管理”中单击“ 证书和机密”。

注释

使用此客户端密码生成 Microsoft Entra ID 令牌，以便使用 Azure Databricks 对 Microsoft Entra ID 服务主体进行身份验证。若要确定 Azure Databricks 工具或 SDK 是否可以使用 Microsoft Entra ID 令牌，请参阅该工具或 SDK 的文档。
在“客户端密码”选项卡上，单击“新建客户端密码” 。
在“添加客户端机密”窗格中的“说明”，输入客户端机密的说明。
对于“过期”，选择客户端机密的过期时间段，然后单击“添加”。
复制客户端密码的“值”并将其存储在安全位置，因为此客户端密码是应用程序的密码。

使用 Azure CLI 配置服务主体

请参阅使用 Azure CLI 创建Microsoft Entra ID（前为 Azure Active Directory）服务主体。

使用Microsoft标识平台 REST API 获取Microsoft Entra ID 访问令牌

重要

本部分介绍如何使用Microsoft标识平台 REST API 手动获取服务主体的 Microsoft Entra ID 令牌。

若要使用服务主体访问 Databricks REST API，请获取并使用服务主体的 Microsoft Entra ID 访问令牌。有关详细信息，请参阅第一种情况：使用共享机密访问令牌请求。

小窍门

还可以使用 Azure CLI 获取Microsoft Entra ID 访问令牌。请参阅使用 Azure CLI 获取Microsoft Entra ID 访问令牌。

收集以下信息：

参数	DESCRIPTION
`Tenant ID`	在 Microsoft Entra ID 中注册的相关应用程序的 `Directory (tenant) ID`。
`Client ID`	在 Microsoft Entra ID 中注册的相关应用程序的 `Application (client) ID`。
`Client secret`	在 Microsoft Entra ID 中注册的相关应用程序的客户端密码的 `Value`。

使用上述信息以及 curl 获取 Microsoft Entra ID 访问令牌。

curl -X POST -H 'Content-Type: application/x-www-form-urlencoded' \
https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token \
-d 'client_id=<client-id>' \
-d 'grant_type=client_credentials' \
-d 'scope=2ff814a6-3304-4ab8-85cb-cd0e6f879c1d%2F.default' \
-d 'client_secret=<client-secret>'

替换为：

<tenant-id> 使用已注册应用程序的租户 ID。
<client-id> 使用已注册应用程序的客户端 ID。
<client-secret> 具有已注册应用程序的客户端机密值。

不要更改 scope 参数的值。它表示 Azure Databricks 的编程 ID（2ff814a6-3304-4ab8-85cb-cd0e6f879c1d），以及默认作用域（/.default，URL 编码为 %2f.default）。

例如：

curl -X POST -H 'Content-Type: application/x-www-form-urlencoded' \
https://login.microsoftonline.com/a1bc2d34-5e67-8f89-01ab-c2345d6c78de/oauth2/v2.0/token \
-d 'client_id=33334444-dddd-5555-eeee-6666ffff7777' \
-d 'grant_type=client_credentials' \
-d 'scope=2ff814a6-3304-4ab8-85cb-cd0e6f879c1d%2F.default' \
-d 'client_secret=abc1D~Ef...2ghIJKlM3'

Microsoft Entra ID 访问令牌位于 access_token 调用输出中的值中。

使用 Azure CLI 获取Microsoft Entra ID 访问令牌

重要

本部分介绍如何使用 Azure CLI 手动获取服务主体的 Microsoft Entra ID 令牌。

若要使用服务主体访问 Databricks REST API，请获取并使用服务主体的 Microsoft Entra ID 访问令牌。

收集以下信息：

参数	DESCRIPTION
`Tenant ID`	在 Microsoft Entra ID 中注册的相关应用程序的 `Directory (tenant) ID`。
`Client ID`	在 Microsoft Entra ID 中注册的相关应用程序的 `Application (client) ID`。
`Client secret`	在 Microsoft Entra ID 中注册的相关应用程序的客户端密码的 `Value`。

请通过执行以下操作之一获取 Microsoft Entra ID 服务主体的正确 Azure 订阅 ID（如果你尚不知道此 ID）：
- 在 Azure Databricks 工作区的顶部导航栏中，单击用户名，然后单击 Azure 门户。在显示的 Azure Databricks 工作区资源页上，单击边栏中的“概述”。然后查找“订阅 ID”字段，其中包含订阅 ID。
- 使用 Azure CLI 运行 az databricks workspace list 命令，使用 --query 和 -o 或 --output 选项缩小结果范围。将 adb-0000000000000000.0.azuredatabricks.net 替换为你的工作区实例的名称，不包括 https://。在此示例中，输出中 00000000-0000-0000-0000-000000000000 后的 /subscriptions/ 是订阅 ID。
```
az databricks workspace list --query "[?workspaceUrl==\`adb-0000000000000000.0.azuredatabricks.net\`].{id:id}" -o tsv

# /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-rg/providers/Microsoft.Databricks/workspaces/my-ws
```
  如果显示了以下消息，则表示登录到了错误的租户：The subscription of '<subscription-id>' doesn't exist in cloud 'AzureCloud'.若要登录到正确的租户，必须再次运行 az login 命令，使用 -t 或 --tenant 选项指定正确的租户 ID。
  
  可以通过运行命令 curl -v <per-workspace-URL>/aad/auth 并查看输出 < ___location: https://login.microsoftonline.com/00000000-0000-0000-0000-000000000000 来获取 Azure Databricks 工作区的租户 ID，其中的 00000000-0000-0000-0000-000000000000 是租户 ID。另请参阅在 Azure 门户中获取订阅和租户 ID。
```
az login -t <tenant-id>
```
获得 Microsoft Entra ID 服务主体的正确 Azure 租户 ID、客户端 ID、客户端密码和订阅 ID 后，请使用 Azure CLI 运行 az login 命令来登录到 Azure。使用 --service-principal 选项，同时为在 Microsoft Entra ID 中注册的相关应用程序指定 Tenant ID (Directory (tenant) ID)、Client ID (Application (client) ID) 和 Client secret (Value) 参数的值。
```
az login \
--service-principal \
-t <Tenant-ID> \
-u <Client-ID> \
-p <Client-secret>
```
确认你已登录到已登录 Microsoft Entra ID 服务主体的正确订阅。为此，请运行 az account set 命令，使用 -s 或 --subscription 选项来指定正确的订阅 ID。
```
az account set -s <subscription-id>
```
通过运行 az account get-access-token 命令为已登录的 Microsoft Entra ID 服务主体生成 Microsoft Entra ID 访问令牌。使用 --resource 选项指定 Azure Databricks 服务的唯一资源 ID，即 2ff814a6-3304-4ab8-85cb-cd0e6f879c1d。可以使用--query和-o或--output选项在命令的输出中仅显示Microsoft Entra ID令牌的值。
```
az account get-access-token \
--resource 2ff814a6-3304-4ab8-85cb-cd0e6f879c1d \
--query "accessToken" \
-o tsv
```

使用服务主体的 Microsoft Entra ID 访问令牌来访问 Databricks REST API

重要

本部分介绍如何使用 curl 和服务主密钥的 Microsoft Entra ID 访问令牌来访问 Databricks REST API。

您可以不用curl，改为使用实现 Databricks 客户端统一身份验证标准的某个参与工具或 SDK。这些工具和 SDK 还会自动生成并替换过期Microsoft Entra ID 令牌，并利用以下 Databricks 身份验证类型：

服务主体作为 Databricks 用户，可以使用 Microsoft Entra ID 令牌对 Databricks REST API 进行身份验证。

如果服务主体在 Azure 中的目标工作区资源上具有“参与者”或“所有者”角色，那么它也可以将自己添加为工作区的管理员。如果服务主体是目标工作区的参与者或所有者，而你想要使用其 Microsoft Entra ID 令牌将其添加到工作区，请转到非 Azure Databricks 用户的服务主体的工作区级别 API 访问权限。

否则，请转到作为 Azure Databricks 用户和管理员的服务主体的 API 访问权限。

作为 Azure Databricks 用户和管理员的服务主体的 API 访问权限

若要完成此过程，必须先将服务主体添加到 Azure Databricks 帐户或工作区。可以使用 SCIM （帐户） API 将服务主体直接添加到帐户，而无需向其授予工作区访问权限。

可以使用服务主体 API 终结点将服务主体添加到工作区。同时，这还会将服务主体添加到你的 Azure Databricks 帐户中。例如：

使用 Databricks CLI 0.205 或更高版本（建议）：

添加服务主体：

databricks service-principals create --application-id 33334444-dddd-5555-eeee-6666ffff7777 --display-name "My Service Principal" -p <profile-name-that-references-calling-users-access-token>

更新服务主体的工作区权限：

databricks service-principals patch 1234567890123456 --json @update-service-principal.json -p <profile-name-that-references-access-token>

update-service-principal.json:

{
  "Operations": [
    {
      "op": "add",
      "path": "entitlements",
      "value": {
        "value": "workspace-acccess",
        "value": "allow-cluster-create",
        "value": "databricks-sql-access"
      }
    }
  ],
  "schema": ["urn:ietf:params:scim:api:messages:2.0:PatchOp"]
}

请参阅 Databricks CLI 的身份验证。

通过使用 curl：

curl -X POST \
-H 'Authorization: Bearer <access-token>' \
https://adb-1234567890123456.7.azuredatabricks.net/api/2.0/preview/scim/v2/ServicePrincipals \
-H 'Content-type: application/scim+json' \
-d @create-service-principal.json

create-service-principal.json:

{
  "displayName": "My Service Principal",
  "applicationId": "33334444-dddd-5555-eeee-6666ffff7777",
  "entitlements": [
    {
      "value": "allow-cluster-create"
    }
  ],
  "schemas": ["urn:ietf:params:scim:schemas:core:2.0:ServicePrincipal"],
  "active": true
}

如果存在以下任一情况，请转到非 Azure Databricks 用户的服务主体的工作区级别 API 访问权限：

要调用的 Azure Databricks REST API 需要工作区管理员访问权限，服务主体是工作区的成员，但当前没有工作区的管理员访问权限。
尚未将服务主体添加到目标 Azure Databricks 工作区。

收集以下信息。

参数	DESCRIPTION
Microsoft Entra ID 访问令牌	从使用 Microsoft 标识平台 REST API 获取 Microsoft Entra ID 访问令牌或使用 Azure CLI 获取 Microsoft Entra ID 访问令牌的请求中返回的 Microsoft Entra ID 访问令牌。

使用 Microsoft Entra ID 访问令牌与 curl，调用 Databricks REST API。例如：

使用 Databricks CLI 0.205 或更高版本（建议）：
```
databricks clusters list -p <profile-name-that-references-azure-ad-access-token>
```
请参阅 Databricks CLI 的身份验证。

通过使用 curl：
```
curl -X GET \
-H 'Authorization: Bearer <access-token>' \
https://<databricks-instance>/api/2.0/clusters/list
```
替换为：
- <access-token> 与 Microsoft Entra ID 访问令牌。
- <databricks-instance> 与 Azure Databricks 部署的每个工作区 URL。
- GET 和 /api/2.0/clusters/list（具有目标 Databricks REST API 的相应 HTTP 操作和终结点）。
例如：
```
curl -X GET \
-H 'Authorization: Bearer <access-token>' \
https://adb-1234567890123456.7.azuredatabricks.net/api/2.0/clusters/list
```

非 Azure Databricks 用户的服务主体的工作区级别 API 访问权限

如果存在以下任一情况，请遵循此过程：

要调用的 Azure Databricks REST API 需要工作区管理员访问权限，服务主体是工作区的成员，但当前没有工作区的管理员访问权限。
尚未将服务主体添加到目标 Azure Databricks 工作区。

要求：

服务主体需要在 Azure 中的目标工作区资源上具有“参与者”或“所有者”角色。

收集以下信息：

参数	DESCRIPTION
租户 ID	在 Azure 门户预配服务主体中 Microsoft Entra ID 中注册的相关应用程序的“目录(租户) ID”。
客户 ID	在 Microsoft Entra ID 中注册的相关应用程序的“应用程序(客户端) ID”。
客户密钥	在在 Azure 门户预配服务主体中创建的 Microsoft Entra ID 中注册的相关应用程序的客户端密码的“值”。
Microsoft Entra ID 访问令牌	从使用 Microsoft 标识平台 REST API 获取 Microsoft Entra ID 访问令牌或使用 Azure CLI 获取 Microsoft Entra ID 访问令牌的请求中返回的 Microsoft Entra ID 访问令牌。
订阅编号	与目标 Azure Databricks 工作区关联的 Azure 订阅的 ID（而不是名称）。若要访问此信息和以下信息，请参阅 “打开资源”。要打开目标资源，可以在 Azure 中搜索 Azure Databricks 服务类型以及你了解的有关目标 Azure Databricks 工作区的任何其他信息。
资源组名称	与目标 Azure Databricks 工作区关联的 Azure 资源组的名称。
工作区名称	目标 Azure Databricks 工作区在 Azure 中的名称。

使用上述某些信息与 curl，获取 Microsoft Entra ID 管理终结点访问令牌。

curl -X POST -H 'Content-Type: application/x-www-form-urlencoded' \
https://login.microsoftonline.com/<tenant-id>/oauth2/token \
-d 'client_id=<client-id>' \
-d 'grant_type=client_credentials' \
-d 'resource=https%3A%2F%2Fmanagement.core.windows.net%2F' \
-d 'client_secret=<client-secret>'

替换为：

<tenant-id> 使用已注册应用程序的租户 ID。
<client-id> 使用已注册应用程序的客户端 ID。
使用已注册应用程序的客户端机密值替换<client-secret>。

不要更改 resource 参数的值。它表示Microsoft Entra ID 管理终结点（https://management.core.windows.net/URL 编码为 https%3A%2F%2Fmanagement.core.windows.net%2F）。

例如：

curl -X POST -H 'Content-Type: application/x-www-form-urlencoded' \
https://login.microsoftonline.com/a1bc2d34-5e67-8f89-01ab-c2345d6c78de/oauth2/token \
-d 'client_id=33334444-dddd-5555-eeee-6666ffff7777' \
-d 'grant_type=client_credentials' \
-d 'resource=https%3A%2F%2Fmanagement.core.windows.net%2F' \
-d 'client_secret=abc1D~Ef...2ghIJKlM3'

Microsoft Entra ID 管理终结点访问令牌位于调用输出中的 access_token 值中。

使用 Microsoft Entra ID 管理终结点访问令牌、上述其余信息与 curl，调用 Databricks REST API，例如：
```
 curl -X GET \
 -H 'Authorization: Bearer <access-token>' \
 -H 'X-Databricks-Azure-SP-Management-Token: <management-access-token>' \
 -H 'X-Databricks-Azure-Workspace-Resource-Id: /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.Databricks/workspaces/<workspace-name>' \
 https://<databricks-instance>/api/2.0/clusters/list
```
替换为：
- <access-token> 与 Microsoft Entra ID 访问令牌。
  - <management-access-token> 与 Microsoft Entra ID 管理终结点访问令牌。
  - <subscription-id> 与目标 Azure Databricks 工作区关联的订阅 ID。
  - <resource-group-name> 与目标 Azure Databricks 工作区关联的资源组的名称。
  - 将 <workspace-name> 替换为指定的 Azure Databricks 工作区名称。
  - <databricks-instance> 与 Azure Databricks 部署的每个工作区 URL。
  - GET 和 /api/2.0/clusters/list（具有目标 Databricks REST API 的相应 HTTP 操作和终结点）。
  例如：
```
curl -X GET \
-H 'Authorization:Bearer <access-token>' \
-H 'X-Databricks-Azure-SP-Management-Token: abC1dE...ghIj23kl' \
-H 'X-Databricks-Azure-Workspace-Resource-Id: /subscriptions/12a345...bcd6789e/resourceGroups/my-resource-group/providers/Microsoft.Databricks/workspaces/my-workspace' \
https://adb-1234567890123456.7.azuredatabricks.net/api/2.0/clusters/list
```
向工作区进行身份验证后，服务主体将成为 Azure Databricks 工作区管理员，不再需要参与者或所有者角色才能访问工作区。

通过

获取服务主体的 Microsoft Entra ID 令牌

在 Azure 门户中预配服务主体

使用 Azure CLI 配置服务主体

使用Microsoft标识平台 REST API 获取Microsoft Entra ID 访问令牌

使用 Azure CLI 获取Microsoft Entra ID 访问令牌

使用服务主体的 Microsoft Entra ID 访问令牌来访问 Databricks REST API

作为 Azure Databricks 用户和管理员的服务主体的 API 访问权限

非 Azure Databricks 用户的服务主体的工作区级别 API 访问权限

反馈

其他资源