教學課程：設定 Playvox 來自動佈建使用者

此教學課程說明在 Playvox 與 Microsoft Entra ID 中設定自動佈建使用者所需遵循的步驟。 設定時，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，自動佈建和取消佈建使用者或群組至 Playvox。 如需有關此服務如何進行和運作的重要詳細資料及常見問題，請參閱使用 Microsoft Entra ID 將使用者佈建和取消佈建至 SaaS 應用程式。

支援的功能

• 在 Playvox 中建立使用者。
• 當使用者不再需要存取權時，將其從 Playvox 中移除。
• 讓 Microsoft Entra ID 與 Playvox 之間的使用者屬性保持同步。

必要條件

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

• Microsoft Entra 租用戶。
• 下列其中一個角色：應用程式系統管理員、雲端應用程式管理員或應用程式擁有者。
• Playvox 中具有超級管理員權限的使用者帳戶。

步驟 1：規劃佈建部署

1. 了解佈建服務的運作方式。

2. 判斷誰會在佈建範圍內。

3. 確定哪些資料要在 Microsoft Entra ID 與 Playvox 之間對應。

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

1. 登入 Playvox 管理主控台，並移至設定> API 金鑰。

2. 選取 [建立 API 金鑰]。

   

3. 輸入有意義的 API 金鑰名稱，然後選取 [儲存]。 產生 API 金鑰之後，請選取 [關閉]。

4. 在您建立的 API 金鑰上，選取 [詳細資料] 圖示。

   

5. 複製並儲存 BASE64 金鑰 值。 稍後，在 Azure 入口網站中，您會在 Playvox 應用程式的 [佈建] 索引標籤中的 [秘密權杖] 文字方塊中輸入此值。

   

步驟 3：從 Microsoft Entra 應用程式庫新增 Playvox

若要開始管理 Playvox 的佈建，請從應用程式庫將 Playvox 新增至您的 Microsoft Entra 租用戶。 若要進一步了解，請參閱快速入門：將應用程式新增到 Microsoft Entra 租用戶。

如果您先前已設定 Playvox 的單一登入 (SSO)，則可以使用相同的應用程式。 不過，我們建議您在剛開始測試整合時先建立個別的應用程式。

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

您可以使用 Microsoft Entra 佈建服務，根據應用程式的指派或是使用者或群組的屬性，界定所要佈建的人員。 如需根據指派界定要佈建至應用程式的人員，請參閱在 Microsoft Entra ID 中管理應用程式的使用者指派，將使用者和群組指派給應用程式。 若只根據使用者或群組的屬性來界定要佈建的人員，請使用範圍篩選器，如使用範圍篩選器的屬性型應用程式佈建所說明。

請記住下列幾點：

• 將使用者指派給 Playvox 時，您必須選取 [預設存取] 以外的角色。 具有 [預設存取] 角色的使用者會從佈建中排除，而且會在佈建記錄中標示為不具有效權限。 如果應用程式上唯一可用的角色是預設存取角色，您可以更新應用程式資訊清單，新增更多角色。

• 從小規模開始。 在推出給所有人之前，先使用一小部分的使用者或群組進行測試。 當佈建範圍是以指派的使用者或群組為基礎時，您可以將一或兩個使用者或群組指派給應用程式，以控制該集合的大小。 當佈建範圍包含所有使用者和群組時，您可以指定以 屬性為基礎的範圍篩選器 來限制測試集的大小。

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

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

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

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

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

   

3. 在應用程式清單中，搜尋並選取 [Playvox]。

   

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

   

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

   

6. 在 [管理員認證] 區段中，輸入您的 Playvox 租用戶 URL，如下所示：

   https://{tenant}.playvox.com/scim/v1

   輸入您稍早在步驟 2 中複製的秘密權杖。 接著，選取 [測試連線]，以確保 Microsoft Entra ID 可以連線到 Playvox。 如果連線失敗，請確定您的 Playvox 帳戶具有管理員權限並再試一次。

   

7. 在 [通知電子郵件] 文字輸入框中，輸入會收到佈建錯誤通知的個人或群組電子郵件地址。 接著選取 [發生失敗時傳送電子郵件通知] 核取方塊。

   

8. 選取 [儲存]。

9. 在 [對應] 區段中，選取 [將 Microsoft Entra 使用者同步至 Playvox]。

10. 在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Playvox 的使用者屬性。 選取為比對屬性的屬性會用來比對 Playvox 中的使用者帳戶以進行更新作業。 如果您選擇變更比對目標屬性，確定 Playvox API 支援根據該屬性來篩選使用者。 選取 [儲存] 認可任何變更。

    屬性	類型	支援篩選
    userName	String	✓
    作用中	布林值
    displayName	String
    emails[type eq "work"].value	String
    name.givenName	String
    name.familyName	String
    name.formatted	String
    externalId	String

11. 若要設定範圍篩選條件，請參閱範圍篩選器教學課程中的指示。

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

    

13. 仍在設定中，選擇您想要的範圍內的值，以定義要佈建到 Playvox 的使用者或群組。

    

14. 準備好要佈建時，請選取 [儲存]。

    

此作業會對在 [設定] 區段的 [範圍] 中所定義所有使用者和群組啟動首次同步處理週期。 初始週期所花費的時間比之後的週期長。 只要 Microsoft Entra 佈建服務在執行中，則之後的週期大約每 40 分鐘進行一次。

步驟 6：監視您的部署

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

• 使用佈建記錄來判斷哪些使用者已佈建成功或失敗。
• 檢查進度列來查看佈建週期的狀態，以及其接近完成的程度。
• 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 若要深入了解隔離狀態，請參閱應用程式佈建處於隔離狀態。

其他資源

• 管理企業應用程式的使用者帳戶佈建
• 什麼是搭配 Microsoft Entra ID 的應用程式存取和單一登入？

下一步

• 瞭解如何針對佈建活動檢閱記錄和取得報告