教學課程︰設定 Gong 來自動佈建使用者
此教學課程說明您在 Gong 與 Microsoft Entra ID 中設定自動使用者佈建所需的步驟。 設定時，Microsoft Entra ID 會使用 Microsoft Entra 佈建服務，自動佈建和取消佈建使用者和群組至 Gong。 如需此服務的用途、運作方式和常見問題等重要詳細資訊，請參閱使用 Microsoft Entra ID 自動對 SaaS 應用程式進行使用者佈建和取消佈建。
支援的功能
- 在 Gong 中建立使用者。
- 當使用者不再需要存取時，將其從 Gong 中移除。
- 讓 Microsoft Entra ID 與 Gong 之間的使用者屬性保持同步。
- 在 Gong 中佈建群組和群組成員資格。
必要條件
本教學課程中概述的案例假設您已經具有下列必要條件：
- Microsoft Entra 租用戶。
- 下列其中一個角色：應用程式管理員、雲端應用程式管理員，或應用程式擁有者。
- Gong 中具有技術管理員權限的使用者帳戶。
步驟 1：規劃佈建部署
- 了解佈建服務的運作方式 \(部分機器翻譯\)。
- 判斷誰會在佈建範圍 \(部分機器翻譯\) 內。
- 判斷要在 Microsoft Entra ID 與 Gong 之間對應哪些資料。
步驟 2：設定 Gong 以支援使用 Microsoft Entra ID 進行佈建
移至您的公司設定頁面 > [人員] 區域 > [小組成員佈建]。
選取 [Microsoft Entra ID] 作為佈建來源。
若要將資料擷取、工作區和權限設定指派給 Microsoft Entra 群組：
- 在 [指派設定] 區域中，按一下 [新增指派]。
- 為指派提供一個名稱。
- 在 [Microsoft Entra 群組] 區域中，選取您要定義其設定的 Microsoft Entra 群組。
- 在 [資料擷取] 區域中，為屬於此群組的人員選取首頁工作區和資料擷取設定。
- 在 [工作區和權限] 區域中，針對組織中的其他工作區設定權限設定檔。
- 在 [更新設定] 區域中，定義如何管理此指派的設定：
- 選取 [手動編輯]，在 Gong 中針對此指派中的使用者管理資料擷取和權限設定。 在建立指派之後：如果您在 Microsoft Entra ID 中對群組設定進行變更，則系統不會將它們推送至 Gong。 不過，您可以在 Gong 中手動編輯群組設定。
- (建議) 選取 [自動更新]，以對 Gong 中的資料擷取和權限設定提供 Microsoft Entra ID 控制權。 只有在建立指派時，才可在 Gong 中定義資料擷取和權限設定。 之後，只有在從 Microsoft Entra ID 推送時，才會將其他變更套用至群組中具有此指派的使用者。
- 按一下 [新增指派]。
對於沒有指派的組織 (步驟 3)，請為自動佈建的使用者選取要套用的權設限定檔。
在 [管理員的佈建設定] 區域中：
- 選取 [在匯入新小組成員時通知直接管理員與記錄的小組]，讓您的小組管理員隨時掌握情況。
- 選取 [管理員可以開啟或關閉其小組的資料擷取]，為您的小組管理員提供一些自主性。
提示
如需詳細資訊，請參閱小組成員佈建常見問題一文中的「什麼是管理員的佈建設定」。
按一下 [更新] 以儲存您的設定。
注意
如果您稍後從 Microsoft Entra ID 變更佈建來源，然後想要返回 Microsoft Entra ID 佈建，則必須對 Microsoft Entra ID 進行重新驗證。
步驟 3：從 Microsoft Entra 應用程式庫新增 Gong
從 Microsoft Entra 應用程式庫新增 Gong，以開始管理對 Gong 的佈建。 如果您先前已針對 SSO 設定 Zero，則可使用相同的應用程式。 不過，建議在一開始測試整合時，建立個別的應用程式。 在此深入了解從資源庫新增應用程式。
步驟 4：定義佈建範圍內的人員
Microsoft Entra 佈建服務可供根據對應用程式的指派，或根據使用者/群組的屬性，界定將要佈建的人員。 如果選擇根據指派來界定將佈建至應用程式的人員，則可使用下列步驟將使用者和群組指派給應用程式。 如果選擇僅根據使用者或群組屬性來界定將要佈建的人員，即可使用如這裡所述的範圍篩選條件。
從小規模開始。 在推出給所有人之前，先使用一小部分的使用者和群組進行測試。 當佈建範圍設為已指派的使用者和群組時，您可將一或兩個使用者或群組指派給應用程式來控制這點。 當範圍設為所有使用者和群組時，您可指定以屬性為基礎的範圍篩選條件。
如果需要其他角色，您可以更新應用程式資訊清單以新增角色。
步驟 5：設定使用者自動佈建至 Gong
本節將引導逐步設定 Microsoft Entra 佈建服務，以根據 Microsoft Entra ID 中的使用者和/或群組指派，在 Gong 中建立、更新和停用使用者和/或群組。
若要在 Microsoft Entra ID 中為 Gong 設定自動使用者佈建：
以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別]>[應用程式]>[企業應用程式]
在應用程式清單中，選取 [Gong]。
選取 [佈建] 索引標籤。
將 [佈建模式] 設定為 [自動]。
![佈建索引標籤 [自動]](common/provisioning-automatic.png)
在 [管理員認證] 區段中，按一下 [授權]，並確定您輸入了 Gong 帳戶的系統管理員認證。 按一下 [測試連線]，以確保 Microsoft Entra ID 可以連線至 Gong。 如果連線失敗，請確定您的 Gong 帳戶具有管理員權限，並再試一次。
在 [通知電子郵件] 欄位中，輸入應該收到佈建錯誤通知的個人或群組電子郵件地址，然後選取 [發生失敗時傳送電子郵件通知] 核取方塊。
選取 [儲存]。
在 [對應] 區段下，選取 [將 Microsoft Entra 使用者同步至 Gong]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Gong 的使用者屬性。 選取為 [比對] 屬性 (Property) 的屬性 (Attribute) 會用來比對 Gong 中的使用者帳戶，以進行更新作業。 如果您選擇變更比對目標屬性，則必須確保 Gong API 支援根據該屬性來篩選使用者。 選取 [儲存] 按鈕以認可所有變更。
屬性 類型 支援篩選 Gong 必要項目 userName String ✓ ✓ urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager String 作用中 布林值 title String emails[type eq "work"].value String ✓ name.givenName String ✓ name.familyName String ✓ phoneNumbers[type eq "work"].value String externalId String 地區設定 String timezone String urn:ietf:params:scim:schemas:extension:Gong:2.0:User:stateOrProvince String urn:ietf:params:scim:schemas:extension:Gong:2.0:User:country String 在 [對應] 區段中，選取 [將 Microsoft Entra 群組同步至 Gong]。
在 [屬性對應] 區段中，檢閱從 Microsoft Entra ID 同步處理至 Gong 的群組屬性。 選取為 [比對] 屬性 (Property) 的屬性 (Attribute) 會用來比對 Gong 中的群組以進行更新作業。 選取 [儲存] 按鈕以認可所有變更。
屬性 類型 支援篩選 Gong 必要項目 displayName String ✓ ✓ 成員 參考 若要設定範圍篩選，請參閱範圍篩選教學課程中提供的下列指示。
若要啟用適用於 Gong 的 Microsoft Entra 佈建服務，請在 [設定] 區段中，將 [佈建狀態] 變更為 [開啟]。
透過在 [設定] 區段的 [範圍] 中選擇需要的值，可定義要佈建到 Gong 的使用者和/或群組。
當您準備好要佈建時，按一下 [儲存]。
此作業會對在 [設定] 區段的 [範圍] 中所定義所有使用者和群組啟動首次同步處理週期。 初始週期會比後續週期花費更多時間執行，只要 Microsoft Entra 佈建服務正在執行，這大約每 40 分鐘便會發生一次。
步驟 6：監視您的部署
設定佈建後，請使用下列資源來監視部署：
- 使用佈建記錄來判斷哪些使用者已佈建成功或失敗
- 檢查進度列來查看佈建週期的狀態，以及其接近完成的程度
- 如果佈建設定似乎處於狀況不良的狀態，則應用程式將會進入隔離狀態。 在此 \(部分機器翻譯\) 深入了解隔離狀態。
變更記錄
- 03/23/2022 - 已新增群組佈建的支援。
- 04/21/2022 - emails[type eq "work"].value 已標示為必要屬性。