Интеграция единого входа Microsoft Entra с Contentful

В этой статье вы узнаете, как интегрировать Contentful с идентификатором Microsoft Entra ID. Интеграция Contentful с идентификатором Microsoft Entra ID позволяет:

• Управляйте доступом к Contentful с помощью Microsoft Entra ID.
• Включите автоматический вход пользователей в Contentful с помощью учетных записей Microsoft Entra.
• Управляйте своими учетными записями в одном центральном месте.

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

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

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

• подписка на Contentful с включенной функцией единого входа.

Описание сценария

В этой статье описана настройка и проверка единого входа Microsoft Entra в тестовой среде.

• Contentful поддерживает SSO, инициированный SP и IDP.
• Contentful поддерживает JIT-подготовку пользователей.
• Contentful поддерживает автоматическую подготовку пользователей.

Примечание.

Идентификатор этого приложения — фиксированное строковое значение, поэтому в одном тенанте можно сконфигурировать только один экземпляр.

Добавьте Contentful из галереи

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

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

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

Настройка и проверка единого входа Microsoft Entra для Contentful

Настройте и проверьте одноэтапную аутентификацию Microsoft Entra в Contentful с помощью тестового пользователя B.Simon. Для обеспечения работы единого входа необходимо установить связь между пользователем Microsoft Entra и соответствующим пользователем в Contentful.

Чтобы настроить и проверить единый вход Microsoft Entra в Contentful, выполните следующие действия:

1. Настройте единый вход Microsoft Entra, чтобы пользователи могли использовать эту функцию.
   1. Создайте тестового пользователя Microsoft Entra для тестирования единого входа Microsoft Entra с помощью B.Simon.
   2. Назначьте тестового пользователя Microsoft Entra, чтобы разрешить B.Simon использовать единый вход Microsoft Entra.
2. Настройка SSO в Contentful — для настройки параметров единого входа на стороне приложения.
   1. Создайте тестового пользователя Contentful — для того, чтобы в Contentful была создана аналогия с пользователем B. Simon, связанного с представлением пользователя Microsoft Entra.
3. Проверка единого входа позволяет убедиться в правильности конфигурации.

Настройка SSO Microsoft Entra

Выполните следующие шаги, чтобы включить функцию единого входа (SSO) Microsoft Entra.

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

2. Перейдите к Identity>Applications>Enterprise applications>Contentful>Единый вход.

3. На странице Выбрать метод единого входа выберите SAML.

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

   

5. В разделе Базовая конфигурация SAML, если вы хотите настроить приложение в режиме, инициируемом IDP, выполните следующие действия:

   a. В текстовом поле URL-адрес ответа скопируйте URL-адрес ACS (службы потребителя утверждений) со страницы настройки SSO в Contentful. Он будет выглядеть так: https://be.contentful.com/sso/<organization_id>/consume.

6. Чтобы настроить приложение для работы в режиме, инициируемом поставщиком услуг, щелкните Задать дополнительные URL-адреса и выполните следующие действия.

   a. В текстовом поле URL-адрес входа скопируйте тот же URL-адрес ACS (служба обработки утверждений). Он будет выглядеть так: https://be.contentful.com/sso/<organization_id>/login.

   Примечание.

   Эти значения не являются реальными. Замените эти значения фактическим URL ответа и URL входа, скопировав URL службы ACS (Служба приема утверждений) со страницы настройки SSO в Contentful.

7. Приложение Contentful ожидает утверждения SAML в определенном формате, что требует добавления настраиваемых сопоставлений атрибутов в конфигурацию атрибутов токена SAML. На следующем снимке экрана показан список атрибутов по умолчанию.

   

8. В дополнение к описанному выше приложение Contentful ожидает несколько дополнительных атрибутов в ответе SAML, как показано ниже. Эти атрибуты также заранее заполнены, но вы можете изменить их в соответствии со своими требованиями.

   Имя.	Атрибут источника
   эл. почта	user.userprincipalname

9. На странице Настройка единого входа с помощью SAML в разделе Сертификат подписи SAML найдите пункт Сертификат (Base64) и щелкните Скачать, чтобы скачать сертификат. Сохраните этот сертификат на компьютере.

   

10. В разделе Настройка Contentful скопируйте URL-адрес входа, чтобы настроить единый вход Contentful.

Создание тестового пользователя Microsoft Entra

В этом разделе описано, как создать тестового пользователя B.Simon.

1. Войдите в центр администрирования Microsoft Entra как минимум Администратор пользователей.
2. Перейдите в Идентификация>Пользователи>Все пользователи.
3. Выберите "Создать пользователя>" в верхней части экрана.
4. В свойствах пользователя выполните следующие действия.
   1. В поле "Отображаемое имя" введите B.Simon.
   2. В поле основного имени пользователя введите username@companydomain.extension. Например, B.Simon@contoso.com.
   3. Установите флажок Показать пароль и запишите значение, которое отображается в поле Пароль.
   4. Выберите Просмотреть и создать.
5. Нажмите кнопку создания.

Назначение тестового пользователя Microsoft Entra

В этом разделе описано, как разрешить пользователю B.Simon использовать единый вход, предоставив этому пользователю доступ к Contentful.

1. Войдите в центр администрирования Microsoft Entra как минимум в роли Администратора облачных приложений.
2. Перейдите к Identity>Applications>Enterprise applications>Contentful.
3. На странице обзора приложения выберите "Пользователи" и "Группы".
4. Выберите Добавить пользователя или группу, а затем в диалоговом окне Добавление назначения выберите Пользователи и группы.
   1. В диалоговом окне Пользователи и группы выберите B.Simon в списке пользователей, а затем в нижней части экрана нажмите кнопку Выбрать.
   2. Если пользователям необходимо назначить роль, вы можете выбрать ее из раскрывающегося списка Выберите роль. Если для этого приложения не настроена ни одна роль, будет выбрана роль "Доступ по умолчанию".
   3. В диалоговом окне Добавление назначения нажмите кнопку Назначить.

Настройка единого входа в Contentful

Выполните следующие действия, чтобы настроить единый вход на стороне Contentful.

1. В разделеContentful перейдите на страницу настройки единого входа в области Параметры организации.
2. Щелкните Настроить SSO.
3. Скопируйте и вставьте URL-адрес для входа из раздела Set up Contentful в Microsoft Entra ID.
4. Скопируйте и вставьте сертификат из файла сертификата в формате Base64, скачанного с Microsoft Entra ID.
5. Настройте имя единого входа для входа, инициированного поставщиком услуг.
6. Нажмите кнопку Включить единый вход.

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

Создание тестового пользователя Contentful

В этом разделе описано, как в приложении Contentful создать пользователя с именем B.Simon. Платформа Contentful поддерживает подготовку пользователей по принципу 'точно в срок', включенную по умолчанию. В этом разделе никакие действия с вашей стороны не требуются. Если пользователь еще не существует в Contentful, он создается после проверки подлинности.

Contentful также поддерживает автоматическую подготовку пользователей. Дополнительные сведения о настройке автоматической подготовки пользователей можно найти здесь.

Тестирование SSO (единого входа)

В этом разделе вы тестируете конфигурацию единого входа Microsoft Entra с помощью следующих параметров.

Инициация поставщиком услуг:

• Щелкните "Тестировать это приложение", вы будете перенаправлены по URL-адресу для входа в Contentful, где можно инициировать поток входа.

• Перейдите по URL-адресу для входа в Contentful и инициируйте оттуда поток входа.

Инициировано поставщиком удостоверений (IDP)

• Щелкните "Тестировать это приложение", и вы автоматически войдете в приложение Contentful, для которого настроили единый вход.

Вы можете также использовать портал "Мои приложения" корпорации Майкрософт для тестирования приложения в любом режиме. Щелкнув на плитку Contentful в разделе "Мои приложения", вы будете перенаправлены на страницу входа этого приложения для начала процесса авторизации, если оно настроено в режиме SP. Если приложение настроено в режиме IDP, вы автоматически войдете в приложение Contentful, для которого настроена функция SSO. Дополнительные сведения о портале "Мои приложения" см. в этой статье.

Связанное содержимое

После настройки Contentful вы можете применить функцию управления сеансами, которая в режиме реального времени защищает конфиденциальные данные вашей организации от хищения и несанкционированного доступа. Управление сеансом является расширением функции условного доступа. Узнайте, как применять управление сеансами с помощью приложений Defender для облака.