Руководство по настройке Playvox для автоматической подготовки пользователей

В этом руководстве описаны действия, описанные как в Playvox, так и в идентификаторе Microsoft Entra для настройки автоматической подготовки пользователей. При настройке идентификатор Microsoft Entra id автоматически подготавливает и отменяет подготовку пользователей или групп в Playvox с помощью службы подготовки Microsoft Entra. Важные сведения о том, что эта служба делает и как она работает, а также часто задаваемые вопросы см. в статье "Автоматизация подготовки пользователей и отмена подготовки к приложениям SaaS с помощью идентификатора Microsoft Entra".

Поддерживаемые возможности

• Создание пользователей в Playvox.
• Удаление пользователей из Playvox, когда им больше не нужен доступ.
• Синхронизация атрибутов пользователей между идентификатором Microsoft Entra и Playvox.

Необходимые компоненты

В сценарии, описанном в этом руководстве, предполагается, что у вас уже имеется:

• Клиент Microsoft Entra.
• Одна из следующих ролей: Application Администратор istrator, Cloud Application Администратор istrator или Владелец приложения.
• Учетная запись пользователя Playvox с разрешениями суперадминистратора.

Шаг 1. Планирование развертывания подготовки

1. Узнайте, как работает служба подготовки.

2. Определите, кто будет находиться в области подготовки.

3. Определите, какие данные необходимо сопоставить между идентификатором Microsoft Entra и Playvox.

Шаг 2. Настройка Playvox для поддержки подготовки с помощью идентификатора Microsoft Entra

1. Войдите в консоль администрирования Playvox и последовательно выберите Settings > API Keys (Параметры > Ключи API).

2. Щелкните Создание ключа API.

   

3. Введите понятное имя для ключа API, а затем нажмите Сохранить. После создания ключа API нажмите кнопку Закрыть.

4. В созданном ключе API щелкните значок Сведения.

   

5. Скопируйте и сохраните значение BASE64 KEY. Позже на портале Azure введите это значение в текстовое поле Секретный токен на вкладке Подготовка приложения Playvox.

   

Шаг 3. Добавление Playvox из коллекции приложений Microsoft Entra

Чтобы начать управление подготовкой в Playvox, добавьте Playvox в клиент Microsoft Entra из коллекции приложений. Дополнительные сведения см . в кратком руководстве. Добавление приложения в клиент Microsoft Entra.

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

Шаг 4. Определение того, кто будет находиться в область для подготовки

Служба подготовки Microsoft Entra используется для область, которые будут подготовлены на основе назначения приложению или атрибутов пользователя или группы. Чтобы область, которые будут подготовлены к приложению на основе назначения, см. статью "Управление назначением пользователей для приложения в идентификаторе Microsoft Entra ID", чтобы узнать, как назначить пользователей или группы приложению. Чтобы указать, кто именно будет подготовлен, только на основе атрибутов пользователя или группы, можете использовать фильтр области, как описано в статье Подготовка приложений на основе атрибутов с использованием фильтров области.

Помните следующее.

• При назначении пользователей для Playvox необходимо выбрать роль, отличную от роли "Доступ по умолчанию". Пользователи с ролью "Доступ по умолчанию" исключаются из подготовки и будут помечены в журналах подготовки как не назначенные явно. Если в приложении доступна только эта роль, измените манифест приложения, чтобы добавить другие роли.

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

Шаг 5. Настройка автоматической подготовки пользователей в Playvox

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

Чтобы настроить автоматическую подготовку пользователей для Playvox в идентификаторе Microsoft Entra, выполните следующие действия.

1. Войдите в Центр администрирования Microsoft Entra как минимум облачные приложения Администратор istrator.

2. Перейдите к приложениям Identity>Applications>Enterprise.

   

3. В списке приложений найдите и выберите Playvox.

   

4. Выберите вкладку Подготовка.

   

5. Для параметра Режим подготовки к работе выберите значение Automatic (Автоматически).

   

6. В разделе Учетные данные администратора введите URL-адрес клиента Playvox в виде:

   https://{tenant}.playvox.com/scim/v1

   Введите Секретный токен, скопированный ранее на Шаге 2. Затем выберите "Проверить Подключение", чтобы убедиться, что идентификатор Microsoft Entra может подключиться к Playvox. Если установить подключение не удалось, убедитесь, что у учетной записи Playvox есть разрешения администратора, и повторите попытку.

   

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

   

8. Выберите Сохранить.

9. В разделе "Сопоставления" выберите "Синхронизировать пользователей Microsoft Entra" с Playvox.

10. Просмотрите атрибуты пользователя, синхронизированные с идентификатором Microsoft Entra в Playvox в разделе "Сопоставление атрибутов". Атрибуты, выбранные как свойства Сопоставления, используются для сопоставления учетных записей пользователей в Playvox при операциях обновления. Если вы решили изменить соответствующий целевой атрибут, потребуется убедиться, что API Playvox поддерживает фильтрацию пользователей по этому атрибуту. Чтобы зафиксировать изменения, щелкните Сохранить.

    Атрибут	Тип	Поддерживается для фильтрации
    userName	Строка	✓
    active	Логический
    displayName	Строка
    emails[type eq "work"].value	Строка
    name.givenName	Строка
    name.familyName	Строка
    name.formatted	Строка
    externalId	Строка

11. Чтобы настроить фильтры области, ознакомьтесь с инструкциями в этом учебнике.

12. Чтобы включить службу подготовки Microsoft Entra для Playvox, измените состояние подготовки на On в разделе Параметры.

    

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

    

14. Когда будете готовы выполнить подготовку, нажмите кнопку Сохранить.

    

После этого начнется цикл начальной синхронизации всех пользователей и групп, определенных в поле Область в разделе Параметры. Начальный цикл длится дольше последующих. Последующие циклы происходят примерно каждые 40 минут, если служба подготовки Microsoft Entra выполняется.

Шаг 6. Мониторинг развертывания

Завершив настройку подготовки, используйте следующие ресурсы для мониторинга развертывания:

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

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

• Управление подготовкой учетных записей пользователей для корпоративных приложений
• Что такое доступ к приложению и единый вход с помощью идентификатора Microsoft Entra?

Следующие шаги

• Сведения о просмотре журналов и получении отчетов о действиях по подготовке