教學課程:設定 Peakon 以自動佈建使用者
本教學課程的目的是示範在 Peakon 和 Microsoft Entra ID 中執行的步驟,以將 Microsoft Entra ID 設定為自動對 Peakon 佈建和取消佈建使用者與/或群組。
注意
本教學課程說明建置在 Microsoft Entra 使用者佈建服務之上的連接器。 如需此服務執行方式、運作方式和常見問題的重要詳細資料,請參閱使用 Microsoft Entra ID 對 SaaS 應用程式自動佈建和取消佈建使用者。
此連接器目前為預覽版。 如需預覽版的詳細資訊,請參閱線上服務的通用授權條款。
必要條件
本教學課程中概述的案例假設您已經具有下列必要條件
- Microsoft Entra 租用戶。
- Peakon 租用戶。
- Peakon 中具有管理員權限的使用者帳戶。
注意
此整合也可從 Microsoft Entra US Government 雲端環境使用。 您可以在 Microsoft Entra US Government 雲端應用程式資源庫中找到此應用程式,並以您從公用雲端所做的相同方式進行設定。
將使用者指派給 Peakon
Microsoft Entra ID 使用稱為指派的概念來判斷哪些使用者應該接收所選應用程式的存取權。 在自動佈建使用者的情境中,只有已指派給 Microsoft Entra ID 應用程式的使用者與/或群組會進行同步。
設定並啟用自動佈建使用者之前,您應該先決定 Microsoft Entra ID 中的哪些使用者與/或群組需要存取 Peakon。 一旦決定後,您可以依照此處的指示,將這些使用者和/或群組指派給 Peakon:
將使用者指派給 Peakon 的重要秘訣
建議將單一 Microsoft Entra 使用者指派給 Peakon,以測試自動佈建使用者的設定。 其他使用者及/或群組可能會稍後再指派。
將使用者指派給 Peakon 時,您必須在 [指派] 對話方塊中選取任何有效的應用程式特有角色 (如果有的話)。 具有預設存取角色的使用者會從佈建中排除。
設定 Peakon 以進行佈建
登入您的 Peakon 管理主控台。 按一下 [組態]。
選取整合。
啟用 [員工佈建]。
複製 [SCIM 2.0 URL] 和 [OAuth 持有人權杖] 的值。 這些值會輸入至 Peakon 應用程式 [佈建] 索引標籤中的 [租用戶 URL] 和 [祕密權杖] 欄位。
從資源庫新增 Peakon
若要使用 Microsoft Entra ID 設定 Peakon 以自動佈建使用者,您必須將 Peakon 從 Microsoft Entra 應用程式資源庫新增至受控 SaaS 應用程式清單中。
- 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
- 瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [新增應用程式]。
- 在 [從資源庫新增] 區段中鍵入 Peakon,在搜尋方塊中選取 [Peakon]。
- 從結果面板選取 [Peakon],然後新增應用程式。 將應用程式新增至您的租用戶時,請稍候幾秒鐘。
設定將使用者自動佈建至 Peakon
本節將引導您逐步設定 Microsoft Entra 佈建服務,以根據 Microsoft Entra ID 中的使用者與/或群組指派,在 Peakon 中建立、更新和停用使用者與/或群組。
提示
建議您選擇為 Peakon 啟用 SAML 型單一登入,方法是遵循 Peakon 單一登入教學課程中提供的指示。 單一登入和自動使用者佈建可以分開設定,但這兩個功能是互補的。
在 Microsoft Entra ID 中為 Peakon 設定自動佈建使用者:
以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別]>[應用程式]>[企業應用程式]
在應用程式清單中,選取[Peakon]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在 [管理員認證] 區段下,分別在 [租用戶 URL] 和 [秘密權杖] 中輸入稍早擷取到的 [SCIM 2.0 URL] 和 [OAuth 持有人權杖] 值。 按一下 [測試連線],以確定 Microsoft Entra ID 可以連線至 Peakon。 如果連線失敗,請確定您的 Peakon 帳戶具有管理員權限並再試一次。
在 [通知電子郵件] 欄位中,輸入應該收到佈建錯誤通知的個人或群組電子郵件地址,然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
按一下 [檔案] 。
在 [對應] 區段底下,選取 [將 Microsoft Entra 使用者同步至 Peakon]。
在 [屬性對應] 區段中,檢閱從 Microsoft Entra ID 同步至 Peakon 的使用者屬性。 選取為 [比對] 屬性的屬性會用來比對 Peakon 中的使用者帳戶以進行更新作業。 選取 [儲存] 按鈕以認可所有變更。
若要設定範圍篩選,請參閱範圍篩選教學課程中提供的下列指示。
當您準備好要佈建時,按一下 [儲存]。
此作業會對在 [設定] 區段的 [範圍] 中定義的所有使用者和/或群組,啟動首次同步處理。 初始同步處理的執行時間比後續的同步處理要長,只要 Microsoft Entra 佈建服務仍在執行,後續的同步處理大約每 40 分鐘就會發生一次。 您可以使用 [同步處理詳細資料] 區段來監視進度,並遵循連結來佈建活動報告,當中會描述 Peakon 上 Microsoft Entra 佈建服務所執行的所有動作。
如需如何讀取 Microsoft Entra 佈建記錄的詳細資訊,請參閱關於使用者帳戶自動佈建的報告。
連接器限制
- Peakon 中的所有自訂使用者屬性都必須延伸自 Peakon 的自訂 SCIM 使用者延伸
urn:ietf:params:scim:schemas:extension:peakon:2.0:User
。