Настройка Miro для автоматического предоставления пользователей с помощью Microsoft Entra ID

Цель этой статьи — продемонстрировать шаги, которые необходимо выполнить в Miro и Microsoft Entra ID, чтобы настроить Microsoft Entra ID для автоматического предоставления и отзыва доступа пользователям и/или группам в Miro.

Примечание.

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

Предварительные условия

В сценарии, описанном в этой статье, предполагается, что у вас уже есть следующие предварительные требования:

  • клиент Miro;
  • учетная запись пользователя в Miro с разрешениями администратора.

Назначение пользователей в Miro

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

Перед настройкой и включением автоматической подготовки пользователей необходимо решить, какие пользователи и группы в идентификаторе Microsoft Entra должны иметь доступ к Miro. Когда этот вопрос будет решен, этих пользователей и (или) группы можно будет назначить приложению Miro, следуя приведенным ниже указаниям.

Важные рекомендации по назначению пользователей в Miro

  • Рекомендуется, чтобы один пользователь Microsoft Entra был назначен в Miro для тестирования конфигурации автоматического предоставления учетных записей пользователей. Дополнительные пользователи и/или группы можно назначить позднее.

  • При назначении пользователя в Miro в диалоговом окне назначения необходимо выбрать действительную роль для конкретного приложения (если доступно). Пользователи с ролью Доступ по умолчанию исключаются из управления.

Настройка Miro для управления ресурсами

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

Перед настройкой Miro для автоматической подготовки пользователей с помощью Идентификатора Microsoft Entra необходимо добавить Miro из коллекции приложений Microsoft Entra в список управляемых приложений SaaS.

Чтобы добавить Miro из коллекции приложений Microsoft Entra, выполните следующие действия:

  1. Войдите в Центр администрирования Microsoft Entra в роли Администратора облачных приложений или выше.
  2. Перейдите к разделу Entra ID>корпоративные приложения>Новое приложение.
  3. В разделе Добавление из коллекции в поле поиска введите Miro.
  4. Выберите Miro в области результатов и добавьте это приложение. Подождите несколько секунд, пока приложение не будет добавлено в вашего арендатора.

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

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

Совет

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

Примечание.

Дополнительные сведения о конечной точке SCIM Miro см. на этой странице.

Для настройки автоматического создания учетных записей пользователей для Miro в Microsoft Entra ID

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

  2. Перейдите к Entra ID>приложениям для предприятий

    Колонка

  3. Из списка приложений выберите Miro.

    Ссылка на Miro в списке

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

    Снимок экрана: опции управления с выделенной функцией

  5. Выберите + Новая конфигурация.

    Автоматический снимок экрана вкладки

  6. В разделе Учетные данные администратора введите значение https://miro.com/api/v1/scim в поле URL-адрес клиента. Введите полученное ранее значение токена проверки подлинности SCIM в поле Секретный токен. Выберите "Проверить подключение", чтобы убедиться, что идентификатор Microsoft Entra может подключиться к Miro. Если установить подключение не удалось, убедитесь, что у учетной записи Miro есть разрешения администратора, и повторите попытку.

    URL-адрес клиента и токен

  7. Нажмите кнопку "Создать", чтобы создать конфигурацию.

  8. Выберите "Свойства " на странице обзора .

  9. Щелкните значок "Изменить ", чтобы изменить свойства. Включите уведомления и предоставьте сообщение электронной почты для получения сообщений карантина. Включение предотвращения случайных удалений. Выберите Применить, чтобы сохранить изменения.

    Скриншот свойств Provisioning.

  10. Выберите сопоставление атрибутов на левой панели и выберите пользователей.

  11. Просмотрите атрибуты пользователя, которые синхронизируются из Microsoft Entra ID в Miro в разделе Сопоставление атрибутов. Атрибуты, выбранные как свойства Сопоставления, используются для сопоставления учетных записей пользователей в Miro для операций обновления. Нажмите кнопку Сохранить, чтобы зафиксировать все изменения.

    Атрибуты пользователя Miro

  12. Выберите Группы.

  13. Просмотрите атрибуты группы, синхронизированные из Microsoft Entra ID в Miro, в разделе "Сопоставление атрибутов". Атрибуты, выбранные как свойства сопоставления, используются для сопоставления групп в Miro для операций обновления. Нажмите кнопку Сохранить, чтобы зафиксировать все изменения. Снимите флажок "Создать и удалить " в разделе " Действия целевого объекта ", так как API Miro SCIM не поддерживает создание и удаление групп.

    Атрибуты группы Miro

  14. Чтобы настроить фильтры области, ознакомьтесь со следующими инструкциями, приведенными в статье о фильтрации области.

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

  16. Когда вы будете готовы к подготовке, выберите "Начать подготовку " на странице обзора .

Следите за развертыванием

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

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

Ограничения соединителя

  • Конечная точка SCIM Миро не разрешает операции создания и удаления в группах. Она поддерживает только групповую операцию обновления.

Советы по устранению неполадок

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

    Советы группы Miro

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