Настройка единого входа Gradle Enterprise с помощью идентификатора Microsoft Entra

2025-04-30

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

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

Необходимые условия

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

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

Подписка Gradle Enterprise с поддержкой единого входа (SSO).

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

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

Gradle Enterprise поддерживает единый вход, инициированный поставщиком службы

Добавление Gradle Enterprise из галереи

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

Войдите в Центр администрирования Microsoft Entra как минимум администратор облачных приложений.
Перейдите к Entra ID>приложениям для предприятий>Новое приложение.
В разделе "Добавление из коллекции " в поле поиска введите Gradle Enterprise .
Выберите Gradle Enterprise на панели результатов и добавьте это приложение. Подождите несколько секунд, пока приложение добавляется в клиент.

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

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

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

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

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

Настройте единую систему входа Microsoft Entra

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

Войдите в Центр администрирования Microsoft Entra как минимум администратор облачных приложений.
Перейдите к приложению Entra ID>Enterprise>Gradle Enterprise>Single sign-on.
На странице "Выбор метода единого входа" выберите SAML.
На странице "Настройка единого входа" на странице SAML выберите значок редактирования и пера для базовой конфигурации SAML , чтобы изменить параметры.
В разделе "Базовая конфигурация SAML" введите значения для следующих полей:

a. В текстовом поле URL-адреса входа введите URL-адрес , используя следующий шаблон: https://<CLIENT_DOMAIN>

б. В текстовом поле "Идентификатор сущности" введите URL-адрес, используя следующий шаблон: https://<CLIENT_DOMAIN>/keycloak/realms/gradle-enterprise

с. В текстовом поле "URL-адрес ответа" введите URL-адрес, используя следующий шаблон: https://<CLIENT_DOMAIN>/keycloak/realms/gradle-enterprise/broker/saml/endpoint

Заметка

Эти значения не являются реальными. Обновите эти значения фактическим URL-адресом входа и идентификатором. Чтобы получить эти значения, обратитесь к группе поддержки клиентов Gradle Enterprise. Вы также можете ссылаться на шаблоны, показанные в разделе "Базовая конфигурация SAML ".
На странице "Настройка единого входа с помощью SAML " в разделе "Сертификат подписи SAML " найдите XML метаданных федерации и выберите "Скачать ", чтобы скачать сертификат и сохранить его на компьютере.
Скопируйте соответствующие URL-адреса в разделе "Настройка Gradle Enterprise" в соответствии с вашим требованием.

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

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

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

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

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

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

Настроить систему единого входа Gradle Enterprise

Чтобы настроить единый вход на стороне Gradle Enterprise , необходимо отправить скачанный XML-код метаданных федерации и соответствующие URL-адреса, скопированные из конфигурации приложения, в службу поддержки Gradle Enterprise. Они задают этот параметр для правильного установки подключения SAML SSO на обеих сторонах.

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

В этом разделе описано, как создать пользователя Britta Simon в Gradle Enterprise. Обратитесь к группе поддержки Gradle Enterprise , чтобы добавить пользователей на платформу Gradle Enterprise. Пользователи должны быть созданы и активированы перед использованием единого входа.

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

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

Выберите Протестировать это приложение, этот параметр перенаправит вас на URL-адрес входа Gradle Enterprise, где можно инициировать процесс входа.
Перейдите непосредственно по URL-адресу для входа в Gradle Enterprise и начните процесс входа оттуда.
Панель доступа Майкрософт можно использовать. При выборе плитки Gradle Enterprise на панели доступа вас перенаправят к URL для входа Gradle Enterprise. Дополнительные сведения о панели доступа см. в разделе "Общие сведения о панели доступа".

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