Руководство по интеграции единого входа Microsoft Entra с организацией GitHub Enterprise Cloud

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

• Контроль доступа к организации GitHub Enterprise Cloud с помощью идентификатора Microsoft Entra ID.
• Управление доступом к организации GitHub Enterprise Cloud в одном центральном расположении.

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

Чтобы приступить к работе, потребуется следующее.

• Подписка Microsoft Entra. Если у вас нет подписки, вы можете получить бесплатную учетную запись.
• Организация GitHub, созданная в облаке GitHub Enterprise Cloud, которой требуется план выставления счетов GitHub Enterprise.

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

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

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

• GitHub поддерживает автоматическую подготовку пользователей (приглашения организации).

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

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

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

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

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

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

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

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

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

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

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

2. Перейдите к приложениям>Identity>Applications>Enterprise GitHub>с единым входом.

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

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

   

5. На странице Базовая конфигурация SAML введите значения следующих полей.

   a. В текстовое поле Идентификатор (идентификатор сущности) введите URL-адрес в следующем формате: https://github.com/orgs/<Organization ID>.

   b. В текстовом поле URL-адрес ответа введите URL-адрес в следующем формате: https://github.com/orgs/<Organization ID>/saml/consume.

   c. В текстовом поле URL-адрес для входа введите URL-адрес в следующем формате: https://github.com/orgs/<Organization ID>/sso

   Примечание.

   Обратите внимание, что значения, указанные выше, используются в качестве примера. Необходимо указать фактические значения идентификатора, URL-адреса ответа и URL-адреса входа. Мы рекомендуем использовать уникальное значение строки идентификатора. Перейдите в раздел администрирования GitHub, чтобы получить эти значения.

6. Приложение GitHub ожидает утверждения SAML в определенном формате, поэтому следует добавить настраиваемые сопоставления атрибутов в вашу конфигурацию атрибутов токена SAML. На следующем снимке экрана показан список атрибутов по умолчанию, в котором значение Уникальный идентификатор пользователя (ID) сопоставляется с user.userprincipalname. Приложение GitHub ожидает сопоставления уникального идентификатора пользователя (ID) с user.mail, поэтому необходимо изменить сопоставление атрибутов, щелкнув значок Изменить.

   

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

   

8. Требуемый URL-адрес можно скопировать из раздела Настройка GitHub.

   

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

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

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

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

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

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

2. Перейдите к приложениям>Identity>Applications>Enterprise GitHub.

3. На странице "Обзор" приложения найдите раздел Управление и выберите Пользователи и группы.

4. Выберите Добавить пользователя, а в диалоговом окне Добавление назначения выберите Пользователи и группы.

5. В диалоговом окне Пользователи и группы выберите B.Simon в списке пользователей, а затем в нижней части экрана нажмите кнопку Выбрать.

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

   

7. В диалоговом окне Добавление назначения нажмите кнопку Назначить.

Настройка единого входа для GitHub

1. В другом окне веб-браузера войдите на свой корпоративный сайт GitHub в качестве администратора.

2. Перейдите к разделу Параметры и щелкните Безопасность.

   

3. Установите флажок Enable SAML authentication (Включить аутентификацию SAML). После отображения полей конфигурации единого входа выполните следующие действия:

   

   a. Скопируйте значение URL-адреса единого входа и вставьте это значение в текстовое поле URL-адреса входа в базовой конфигурации SAML.

   b. Скопируйте значение URL-адреса службы потребителей утверждения и вставьте это значение в текстовое поле URL-адреса ответа в базовой конфигурации SAML.

4. Задайте значения в следующих полях:

   

   a. В текстовое поле URL-адреса входа вставьте значение URL-адреса входа, скопированное ранее.

   b. В текстовое поле издателя вставьте значение идентификатора Microsoft Entra, скопированное ранее.

   c. Откройте в Блокноте сертификат, скачанный с портала Azure, и вставьте его содержимое в текстовое поле Public Certificate (Общедоступный сертификат).

   d. Щелкните значок Изменить, чтобы изменить метод подписи и метод выборки с RSA-SHA1 и SHA1 на RSA-SHA256 и SHA256, как показано ниже.

   д) Замените URL-адрес по умолчанию на URL-адрес службы обработчика утверждений (URL-адрес ответа), чтобы URL-адрес в GitHub совпадал с URL-адресом на странице регистрации приложения в Azure.

   

5. Щелкните Test SAML configuration (Проверка конфигурации SAML), чтобы убедиться в отсутствии сбоев проверки при выполнении единого входа.

   

6. Щелкните Сохранить.

Примечание.

Технология единого входа в GitHub позволяет выполнять аутентификацию определенных организаций и не заменяет метод аутентификации самого репозитория. Однако если сеанс github.com истекает, пользователи могут получить запрос на вход с использованием идентификатора и пароля GitHub во время процесса единого входа.

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

В рамках этого раздела создается пользователь с именем Britta Simon в GitHub. GitHub поддерживает автоматическую подготовку пользователей, которая по умолчанию включена. Дополнительные сведения о настройке автоматической подготовки пользователей можно найти здесь.

Если необходимо создать пользователя вручную, выполните следующие действия:

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

2. Выберите параметр Пользователи.

   

3. Нажмите Invite member (Пригласить участника).

   

4. На странице диалогового окна Invite member (Приглашение участников) сделайте следующее.

   a. В текстовом поле Электронная почта введите адрес электронной почты учетной записи Britta Simon.

   

   b. Щелкните Send Invitation (Отправить приглашение).

   

   Примечание.

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

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

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

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

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

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

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

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