在 Control Hub 中啟用 Enter ID

在政府版Webex中,Entra ID (Azure AD) 精靈應用程式適用於 GCC 中度 Entra ID和 GCC 高 Entra ID客戶。

本文中描述的部分功能尚不適用於所有客戶。

開始之前

確保您有權存取 Entra ID帳戶,該帳戶具有以下權限:向應用程式授予租戶範圍的管理員同意。
1

登入 Control Hub使用完整管理員帳戶。

2

轉至組織設定 然後向下捲動至Microsoft Azure Active Directory精靈應用程式

3

按一下 設定 以開始設定。

4

(可選)對於政府Webex管理員,請選取進入全球進入 GCC 高 並按一下繼續

進入全球 將精靈傳送至 GCC 中級和商業的 Entra AD。進入 GCC 高 將精靈傳送至 GCC 高的 Entra AD。
5

驗證您的 Entra ID管理員帳戶。

如果您不是 Entra ID中的全域或特權角色管理員,則可以請求存取權以授予 Entra ID (Azure AD) 精靈應用程式的權限。

如果您在 Entra ID中具有完全管理員權限,則可以透過轉至 來檢閱和授予對請求的存取權身分 >應用程式 >企業應用程式。低於動,選取管理員同意請 求並按一下Cisco Webex身分整 合並選取複查權限並接受。此程序會向Webex應用程式授予一般驗證。

最後,按一下全部(預覽 )標籤,選取Cisco Webex身分整 合並按一下檢閱應用程式。低於安全性 >權限,按一下向Cisco授予管理員同意 授予在 Control Hub 中啟用 Entra ID所需的所有必要權限。

請參閱Microsoft支 援有關此過程的更多資訊。

6

複查權限並按一下 受授予該帳戶授權,以存取您的 Entra ID租用戶。

Cisco Webex身分是 Entra ID中的 Entra ID企業應用程式。精靈應用程式會連線至此應用程式以存取 Entra ID圖形 API。存取它所需的許可權是支援和使用它所需的最低許可權。

顯示可用許可權的影像。
權限 使用情況
管理此應用程式建立或擁有的應用程式

需要在 Entra ID Enterprise 中管理Cisco Webex身份識別應用程式,包括:

  • 在 Entra ID中建立/刪除此應用程式

  • 屬性對映設定

  • 重新命名 Entra ID中的應用程式

  • 啟用/停用自動佈建

讀取所有稽核記錄資料 用於存取Cisco Webex建稽核日誌,以讀取佈建歷史記錄。此資訊用於精靈應用程式中的同步摘要和同步報告功能。
讀取所有群組/讀取所有群組成員資格 從 Entra ID讀取群組清單,以允許成功設定群組同步範圍。

群組成員資格的更新可能需要長達 12 小時才能同步。如果在進行群組同步時新使用者尚未自動同步,您將需要再等 12 小時,讓新使用者同步到其群組。

查看所有使用者的完整設定檔 在同步範圍中新增使用者時使用。例如,此權限允許透過搜尋使用者並在使用者頁面上的表格中顯示使用者來讀取使用者資訊。
7

對於 SMB 客戶,請通過勾選同步預設值勾選 方塊並按一下繼續來接受預設 設定。對於企業客戶,請轉至下一步並繼續配置。

如果您接受預設設定,這表示您希望:
  • 將所有使用者同步至 Webex。
  • 接受預設屬性對對。
  • 啟用切換以同步所有使用者的設定檔圖片以顯示在 Webex 服務上。
  • 完成組配置後啟用自動同步。
顯示 Azure AD 同步預設設定選項的影像
8

企業客戶(超過 1000 個使用者)或想要手動設定設定的客戶,請按一下 性標籤,並對應屬性。按一下儲存

您可以將其他使用者屬性從 Entra ID對映至Webex,或使用變更現有的使用者屬性對映 性頁面。您可以確保正確設定來自訂對地圖。您對圖為使用者名稱的值非常重要。Webex 會使用使用者的電子郵件地址做為使用者名稱。依預設,Entra ID中的 userPrincipalName (UPN) 會對應 Control Hub 中的電子郵件地址(使用者名稱)。

在第一次設定期間,無法編輯對地圖。此時,無法完全構建對應的實例,且沒有自訂對應屬性的實例。但是,您可以在設定 完成 時按一下編輯以變更它。

9

按一下使用者標籤將使用者新增加至同步 範圍。

您可以輸入使用者名稱以在同步範圍中搜尋並新增使用者。​​​​​​​您還可以透過按一下右側的回收站圖示,從同步範圍中移除使用者。按一下儲存

如果您要從 Entra ID中全選使用者,請選取選取所有使用者。如果您選取它,則不需要選取範圍中的群組,因為此選項同時同步群組。

顯示已同步所有使用者的影像

我們不建議為 具有數十萬使用者的重要企業客戶使用選取所有使用者,因為初始化程式需要很長時間。如果您在 Control Hub 中意外同步許多使用者,則還需要更長時間來刪除這些使用者。

按一下儲存

10

組標籤中,您可以搜尋個別群組並將其新增至Webex。

  • 按一下同步群組成員 標籤以全選使用者。
  • 按一下同步子群組 標籤以選取特定子群組中的使用者。

預設情況下,只會同步所選群組中的使用者。轉至 多標籤並選取同步群組物 件您還想要同步群組本身。

顯示幕幕以新增或移除群組的影像
11

在更多 標籤 上,您可以設定一些進步同步選項:

  • 同步使用者頭像- 開啟此功能以允許Webex應用程式將所有範圍內使用者的頭像同步到Webex。更新使用者頭像時,使用者的頭像會在 Webex 中自動更新。它可能不會立即更新,因為它依賴更新通知來觸發更新。

  • 同步群組物件- 開啟此功能,以便所選的群組物件在群組標籤同步至Webex。

  • 啟用單一登入- 開啟此功能以為您的組織設定 OpenID Connect (OIDC) SSO 。

    如果您的組織已經有使用其中一個SAML選項啟用SSO ,您必須先停用SAML選項,然後才能在 Entra ID (Azure AD) 精靈應用程式中啟動 OIDC SSO 。

  • 識別和同步會議室物件- 開啟此功能可將會議室物件同步至Webex。

12

您可以決定是否允許立即或稍後進行同步。如果您選取現在 允許選項 ,它會將所有設定都用於即將進行的同步。如果您選取儲存 並允許稍後選項 ,則同步不會啟動,直到您允許自動同步。

顯示儲存組配置的選項的影像
13

應用程式與 Entra ID通訊,以"安裝;設定"組態並排定同步。

顯示設定成功的影像
同步完成後,下列其中一個結果會出現在工作狀 態欄位:
  • 使用中:同步成功。
  • 隔離多次失敗後,該同步工作已被隔離在 Entra ID中。請參閱Entra ID文 件獲取更多資訊。
  • 未執行此狀態僅在首次設定後出現。首次設定後,服務尚未執行。

您還可以按一下檢視摘 要若要查看其它資訊(譬如上次同步的時間和日期,以及同步、跳過或失敗的使用者數):

使用者

  • 已同步顯示成功同步至Webex的使用者數目。
  • 已跳過顯示在上次同步中跳過的使用者數。例如,Entra ID中未新增至 Entra ID (Azure AD) 精靈應用程式同步範圍的新使用者。這些使用者未同步至Webex;將它們新增至同步範圍,以將其同步至Webex。
  • 失敗:顯示無法同步的使用者數目。如需這些使用者同步失敗原因的相關資訊,請查看 Entra ID應用程式佈建稽核記錄。如果您需要立即同步這些使用者,您可以隨佈建使用者。

群組

  • 已同步顯示成功同步至Webex並在 Control Hub 中建立的群組數。
  • 待同步此狀態表示群組中的所有使用者尚未新增。使用者必須先成功同步至Webex。

將現有Cisco Webex Enterprise 應用程式設定移轉至 Entra ID (Azure AD) 精靈應用程式

若您已在 Entra ID中"安裝;設定"Cisco Webex Enterprise 應用程式,則可以自動將所有設定移轉至 Entra ID (Azure AD) 精靈應用程式。您可以在 Control Hub 中管理所有 Entra ID ,而不會丟失您先前的任何設定。

1

登入 Control Hub使用完整管理員帳戶。

2

轉至組織 設定 ,然後向下卷至目錄 同步區 段。

3

按一下 設定 以開始設定。

4

使用 Entra ID設定來驗證 Entra ID管理員帳戶。確保您使用的帳戶具有下一步中所述的許可權。

5

複查權限並按一下 受授予該帳戶授權,以存取您的 Entra ID租用戶。

Cisco Webex身分同步是 Entra ID中的 Entra ID企業應用程式。精靈應用程式會連線至此應用程式以存取 Entra ID圖形 API。存取它所需的許可權是支援和使用它所需的最低許可權。

顯示可用許可權的影像。
權限 使用情況
管理此應用程式建立或擁有的應用程式

需要在 Entra ID Enterprise 中管理Cisco Webex身份識別應用程式,包括:

  • 在 Entra ID中建立/刪除此應用程式

  • 屬性對映設定

  • 重新命名 Entra ID中的應用程式

  • 啟用/停用自動佈建

讀取所有稽核記錄資料 用於存取Cisco Webex建稽核日誌,以讀取佈建歷史記錄。此資訊用於精靈應用程式中的同步摘要和同步報告功能。
讀取所有群組/讀取所有群組成員資格 從 Entra ID讀取群組清單,以允許成功設定群組同步範圍。
查看所有使用者的完整設定檔 在同步範圍中新增使用者時使用。例如,此權限允許透過搜尋使用者並在使用者頁面上的表格中顯示使用者來讀取使用者資訊。
6

選取遷移現有的應用程式。

7

接受其他唯讀權限請求後,選取您要移轉至精靈應用程式的現有應用程式,然後選取續。

若所選的現有應用程式未將佈建使用者佈建為相同的 Control Hub,則移轉將會失敗。

8

移轉完成後,我們建議您進行演練 在啟用自動同步之前,請確保沒有任何錯誤。

執行演練

在啟用自動同步之前,我們建議您先執行演練以確保沒有任何錯誤。演練完成後,您可以下載演練報告以查看詳細資訊。報告中可用的欄位包括:

表 1. 演練報告欄說明
欄名說明
物件類型Entra ID中的物件類型,例如使用者或群組。
動作類型在同步期間將對物件執行的動作類型。可能的動作類型有:
  • 符合— Entra ID和 Control Hub 中的物件相符。
  • 新增- 物件將新增至 Control Hub。
  • 停用— 物件在 Control Hub 中,但物件已在 Entra ID中移除,或者未新增至同步範圍。同步後,物件將被停用。
Azure IDEntra ID中的物件的ID。
Azure 名稱Entra ID中的物件名稱。
Webex名稱Webex中的物件的名稱。
原因在同步期間動作類型將發生的原因。
1

登入 Control Hub使用完整管理員帳戶。

2

轉至組織 設定 ,然後向下卷至目錄 同步區 段。

3

按一下您要同步的實例旁的三個垂直點,然後選取練。

4

當演練完成後,按一下下載摘 要以 將報告下載為CSV 檔案。

啟用或停用自動同步

Entra ID (Azure AD) 精靈應用程式及其對應的後端服務會檢查是否啟用了自動同步,以確定何時將使用者或群組從 Entra ID同步到Webex。啟用自動同步以允許自動佈建使用者和群組同步。當您停用自動同步 精靈應用程式不會將任何內容同步到Webex,但會保留現有設定。

通常,使用者是每 40 分鐘同步一 次根據Microsoft策略。

1

以完全組織管理員的名登入 Control Hub。

2

轉至組織 設定 ,然後向下卷至目錄 同步區 段。

3

切換至右側以啟用自動 同步

若要停用此功能,請切換至 左側的自動同步。

編輯 Entra ID (Azure AD) 精靈應用程式設定

1

登入 Control Hub使用完整管理員帳戶。

2

轉至組織 設定 ,然後向下卷至目錄 同步區 段。

3

按一下編輯設定。

顯示用於刪除 Azure AD 實例的選項的影像
4

透過從左側欄中選取源自 Entra ID的屬性來自訂屬性對映。Webex Cloud 中的目標屬性位於右側欄。請參閱Entra ID (Azure AD) 精靈應用程式屬性對 映有關對映屬性的更多資訊。

顯示自訂屬性的影像
5

在使用者 群組 標籤 上,從同步範圍新增或移除使用者與群組。

嵌套的群組不會自動同步至雲端。確保選取要同步的群組中所嵌套的任何群組。
6

在更多 標籤 上,變更您的喜好設定(若需要)。

7

按一下 儲存 以儲存修改的組配置。

您的更新將下一次同步使用。Entra ID自動同步機制會處理使用者與使用者群組的同步。

編輯Webex實例名稱

變更Cisco Webex身份識別實例名稱在 Entra ID企業應用程式清單中的顯示方式。

1

登入 Control Hub使用完整管理員帳戶。

2

轉至組織 設定 ,然後向下卷至目錄 同步區 段。

3

按一下編輯實例名稱。

顯示用於刪除 Azure AD 實例的選項的影像
4

輸入新的實例名稱,然後按一下存。

刪除 Entra ID (Azure AD) 精靈應用程式設定

當您刪除 Entra ID (Azure AD) 精靈應用程式時,它會移除 Entra ID同步的設定。Webex或 Entra ID未保留設定。如果您將來想要使用 Entra ID同步,您將需要進行完全重新設定。

勿從 Entra ID中刪除Cisco Webex應用程式。

1

登入 Control Hub使用完整管理員帳戶。

2

轉至組織 設定 ,然後向下卷至目錄 同步區 段。

3

按一下刪除實例。

顯示用於刪除 Azure AD 實例的選項的影像
4

在刪除 Azure AD 實例? 頁面中 ,如果要從 Webex 移除同意協定,請選取撤銷 Azure AD 管理員同意。如果您選取此選項,則必須輸入您的認證並再次授予許可權。

顯示刪除視窗以刪除 Azure AD 實例的影像
5

按一下刪除

隨選將使用者佈建為Webex

您可以立即將使用者佈建為Webex (獨立於 Entra ID同步),並立即檢查結果。這有助於在安裝期間對問題進行疑難排解。

1

登入 Control Hub使用完整管理員帳戶。

2

轉至組織設 定並向下捲動至目錄同 步區段。

3

按一下隨選佈建使用者。

顯示用於刪除 Azure AD 實例的選項的影像
4

搜尋並選取您要佈建的使用者,然後按一下建。

5

完成後,會顯示以下結果之一:

  • 佈建成功:已在Webex中成功建立新使用者。
  • 已跳過佈建:由於某種原因,佈建被跳過,通常是因為使用者已存在。詳細資訊出現在結果摘 要頁面。
  • 佈建失敗:佈建失敗。詳細資訊出現在結果摘 要頁面。
6

按一下 試以再次佈建相同使用者(若其跳過或失敗)。

7

按一下佈建其他使用 者以返回佈建頁面。

8

按一下 成當您完成後。

將 Entra ID驗證的網域匯入 Control Hub

客戶可能已在 Entra ID中驗證了數百個網域。當他們與 Control Hub 整合時,如果他們想要將已驗證的網域從 Entra ID匯入 Control Hub。這可節省維護或設定過程的許多工作。

1

轉至 Control Hub 中的組織設定 標籤中的網域秒數。

2

按一下使用進入ID新增。

3

在新增 已驗證的網域 頁面中,搜尋並選取要新增的網域。

4

按一下新增

已驗證的網域將顯示在已驗證的網域清單中。

Entra ID (Azure AD) 精靈應用程式屬性對映

Entra ID (Azure AD) 精靈應用程式可以支援並同步您對屬性表達式所做的任何變更。例如,在 Entra ID中,您可以將顯示名稱 以便它同時顯示姓氏給定名稱 屬性。這些變更會顯示在精靈應用程式中。

您可以在 Entra ID中找到有關對映屬性表達式的更多資訊, Microsoft說明網站。

使用下表以了解有關特定 Entra ID屬性的資訊。

Entra ID不會同步空值。如果您在 Entra ID中將屬性值設定為空值,則不會在Webex中將其刪除或使用空值修補。請參閱Microsoft說明網 站獲取更多資訊。

表格 2. Azure 到 Webex 對映

Entra ID屬性(來源)

Webex 使用者屬性(目標)

說明

userPrincipalName

userName

它是Webex中使用者的唯一ID 。這是電子郵件格式。

displayName

displayName

顯示在 Webex 應用程式上的使用者名稱。

surname

name.familyName

givenName

name.givenName

objectId

externalId

它是 Entra ID中的使用者的 UID。一般來說,它是 16 位元組字串。我們不建議變更此對圖。

jobTitle

title

usageLocation

addresses[type eq "work"].country

我們建議使用使用[type eq 「work」] 位址對位來對位 [type eq「work]。country。如果您選擇其他屬性,您應該確保屬性值符合標準。譬如,美國應該是美國。中國應為 CN 等。

city

addresses[type eq "work"].locality

streetAddress

addresses[type eq "work"].streetAddress

state

addresses[type eq "work"].region

postalCode

addresses[type eq "work"].postalCode

telephoneNumber

phoneNumbers[type eq "work"].value

mobile

phoneNumbers[type eq "mobile"].value

facsimileTelephoneNumber

phoneNumbers[type eq "fax"].value

manager

manager

將使用者的管理員資訊與Webex同步,以便使用者始終可以在使用者的聯絡人名片上看到正確的管理員資訊。

當建立使用者時,Entra ID會檢查該使用者的管理員物件是否在Webex身份識別中。如果不是,則會忽略使用者的管理員屬性。如果有管理員屬性,則該屬性必須符合兩個條件才能顯示在使用者的聯絡人名片:

  • 管理員物件會同步到Webex。
  • 成員使用者在Webex應用程式中處於活動狀態。從技術上講,它可以觸發後端事件,以定期查詢使用者的管理員屬性。因此,當新增或變更使用者的管理員資訊時,使用者的管理員屬性可透過觸發的服務進行更新。

當使用者的驗證權杖過期時,這些條件會檢查使用者的管理員屬性的更新。

直到使用者在變更後第一次登入之後,管理員屬性變更才會反映在使用者的聯絡人名片上。

常見問題及解答

如何從Cisco目錄連接器佈建移轉至 Entra ID (Azure AD) 精靈應用程式?

在設定期間,精靈應用程式會偵測您的組織是否使用 Directory Connector。如果啟用的話,會出現一個對話方塊,您可以在其中選擇使用 Entra ID並封鎖 Directory Connector。按一下 鎖以確認您想要繼續 Entra ID (Azure AD) 精靈應用程式設定。

您還可以選擇在設定精靈應用程式之前停用 Directory Connector。設定後,精靈應用程式管理使用者設定檔。但是,精靈應用程式僅管理已新增至同步範圍的使用者;您無法使用精靈應用程式來管理由 Directory Connector 同步的、不屬於同步範圍的使用者。

可以設定使用Microsoft Entra的單一登入嗎?

您可以設定單一登入(SSO) 整 合Control Hub 客戶組織與使用Microsoft Entra ID作為身份識別提供者的部署之間。

使用者頭像在Webex中什麼時候更新?

當在Webex身份識別中建立使用者時,使用者頭像會同步到Webex 。此更新依賴於在 Entra ID中更新的使用者頭像。精靈應用程式隨後會從 Entra ID擷取新的頭像。