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

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

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

Предпосылки

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

• Клиент Microsoft Entra.
• Одна из следующих ролей: администратор приложений, администратор облачных приложений или владелец приложения.
• Учетная запись организации Contentful с подпиской, поддерживающей подготовку системы для управления междоменной идентификацией (SCIM). Если у вас есть вопросы о подписке вашей организации, обратитесь в службу поддержки Contentful.

Спланируйте развертывание для подготовки оборудования

1. Узнайте, как работает служба снабжения.
2. Определите, кто входит в область предоставления ресурсов.
3. Определите, какие данные следует сопоставить между идентификатором Microsoft Entra и Contentful.

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

1. В Contentful создайте учетную запись пользователя службы . Все разрешения на предоставление ресурсов для Azure предоставляются через эту учетную запись. Рекомендуется выбрать владельца в качестве роли организации для этой учетной записи.

2. Войдите в Contentful в качестве пользователя службы.

3. В меню слева выберите Настройки организации>Инструменты доступа>Управление пользователями.

   

4. Скопируйте и сохраните URL-адрес SCIM. Это значение будет введено на портале Azure на вкладке "Подготовка " приложения Contentful.

5. Выберите "Создать личный маркер доступа".

   

6. В модальном окне введите имя личного маркера доступа и нажмите кнопку "Создать".

7. Создается URL-адрес SCIM и секретный маркер. Скопируйте и сохраните эти значения. Эти значения введите на вкладке "Подготовка " приложения Contentful.

   

Если у вас есть вопросы при настройке подготовки в консоли администрирования Contentful, обратитесь в службу поддержки Contentful.

Добавьте Contentful из галереи приложений Microsoft Entra

Чтобы управлять управлением в Contentful, добавьте Contentful из галереи приложений Microsoft Entra. Если вы ранее настроили Contentful для единого входа, можно использовать то же приложение. Однако рекомендуется создать отдельное приложение для первоначального тестирования интеграции. Узнайте, как добавить приложение в коллекцию.

Определение, кто подлежит включению в область предоставления ресурсов

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

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

• Если вам нужны дополнительные роли, можно обновить манифест приложения , чтобы добавить новые роли.

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

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

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

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

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

   

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

   

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

   

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

   

6. В поле URL-адрес арендатора введите URL-адрес вашего арендатора Contentful и секретный токен. Выберите Test Connection, чтобы убедиться, что Microsoft Entra ID может подключаться к Contentful. Если подключение завершается ошибкой, убедитесь, что учетная запись Contentful имеет необходимые разрешения администратора и повторите попытку.

   

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

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

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

   

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

11. Просмотрите атрибуты пользователя, синхронизированные из Microsoft Entra ID в Contentful в разделе Attribute-Mapping. Атрибуты, выбранные в качестве свойств сопоставления , используются для сопоставления учетных записей пользователей в Contentful для операций обновления. Если вы решили изменить соответствующий целевой атрибут, необходимо убедиться, что API Contentful поддерживает фильтрацию пользователей на основе этого атрибута. Нажмите кнопку Сохранить, чтобы зафиксировать все изменения.

    Свойство	Тип	Поддерживается для фильтрации
    userName	Струна	✓
    имя.имяОтчество	Струна
    имя_фамилия	Струна

12. В разделе «Сопоставление атрибутов» просмотрите атрибуты группы, синхронизированные из Microsoft Entra ID в Contentful. Атрибуты, выбранные в качестве свойств сопоставления , используются для сопоставления групп в Contentful для операций обновления. Нажмите кнопку Сохранить, чтобы зафиксировать все изменения.

    Свойство	Тип	Поддерживается для фильтрации
    отображаемое имя	Струна	✓
    члены	Справка

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

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

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

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

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

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

Связанный контент

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