教學課程：設定 Vonage 自動進行使用者佈建

發行項
07/17/2024

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

支援的功能

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

必要條件

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

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

步驟 1：規劃佈建部署

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

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

以管理使用者身分登入 Vonage 系統管理員入口網站。
瀏覽至左側功能表上的 [帳戶及單一登入帳戶] 。
選取［使用者設定] 索引標籤，開啟 [SCIM 使用者佈建]，然後按一下 [儲存]。

啟用 scim

步驟 3：從 Microsoft Entra 應用程式資源庫新增 Vonage

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

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

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

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

步驟 5：設定對 Vonage 的自動使用者佈建

注意

任何新增至 Vonage 的使用者都必須有名字、姓氏及電子郵件。否則整合將無法進行。

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

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

以至少雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別]>[應用程式]>[企業應用程式]
在應用程式清單中，選取 [Vonage]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
在進行下一個步驟之前，請確定您已獲授權為帳戶超級使用者。若要檢查使用者是否為帳戶超級使用者，請在 Vonage 管理員入口網站進行登入。您應該會在左上角看到與下圖類似的畫面。
在 [管理員認證] 區段中，按一下 [授權]，請確定輸入帳戶超級使用者認證，如果沒有要求您輸入認證，請確定您已使用帳戶超級使用者進行登入 (您可以在左上方檢查確認 http://admin.vonage.com/，下方您應該要見到「帳戶超級使用者」的名稱)。按一下 [測試連線]，以確認 Microsoft Entra ID 可以連線至 Vonage。如果連線失敗，請確定您的 Vonage 帳戶具有管理員權限，然後再試一次。
在 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在 [對應] 區段中，選取 [將 Microsoft Entra 使用者同步至 Vonage]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步到 Vonage 的使用者屬性。選取為 [比對] 屬性的屬性會用來比對 Vonage 中的使用者帳戶，以進行更新作業。如果您選擇變更比對目標屬性，則必須確保 Vonage API 支援根據該屬性來篩選使用者。選取 [儲存] 按鈕以認可所有變更。

屬性類型支援篩選

userName String ✓

作用中布林值

emails[type eq "work"].value String

name.givenName String

name.familyName String
若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。
若要啟用適用於 Vonage 的 Microsoft Entra 佈建服務，請將 [設定] 區段中的 [佈建狀態] 變更為 [開啟]。
透過在 [設定] 區段的 [範圍] 中選擇需要的值，以定義要佈建到 Vonage 的使用者和/或群組。
當您準備好要佈建時，按一下 [儲存]。