共用方式為

教學課程︰設定 Torii 來自動佈建使用者

  • 發行項

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

支援的功能

  • 在 Torii 中建立使用者。
  • 當 Torii 中的使用者不再需要存取時，將其移除。
  • 讓 Microsoft Entra ID 與 Torii 之間的使用者屬性保持同步。
  • 單一登入到 Torii (建議)。

必要條件

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

步驟 1：規劃佈建部署

  1. 了解佈建服務的運作方式 \(部分機器翻譯\)。
  2. 判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
  3. 判斷要在 Microsoft Entra ID 與 Torii 之間對應的資料。

步驟 2：設定 Torii 以支援使用 Microsoft Entra ID 進行佈建

  1. 登入 Torii 管理主控台。

  2. 瀏覽至 [設定] 頁面 [安全性]>，啟用 SCIM 切換開關。

    SCIM 切換開關的螢幕擷取畫面。

  3. 瀏覽至 [API 存取] 索引標籤。從這裡，您可以檢視及管理 Torii API 金鑰和 SCIM。

  4. 按一下 [產生 API 金鑰] 以產生新的 SCIM。

    產生 API 金鑰的螢幕擷取畫面。

  5. 選擇類型：SCIM。

  6. 新增 [描述] 並設定 [到期日]。 出於安全目的，我們建議在產生新金鑰時設定到期日。

  7. 按一下 [產生金鑰]。

  8. 複製並儲存該 API 金鑰，因為之後將無法再查看。 此值會輸入到您的 Torii 應用程式 [佈建] 索引標籤中的 [祕密權杖] 欄位。

  9. 按一下 [知道了]。

    建立 API 金鑰的螢幕擷取畫面。

    複製 API 金鑰的螢幕擷取畫面。

  10. Torii 租使用者 URL：https://api.toriihq.com/v1.0/scim/v2將會在 Torii 應用程式的 [布建] 索引標籤的 [租使用者 URL] 字段中輸入。

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

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

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

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

  • 如需其他角色，可以更新應用程式資訊清單以新增角色。

步驟 5：設定將使用者自動佈建至 Torii

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

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

  1. 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。

  2. 瀏覽至 [身分識別] > [應用程式] > [企業應用程式]

    企業應用程式刀鋒視窗的螢幕擷取畫面。

  3. 在應用程式清單中，選取 [Torii]。

    應用程式清單中 Torii 連結的螢幕擷取畫面。

  4. 選取 [佈建] 索引標籤。

    [佈建] 索引標籤的螢幕擷取畫面。

  5. 將 [佈建模式] 設定為 [自動]。

    [自動化佈建] 索引標籤的螢幕擷取畫面。

  6. 在 [管理員認證] 區段底下，輸入您的 Torii 租用戶 URL 和祕密權杖。 按一下 [測試連線]，以確保 Microsoft Entra ID 可以連線到 Torii。 如果連線失敗，請確定您的 Torii 帳戶具有管理員權限，然後再試一次。

    權杖的螢幕擷取畫面。

  7. 在 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。

    通知電子郵件的螢幕擷取畫面。

  8. 選取 [儲存]。

  9. 在 [對應] 區段下，選取 [將 Microsoft Entra 使用者同步處理至 Torii]。

  10. 在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Torii 的使用者屬性。 選取為 [比對] 屬性 (Property) 的屬性 (Attribute) 會用來比對 Torii 中的使用者帳戶，以進行更新作業。 如果您選擇變更比對目標屬性，則必須確保 Torii API 支援根據該屬性來篩選使用者。 選取 [儲存] 按鈕以認可所有變更。

    屬性 類型 支援篩選 Torii 的必要項目
    userName String ✓ ✓
    作用中 布林值
    name.givenName String
    name.familyName String
    userType String

    注意

    • userName 必須是具有有效網域的有效電子郵件地址。
    • userType(Torii 中的角色)：
    • 它必須與在 Torii 顯示的完全相同
    • 如果 userType 是空的，則使用者將取得預設的員工角色。
    • 使用者類型 (角色) 會出現在這裡。
    • 只有管理員使用者 (不是「員工」類型) 才會顯示在 Torii 的 UI 中
    • 請在這裡閱讀有關 Torii 屬性的更多資訊。

  11. 若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。

  12. 如要啟用 Torii 的 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。

    佈建狀態切換為開啟的螢幕擷取畫面。

  13. 透過在 [設定] 區段的 [範圍] 中選擇需要的值，可定義要佈建到 Torii 的使用者。

    佈建範圍的螢幕擷取畫面。

  14. 當您準備好要佈建時，按一下 [儲存]。

    [儲存佈建設定] 的螢幕擷取畫面。

針對 [設定] 區段的 [範圍] 中定義的所有使用者，此作業會啟動首次同步週期。 初始週期會比後續週期花費更多時間執行，只要 Microsoft Entra 佈建服務正在執行，大約每 40 分鐘就會發生一次。

步驟 6：監視您的部署

設定佈建後，請使用下列資源來監視部署：

  • 使用佈建記錄來判斷哪些使用者已佈建成功或失敗
  • 檢查進度列來查看佈建週期的狀態，以及其接近完成的程度
  • 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 在此 \(部分機器翻譯\) 深入了解隔離狀態。

更多資源

下一步