Налаштуйте програму майстра Entra ID (Azure AD) в Control Hub

Увімкнути Entra ID в Control Hub

У Webex for Government програма майстра Entra ID (Azure AD) доступна як для клієнтів GCC Moderate Entra ID, так і для клієнтів GCC High Entra ID.

Деякі функції, описані в цій статті, ще не доступні всім клієнтам.

Перед початком

Переконайтеся, що у вас є доступ до облікового запису Entra ID, який має повноваження надати згоду адміністратора для всього клієнта на запит.

Увійдіть у Control Hub за допомогою облікового запису адміністратора з повними правами.

Перейдіть до Налаштування організації , потім прокрутіть вниз до програми майстра Microsoft Azure Active Directory.

Натисніть Налаштувати , щоб запустити конфігурацію.

(Необов’язково) Для Webex для державних адміністраторів виберіть Entra Worldwide або Entra GCC High і клацніть Продовжити.

Entra Worldwide надсилає майстра в компанію Entra AD як для модерації, так і для комерційних організацій GCC. Entra GCC High надсилає майстра в службу Entra AD для GCC High.

Автентифікація облікового запису адміністратора Entra ID.

Якщо ви не глобальний адміністратор або адміністратор з привілейованими ролями в Entra ID, ви можете запитати доступ, щоб надати дозвіл програмі майстра Entra ID (Azure AD).

Якщо у вас є повні права адміністратора в Entra ID, ви можете переглянути й надати доступ до запитів, перейшовши до розділу Ідентифікатор > Програми > Корпоративні програми. У розділі Активність виберіть Запити на згоду адміністратора , клацніть Інтеграція ідентифікації Cisco Webex , а потім виберіть Переглянути дозволи та прийняти. Цей процес надає можливість загальної автентифікації програмі Webex.

Нарешті, клацніть вкладку Усі (перегляд) , виберіть Інтеграція ідентифікації Cisco Webex і клацніть Переглянути програму. У розділі Безпека > Дозволи клацніть Надати згоду адміністратора для Cisco , щоб надати всі необхідні дозволи для ввімкнення Entra ID в Control Hub.

Додаткову інформацію про цей процес див. в Підтримку Microsoft .

Перегляньте дозволи та натисніть Прийняти , щоб надати авторизацію облікового запису для доступу до клієнта Entra ID.

Cisco Webex Identity — це корпоративна програма Entra ID в Entra ID. Програма майстра підключається до цієї програми, щоб отримати доступ до API графіка Entra ID. Дозволи, необхідні для доступу до неї, — це мінімальні дозволи, необхідні для її підтримки й використання.

Дозвіл	Використання
Керування програмами, створеними або якими володіє ця програма	Вимагається для керування програмою Cisco Webex Identity в Entra ID Enterprise, зокрема: Створити/видалити цю програму в Entra ID Конфігурація зіставлення атрибутів Перейменування застосунку в Entra ID Увімкнути/вимкнути автоматичну підготовку
Прочитати всі дані журналу аудиту	Використовується для доступу до журналу аудиту підготовки Cisco Webex Identity для читання історії підготовки. Ця інформація використовується для функції зведених даних про синхронізацію та звітів про синхронізацію в програмі майстра.
Прочитати всі групи/Прочитати все членство в групах	Зчитує список груп із Entra ID, щоб дозволити успішне налаштування області синхронізації груп. Синхронізація оновлень членства в групах може тривати до 12 годин. Якщо новий користувач не синхронізувався автоматично під час синхронізації групи, вам доведеться очікувати ще 12 годин, поки новий користувач синхронізується зі своєю групою.
Прочитати повні профілі всіх користувачів	Використовується під час додавання користувачів у область синхронізації. Наприклад, цей дозвіл дозволяє читання інформації про користувача шляхом пошуку користувача та відображення користувачів у таблиці на сторінці користувача.

Для клієнтів малого та середнього бізнесу прийміть настройки за замовчуванням, установивши прапорець Синхронізувати за замовчуванням і натиснувши Продовжити . Для корпоративних клієнтів перейдіть до наступного кроку та продовжуйте налаштування.

Якщо ви приймаєте налаштування за замовчуванням, це означає, що ви хочете:

Синхронізуйте всіх користувачів з Webex.
Прийміть відображення атрибутів за замовчуванням.
Увімкніть перемикач для синхронізації всіх зображень профілю користувачів для відображення в Службах Webex.
Увімкніть автоматичну синхронізацію після завершення конфігурації.

Зображення, що відображає параметр налаштування синхронізації Azure AD за замовчуванням

Для корпоративних клієнтів (більше 1000 користувачів) або клієнтів, які бажають налаштувати параметри вручну, клацніть вкладку Атрибути і зіставте атрибути. Клацніть Зберегти.

Можна зіставити інші атрибути користувача з Entra ID з Webex або змінити наявне зіставлення атрибутів користувача на сторінці Атрибути . Зіставлення можна настроїти правильно. Значення, яке ви відображаєте як ім'я користувача, є важливим. Webex використовує адресу електронної пошти користувача як ім'я користувача. За замовчуванням ім’я користувача (UPN) в Entra ID зіставляється з адресою електронної пошти (ім’я користувача) в Control Hub.

Ви не можете редагувати зіставлення під час першого налаштування. На той момент відповідний екземпляр не побудований повністю, і немає екземпляра індивідуального атрибута відображення. Однак ви можете натиснути кнопку Редагувати , щоб змінити його після завершення інсталяції.

Щоб додати користувачів до області синхронізації, перейдіть на вкладку Користувачі .

Для пошуку та додавання користувача в області синхронізації можна ввести ім’я користувача. Клацніть Зберегти.

Якщо ви хочете вибрати всіх користувачів через Entra ID, виберіть Вибрати всіх користувачів. Якщо його вибрано, не потрібно виділяти групи в межах області, оскільки цей параметр синхронізує групи одночасно.

Зображення, на якому синхронізовано всіх користувачів

Ми не рекомендуємо використовувати Select all users для значних корпоративних клієнтів із сотнями тисяч користувачів, оскільки процес ініціалізації вимагає тривалого часу. Якщо випадково синхронізувати багато користувачів у Центрі керування, видалення цих користувачів також займе більше часу.

Клацніть Зберегти.

На вкладці Групи можна шукати окремі групи та додавати їх у Webex.

Клацніть вкладку Синхронізувати учасників групи , щоб знайти й вибрати всіх користувачів у певних групах.
Клацніть вкладку Синхронізувати дочірні групи , щоб вибрати батьківські групи, діти яких потрібно синхронізувати.
Вибір батьківської групи синхронізує лише користувачів із її дочірніх груп. Використовуйте вкладку Синхронізувати учасників групи , щоб синхронізувати більшу батьківську групу.

За замовчуванням синхронізуються лише користувачі з вибраних груп із Webex. Щоб також синхронізувати групи самі, перейдіть на вкладку Додатково і виберіть Синхронізувати об’єкти групи .

Зображення, на якому показано екран для додавання або видалення груп

На вкладці Додатково можна настроїти деякі додаткові параметри синхронізації:

Синхронізація аватарів користувачів. Увімкніть цей параметр, щоб дозволити програмі Webex синхронізувати всі аватари користувача в області з Webex. Коли аватар користувача оновлюється, аватар користувача автоматично оновлюється у Webex. Він може не оновлюватися негайно, оскільки він покладається на сповіщення про оновлення, щоб ініціювати оновлення.
Синхронізація об’єктів групи — увімкніть цей параметр, щоб вибрані об’єкти групи на вкладці Групи було синхронізовано з Webex.
Активувати єдиний вхід — увімкніть цей параметр, щоб налаштувати єдиний вхід OpenID Connect (OIDC) для своєї організації.

Якщо у вашій організації вже ввімкнуто SSO за допомогою одного з параметрів SAML, необхідно спочатку вимкнути параметр SAML, перш ніж активувати єдиний вхід OIDC в програмі майстра Entra ID (Azure AD).
Ідентифікація та синхронізація об’єктів кімнати— увімкніть цей параметр, щоб синхронізувати об’єкти кімнати з Webex.

Ви можете вирішити, чи хочете ви дозволити синхронізацію відбуватися відразу або на більш пізньому етапі. Якщо ви виберете параметр Дозволити зараз , він застосує всі налаштування до майбутньої синхронізації. Якщо вибрати параметр Зберегти й дозволити пізніше , синхронізація не почнеться, доки не буде дозволено автоматичну синхронізацію.

Зображення з можливістю збереження конфігурації

Програма зв’язується з Entra ID для налаштування конфігурації та планування синхронізації.

Після завершення синхронізації в полі Стан завдання з’явиться один із таких результатів:

Активний: синхронізація пройшла успішно.
Карантин: завдання синхронізації було поставлено на карантин в Entra ID після кількох помилок. Додаткову інформацію див. в документації Entra ID .
Не запущено: цей стан відображається лише після першого налаштування. Після першого налаштування службу ще не запущено.

Також можна клацнути Переглянути зведення , щоб переглянути додаткову інформацію, як-от час і дата останньої синхронізації, а також кількість синхронізованих, пропущених або помилок користувачів:

Користувачі

Синхронізовано: показує кількість користувачів, які успішно синхронізовані з Webex.
Пропущено: показує кількість користувачів, яких пропустили під час останньої синхронізації. Наприклад, нові користувачі в Entra ID, які не були додані до області синхронізації програми майстра Entra ID (Azure AD). Цих користувачів не було синхронізовано з Webex. Додайте їх у область синхронізації, щоб синхронізувати з Webex.
Помилка: показує кількість користувачів, яких не вдалося синхронізувати. Перевірте журнал аудиту підготовки програми Entra ID, щоб отримати додаткову інформацію про те, чому ці користувачі не виконали синхронізацію. Якщо потрібно негайно синхронізувати цих користувачів, можна підготувати користувачів на вимогу.

Групи

Синхронізовано: показує кількість груп, які успішно синхронізовані з Webex і створені в Control Hub.
Підлягає синхронізації: цей стан вказує на те, що всіх користувачів у групі ще не було додано. Спочатку користувачі повинні бути успішно синхронізовані з Webex.

Виконайте міграцію наявних конфігурацій програми Cisco Webex Enterprise App в програму майстра Entra ID (Azure AD)

Якщо ви вже налаштували програму Cisco Webex Enterprise в Entra ID, можна автоматично перенести всі свої конфігурації на програму майстра Entra ID (Azure AD). Ви можете керувати всіма функціями Entra ID в Control Hub, не втрачаючи жодної з попередніх конфігурацій.

Увійдіть у Control Hub за допомогою облікового запису адміністратора з повними правами.

Перейдіть до розділу Настройки організації, а потім прокрутіть униз до розділу Синхронізація служби каталогів .

Натисніть Налаштувати , щоб запустити конфігурацію.

Автентифікуйте обліковий запис адміністратора Entra ID за допомогою конфігурації Entra ID. Переконайтеся, що ви використовуєте обліковий запис із дозволами, описаними в наступному кроці.

Перегляньте дозволи та натисніть Прийняти , щоб надати авторизацію облікового запису для доступу до клієнта Entra ID.

Cisco Webex Identity Synchronization — це корпоративна програма Entra ID в Entra ID. Програма майстра підключається до цієї програми, щоб отримати доступ до API графіка Entra ID. Дозволи, необхідні для доступу до нього, - це мінімальні дозволи, необхідні для його підтримки та використання.

Дозвіл	Використання
Керування програмами, створеними або якими володіє ця програма	Вимагається для керування програмою Cisco Webex Identity в Entra ID Enterprise, зокрема: Створити/видалити цю програму в Entra ID Конфігурація зіставлення атрибутів Перейменування застосунку в Entra ID Увімкнути/вимкнути автоматичну підготовку
Прочитати всі дані журналу аудиту	Використовується для доступу до журналу аудиту підготовки Cisco Webex Identity для читання історії підготовки. Ця інформація використовується для функції зведених даних про синхронізацію та звітів про синхронізацію в програмі майстра.
Прочитати всі групи/Прочитати все членство в групах	Зчитує список груп із Entra ID, щоб дозволити успішне налаштування області синхронізації груп.
Прочитати повні профілі всіх користувачів	Використовується під час додавання користувачів у область синхронізації. Наприклад, цей дозвіл дозволяє читання інформації про користувача шляхом пошуку користувача та відображення користувачів у таблиці на сторінці користувача.

Виберіть Перенести наявну програму.

Після прийняття додаткових запитів на дозволи лише для читання виберіть наявну програму, яку потрібно перенести в програму майстра, а потім Продовжити.

Якщо вибрана наявна програма не готує користувачів до одного й того самого Control Hub, міграція не вдасться.

Після завершення міграції ми рекомендуємо виконати контрольний тест перед увімкненням автоматичної синхронізації, щоб переконатися, що немає помилок.

Виконати контрольний тест

Перш ніж увімкнути автоматичну синхронізацію, рекомендуємо спочатку виконати контрольний тест, щоб переконатися, що немає помилок. Після завершення контрольного тесту можна завантажити звіт про контрольний тест, щоб ознайомитися з докладною інформацією. Доступні стовпці у звіті:

Таблиця 1. Описи стовпців звіту про контрольний тест
Ім’я стовпця	Опис
Тип об’єкта	Тип об’єкта в ідентифікаторі Entra, наприклад користувач або група.
Тип дії	Тип дії, яку буде виконано з об’єктом під час синхронізації. Можливі типи дій: Зіставлено—Об’єкт збігається в Entra ID і Control Hub. Додати— об’єкт буде додано до Control Hub. Деактивувати— об’єкт знаходиться в Control Hub, але об’єкт було видалено в Entra ID або його не було додано до області синхронізації. Після синхронізації об’єкт буде деактивовано.
Ідентифікатор Azure	Ідентифікатор об’єкта в ідентифікаторі Entra.
Ім’я Azure	Ім’я об’єкта в ідентифікаторі Entra.
Ім’я 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	Клацніть Змінити конфігурацію.
4	Налаштуйте зіставлення атрибутів, вибравши атрибут із лівого стовпця, який походить від Entra ID. Атрибут призначення в Webex Cloud знаходиться в правому стовпці. Додаткову інформацію про атрибути зіставлення в програмі майстра Entra ID (Azure AD) див. у розділі Зіставлення атрибутів застосунку майстра.
5	На вкладках Користувачі та групи додайте або видаліть користувачів і групи зі сфери синхронізації. Вкладені групи не синхронізуються автоматично з хмарою. Переконайтеся, що ви вибрали будь-які групи, які вкладені в групи, які потрібно синхронізувати.
6	На вкладці Додатково змініть свої налаштування, якщо потрібно.
7	Натисніть Зберегти , щоб зберегти змінену конфігурацію. Ваші оновлення будуть застосовані під час наступної синхронізації. Механізм автоматичної синхронізації Entra ID обробляє синхронізацію користувачів і груп користувачів.

Змінити ім’я екземпляра Webex

Змініть спосіб відображення імені екземпляра Cisco Webex Identity у списку корпоративних програм Entra ID.

1	Увійдіть у Control Hub за допомогою облікового запису адміністратора з повними правами.
2	Перейдіть до розділу Настройки організації, а потім прокрутіть униз до розділу Синхронізація служби каталогів .
3	Клацніть Змінити ім’я екземпляра.
4	Введіть нове ім’я екземпляра й клацніть Зберегти.

Видалити конфігурацію програми майстра Entra ID (Azure AD)

Видалення програми майстра Entra ID (Azure AD) призведе до видалення конфігурації синхронізації Entra ID. Конфігурація не збережена Webex або Entra ID. Якщо ви хочете використовувати синхронізацію Entra ID в майбутньому, вам потрібно буде здійснити повну переналаштування.

Не видаляйте програму Cisco Webex із Entra ID.

1	Увійдіть у Control Hub за допомогою облікового запису адміністратора з повними правами.
2	Перейдіть до розділу Настройки організації, а потім прокрутіть униз до розділу Синхронізація служби каталогів .
3	Клацніть Видалити екземпляр.
4	На сторінці Видалити екземпляр Azure AD? виберіть відкликати згоду адміністратора Azure AD, якщо потрібно видалити угоду про згоду з Webex. Якщо вибрати цей параметр, необхідно ввести облікові дані та надати дозволи ще раз.
5	Клацніть Видалити.

Надання користувача Webex на вимогу

Ви можете негайно підготувати користувача до Webex, незалежно від синхронізації Entra ID, і миттєво перевірити результат. Це корисно в разі виправлення неполадок під час налаштування.

1	Увійдіть у Control Hub за допомогою облікового запису адміністратора з повними правами.
2	Перейдіть до Налаштування організації і прокрутіть вниз до розділу Синхронізація каталогу .
3	Клацніть Надати користувача на вимогу.
4	Знайдіть і виберіть користувача, якого потрібно підготувати, а потім клацніть Підготувати.
5	Після завершення з’явиться один із таких результатів: Успішно підготовку: Нового користувача було успішно створено у Webex. Підготовку пропущено: Підготовку було пропущено з якоїсь причини, зазвичай тому що користувач уже існує. Відомості з’являться на сторінці Підсумкові результати . Помилка підготовки: Помилка підготовки. Відомості з’являться на сторінці Підсумкові результати .
6	Клацніть Повторити спробу , щоб знову надати того самого користувача, якщо він пропустив або сталася помилка.
7	Клацніть Підготувати іншого користувача , щоб повернутися на сторінку підготовки.
8	Клацніть Готово , коли завершите.

Імпортувати підтверджені домени Entra ID до Control Hub

Клієнти можуть мати сотні доменів, перевірених в Entra ID. Під час інтеграції з Control Hub вони мають намір імпортувати перевірені домени з Entra ID до Control Hub. Це може заощадити багато зусиль у процесі обслуговування або налаштування.

1	Перейдіть до розділу Домен на вкладці Параметри організації в Центрі керування.
2	Клацніть Додати за допомогою Entra ID.
3	На сторінці Додавання перевірених доменів знайдіть і виберіть домени, які потрібно додати.
4	Клацніть Додати. Зіставлені домени з’являться в списку підтверджених доменів.

Зіставлення атрибутів програми майстра Entra ID (Azure AD)

Програма майстра Entra ID (Azure AD) може підтримувати та синхронізувати будь-які зміни, внесені до виразів атрибутів. Наприклад, в Entra ID ви можете зіставити displayName так, щоб він відображав як прізвище , так і атрибути givenName . Ці зміни з’являться в програмі майстра.

Додаткову інформацію про зіставлення виразів атрибутів можна знайти в Entra ID на довідковому сайті Microsoft.

Використовуйте наведену нижче таблицю, щоб отримати інформацію про певні атрибути Entra ID.

Ідентифікатор Entra не синхронізує нульові значення. Якщо значення атрибута в Entra ID має значення null, його не буде видалено або виправлено значенням null у Webex. Перегляньте обмеження на довідковому сайті Microsoft для отримання додаткової інформації.

Таблиця 2. Azure to Webex Mappings
Введіть атрибут ідентифікатора (джерело)	Атрибут користувача Webex (цільовий)	Опис
ім'я користувачаПринципів	Ім'я користувача	Це унікальний ідентифікатор користувача у Webex. Це електронна пошта у форматі.
ім'я дисплея	ім'я дисплея	Ім'я користувача, яке відображається в додатку Webex.
прізвище	ім'я.прізвищеНайменування
GivenName	ім'я.givenНайменування
objectId	ExternalId	Це UID користувача в Entra ID. Як правило, це рядок у 16 байтів. Ми не рекомендуємо змінювати це відображення.
jobTitle	назва
ВикористанняМісцезнаходження	адреси[тип eq "робота"].country	Ми рекомендуємо використовувати uselocation mapping для адрес [введіть eq "work"].country. Якщо ви вибираєте інший атрибут, слід переконатися, що значення атрибутів відповідають стандартам. Наприклад, США повинні бути США. Китай повинен бути CN і так далі.
місто	адреси[тип eq "робота"].населений пункт
StreetAddress	адреси[тип eq "робота"].streetAddress
стан	адреси[тип eq "робота"].region
поштовий індекс	адреси[тип eq "робота"].поштовийкод
номер телефону	phoneNumbers[type eq "work"].value
мобільний	phoneNumbers[type eq "mobile"].value
факсимілетелефонНумер	phoneNumbers[type eq "факс"].value
голова	голова	Синхронізує інформацію про менеджера користувачів із Webex, щоб користувачі завжди могли бачити правильну інформацію про менеджера на картці контакту користувача. Під час створення користувача Entra ID перевіряє, чи в об’єкті менеджера користувача міститься ідентифікатор Webex. Якщо ні, атрибут менеджера користувача ігнорується. Якщо атрибут менеджера існує, для відображення атрибута на картці контакту користувача має бути виконано дві умови: Об’єкт менеджера синхронізовано з Webex. Користувач-учасник активний у програмі Webex. Технічно можна запустити подію сервера з періодичним запитом атрибута менеджера користувача. Тому, коли інформація про менеджера користувача додається або змінюється, атрибут менеджера користувача може оновити через запущену службу. Ці умови перевіряють оновлення атрибута менеджера користувача після закінчення терміну дії токена автентифікації користувача. Зміни атрибутів менеджера не відображатимуться на картці контакту користувача, доки користувач не ввійде в систему вперше після зміни.

Поширені запитання

Як я можу перейти до програми майстра Entra ID (Azure AD) із підготовки Cisco Directory Connector?

Під час налаштування програма майстра визначає, чи використовує ваша організація з’єднувач каталогів. Якщо цей параметр увімкнено, відкриється діалогове вікно, у якому можна вибрати використання Entra ID та блокування з’єднувача каталогів. Клацніть Блокувати , щоб підтвердити, що потрібно продовжити конфігурацію програми майстра Entra ID (Azure AD).

Перед налаштуванням програми майстра також можна вимкнути з’єднувач каталогів. Після налаштування програма майстра керує профілями користувачів. Однак програма майстра керує лише користувачами, доданими до області синхронізації. Ви не можете використовувати програму майстра для керування користувачами, синхронізованими з’єднувачем каталогів, які не були частиною області синхронізації.

Чи можна налаштувати єдиний вхід за допомогою Microsoft Entra?

Ви можете налаштувати інтеграцію єдиного входу (SSO) між організацією клієнта Control Hub і розгортанням, у якому як постачальник посвідчень використовується Microsoft Entra ID.

Коли аватар користувача оновиться у Webex?

Аватари користувача синхронізуються з Webex, коли користувача створюється в ідентифікаторі Webex. Це оновлення залежить від аватара користувача, що оновлюється в Entra ID. Потім програма майстра отримує новий аватар від Entra ID.

Дякуємо за відгук.