SCIM API 2.0

預覽

這個特性在公共預覽

磚支持SCIM或System for Cross-domain Identity Management,這是一個開放標準,允許您使用REST API和JSON自動化用戶配置。Databricks SCIM API遵循SCIM協議的2.0版本。

需求

SCIM 2.0 api

一個磚的工作區管理員可以調用所有SCIM API端點:

非管理用戶和服務主體可以調用端點,用戶獲取端點來顯示名稱和id,以及集團獲取端點來顯示組顯示名稱和id。

調用工作空間SCIM api

對於工作空間SCIM api,對於示例,將工作空間替換為< databricks-instance >工作空間的URL您的Databricks部署。

https//<-實例>/api/2.0/預覽/scim/v2/<api-端點>

頭參數

參數

類型

描述

授權(必需)

或者:

. netrc文件(如果使用旋度

字符串

設置為持票人<訪問令牌>

看到使用Databricks個人訪問令牌進行身份驗證學習如何使用UI和生成令牌令牌API 2.0學習如何使用API生成令牌。

重要!生成此令牌的Databricks管理員用戶不應該由您的身份提供者(IdP)管理。由IdP管理的Databricks管理用戶可以使用IdP解除配置,這將導致禁用您的SCIM配置集成。

而不是一個授權頭文件,您可以使用. netrc文件隨——netrc(或- n)選項。此文件存儲與代碼分離的機器名稱和令牌,並減少多次鍵入憑據字符串的需要。的. netrc的每個組合都包含一個條目< databricks-instance >和令牌。例如:

< databricks-instance >登錄令牌密碼<訪問令牌>

內容類型(寫操作所需)

字符串

設置為應用程序/ scim + json

接受(讀取操作所需)

字符串

設置為應用程序/ scim + json

賬戶SCIM api

SCIM API 2.0(帳戶管理員)僅對帳戶管理員可用。

上調用帳戶級SCIM APIaccounts.cloud.www.eheci.com域,而不是您的工作區域。例如:

https//賬戶com/api/2.0/賬戶/account_id/scim/v2/用戶/user_id

使用您的帳戶所有者或帳戶管理員用戶名和密碼與HTTP基本身份驗證。

過濾結果

使用過濾器返回用戶或組的子集。對於所有用戶,用戶用戶名和組displayName支持領域。管理員用戶可以對用戶進行過濾活躍的屬性。

操作符

描述

行為

情商

=

屬性值和操作符值必須相同。

不等於

屬性值和操作符值不相同。

有限公司

包含

運算符值必須是屬性值的子字符串。

西南

開始於

屬性必須以並包含操作符值開始。

而且

邏輯和

當所有表達式的值都為true時匹配。

邏輯或

當任何表達式的計算結果為true時匹配。

排序結果

對結果進行排序,使用sortBy而且排序方式查詢參數.默認是按ID排序。