授權服務主體使用 OAuth 存取 Azure Databricks 資源。 對於無人值守的程序,例如自動化的 CLI 指令或腳本或應用程式的 REST API 呼叫,請使用機器對機器(M2M)認證。 這些流程可以使用統一認證或手動請求存取權杖。 使用 OAuth on-behalf-of(OBO)以互動方式充當服務主體,無需 OAuth 秘密。
Azure Databricks 會使用 OAuth 2.0 作為 UI 外部服務主體授權和驗證的慣用通訊協定。 統一客戶端驗證自動化令牌生成和刷新。 當服務主體登入並獲得同意時,OAuth 會發出存取權杖,供 CLI、SDK 或其他工具代表其使用。 每個存取權杖的有效期為一小時,之後會自動要求新權杖。
在本頁中,授權指的是使用 OAuth 授權服務主體存取 Azure Databricks 資源,而認證則指透過存取權杖驗證憑證。
如需更多高階詳細資料,請參閱 授權存取 Azure Databricks 資源。
備註
本頁涵蓋 Databricks 管理服務主體的 OAuth M2M 和 OAuth 代表使用者驗證(OBO)。 如果您使用 Microsoft Entra 管理服務主體,請參閱 「使用 Microsoft Entra 服務主體認證」。
授權服務主體的方式
Azure Databricks 支援以下幾種授權服務主體的方式:
帶有用戶端密鑰的機器對機器(M2M)OAuth: 用於無人值守的工作負載。 請參閱使用用戶端 ID 和用戶端密鑰透過 OAuth M2M 進行授權。 您可以透過以下方式之一授權:
- 自動(建議):使用支援的工具與 SDK(例如 Azure Databricks Terraform SDK)使用統一驗證。 此方法會自動處理權杖產生和重新整理,非常適合自動化或其他無人值守工作負載。
- 手動:使用 OAuth 用戶端憑證授權,將服務主體的用戶端 ID 和密碼換取存取權杖。 如果您的工具或 API 不支援統一驗證,請使用此方法。 您可能需要為您的應用程式建立自己的令牌刷新機制。 如需詳細資訊,請參閱 手動產生 OAuth M2M 存取權杖。
OAuth 代表使用者(OBO): 透過標準的使用者對機器(U2M)OAuth 流程,以您管理的服務主體身分行事,無需 OAuth 秘密。 當有人主導工作階段時,利用這個功能作為互動式存取。 請參考 使用 OAuth OBO 進行服務主體認證。
先決條件
在設定 OAuth 之前,請執行下列步驟:
- 建立 Azure Databricks 服務主體。 請參閱 將服務主體新增至您的帳戶。
- 移至服務主體的 [ 設定 ] 索引標籤,然後選取此工作區應該擁有的權利。
- 移至 [許可權] 索引標籤,並將存取權授與您想要管理和使用此服務主體的任何 Azure Databricks 使用者、服務主體和群組。 請參閱 誰可以管理和使用服務主體?。
使用 OAuth OBO 以服務主體身分進行驗證
OAuth 代表使用者 (OBO) 讓 OAuth 用戶端(如 Databricks CLI)以委派身分行事。 使用 OBO,當你透過標準的使用者對機器(U2M)OAuth 流程授權客戶端時,你可以委派一個你管理的服務主體,而非你自己的使用者身份。
Requirements
- 你在要以其身分進行驗證的服務主體上具有 服務主體管理員 角色。 如果你創建了服務主體,這個角色會自動生效。 請參閱 「管理服務負責人的角色」。
以服務主體身分驗證
啟動標準 U2M 流程。 以下範例使用 Databricks CLI:
databricks auth login --host <workspace-url>會開啟一個瀏覽器視窗以進行授權。 從下拉選單中選擇要認證的服務主體,然後授權該應用程式。
OAuth 令牌是以服務主體的身份發出的。
sub標記中的主張對應於所選服務主體。 要查看該代幣,請執行:databricks auth token --host <workspace-url>
此流程適用於任何支援標準 U2M 認證的應用程式。 完整步驟請參見 「自動授權與統一認證 」或 「手動產生 OAuth U2M 存取權杖」。
使用用戶端 ID 與密鑰進行 OAuth M2M 授權
對於自動化、腳本及 CI/CD 等無人值守工作負載,為服務主體應用程式建立一個用戶端密碼,並透過用戶端憑證(M2M)流程將其換成短壽命的存取權杖。
步驟 1:建立 OAuth 密鑰
若要使用 OAuth 授權存取 Azure Databricks 資源,您必須建立 OAuth 秘密。 密碼可用來產生用於驗證的 OAuth 存取權杖。 服務主體最多可以有五個 OAuth 秘密,而且每個秘密的有效期最長可達兩年。 Azure Databricks 會在 90 天未使用後自動刪除 OAuth 密碼。
帳戶管理員和工作區管理員可以建立服務主體的 OAuth 秘密。
- 按兩下頂端列中的使用者名稱,然後選取 [ 設定]。
- 點擊 身分識別和存取 標籤。
- 在 服務主體 旁,點選 管理。
- 選取服務主體。
- 按一下Secrets 分頁。
- 按一下 產生密碼。
- 設定密碼的存留期 (以天為單位) (最多 730 天)。
- 在 Scopes 中,選取此密鑰可使用的 API 範圍。 要限制祕密,請搜尋並選擇一個或多個作用域,例如
sql或jobs。 若要讓秘密存取服務主體授權的所有 API,請選擇 所有 API (不建議)。 參見 Scoped OAuth 祕密。 - 點選 「」 生成 「」。
- 複製顯示的密碼和用戶端 ID,然後按一下 完成。 秘密只會顯示一次。 用戶端識別碼與服務主體的應用程式識別碼相同。
帳戶管理員也可以從帳戶主控台建立 OAuth 密碼。 從 [ 使用者管理 ] 索引標籤中,選取服務主體,然後移至 [ 認證 & 秘密 ] 索引標籤。
範圍限定的 OAuth 密碼
預設情況下,OAuth 秘密可存取服務主體授權的所有all-apis API()。 具範圍限制的密鑰會將存取權限限制在特定的一組 API 存取範圍,例如 sql、jobs 或 unity-catalog。 由有範圍的秘密鑄造的 OAuth 存取權杖不能超過該秘密的範圍,這會限制秘密外洩或濫用的影響。 Databricks 建議僅將每個機密綁定到其整合所需的範圍。
未設定範圍而建立的密鑰(包括所有現有的密鑰)會保留 all-apis 存取權,且其行為與先前相同。
範圍是在你產生秘密時設定的,之後無法更改。 若要使用不同的範圍,請產生新的密鑰。 在 密鑰表中,按一下現有密鑰的 複製,即可建立一個具有相同範疇和有效期限的新密鑰。
Warning
具有 authentication 範圍的密鑰可以建立具有任何範圍的新權杖。 僅將此範疇套用於用來管理其他憑證的密鑰。
關於完整的範圍清單及每個範圍涵蓋的 API 操作,請參見 API 範圍。
步驟 2:使用 OAuth 授權
若要搭配統一驗證工具使用 OAuth 授權,您必須設定下列相關聯的環境變數、 .databrickscfg 欄位、Terraform 欄位或 Config 欄位:
- Azure Databricks 主機,指定為帳戶作業的
https://accounts.azuredatabricks.net或目標是每個工作區的URL,例如工作區作業的https://adb-1234567890123456.7.azuredatabricks.net。 - Azure Databricks 帳戶 ID,用於 Azure Databricks 帳戶作業。
- 服務主體客戶端識別碼。
- 服務主體密鑰。
若要執行 OAuth 服務主體驗證,請根據您使用的工具或 SDK,將以下內容整合到您的程式碼中:
環境
若要搭配工具或 SDK 使用特定 Azure Databricks 驗證類型的環境變數,請參閱 授權存取 Azure Databricks 資源 或工具或 SDK 的檔。 另請參閱 統一鑑別的環境變數和欄位, 以及 鑑別方法優先順序。
針對帳戶層級作業,請設定下列環境變數:
-
DATABRICKS_HOST,設定為 Azure Databricks 帳戶主控台網址的值 (https://accounts.azuredatabricks.net)。 DATABRICKS_ACCOUNT_IDDATABRICKS_CLIENT_IDDATABRICKS_CLIENT_SECRET
針對工作區層級作業,請設定下列環境變數:
-
DATABRICKS_HOST,設定為 Azure Databricks 個別工作區網址,例如https://adb-1234567890123456.7.azuredatabricks.net。 DATABRICKS_CLIENT_IDDATABRICKS_CLIENT_SECRET
個人檔案
在您的 檔案中,建立或識別含有下列欄位的 Azure Databricks .databrickscfg。 如果您建立設定檔,請將占位符替換成適當的值。 若要搭配工具或 SDK 使用配置檔,請參閱 授權存取 Azure Databricks 資源 或工具或 SDK 的文件。 另請參閱 統一鑑別的環境變數和欄位, 以及 鑑別方法優先順序。
針對帳戶層級作業,請在您的 .databrickscfg 檔案中設定下列值。 在此情況下,Azure Databricks 帳戶主控台網址為 https://accounts.azuredatabricks.net:
[<some-unique-configuration-profile-name>]
host = <account-console-url>
account_id = <account-id>
client_id = <service-principal-client-id>
client_secret = <service-principal-secret>
針對工作區層級作業,請在您的 .databrickscfg 檔案中設定下列值。 在此情況下,主機是 Azure Databricks 個別工作區網址,例如 https://adb-1234567890123456.7.azuredatabricks.net:
[<some-unique-configuration-profile-name>]
host = <workspace-url>
client_id = <service-principal-client-id>
client_secret = <service-principal-secret>
CLI
針對 Databricks CLI,請執行下列其中一項:
- 設定環境變數,如「 環境」 標籤上所指定。
- 請根據
.databrickscfg頁面的指定來設定您檔案中的值。
環境變數一律優先於 .databrickscfg 檔案中的值。
另請參閱 OAuth 計算機對電腦 (M2M) 驗證。
連線
備註
下列 Databricks Connect 版本支援 OAuth 服務主體驗證:
- 針對 Python,Databricks Connect for Databricks Runtime 14.0 或更高版本。
- 針對 Scala,適用於 Databricks Runtime 13.3 LTS 和更新版本的 Databricks Connect。 Databricks Runtime 13.3 LTS 和更新版本的 Databricks Connect 隨附的 Java 用 Databricks SDK 必須升級至 0.17.0 或以上版本。
在使用 Databricks Connect 時,您可以:
-
使用組態配置檔:如 [
.databrickscfg] 索引標籤中所述,設定檔案中的工作區層級值。也請將 設定cluster_id為工作區實例 URL。 -
使用環境變數: 設定與 [ 環境] 索引標籤上所示相同的值。也請將 設定
DATABRICKS_CLUSTER_ID為工作區實例 URL。
對於 Databricks Connect,如果你同時將某個值設為環境變數並在 .databrickscfg 中設定,則環境變數會優先。
若要使用這些設定初始化 Databricks Connect,請參閱 Databricks Connect 的計算組態。
VS Code
對於 Databricks IDE 擴充功能,請執行以下步驟:
- 在您的
.databrickscfg檔案中,按照 [設定檔] 索引標籤上的指定,設定 Azure Databricks 的 工作區層級作業 值。 - 在 Databricks IDE 擴充套件的 設定 窗格中,點選 「配置 Databricks」。
- 在 [命令面板] 中,針對 [Databricks 主機],輸入您的工作區專用網址,例如
https://adb-1234567890123456.7.azuredatabricks.net,然後按Enter。 - 在 命令面板中,選取 URL 清單中目標設定檔的名稱。
更多細節請參閱 Databricks IDE 擴充功能的設定授權。
Terraform(星體改造技術)
帳戶層級作業
對於預設身份驗證:
provider "databricks" {
alias = "accounts"
}
對於直接配置:
provider "databricks" {
alias = "accounts"
host = <retrieve-account-console-url>
account_id = <retrieve-account-id>
client_id = <retrieve-client-id>
client_secret = <retrieve-client-secret>
}
請用您自己的實作來取代 retrieve 預留位置,以便從主控台或其他配置儲存區(例如 HashiCorp Vault)中擷取值。 另請參閱 Vault 提供者。 在此情況下,Azure Databricks 帳戶主控台 URL 是 https://accounts.azuredatabricks.net。
工作區層級作業
預設設定:
provider "databricks" {
alias = "workspace"
}
對於直接配置:
provider "databricks" {
alias = "workspace"
host = <retrieve-workspace-url>
client_id = <retrieve-client-id>
client_secret = <retrieve-client-secret>
}
請用您自己的實作來取代 retrieve 預留位置,以便從主控台或其他配置儲存區(例如 HashiCorp Vault)中擷取值。 另請參閱 Vault 提供者。 在此情況下,主機是 Azure Databricks 每個工作區的 URL,例如 https://adb-1234567890123456.7.azuredatabricks.net。
如需有關使用 Databricks Terraform 提供者進行驗證的詳細資訊,請參閱驗證。
Python
帳戶層級作業
預設設定:
from databricks.sdk import AccountClient
a = AccountClient()
# ...
對於直接配置:
from databricks.sdk import AccountClient
a = AccountClient(
host = retrieve_account_console_url(),
account_id = retrieve_account_id(),
client_id = retrieve_client_id(),
client_secret = retrieve_client_secret()
)
# ...
請將預留位置 retrieve 替換為您自己的實作,以從主控台或其他組態儲存庫中擷取值,例如 Azure KeyVault。 在此情況下,Azure Databricks 帳戶主控台 URL 是 https://accounts.azuredatabricks.net。
工作區層級作業
預設設定:
from databricks.sdk import WorkspaceClient
w = WorkspaceClient()
# ...
對於直接配置:
from databricks.sdk import WorkspaceClient
w = WorkspaceClient(
host = retrieve_workspace_url(),
client_id = retrieve_client_id(),
client_secret = retrieve_client_secret()
)
# ...
使用您自己的方法替換 retrieve 以取得從主控台或其他配置存放區中取得值,例如 Azure KeyVault。 在此情況下,主機是 Azure Databricks 每個工作區的 URL,例如 https://adb-1234567890123456.7.azuredatabricks.net。
如需了解使用 Python 並實施統一驗證的 Databricks 工具和 SDK 的詳細資訊,請參閱:
備註
Databricks IDE 擴充套件使用 Python,但尚未實作 OAuth 服務主體認證。
JAVA
工作區層級作業
預設設定:
import com.databricks.sdk.WorkspaceClient;
// ...
WorkspaceClient w = new WorkspaceClient();
// ...
對於直接配置:
import com.databricks.sdk.WorkspaceClient;
import com.databricks.sdk.core.DatabricksConfig;
// ...
DatabricksConfig cfg = new DatabricksConfig()
.setHost(retrieveWorkspaceUrl())
.setClientId(retrieveClientId())
.setClientSecret(retrieveClientSecret());
WorkspaceClient w = new WorkspaceClient(cfg);
// ...
使用您自己的方法替換 retrieve 以取得從主控台或其他配置存放區中取得值,例如 Azure KeyVault。 在此情況下,主機是 Azure Databricks 每個工作區的 URL,例如 https://adb-1234567890123456.7.azuredatabricks.net。
如需了解使用 Java 並實作統一驗證的 Databricks 工具和 SDK 進行驗證的詳情,請參閱:
- 設定 Scala 的 Databricks Connect 用戶端(Scala 版 Databricks Connect 用戶端使用內建的 Java Databricks SDK 進行驗證)
- 使用 Azure Databricks 帳戶或工作區來驗證適用於 JAVA 的 Databricks SDK
Go
帳戶層級作業
預設設定:
import "github.com/databricks/databricks-sdk-go"
// Uses environment configuration automatically
a := databricks.Must(databricks.NewAccountClient())
對於直接配置:
import (
"github.com/databricks/databricks-sdk-go"
)
// ...
a := databricks.Must(databricks.NewAccountClient(&databricks.Config{
Host: retrieveWorkspaceUrl(),
ClientId: retrieveClientId(),
ClientSecret: retrieveClientSecret(),
}))
// ...
使用您自己的方法替換 retrieve 以取得從主控台或其他配置存放區中取得值,例如 Azure KeyVault。 在此情況下,Azure Databricks 帳戶主控台 URL 是 https://accounts.azuredatabricks.net。
工作區層級作業
預設設定:
import "github.com/databricks/databricks-sdk-go"
// Uses environment configuration automatically
w := databricks.Must(databricks.NewWorkspaceClient())
對於直接配置:
import "github.com/databricks/databricks-sdk-go"
// ...
w := databricks.Must(databricks.NewWorkspaceClient(&databricks.Config{
Host: retrieveAccountConsoleUrl(),
ClientId: retrieveClientId(),
ClientSecret: retrieveClientSecret(),
}))
// ...
使用您自己的方法替換 retrieve 以取得從主控台或其他配置存放區中取得值,例如 Azure KeyVault。 在此情況下,主機是 Azure Databricks 每個工作區的 URL,例如 https://adb-1234567890123456.7.azuredatabricks.net。
如需使用 Go 和實作 Databricks 用戶端統一驗證的 Databricks 工具和 SDK 進行驗證的詳細資訊,請參閱使用 Azure Databricks 帳戶或工作區驗證適用於 Go 的 Databricks SDK。
手動產生 OAuth M2M 存取權杖
本節適用於不支援 Databricks 統一驗證的工具或服務。 如果您需要手動產生、重新整理或使用 Azure Databricks OAuth 權杖進行 M2M 驗證,請遵循下列步驟。
若要產生 OAuth M2M 存取權杖,請使用服務主體的用戶端識別碼和 OAuth 密碼。 每個存取權杖的有效期為一小時。 到期後,請申請新的令牌。 您可以在帳戶或工作區層級產生權杖:
- 帳戶層級: 用於呼叫服務主體可存取的帳戶與工作區層級的帳戶層級與工作區層級 REST API。 請參閱產生帳戶層級存取權杖。
- 工作區層級: 用來在單一工作區內呼叫 REST API。 請參閱產生工作區層級存取權杖。
產生帳戶層級存取權杖
使用帳戶層級權杖來呼叫帳戶的 REST API,以及服務主體可以存取的任何工作區。
將下列 URL 取代
<account-id>為您的帳戶 ID,以建構權杖端點 URL。https://accounts.azuredatabricks.net/oidc/accounts/<my-account-id>/v1/token使用
curl來要求 OAuth 存取權杖。 Replace:-
將
<token-endpoint-URL>替換為上述 URL。 -
<client-id>與服務主體的用戶端 ID(應用程式 ID)。 -
<client-secret>使用服務主體的 OAuth 機密。
export CLIENT_ID=<client-id> export CLIENT_SECRET=<client-secret> curl --request POST \ --url <token-endpoint-URL> \ --user "$CLIENT_ID:$CLIENT_SECRET" \ --data 'grant_type=client_credentials&scope=all-apis'這會產生類似下列的回應:
{ "access_token": "eyJraWQiOiJkYTA4ZTVjZ…", "token_type": "Bearer", "expires_in": 3600 }範圍
all-apis將要求 OAuth 存取權杖,以允許服務主體呼叫任何其有權存取的 Databricks REST API。-
將
從回應中複製
access_token值。
產生工作區層級存取權杖
僅將工作區層級權杖與該工作區中的 REST API 搭配使用。
使用 Azure Databricks 工作區實例名稱來取代
<databricks-instance>和你的<databricks-instance>,以建構權杖端點 URL,例如 :https://<databricks-instance>/oidc/v1/token使用
curl來要求 OAuth 存取權杖。 Replace:-
將
<token-endpoint-URL>替換為上方的 URL。 -
<client-id>使用服務主體的用戶端 ID(應用程式 ID)。 -
<client-secret>與服務主體的 OAuth 機密。
export CLIENT_ID=<client-id> export CLIENT_SECRET=<client-secret> curl --request POST \ --url <token-endpoint-URL> \ --user "$CLIENT_ID:$CLIENT_SECRET" \ --data 'grant_type=client_credentials&scope=all-apis'這會產生類似下列的回應:
{ "access_token": "eyJraWQiOiJkYTA4ZTVjZ…", "token_type": "Bearer", "expires_in": 3600 }-
將
從回應中複製
access_token值。
備註
部分服務要求在工作區權杖請求中包含 authorization_details。 有關使用它的服務及如何將其加入令牌請求,請參閱「請求帶有授權詳情的 OAuth 令牌」。
承擔角色
服務主體在請求工作區層級存取權杖時,可以扮演該角色。 當服務主體擔任角色時,該角色的權限會取代服務主體的權限。 在 Azure Databricks 中,角色是以群組方式實作,服務主體必須擁有該群組的 Assume 權限。 欲了解更多資訊,請參閱基於角色的存取控制(RBAC)。
若要假設角色,請將 assume_group 參數加入權杖要求中:
export CLIENT_ID=<client-id>
export CLIENT_SECRET=<client-secret>
curl --request POST \
--url <token-endpoint-URL> \
--user "$CLIENT_ID:$CLIENT_SECRET" \
--data 'grant_type=client_credentials&scope=all-apis&assume_group=<group-id>'
請將 <group-id> 替換為該角色支援群組的數字 ID。
假設某角色具備以下要求與限制:
- 僅支援工作區層級的標記。 如果你在帳號層級的 token 請求中包含
assume_group,請求就會失敗。 - 服務主體與角色都必須被指派到目標工作空間。 角色假設不會取代服務主體的工作區指派。 請參見 「將服務主體指派到工作區 」及 「將群組指派到工作區」。
- 服務主體必須對該群組具有 Assume 權限。 若未達成,請求即告失敗。 要授予「Assume 權限」,請參閱 管理群組權限。
權杖建立後,用它呼叫工作區 API,無需再指定 assume_group 。
關於允許與拒絕的 SQL 查詢及稽核驗證的完整範例,請參見 教學:用 RBAC 限制 AI 代理的存取範圍。 關於其他認證方法,請參見 切換 RBAC 角色。
呼叫 Azure Databricks REST API
使用 OAuth 存取權杖來呼叫 帳戶層級 或 工作區層級 REST API。 若要呼叫帳戶層級 API,服務主體必須是帳戶管理員。
將令牌包含在 Bearer 身份驗證的授權標頭中。
範例帳戶層級 REST API 要求
此範例會列出帳戶的所有工作區。 Replace:
-
以服務主體的 OAuth 存取權杖取代
<oauth-access-token>。 -
<account-id>使用您的帳戶 ID。
export OAUTH_TOKEN=<oauth-access-token>
curl --request GET --header "Authorization: Bearer $OAUTH_TOKEN" \
'https://accounts.azuredatabricks.net/api/2.0/accounts/<account-id>/workspaces'
範例工作區層級 REST API 要求
此範例會列出工作區中所有可用的叢集。 Replace:
-
<oauth-access-token>搭配服務主體的 OAuth 存取權杖。 -
將
<databricks-instance>替換為 Azure Databricks 工作區執行個體名稱,例如adb-1234567890123456.7.azuredatabricks.net。
export OAUTH_TOKEN=<oauth-access-token>
curl --request GET --header "Authorization: Bearer $OAUTH_TOKEN" \
'https://<workspace-URL>/api/2.0/clusters/list'
疑難排解 OAuth M2M 驗證
使用這些步驟來修正服務主體的 Databricks OAuth M2M 驗證最常見的問題。
快速檢查
首先,驗證導致 OAuth M2M 驗證失敗的這些常見組態問題:
-
憑證:
DATABRICKS_CLIENT_ID設定為服務主體的應用程式 ID(用戶端 ID),且DATABRICKS_CLIENT_SECRET設定為 OAuth 密鑰值,兩者皆無額外空格。 -
主機:
DATABRICKS_HOST指向https://accounts.azuredatabricks.net用於帳戶操作或目標各工作區 URL,例如https://adb-1234567890123456.7.azuredatabricks.net,用於工作區操作。 請勿包括/api。 -
指派: 對於工作區令牌,服務主體會被指派給目標工作區。 當切換至某角色時,該角色也必須被指派到該工作區。 確認服務主體是否擁有 Assume 權限,並在權杖要求中包含
assume_group。 請參見 「扮演角色」。 - 權限: 由權杖使用的身份,無論是服務主體或預設角色,都擁有目標資源所需的權限。
-
衝突: 未設定任何衝突的變數,例如
DATABRICKS_USERNAME、DATABRICKS_TOKEN。 執行env | grep DATABRICKS並解除衝突設定。 - 工具: 使用 統一驗證及當前的 CLI 或 SDK 版本。
401 未經授權
可能的原因和修復方法:
-
錯誤的用戶端 ID 或密鑰: 重新複製
DATABRICKS_CLIENT_ID與DATABRICKS_CLIENT_SECRET。 如果不確定,請重新產生密碼。 - 過期密鑰: 如果目前密鑰已過期,請建立新密鑰。
- 錯誤的憑證簽發者: 對於 M2M,請使用 Databricks OAuth 憑證端點,而非您的 IdP 或雲端令牌端點。
-
主機不匹配: 如果您為工作區 API 進行驗證,
DATABRICKS_HOST必須是您呼叫的工作區 URL。
403 禁忌
可能的原因和修復方法:
-
缺少資源權限:授予權杖所使用的身份所需的權限,例如
CAN USECAN MANAGE叢集或 SQL 倉庫上的權限,以及對筆記本、工作或資料物件的物件層級權限。 對於角色範圍的權杖,請將這些權限授予該角色。 -
未指定工作區: 將服務主體指派至工作區。 對於角色範圍的權杖,也將該角色指派到工作區,授予服務主體 Assume 權限,並在建立權杖時包含
assume_group。 請參見 「扮演角色」。 - 管理員 API 存取權: 對於工作區管理 API,令牌所使用的身份必須是工作區管理員。對於帳戶管理 API,服務主體必須是帳戶管理員。角色假設僅支援工作區層級的權杖。
配置問題
症狀包括逾時、「找不到主機」、「找不到帳戶」或「找不到工作區」。
Fixes:
-
主機規則: 使用帳戶主控台的 URL 用於帳戶 API。 使用工作區 API 時請使用工作區的 URL。 不要包含
/api後綴。 -
帳戶 ID: 僅在帳戶層級操作時提供
DATABRICKS_ACCOUNT_ID。 從帳戶主控台使用UUID。 -
設定檔選擇: 如果您使用多個設定檔,請傳入
--profile <name>或設定DATABRICKS_CONFIG_PROFILE。
Connectivity
如果 OAuth M2M 驗證因網路問題而失敗,請使用下列測試來確認您的環境可以連線到 Databricks 端點:
-
DNS:
nslookup <your-host>(應回傳主機名稱的 IP 位址) -
TLS 與可達性:
curl -I https://<your-host>(應回傳 HTTP 狀態 200、401 或 403) - 企業網路: 確認代理或防火牆規則允許 HTTPS 至 Databricks 端點