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

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

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

Функция GitHub Enterprise Managed User доступна в следующих национальных облачных средах.

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

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

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

Шаг 1: Спланируйте развертывание ваших ресурсов

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

Шаг 2. Подготовка к конфигурированию в Microsoft Entra ID

1. Определите URL-адрес клиента. Это значение, которое вы вводите в поле URL-адреса арендатора на вкладке "Управление" приложения GitHub Enterprise Managed User.

   • Для предприятия на GitHub.com URL-адрес арендатора — https://api.github.com/scim/v2/enterprises/{enterprise}.
   • Для предприятия на GHE.com URL-адрес клиента https://api.{subdomain}.ghe.com/scim/v2/enterprises/{subdomain}

2. Убедитесь, что вы создали токен с областью scim:enterprise для пользователя настройки вашего предприятия. Это значение введите в поле "Секретный токен" на вкладке "Подготовка" приложения GitHub Enterprise Managed User. См. статью "Приступая к работе с корпоративными управляемыми пользователями " на сайте GitHub Docs.

Шаг 3. Добавление управляемого пользователя GitHub Enterprise из коллекции приложений Microsoft Entra

Добавьте GitHub Enterprise Managed User из галереи приложений Microsoft Entra, чтобы начать управление провизионированием для GitHub Enterprise Managed User. Если ранее вы настроили GitHub Enterprise Managed User для единого входа, вы можете использовать то же приложение. Но мы рекомендуем создать отдельное приложение для исходной проверки интеграции. Дополнительные сведения о добавлении приложения из коллекции см. здесь.

Шаг 4. Определение того, кто подлежит обеспечению

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

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

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

Шаг 5. Настройка автоматического предоставления пользователей для управляемых пользователей GitHub Enterprise

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

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

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

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

   

3. В списке приложений выберите GitHub Enterprise Managed User.

   

4. Перейдите на вкладку "Подготовка ".

   

5. Задать + Новая конфигурация.

   

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

   

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

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

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

   

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

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

    Атрибут	Тип	Доступно для фильтрации
    externalId (внешний идентификатор)	Строка	✓
    userName	Строка
    активный	Логический
    роли	Строка
    отображаемое имя	Строка
    имя.имяОтчество	Строка
    name.фамилия	Строка
    имя.отформатировано	Строка
    Электронные письма[тип eq "работа"].значение	Строка
    emails[type eq "домашний"].value	Строка
    emails[type eq "другое"].value	Строка

12. Выберите Группы.

13. Просмотрите атрибуты группы, синхронизированные из Microsoft Entra ID в GitHub Enterprise Managed User в разделе Сопоставление атрибутов. Атрибуты, выбранные в качестве свойств сопоставления , используются для сопоставления групп в GitHub Enterprise Managed User для операций обновления. Нажмите кнопку "Сохранить ", чтобы зафиксировать любые изменения.

    Атрибут	Тип	Доступно для фильтрации
    externalId (внешний идентификатор)	Строка	✓
    отображаемое имя	Строка
    члены	Справочные материалы

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

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

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

Шаг 6. Мониторинг развертывания

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

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

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

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

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

• Узнайте, как просматривать журналы и отчеты по активности по обеспечению