要求具有授權詳細資料的 OAuth 權杖

在工作區 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 要求:

請求令牌

  1. 請依照前述清單中的服務指南,授予請求者對該資源的身份存取權,並建立所需的 JSON 陣列。 有些服務需要其他令牌請求參數,例如 resource。

  2. 對於 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.net Azure Databricks <databricks-instance>,例如 <databricks-instance>,並將 <JSON-array-from-service-guide> 替換為服務指南中的 JSON 陣列。 請包含服務所需的任何額外參數,例如適用於 Zerobus Ingest 的 resource。

若要從筆記本進行 AI 搜尋權杖交換,請改用「從筆記本取得 OAuth 令牌」。