教學課程：設定 Torii 來自動布建使用者

發行項
07/04/2024

本教學課程說明您需要在 Torii 和 Microsoft Entra ID 中執行的步驟，以設定自動使用者布建。設定時，Microsoft Entra ID 會自動使用 Microsoft Entra 布建服務將使用者布建和取消布建給 Torii 。如需此服務的用途、運作方式和常見問題等重要詳細資料，請參閱使用 Microsoft Entra ID 對 SaaS 應用程式自動佈建和取消佈建使用者。

支援的功能

在 Torii 中建立使用者。
當使用者不再需要存取權時，請移除 Torii 中的使用者。
讓用戶屬性在 Microsoft Entra ID 與 Torii 之間保持同步。
Torii 的單一登錄（建議）。

必要條件

本教學課程中概述的案例假設您已經具有下列必要條件：

一個 Microsoft Entra 租用戶
下列其中一個角色：應用程式系統管理員、雲端應用程式管理員，或應用程式擁有者。
具有 Torii 的系統管理員帳戶。

步驟 1：規劃佈建部署

了解佈建服務的運作方式 \(部分機器翻譯\)。
判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
決定要 Microsoft Entra ID 與 Torii 之間對應的數據。

步驟 2：設定 Torii 以支援使用 Microsoft Entra 標識符進行布建

登入 Torii 管理主控台。
流覽至 [設定] 頁面> [安全性]，啟用 SCIM 切換。
流覽至 [ API 存取] 索引標籤。您可以從這裏檢視及管理 Torii API 金鑰和 SCIM。
按兩下 [ 產生 API 金鑰 ] 以產生新的 SCIM。
選擇類型： SCIM。
新增 [描述 ] 並設定 [到期日]。基於安全性考慮，建議您在產生新金鑰時設定到期日。
按一下 [產生金鑰]。
複製並儲存 API 金鑰，因為下一步無法使用。此值將會在 Torii 應用程式的 [布建] 索引標籤的 [秘密令牌 ] 欄位中輸入。
按兩下 [取得]。
Torii 租使用者 URL：https://api.toriihq.com/v1.0/scim/v2將會在 Torii 應用程式的 [布建] 索引標籤的 [租使用者 URL] 字段中輸入。

步驟 3：從 Microsoft Entra 應用連結庫新增 Torii

從 Microsoft Entra 應用連結庫新增 Torii，以開始管理 Torii 的布建。如果您先前已設定 Torii for SSO，您可以使用相同的應用程式。不過，建議您在一開始測試整合時，建立個別的應用程式。在此深入了解從資源庫新增應用程式。

步驟 4：定義佈建範圍內的人員

Microsoft Entra 佈建服務可讓您根據對應用程式的指派，和/或根據使用者屬性，界定將要佈建的人員。如果選擇根據指派來界定將佈建至應用程式的人員，則可使用下列步驟將使用者指派給應用程式。如果選擇僅根據使用者或群組屬性來界定將要佈建的人員，即可使用如這裡所述的範圍篩選條件。

從小規模開始。在推出給所有人之前，先使用一小部分的使用者進行測試。當佈建範圍設為已指派的使用者時，您可將一或兩個使用者指派給應用程式來控制這點。當範圍設為所有使用者時，您可指定以屬性為基礎的範圍篩選條件。
如果需要其他角色，您可以更新應用程式資訊清單以新增角色。

步驟 5：設定 Torii 的自動使用者布建

本節將引導逐步設定 Microsoft Entra 佈建服務，以根據 Microsoft Entra ID 中的使用者和/或群組指派，在 TestApp 中建立、更新和停用使用者。

若要在 Microsoft Entra ID 中設定 Torii 的自動使用者布建：

以至少雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別] > [應用程式] > [企業應用程式]
在應用程式清單中，選取 [Torii]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [ 管理員認證] 區段下，輸入您的 Torii 租使用者 URL 和秘密令牌。按兩下 [ 測試連線 ] 以確保Microsoft Entra ID 可以連線到 Torii。如果連線失敗，請確定您的 Torii 帳戶具有管理員許可權，然後再試一次。
在 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在 [對應] 區段底下，選取 [同步處理Microsoft Entra 使用者至 Torii]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Torii 的用戶屬性。選取為 [比對] 屬性的屬性可用來比對 Torii 中的使用者帳戶以進行更新作業。如果您選擇變更比對目標屬性，您必須確定 Torii API 支援根據該屬性篩選使用者。選取 [儲存] 按鈕以認可所有變更。

屬性類型支援篩選 Torii 的必要專案

userName String ✓ ✓

作用中布林值

name.givenName String

name.familyName String

userType String
注意
- userName 必須是具有有效網域的有效電子郵件位址。
- userType（Torii 中的角色）：
- 它必須和出現在托裡伊一樣
- 如果 userType 是空的，則使用者會取得員工角色做為預設值。
- 使用者類型（角色）會出現在這裡。
- 只有系統管理員使用者（不是來自類型 “Employee”）會顯示在 Torii 的 UI 中
- 在這裡深入瞭解 Torii 的屬性。
若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。
若要啟用 Torii 的 Microsoft Entra 布建服務，請將 [設定] 區段中的 [布建狀態] 變更為 [開啟]。
在 [設定] 區段中，選擇 [範圍] 中的所需值，以定義您想要布建至 Torii 的使用者。
當您準備好要佈建時，按一下 [儲存]。