共用方式為

教學課程：設定 Templafy OpenID Connect 來自動佈建使用者

  • 發行項

本教學課程旨在示範將 Microsoft Entra ID 設定為可對 Templafy OpenID Connect 自動佈建及取消佈建使用者和/或群組時，Templafy OpenID Connect 與 Microsoft Entra ID 中須執行的步驟。

注意

本教學課程說明建置在 Microsoft Entra 使用者佈建服務之上的連接器。 如需此服務執行方式、運作方式和常見問題的重要詳細資源，請參閱 使用 Microsoft Entra ID 將使用者佈建和取消佈建至 SaaS 應用程式。

必要條件

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

  • Microsoft Entra 租用戶。
  • Templafy 租用戶。
  • Templafy 中具有管理員權限的使用者帳戶。

步驟 1：規劃佈建部署

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

將使用者指派給 Templafy OpenID Connect

Microsoft Entra ID 會使用名為指派的概念，來判斷哪些使用者應接收對所選應用程式的存取權。 在自動佈建使用者的內容中，只有已指派至 Microsoft Entra ID 中應用程式的使用者和/或群組會進行同步處理。

設定並啟用自動佈建使用者之前，您應先決定 Microsoft Entra ID 中的哪些使用者和/或群組需要存取 Templafy OpenID Connect。 一旦決定後，您可以依照此處的指示，將這些使用者和/或群組指派給 Templafy OpenID Connect：

將使用者指派至 Templafy OpenID Connect 的重要秘訣

  • 建議將單一 Microsoft Entra 使用者指派至 Templafy OpenID Connect，以測試自動使用者佈建設定。 稍後可能會再指派更多的使用者及/或群組。

  • 將使用者指派給 Templafy OpenID Connect 時，您必須在 [指派] 對話方塊中選取任何有效的應用程式特有角色 (如果有的話)。 具有預設存取角色的使用者會從佈建中排除。

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

設定 Templafy OpenID Connect 以使用 Microsoft Entra ID 進行自動使用者佈建之前，您需要在 Templafy OpenID Connect 上啟用 SCIM 佈建。

  1. 登入您的 Templafy 管理主控台。 按一下 [管理]。

    Templafy 管理主控台

  2. 按一下 [驗證方法]。

    Templafy [管理] 區段的螢幕擷取畫面，其中已指出 [驗證方法] 選項。

  3. 複製 [SCIM API 金鑰] 值。 此值會輸入到 Templafy OpenID Connect 應用程式的 [佈建] 索引標籤的 [祕密權杖] 欄位。

    SCIM API 金鑰的螢幕擷取畫面。

若要以 Microsoft Entra ID 設定 Templafy OpenID Connect 來自動佈建使用者，您必須從 Microsoft Entra 應用程式庫將 Templafy OpenID Connect 新增至您的受控 SaaS 應用程式清單。

若要從 Microsoft Entra 應用程式庫新增 Templafy OpenID Connect，請執行下列步驟：

  1. 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
  2. 瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [新增應用程式]。
  3. 在 [從資源庫新增] 區段的搜尋方塊中，輸入 Templafy OpenID Connect，選取 [Templafy OpenID Connect]。
  4. 從結果面板中選取 [Templafy OpenID Connect]，然後新增應用程式。 將應用程式新增至您的租用戶時，請稍候幾秒鐘。 結果清單中的 Templafy OpenID Connect

步驟 4：設定將使用者自動佈建至 Templafy OpenID Connect

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

提示

您也可以選擇為 Templafy 啟用 OpenID ConnectL 型單一登入，方法是遵循 Templafy OpenID Connect 單一登入教學課程中提供的指示。 單一登入和自動使用者佈建可以分開設定，但這兩個功能是互補的。

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

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

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

    企業應用程式刀鋒視窗

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

    應用程式清單中的 Templafy OpenID Connect 連結

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

    [管理] 選項的螢幕擷取畫面，並已指出 [佈建] 選項。

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

    [佈建模式] 下拉式清單的螢幕擷取畫面，並已指出 [自動] 選項。

  6. 在 [管理員認證] 區段下的 [租用戶 URL] 中輸入 https://scim.templafy.com/scim。 在 [祕密權杖] 中輸入稍早擷取到的 [SCIM API-key] 值。 按一下 [測試連線]，以確保 Microsoft Entra ID 可以連線到 Templafy。 如果連線失敗，請確定您的 Templafy 帳戶具有管理員權限並再試一次。

    租用戶 URL + 權杖

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

    通知電子郵件

  8. 按一下 [檔案] 。

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

  10. 在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Templafy OpenID Connect 的使用者屬性。 選取為 [比對] 屬性的屬性會用來比對 Templafy OpenID Connect 中的使用者帳戶以進行更新作業。 選取 [儲存] 按鈕以認可所有變更。

    屬性 類型 支援篩選
    userName String
    作用中 布林值
    displayName String
    title String
    preferredLanguage String
    name.givenName String
    name.familyName String
    phoneNumbers[type eq "work"].value String
    phoneNumbers[type eq "mobile"].value String
    phoneNumbers[type eq "fax"].value String
    externalId String
    addresses[type eq "work"].locality String
    addresses[type eq "work"].postalCode String
    addresses[type eq "work"].region String
    addresses[type eq "work"].streetAddress String
    addresses[type eq "work"].country String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department String
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization String

    注意

    已針對此應用程式啟用結構描述探索功能。

  11. 在 [對應] 區段底下，選取 [將 Microsoft Entra 群組同步處理至 Templafy]。

  12. 在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Templafy OpenID Connect 的群組屬性。 選取為 [比對] 屬性的屬性會用來比對 Templafy OpenID Connect 中的群組以進行更新作業。 選取 [儲存] 按鈕以認可所有變更。

    屬性 類型 支援篩選
    displayName String
    成員 參考
    externalId String

    注意

    已針對此應用程式啟用結構描述探索功能。

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

  14. 若要對 Templafy OpenID Connect 啟用 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。

    佈建狀態已切換為開啟

  15. 透過在 [設定] 區段的 [範圍] 中選擇需要的值，可定義要佈建到 Templafy OpenID Connect 的使用者和/或群組。

    佈建範圍

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

    儲存佈建設定

    此作業會對在 [設定] 區段的 [範圍] 中定義的所有使用者和/或群組，啟動首次同步處理。 初始同步處理會比後續同步處理花費更多時間執行，只要 Microsoft Entra 佈建服務正在執行，這大約每 40 分鐘便會發生一次。 您可以使用 [同步處理詳細資料] 區段來監視進度，並遵循連結來佈建活動報告，內容會描述 Templafy OpenID Connect 上的 Microsoft Entra 佈建服務所執行之所有動作。

步驟 5：監視您的部署

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

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

變更記錄檔

  • 2023 年 5 月 4 日 - 已新增結構描述探索的支援。

更多資源

下一步