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

В этой статье вы узнаете, как интегрировать Redocly с идентификатором Microsoft Entra. Redocly — это первое средство документации разработчика, которое позволяет нам хранить документы в GitHub, сохраняя документы разработчиков рядом с разработчиками. Интеграция Redocly с идентификатором Microsoft Entra id позволяет:

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

Вы настроите и проверьте единый вход Microsoft Entra для Redocly в тестовой среде. Redocly поддерживает единый вход, инициированный поставщиком услуг , и подготовку пользователей Just In Time .

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

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

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

Добавление приложения и назначение тестового пользователя

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

Добавление Redocly из коллекции Microsoft Entra

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

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

Следуйте инструкциям в статье о создании и назначении учетной записи пользователя, чтобы создать тестовую учетную запись пользователя B.Simon.

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

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

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

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

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

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

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

   

5. В разделе Базовая конфигурация SAML выполните приведенные ниже действия.

   a. В текстовом поле Идентификатор введите URL-адрес в одном из следующих форматов:

   Идентификатор
   https://api.redocly.com/auth/sso?idpId=<CustomerId>
   https://api.<Region>.redocly.com/auth/sso?idpId=<CustomerId>

   b. В текстовое поле URL-адрес ответа введите URL-адрес в любом из следующих форматов:

   URL-адрес ответа
   https://api.redocly.com/auth/sso
   https://api.<Region>.redocly.com/auth/sso
   https://<SiteName>.redoc.dev/_auth/saml2
   https://<SiteName>.<REGION>.redoc.dev/_auth/saml2

   c. В текстовом поле URL-адрес для входа введите URL-адрес в любом из следующих форматов:

   URL-адрес для входа
   https://app.redocly.com/login-sso
   https://app.<Region>.redocly.com/login-sso
   https://<SiteName>.redoc.dev/_auth/idp-login
   https://<SiteName>.<REGION>.redoc.dev/_auth/idp-login

   Примечание.

   Эти значения приведены для примера. Измените их на фактические значения идентификатора и URL-адресов ответа и входа. Чтобы получить эти значения, обратитесь в службу поддержки Redocly. Вы также можете ссылаться на шаблоны, показанные в разделе "Базовая конфигурация SAML".

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

   

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

   

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

Чтобы настроить единый вход на стороне Redocly , необходимо отправить скачанный сертификат (PEM) и соответствующие URL-адреса из конфигурации приложения в службу поддержки Redocly. Специалисты службы поддержки настроят подключение единого входа SAML на обеих сторонах.

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

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

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

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

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

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

• Вы можете использовать портал "Мои приложения" корпорации Майкрософт. Щелкнув плитку Redocly в Мои приложения, вы перейдете по URL-адресу для входа Redocly. Дополнительные сведения см. в Мои приложения Microsoft Entra.

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

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

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

После настройки Redocly вы можете применить функцию управления сеансами, которая защищает конфиденциальные данные вашей организации от кражи и несанкционированного доступа в режиме реального времени. Управление сеансом является расширением функции условного доступа. Узнайте, как применять управление сеансами с помощью Microsoft Cloud App Security.