使用 基於角色的存取控制(RBAC) 來限制 AI 代理對特定任務所需資料與資源的存取權限。 提供代理人一個範圍限定於某角色的 OAuth 代幣。 使用該權杖發出的請求會使用角色的權限,而非認證使用者或服務主體的更廣泛權限。
Scenario
AI 客服人員需要工單摘要與狀態,但不需要包含個人識別資訊(PII)的客戶聯絡資訊。 其認證服務主體擁有更廣泛的存取權限,能讀取兩個資料集。
在此範例中,support.tickets 結構描述包含工單摘要與狀態,但未顯示客戶個人識別資訊(PII)。 客戶聯絡資訊另行儲存在 support.customers.contact_details。
你建立 role-support-agent,授權它對 support.tickets 的讀取權限,並授予服務主體對其的 Assume 權限。 使用範圍限定於該角色的權杖時,代理程式可以讀取客服工單,但無法取得客戶的聯絡資訊。
該角色可繼承父群組的資料權限,且目錄或結構授權可套用於其下方的所有資料表。 在這個例子中,請確認這些授權是否讓該角色有存取客戶聯絡表的權限。 詳見 特權繼承。 更改共用存取授權會影響其他使用者和角色,因此請使用測試工作區,而非移除其他使用者的存取權限。
本教學適用於接受你提供的 OAuth 存取權杖的自訂、自行託管或第三方代理程式。 對於部署在 Databricks Apps 上的代理程式,請使用內建應用程式或使用者授權。 請參見 代理認證。
Prerequisites
- 一個啟用 Unity 目錄且啟用 RBAC 的工作區。 請參見 啟用RBAC。
- 需要帳號管理員或工作區管理員權限,才能建立角色、授予 Assume 權限,並將其指派給工作區。 請參閱 誰可以管理群組?。
- 對該
support目錄的擁有權,或在其上MANAGE。 - 工作區管理員權限,或對範例中使用的 SQL Warehouse 具有「可管理」權限。
- 現有的表格
support.tickets.open_cases與support.customers.contact_details。 使用虛構的測試數據,必要時在全文中將自己的名字替換。 - 分配給工作空間的服務主體,擁有 Databricks SQL 存取權限,可使用 SQL 倉儲,並有權限查詢兩個資料表。 它需要一個具備
sql範圍、可用於機器對機器(M2M)驗證的 OAuth 密鑰。 請參閱 步驟 1:建立 OAuth 密碼。 -
curl在一個可信賴的環境中,你可以請求和測試權杖。 - 可存取
system.access.audit以驗證代理人在該角色下活動的審核讀取者 詳見 驗證審計歸屬。
在此 OAuth M2M 範例中使用 Azure Databricks 管理的服務主體。 Microsoft Entra ID 的受管服務主體使用不同的認證設定。 請參見 使用 OAuth 授權服務主體存取至 Azure Databricks。
步驟 1:建立角色
在這個教學中,建立一個空的帳戶群組作為角色。
帳戶主控台
- 身為帳戶管理員,登入 帳戶控制台。
- 在側邊欄中,按一下 [使用者管理]。
- 在 [群組] 索引標籤上,按一下 [新增群組]。
- 輸入
role-support-agent。 請勿新增成員。 - 按一下 [確認]。
- 將群組指派到有 Databricks SQL 存取權的工作區。 請參閱 將群組指派給工作區。
工作區管理員設定
- 作為工作區管理員,請登入測試工作區。
- 按兩下頂端列中的使用者名稱,然後選取 [ 設定]。
- 點擊 身分識別和存取 標籤。
- 在 [群組] 旁邊,按一下 [管理]。
- 點選新增群組,然後新增。
- 按 Enter,然後選取 Databricks SQL 存取權限。
- 按一下 新增。 請勿新增成員。
這也會把群組指派到工作區,並授予你管理權限。
Databricks 的 SQL 存取權限授予 Databricks SQL 功能,包括儀表板、查詢及 SQL 倉庫。 這個範例使用 SQL 查詢。 如果你的代理也需要核心工作空間功能,如筆記本、作業、模型或管線,請授予工作空間存取權。 請參閱 存取權利。 你在第二步設定資料權限和倉儲權限。
在這個範例中,你是另外授予 Assume 權限,而不是將服務主體加入為成員。 成員資格也會將群組的權限加入服務主體本身的身分。
步驟 2:授權該角色存取支援工單
作為目錄擁有者或在 support 上具有 MANAGE 的使用者,執行:
GRANT USE CATALOG ON CATALOG support TO `role-support-agent`;
GRANT USE SCHEMA, SELECT ON SCHEMA support.tickets TO `role-support-agent`;
作為工作區管理員或擁有 Can manage on the warehouse 的使用者,請授予該角色對倉庫的存取權限:
- 在工作區側邊欄,點選 SQL 倉儲。
- 點選倉庫旁邊的
,然後點選 權限。
- 加
role-support-agent與 Can use。
結構描述層SELECT級授權適用於在 support.tickets 中的所有目前及未來的表格與檢視。 它不會授予對 support.customers 或其他結構描述的存取權。 若要限制角色只能在一個表格上,改在該表格上授予 SELECT 。 請參閱管理 Unity Catalog 中的權限。
步驟 3:授予可切換至該角色的權限
授予服務主體 Assume 權限,使用任一方法:
帳戶主控台
- 作為帳號管理員,打開帳號主控台並點選 使用者管理。
- 在 群組 標籤中,點選
role-support-agent。 - 點選 權限 標籤,然後點選 授予存取權。
- 搜尋並選擇服務主體,選擇 Assume,然後按一下 儲存。
工作區管理員設定
- 作為擁有管理權限的工作區管理員,請在測試工作區開啟 設定>身份與存取。
- 在 群組旁邊,點選 管理,然後選擇
role-support-agent。 - 點選 權限,然後 授權存取。
- 搜尋並選擇服務主體,選擇 Assume,然後按一下 儲存。
步驟 4:請求角色範圍的權杖
在你受信任的令牌請求環境中,設定以下環境變數:
-
DATABRICKS_HOST:工作區網址,包含https://且不含尾斜線。 -
CLIENT_ID以及CLIENT_SECRET:服務主體的應用程式 ID 與 OAuth 用戶端密碼。 -
ROLE_GROUP_ID:role-support-agent的數字識別碼。 帳號管理員可以在帳號主控台的群組網址末尾找到它。 帳號管理員、工作區管理員及群組管理員也能透過id取得群組的 資料。 -
DATABRICKS_SQL_WAREHOUSE_ID:步驟2中授予的倉庫ID。 它位於倉庫的 HTTP 路徑中的/sql/1.0/warehouses/之後。 如需取得 Azure Databricks 計算資源的連線詳細資訊,請參閱。
請使用參數 assume_group 與 sql OAuth 範圍來請求工作區層級令牌。 此範圍會將權杖限制為只能用於 SQL API。 該角色的資料權限決定了它可以查詢哪些資料表。 參見 Scoped OAuth 祕密。
要申請該權杖,請執行:
curl --request POST \
--url "$DATABRICKS_HOST/oidc/v1/token" \
--user "$CLIENT_ID:$CLIENT_SECRET" \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'scope=sql' \
--data-urlencode "assume_group=$ROLE_GROUP_ID"
設定 DATABRICKS_TOKEN 為回應中的 access_token 值。 利用這個 expires_in 數值來判斷何時申請更換。 帳號層級的令牌請求不支援 assume_group。 請參見 「切換角色」。
步驟五:驗證該代幣的存取權限
在提供代幣給代理前,先在可信環境中執行這些檢查。
首先,使用代表服務主體自身身分的權杖取得基準。 在第 4 步重複請求,但不加參數 assume_group,並暫時將 DATABRICKS_TOKEN 設為該權杖。 在此步驟執行兩個查詢並確認是否成功。 接著將 DATABRICKS_TOKEN 設回角色範圍的權杖,重複檢查。
查看支援工單
請用角色範圍權杖執行此請求:
curl --request POST \
--url "$DATABRICKS_HOST/api/2.0/sql/statements" \
--header "Authorization: Bearer $DATABRICKS_TOKEN" \
--header 'Content-Type: application/json' \
--data "{
\"warehouse_id\": \"$DATABRICKS_SQL_WAREHOUSE_ID\",
\"statement\": \"SELECT * FROM support.tickets.open_cases LIMIT 10\",
\"wait_timeout\": \"50s\"
}"
查詢會成功是因為該角色能讀取 support.tickets。 檢查回應 status.state 是否為 SUCCEEDED。 如果是 PENDING 或 RUNNING,則使用傳回的 statement_id 以相同標記取得結果:
curl --request GET \
--url "$DATABRICKS_HOST/api/2.0/sql/statements/<statement-id>" \
--header "Authorization: Bearer $DATABRICKS_TOKEN"
請參閱 語句執行 API:在倉庫上執行 SQL 以了解語句狀態與結果處理。
檢查是否已禁止存取客戶個人可識別資訊(PII)
使用相同的角色範圍權杖與 warehouse,執行:
curl --request POST \
--url "$DATABRICKS_HOST/api/2.0/sql/statements" \
--header "Authorization: Bearer $DATABRICKS_TOKEN" \
--header 'Content-Type: application/json' \
--data "{
\"warehouse_id\": \"$DATABRICKS_SQL_WAREHOUSE_ID\",
\"statement\": \"SELECT 1 FROM support.customers.contact_details LIMIT 1\",
\"wait_timeout\": \"50s\"
}"
如果該陳述仍在執行,請依前一節所述擷取結果。 查詢在 status.error 中因權限錯誤而失敗,儘管使用服務主體自身的權杖時會成功。 僅有 HTTP 成功回應並不代表查詢成功。 缺少資料表、過期的憑證或倉儲錯誤,並不能證明角色的資料權限設定正確。
檢查稽核歸因
使用具備 驗證審計歸屬 中所述存取權限的稽核讀取器。 檢查測試查詢事件 在 system.access.audit中 identity_metadata.run_as 識別授權角色, run_as_display_name 包含 role-support-agent,並 run_by 識別發起請求的服務主體。 審計資料會持續更新,因此近期事件可能不會立即顯示。 請參見 身分中繼資料參考。
步驟 6:設定代理程式
將代理的 Azure Databricks 用戶端設定為工作區 URL 及已驗證的角色範圍令牌。 只提供該權杖給代理,而非服務主體的 OAuth 秘密或其未設範圍的權杖。 角色範圍的令牌限制了使用該令牌所發出的請求。 它不會移除服務主體在其他會話中的權限。
對於使用 Databricks SDK for Python 的代理,請在代理的環境中設定 DATABRICKS_HOST 和 DATABRICKS_TOKEN ,然後初始化客戶端:
from databricks.sdk import WorkspaceClient
w = WorkspaceClient()
SDK 透過 統一認證從環境中讀取令牌。 提供存取權杖並不會給 SDK 申請新權杖所需的憑證。 對於長期運行的代理,安排一個受信任元件在令牌到期前請求並提供一個替換的角色範圍令牌。
可選:使用開發者身份
若在本地測試中使用使用者對機器(U2M)認證,請如步驟 3 授予參與開發者對 role-support-agent 具有 Assume 權限。 開發者如 安裝或更新 Databricks CLI 所述安裝 Databricks CLI,然後使用自己的登入及獨立設定檔進行認證:
databricks auth login --host <workspace-url> --profile support-agent
開發者在瀏覽器的 授權為... 下選取 role-support-agent,並點選 繼續,然後取得該個人資料的令牌:
databricks auth token --profile support-agent
開發者在第 5 步中將傳回的 access_token 作為 DATABRICKS_TOKEN 使用,以進行角色範圍查詢檢查。 這些請求的審核事件會將開發者識別為 run_by。 Databricks CLI 回傳的權杖會過期。 開發者在需要時會取回新的權杖。 請參見API(OAuth 存取權杖)。
清理
對於臨時測試,完成後移除代理的令牌設定,並撤銷為測試建立的 Assume 權限授予。 刪除該角色前,先確認該角色是否擁有資產或是否被其他工作負載使用。
下一步
| Resource | Description |
|---|---|
| 基於角色的存取控制(RBAC)限制 | 檢查哪些功能沒有支援,或在以角色身分運作時行為不同。 |
| 切換 RBAC 角色 | 使用其他支援的方法來切換至角色。 |