在工作區 OAuth 權杖要求中使用 authorization_details,以要求存取特定資源。 每個 Azure Databricks 服務定義其 token 所需的授權物件。
授權細節的運作方式
在傳送至 https://<databricks-instance>/oidc/v1/token 的 authorization_details 請求中,將 POST 作為表單參數傳送,其中 <databricks-instance> 是您的 <databricks-instance>,並帶有 Azure Databricks workspace instance name,例如 adb-1234567890123456.7.azuredatabricks.net。 該值是一個非空的 JSON 陣列,包含授權物件。 每個物件都有由您想要存取的服務所定義的 type 和欄位。
對於用戶端憑證請求,Azure Databricks 會在發出令牌前檢查服務主體是否擁有所請求的權限。 令牌回應與存取令牌包含核准的授權細節。 請求授權詳細資料不會授予服務主體權限。
OAuth 機器對機器(M2M)用戶端憑證授權支援此參數。
AI 搜尋權杖交換也使用它。 授權碼與刷新權杖授權會忽略提供給權杖端點的 authorization_details。
使用授權細節的服務
以下服務指南說明含有 authorization_details 的 Token 要求:
請求令牌
請依照前述清單中的服務指南,授予請求者對該資源的身份存取權,並建立所需的 JSON 陣列。 有些服務需要其他令牌請求參數,例如
resource。對於 M2M 請求,請依照「產生工作區層級存取權杖」。 將
authorization_details服務的值加入令牌請求:export AUTHORIZATION_DETAILS='<JSON-array-from-service-guide>' curl --request POST \ --url "https://<databricks-instance>/oidc/v1/token" \ --user "$CLIENT_ID:$CLIENT_SECRET" \ --data 'grant_type=client_credentials' \ --data 'scope=all-apis' \ --data-urlencode "authorization_details=$AUTHORIZATION_DETAILS"依照 M2M 指南所述,設定
CLIENT_ID和CLIENT_SECRET。 請將 替換為您的adb-1234567890123456.7.azuredatabricks.netAzure Databricks<databricks-instance>,例如<databricks-instance>,並將<JSON-array-from-service-guide>替換為服務指南中的 JSON 陣列。 請包含服務所需的任何額外參數,例如適用於 Zerobus Ingest 的resource。
若要從筆記本進行 AI 搜尋權杖交換,請改用「從筆記本取得 OAuth 令牌」。