В этой статье
dropdown icon
Система междоменного управления удостоверениями (SCIM)
    Приложение Entra ID Wizard
Добавьте Webex из галереи приложений Azure.
Назначать groups/users к приложению в Entra ID
Предоставьте Entra ID разрешение на синхронизацию пользователей с вашей организацией Control Hub.
Сопоставление атрибутов пользователя из Entra ID с Webex
Поддерживаемые синхронизированные объекты
Настройка устаревших SCIM-модулей с помощью приложения Cisco Webex Entra ID Gallery
list-menuВ этой статье
list-menuОтправить обратную связь?

Используйте предварительно настроенное корпоративное приложение Cisco Webex в Microsoft Entra ID для синхронизации назначенных пользователей с Control Hub с помощью устаревшей интеграции SCIM для предоставления доступа. Этот вариант предназначен для организаций, которые уже используют приложение Cisco Webex Gallery.

Система междоменного управления удостоверениями (SCIM)

Для интеграции между пользователями в каталоге и Control Hub используется API системы междоменного управления удостоверениями (SCIM). SCIM является открытым стандартом для автоматизации обмена информацией об удостоверениях пользователей между доменами удостоверения или информационными системами. Система SCIM призвана облегчить управление удостоверениями пользователей в облачных приложениях и службах. SCIM использует стандартизованный API с REST.

Для синхронизации SCIM не требуется локальная инфраструктура или коннекторы. Эта интеграция обеспечивает синхронизацию списка пользователей при каждом создании, обновлении или удалении пользователя из приложения в Entra ID.

Entra ID не синхронизирует нулевые значения. Если значение атрибута установлено как NULL, оно не удаляется и не исправления с значением NULL в Webex. Если это ограничение повлияет на ваших пользователей, обратитесь за поддержкой в Microsoft.

Приложение Entra ID Wizard

Используйте приложение Entra ID Wizard в Control Hub, чтобы упростить синхронизацию пользователей и групп с Webex. Приложение Wizard позволяет легко настроить, какие атрибуты, пользователей и группы следует синхронизировать, а также решить, следует ли синхронизировать аватары пользователей с Webex. См. Настройка приложения Entra ID Wizard в Control Hub, чтобы узнать больше о преимуществах использования мастера.

Добавьте Webex из галереи приложений Azure.

Перед настройкой Control Hub для автоматического предоставления доступа пользователям с помощью Entra ID необходимо добавить Webex из галереи приложений Azure в список управляемых приложений.

В данной процедуре используется более старый протокол SCIM 1.1. Перейдите в раздел Настройка SCIM 2.0 с помощью пользовательского приложения Webex в Entra ID, чтобы ознакомиться с процедурами настройки нового протокола SCIM 2.0.

Для получения информации о возможностях различных методов синхронизации Entra ID см. Поддерживаемые синхронизированные объекты.

1

Войдите на портал Azure по адресу https://portal.azure.com, используя свои учетные данные администратора.

2

Перейдите по ссылке Введите ID для вашей организации.

3

Перейдите в Корпоративные приложения и нажмите Добавить > Добавить приложение из галереи.

4

В поле поиска введите Cisco Webex.

5

В области результатов выберите Cisco Webex, а затем щелкните Добавить, чтобы добавить приложение.

Пример экрана «Добавить приложение» с выделенным приложением Cisco Webex.

Отобразится сообщение о том, что приложение успешно добавлено.

6

Чтобы убедиться, что приложение Webex, добавленное для синхронизации, не отображается на портале пользователя, откройте новое приложение, перейдите в раздел Свойства и задайте для параметра Отображается для пользователей? значение Нет.

Скриншот страницы свойств, на котором показано расположение переключателя «Видимость для пользователей». Его можно найти в нижней части экрана, чуть выше поля «Примечания».

Назначать groups/users к приложению в Entra ID

Эта процедура позволяет выбрать пользователей для синхронизации с облаком Webex.

Entra ID использует концепцию «назначений» для определения того, каким пользователям должен быть предоставлен доступ к выбранным приложениям. В контексте автоматического предоставления доступа пользователям, только сами пользователи. and/or Группы пользователей, «назначенные» приложению в Entra ID, синхронизируются с Control Hub.

Используйте приложение Entra ID Wizard в Control Hub для синхронизации как пользователей в группах Entra ID , так и отдельных объектов групп. Webex не может синхронизировать отдельные группы вне приложения Entra ID Wizard.

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

1

Откройте приложение Webex на портале Entra ID, затем перейдите в Пользователи и группы.

2

Щелкните Добавить назначение.

3

Найдите пользователей или группы, которые необходимо добавить в приложение.

  • Найдите отдельных пользователей, которых необходимо назначить приложению.
  • Найдите группу пользователей, которую необходимо назначить приложению.
4

Щелкните Выбрать, затем Назначить.

Повторите эти действия для всех групп и пользователей, которых необходимо синхронизировать с Webex.

Предоставьте Entra ID разрешение на синхронизацию пользователей с вашей организацией Control Hub.

Используйте эту процедуру для настройки предоставления доступа через Entra ID и получения токена носителя для вашей организации. В инструкции описаны необходимые и рекомендуемые административные настройки.

Если в вашей организации установлено, что все пользователи должны иметь проверенный домен, то в будущем синхронизация не позволит создавать пользователей для непроверенных доменов. Большинство веб-сайтов Webex для государственных организаций требуют проверенных доменов.

Прежде чем начать

Получите свой ИД организации в окнах просмотра данных о клиенте в Control Hub. Щелкните название своей организации в нижнем левом конце и скопируйте ID организации в текстовый файл. Это значение необходимо вам при вводе URL клиента. В этой статье мы используем это значение в качестве примера: a35bfbc6-ccbd-4a17-a488-72gf46c5420c

1

Войдите на портал Azure, а затем перейдите по ссылке ]. > Корпоративные приложения > Все приложения.

2

В списке корпоративных приложений выберите Cisco Webex.

3

Перейдите в раздел Подготовка, затем измените Режим подготовки на Автоматический.

Экран настройки Cisco Webex в Entra ID. В раскрывающемся меню «Режим подготовки» выберите «Автоматический».

Приложение Webex включает в себя некоторые стандартные сопоставления между атрибутами пользователя Entra ID и атрибутами пользователя Webex. Этих атрибутов достаточно для создания пользователей, однако можно добавить дополнительные атрибуты, как описано далее в этой статье.

4

Введите URL-адрес клиента.

В таблице ниже указан URL-адрес вашего предложения Webex. Замените OrgId на ваше конкретное значение.

Таблица 1. URL-адреса клиентов для Webex
Предложение WebexURL-адрес клиента для использования
Webex (по умолчанию) https://api.ciscospark.com/v1/scim/OrgId
Webex for Government https://api-usgov.webex.com/v1/scim/OrgId

Например, URL-адрес клиента может выглядеть так: https://api.ciscospark.com/v1/scim/a35bfbc6-ccbd-4a17-a488-72gf46c5420c.

5

Выполните только одно из следующих действий, чтобы получить значение токена носителя для Секретного токена:

  • Автоматическая генерация нового токена непосредственно в Control Hub.

    В Центре управления перейдите в Приложения > Сервисные приложения, выберите приложение и нажмите Получить токен > Авторизация для получения токена.

  • Создайте новый токен вручную, выполнив следующие шаги:

  1. Скопируйте следующий URL-адрес и откройте его в режиме инкогнито: https://idbroker.webex.com/idb/oauth2/v1/authorize?response_type=token&client_id=C4ca14fe00b0e51efb414ebd45aa88c1858c3bfb949b2405dba10b0ca4bc37402&redirect_uri=http%3A%2F%2Flocalhost%3A3000%2Fauth%2Fcode&scope=spark%3Apeople_read%20spark%3Apeople_write%20Identity%3ASCIM&state=this-should-be-a-random-string-for-security-purpose.

    Указанный выше URL-адрес относится к брокеру удостоверений Webex по умолчанию. Если вы используете Webex для правительства, воспользуйтесь следующим URL для получения токена носитера:

    https://idbroker-f.webex.com/idb/oauth2/v1/authorize?response_type=token&client_id=C4ca14fe00b0e51efb414ebd45aa88c1858c3bfb949b2405dba10b0ca4bc37402&redirect_uri=http%3A%2F%2Flocalhost%3A3000%2Fauth%2Fcode&scope=spark%3Apeople_read%20spark%3Apeople_write%20Identity%3ASCIM&state=this-should-be-a-random-string-for-security-purpose

    Важно использовать браузер в режиме инкогнито, чтобы убедиться, что вход выполняется с помощью правильных учетных данных администратора. Если вы уже вписались в качестве менее привилегированного пользователя, который не может создавать пользователей, то возвращенный токен носитера не сможет создавать пользователей.

  2. На открывшейся странице входа в Webex войдите в систему, используя учетную запись администратора с полными правами для вашей организации.

    Откроется страница ошибки с сообщением о том, что веб-сайт недоступен, но это нормально.

    URL страницы ошибки содержит созданный токен носитера. Этот токен действителен в течение 365 дней (после этого срок его действия истекает).

    Пример URL страницы ошибки с выделенным сгенерированным токеном bearer. Скопируйте значение вашего токена носителя, находящееся между квадратными скобками "access_token". =" и "& amp;token_type=Bearer".

  3. Скопируйте значение токена bearer из адресной строки браузера, расположенной между квадратными скобками access_token= и &token_type=Bearer.

    Например, в этом URL-адресе значение токена выделено: http://localhost:3000/auth/code#access_token={sample_token}&token_typeBearer&expires_in=3887999&state=это-должно быть-a-a-random-string-for-security-purpose.

    Рекомендуется сохранить это значение в текстовом файле в качестве записи маркера, если URL больше не доступен.

6

Вернитесь на портал и вставьте значение токена в Secret Token.

7

Нажмите Проверить соединение, чтобы убедиться, что Entra ID распознает организацию и токен.

Успешный результат указывает на то, что учетные записи имеют права на активацию подготовки пользователя.

8

Введите Уведомление по электронной почте и установите флажок при необходимости получать уведомления обо всех ошибках подготовки.

9

Щелкните Сохранить.

На данном этапе вы успешно авторизовали Entra ID для создания учетных записей и синхронизации пользователей Webex, а также выполнили шаги по настройке синхронизации.

Дальнейшие действия

Если вы хотите сопоставить дополнительные атрибуты пользователя Entra ID с атрибутами Webex, перейдите к следующему разделу.

Для получения информации о внесении изменений в синхронизированную организацию см. статью справки Управление синхронизированными пользователями Entra ID.

Сопоставление атрибутов пользователя из Entra ID с Webex

Выполните следующие действия, чтобы сопоставить дополнительные атрибуты пользователя из Entra ID с Webex или изменить существующие сопоставления атрибутов пользователя.

Сопоставление идентификатора входа с данными Webex не синхронизирует все данные пользователя. Некоторые аспекты данных пользователя не синхронизированы.

  • Аватары

  • Комнаты

  • Атрибуты не указаны в таблице ниже

Рекомендуется не изменять сопоставления атрибутов по умолчанию, если в этом нет острой необходимости. Значение, которое сопоставляется в качестве имени пользователя, особенно важно. В качестве имени пользователя Webex использует его адрес электронной почты. По умолчанию выполняется сопоставление userPrincipalName (UPN) в Azure AD с адресом электронной почты (username) в Control Hub.

Если атрибут userPrincipalName не сопоставлен с адресом электронной почты в Control Hub, пользователи будут подготовлены в Control Hub в качестве новых пользователей, а не сопоставлены с существующими пользователями. Если вы хотите использовать другой атрибут пользователя Azure в формате адреса электронной почты вместо UPN, необходимо изменить это сопоставление по умолчанию в Entra ID с userPrincipalName на соответствующий атрибут пользователя Entra ID.

Прежде чем начать

Вы добавили и настроили приложение Cisco Webex для своего Entra ID и проверили соединение.

Изменить сопоставления атрибутов пользователя можно до или после начала синхронизации пользователей.

1

Войдите на портал Azure, а затем перейдите в раздел « Корпоративные приложения». > Все приложения..

2

Откройте приложение Webex, которое вы добавили или создали в галерее приложений.

Нажмите здесь для получения дополнительной информации о различиях между предустановленным приложением Cisco Webex и пользовательским приложением SCIM 2.0.
3

Перейти к Настройка > Сопоставления и нажмите Идентификатор пользователя для ввода.

4

Установите флажок Показать дополнительные параметры и затем нажмите Редактировать список атрибутов.

5

Выберите атрибуты Webex, которые будут заполнены, на основе атрибутов пользователя Entra ID.

6

Нажмите Сохранить > Да для подтверждения.

Открывается страница сопоставления атрибутов, где вы можете сопоставить атрибуты пользователя Entra ID с выбранными вами атрибутами пользователя Webex.

7

В нижней части страницы щелкните Добавить новое сопоставление.

8

Выберите прямое сопоставление. Выберите атрибут Источник (Атрибут Entra) и атрибут Цель (Атрибут Webex), а затем нажмите ОК.

Таблица 2. Сопоставление идентификатора входа с Webex

Атрибут идентификатора входа (источник)

Атрибут пользователя Webex (целевой объект)

Атрибуты, заполняемые по умолчанию

userPrincipalName

userName

Switch([IsSoftd], , "False", "True", "True", "False")

active

displayName

displayName

surname

name.familyName

givenname.

name.givenName

objectId

externalId

Дополнительные доступные атрибуты

jobTitle

title

usageLocation

addresses[type eq "work"].country

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

employeeid

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

отдел

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

менеджер

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

9

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

Если необходимо начать заново, можно Восстановить сопоставления по умолчанию.

Сопоставление закончено. Пользователи Webex будут созданы или обновлены при следующей синхронизации.

Поддерживаемые синхронизированные объекты

В следующих таблицах показаны различия между синхронизацией Entra ID с Enterprise App Store, приложением Entra ID Wizard для Control Hub и реализацией Entra ID SCIM 2.0.

Таблица 3. Что можно синхронизировать

Предметы

Entra ID SCIM 1.1

Приложение Entra ID Wizard

Entra ID SCIM 2.0

Пользователи

Да

Да

Да

Группы

Нет

Да*

Да

Комнаты

Нет

Да*

Нет

Аватары

Нет

Да*

Нет

*—You Синхронизация групп, комнат и аватаров с Control Hub возможна только через приложение Entra ID Wizard с использованием APIMicrosoft Graph.

Таблица 4. Поддерживаемые атрибуты пользователя

Атрибут

Entra ID SCIM 1.1

Приложение Entra ID Wizard

SCIM 2.0

имя пользователя

Да

Да

Да

отображаемое имя

Да

Да

Да

name.familyName

Да

Да

Да

name.givenName

Да

Да

Да

внешний ID

Да

Да

Да

title

Да

Да

Да

addresses[type eq "work"].country

Да

Да

Да

addresses[type eq "work"].locality

Да

Да

Да

addresses[type eq "work"].streetAddress

Да

Да

Да

addresses[type eq "work"].region

Да

Да

Да

addresses[type eq "work"].postalCode

Да

Да

Да

phoneNumbers[type eq "work"].value

Да

Да

Да

phoneNumbers[type eq "mobile"].value

Да

Да

Да

phoneNumbers[type eq "fax"].value

Да

Да

Да

менеджер

Нет

Да

Нет

отдел

Нет

Нет

Да

Идентификационный номер сотрудника

Нет

Нет

Да

Была ли статья полезной?
Была ли статья полезной?