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

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

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

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

Чтобы интегрировать Идентификатор Microsoft Entra с Contentstack, вам потребуется:

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

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

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

• Contentstack поддерживает единый вход, инициированный поставщиком услуг и поставщиком удостоверений .
• Contentstack поддерживает JIT-подготовку пользователей.

Добавление Contentstack из коллекции

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

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

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

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

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

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

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

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

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

1. Войдите в Центр администрирования Microsoft Entra в качестве администратора облачных приложений и перейдите к приложениям Identity>Applications>Enterprise.

2. Теперь щелкните +Создать приложение и найдите Contentstack и нажмите кнопку "Создать". После создания перейдите к разделу "Настройка единого входа" или щелкните ссылку "Единый вход" в меню слева.

   

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

   

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

   

5. В разделе "Базовая конфигурация SAML" необходимо выполнить несколько действий. Чтобы получить сведения, необходимые для этих действий, сначала необходимо перейти к приложению Contentstack и создать URL-адрес единого входа и ACS следующим образом:

   a. Войдите в учетную запись Contentstack, перейдите на страницу параметров организации и перейдите на вкладку "Единый вход ".

   

   b. Введите имя единого входа и нажмите кнопку "Создать".

   

   Примечание.

   Например, если название вашей компании — Acme, Inc. Введите "acme" здесь. Это имя будет использоваться в качестве одного из учетных данных входа пользователями организации при входе. Имя единого входа может содержать только алфавиты (в нижнем регистре), цифры (0-9) и (или) дефисы (-).

   c. При нажатии кнопки "Создать" будет создан URL-адрес службы потребителей утверждений или URL-адрес ACS, а также другие сведения, такие как идентификатор сущности, атрибуты и формат NameID.

   

6. Вернитесь в раздел "Базовая конфигурация SAML", вставьте идентификатор сущности и URL-адрес ACS, созданный в приведенном выше наборе шагов, в разделах идентификатора (идентификатор сущности) и URL-адреса ответа соответственно и сохраните записи.

   1. В текстовом поле "Идентификатор" вставьте значение идентификатора сущности, скопированное из Contentstack.

      

   2. В текстовом поле "URL-адрес ответа" вставьте URL-адрес ACS, скопированный из Contentstack.

      

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

   

   Примечание.

   При завершении настройки единого входа вы найдете URL-адрес единого входа (т. е. URL-адрес для входа).

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

   

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

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

   Примечание.

   Щелкните здесь , чтобы узнать, как настроить роль в идентификаторе Microsoft Entra.

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

    

11. Скопируйте соответствующие URL-адреса в разделе "Настройка Contentstack" в соответствии с вашим требованием.

    

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

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

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

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

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

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

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

1. Войдите на корпоративный сайт Contentstack в качестве администратора.

2. Перейдите на страницу "Параметры организации" и перейдите на вкладку "Единый вход " в меню слева.

3. На странице единого входа перейдите в раздел "Конфигурация единого входа" и выполните следующие действия:

   1. Введите допустимое имя единого входа и нажмите кнопку "Создать".

      

      Примечание.

      Например, если название вашей компании — Acme, Inc. Введите "acme" здесь. Это имя будет использоваться в качестве одного из учетных данных входа пользователями организации при входе. Имя единого входа может содержать только алфавиты (в нижнем регистре), цифры (0-9) и (или) дефисы (-).

   2. При нажатии кнопки "Создать" будет создан URL-адрес службы потребителей утверждений или URL-адрес ACS, а также другие сведения, такие как идентификатор сущности, атрибуты и формат NameID и нажмите кнопку "Далее".

      

4. Перейдите на вкладку "Конфигурация поставщика удостоверений" и выполните следующие действия.

   

   1. В текстовое поле "URL-адрес единого входа" вставьте URL-адрес входа, скопированный из Центра администрирования Microsoft Entra.

   2. Откройте скачанный сертификат (Base64) из Центра администрирования Microsoft Entra и отправьте его в поле сертификата .

   3. Нажмите кнопку Далее.

5. Затем необходимо создать сопоставление ролей в Contentstack.

   Примечание.

   Вы сможете просматривать и выполнять этот шаг, если сопоставление ролей поставщика ролей является частью плана Contentstack.

6. В разделе "Управление пользователями" на странице "Настройка единого входа Contentstack" вы увидите строгий режим (авторизация доступа к пользователям организации только через единый вход) и время ожидания сеанса (определение продолжительности сеанса для пользователя, выполнившего вход через единый вход). Под этими параметрами вы также увидите параметр "Дополнительные параметры".

   

7. Щелкните "Дополнительные параметры", чтобы развернуть раздел "Сопоставление ролей удостоверений поставщика ролей", чтобы сопоставить роли поставщика ролей с Contentstack. Это необязательный шаг.

8. В разделе "Добавление сопоставления ролей" щелкните ссылку +ADD ROLE MAPPING, чтобы добавить сведения о сопоставлении роли поставщика удостоверений, которая содержит следующие сведения:

   

   1. В идентификаторе роли поставщика удостоверений введите идентификатор группы или роли idP (например, "разработчики"), который можно использовать из манифеста.

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

   3. Для разрешений на уровне стека (необязательно) назначаются стеки и соответствующие роли уровня стека для этой роли. Аналогичным образом можно добавить дополнительные сопоставления ролей для организации Contentstack. Чтобы добавить новое сопоставление ролей, щелкните +ДОБАВИТЬ СОПОСТАВЛЕНИЕ РОЛЕЙ и введите сведения.

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

   5. Наконец, установите флажок "Включить сопоставление ролей поставщика удостоверений ", чтобы включить функцию и нажмите кнопку "Далее".

   Примечание.

   Дополнительные сведения см. в руководстве по единому входу Contentstack.

9. Перед включением единого входа рекомендуется проверить параметры единого входа, настроенные до сих пор. Для этого выполните следующие действия:

   1. Нажмите кнопку "Тест единого входа", и вы перейдете к входу Contentstack на странице единого входа , где необходимо указать имя единого входа вашей организации.
   2. Затем нажмите кнопку "Продолжить", чтобы перейти на страницу входа поставщика удостоверений.
   3. Войдите в свою учетную запись и, если вы сможете войти в идентификатор поставщика удостоверений, тест выполнен успешно.
   4. При успешном подключении вы увидите сообщение об успешном выполнении, как показано ниже.

   

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

    

11. После включения этого доступа пользователи могут получить доступ к организации через единый вход. При необходимости вы также можете отключить единый вход на этой странице.

    

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

В этом разделе пользователь с именем Britta Simon создается в Contentstack. Contentstack поддерживает JIT-подготовку пользователей, которая включена по умолчанию. В этом разделе никакие действия с вашей стороны не требуются. Если пользователь еще не существует в Contentstack, он создается после проверки подлинности.

Проверка единого входа

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

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

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

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

Вход, инициированный поставщиком удостоверений

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

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

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

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