Настройка единого входа SAML для предприятия – GitHub Enterprise Cloud Docs

Настройка единого входа SAML (Security Assertion Markup Language) для предприятия позволяет упростить процесс управления учетными записями сотрудников, обеспечивая централизованную авторизацию и аутентификацию.

GitHub Enterprise Cloud поддерживает протокол SAML, который позволяет вашему предприятию интегрироваться с внешней системой управления идентификацией (Identity Provider) и использовать ее для аутентификации пользователей. Это гарантирует безопасную и надежную идентификацию и упрощает процесс входа в систему для всех сотрудников.

Настройка единого входа (Single Sign-On) с использованием SAML в GitHub Enterprise Cloud дает вашему предприятию возможность контролировать доступ пользователей, роли и привилегии общего доступа, управлять сеансами активности пользователей и обеспечивать безопасность вашей бизнес-информации.

Данный документ обеспечивает пошаговую инструкцию по настройке SAML для вашего предприятия в GitHub Enterprise Cloud и рекомендации для успешной интеграции с вашей системой управления идентификацией. Следуя этим инструкциям, вы сможете без проблем активировать и использовать единый вход SAML для всех пользователей в вашей организации.

Раздел 1: Подготовка к настройке единого входа SAML

Перед тем, как приступить к настройке единого входа SAML для вашего предприятия, вам необходимо выполнить несколько предварительных шагов.

1. Убедитесь, что у вас есть доступ к административным правам для вашего GitHub Enterprise Cloud.
2. Ознакомьтесь с единичной точкой входа вашей организации и убедитесь, что она поддерживает протокол SAML. Если необходимо, свяжитесь с вашим IT-отделом для получения дополнительной информации.
3. Удостоверьтесь, что у вас есть SSL-сертификат, необходимый для настройки безопасного обмена данными с вашей SAML-провайдером.
4. Проанализируйте требования вашей организации к настройке единого входа SAML. Вам могут потребоваться определенные атрибуты или роли, которые нужно будет применить к вашим пользователям во время SSO-процесса.

Когда вы завершите эти предварительные шаги, вы будете готовы приступить к настройке единого входа SAML в GitHub Enterprise Cloud.

Шаг 1: Создание учетной записи провайдера идентификации предприятия

Ваш IdP может представлять собой такие платформы, как Okta, OneLogin, Ping Identity и многие другие. Перед созданием учетной записи вам потребуется следующая информация:

• URL для входа в ваш IdP.
• URL для выхода из вашего IdP.
• URL для получения метаданных вашего IdP.
• X.509 сертификат для вашего IdP.

После создания учетной записи провайдера идентификации предприятия, вы сможете перейти к следующему шагу – настройке единого входа SAML для вашего GitHub Enterprise. Это позволит вашим пользователям аутентифицироваться на GitHub Enterprise с использованием учетных данных вашего IdP.

Генерация сертификатов для идентификации

Для настройки единого входа SAML необходимо создать сертификаты, которые будут использоваться для идентификации вашего предприятия. Такие сертификаты обеспечивают безопасность и защиту данных, передаваемых между вашим предприятием и GitHub Enterprise Cloud.

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

1. Установите инструмент OpenSSL

OpenSSL является библиотекой и набором инструментов для работы с криптографией, включая генерацию и управление сертификатами.

Чтобы установить OpenSSL, воспользуйтесь инструкциями для вашей операционной системы.

2. Создайте приватный ключ

Приватный ключ является секретным файлом, который используется для создания и проверки электронной подписи.

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

openssl req -new -newkey rsa:2048 -nodes -keyout key.pem -out csr.pem

Убедитесь, что вы ввели корректные данные во время выполнения этой команды. Используйте надежные пароли и информацию, которую следует указать в вашем сертификате.

Сохраните приватный ключ в key.pem.

3. Создайте запрос на сертификат (CSR)

CSR является файлом, который содержит информацию о вашем предприятии и публичный ключ, связанный с вашим приватным ключом.

Создайте CSR с помощью следующей команды:

openssl x509 -req -sha256 -in csr.pem -signkey key.pem -out cert.pem

Сохраните CSR в csr.pem.

4. Загрузите сертификат в GitHub Enterprise Cloud

После создания сертификата, вам необходимо загрузить его в GitHub Enterprise Cloud. Инструкции по загрузке сертификата можно найти в документации GitHub.

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

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

Настройка метаданных провайдера идентификации

Для начала настройки метаданных провайдера идентификации, вам понадобится предоставить метаданные своего провайдера идентификации пользовательской службе поддержки GitHub Enterprise Cloud.

Метаданные провайдера идентификации могут быть представлены в формате XML или в файле, доступном по URL. Рекомендуется использовать файлы, доступные по URL, чтобы обеспечить актуальность метаданных.

В метаданных провайдера идентификации должна быть указана информация о вашей организации и атрибуты, которые вы хотите передавать GitHub Enterprise Cloud.

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

Примечание: при предоставлении метаданных пользовательской службе поддержки GitHub Enterprise Cloud, убедитесь, что вы не раскрываете конфиденциальные данные или информацию, которую вы не хотите передавать GitHub.

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

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

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

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

Раздел 2: Настройка единого входа SAML для GitHub Enterprise Cloud

В этом разделе мы рассмотрим процесс настройки единого входа SAML для GitHub Enterprise Cloud. Единый вход SAML позволяет вашей организации использовать свою систему аутентификации для управления доступом к учетным записям пользователей в GitHub.

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

Чтобы настроить единый вход SAML для GitHub Enterprise Cloud, выполните следующие шаги:

1. Создайте провайдера идентичности в вашей системе аутентификации и настройте его параметры.
2. Создайте метаданные провайдера идентичности и сохраните их на вашем компьютере.
3. Войдите в свою учетную запись GitHub Enterprise Cloud и перейдите в настройки вашей организации.
4. Выберите вкладку “Единый вход SAML” и нажмите на кнопку “Настроить SAML для вашей организации”.
5. Загрузите метаданные провайдера идентичности в соответствующее поле и нажмите “Продолжить”.
6. Настройте сопоставление атрибутов пользователей между вашей системой аутентификации и GitHub.
7. Установите параметры безопасности и првила для единого входа SAML.
8. Сохраните настройки и проверьте работу единого входа SAML для вашей организации в GitHub Enterprise Cloud.

После завершения настройки вы сможете использовать единый вход SAML для управления доступом к вашей организации в GitHub Enterprise Cloud. Это позволит вашей компании улучшить безопасность и упростить процесс аутентификации пользователей.

Шаг 2: Настройка SAML для аккаунта GitHub Enterprise Cloud

После создания единого входа SAML для предприятия вы можете настроить SAML для своего аккаунта GitHub Enterprise Cloud.

1. На странице администрирования аккаунта прокрутите вниз до раздела “Authentication” и нажмите на “SAML single sign-on”.

2. На странице “Настройка SAML” нажмите на “Редактировать” рядом с “SAML single sign-on”.

3. В поле “Issuer” введите идентификатор (Issuer) для вашего удостоверяющего центра SAML.

4. В поле “SSO URL” введите URL-адрес SSO для вашего удостоверяющего центра SAML.

5. В поле “Certificate fingerprint” введите отпечаток сертификата вашего удостоверяющего центра SAML.

6. Нажмите “Сохранить”, чтобы применить настройки SAML.

После настройки SAML для аккаунта GitHub Enterprise Cloud, учетные записи пользователей будут проверяться и аутентифицироваться через ваш удостоверяющий центр SAML.

Добавление провайдера идентификации в настройки GitHub

В этом разделе мы рассмотрим, как добавить провайдера идентификации в настройки GitHub и настроить SAML-авторизацию для вашего предприятия.

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

Затем выберите раздел “Безопасность и доступ” и перейдите во вкладку “Настройки SAML-авторизации”. Здесь вы найдете список всех настроенных провайдеров идентификации.

Чтобы добавить нового провайдера, нажмите кнопку “Добавить провайдера идентификации”. В появившемся окне вам потребуется указать URL-адрес метаданных вашего провайдера идентификации.

После добавления провайдера вам необходимо сохранить настройки и ввести пароль администратора для подтверждения изменений.

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

Обратите внимание, что все ваши пользователи должны быть зарегистрированы в вашем провайдере идентификации, чтобы использовать SAML-авторизацию.

Теперь вы готовы использовать SAML-авторизацию для вашего предприятия в GitHub. Это обеспечит единый вход для всех ваших пользователей и повысит безопасность вашей организации.