Авторизация приложений OAuth на GitHub Enterprise Server 38 Docs - руководство

OAuth (Open Authorization) - это открытый стандарт авторизации, который позволяет пользователям предоставлять доступ к своим аккаунтам на сторонних сайтах и приложениях, без необходимости раскрытия своих учетных данных.

Веб-сайты и приложения, использующие GitHub Enterprise Server, могут использовать протокол OAuth для аутентификации пользователей. Это позволяет пользователям входить на сайт или в приложение с помощью учетных данных своего аккаунта GitHub, а также предоставляет приложению доступ к части данных и функциональности пользователя на GitHub.

GitHub Enterprise Server 3.8 Docs – руководство предоставляет подробную информацию о том, как настроить авторизацию приложений OAuth на GitHub Enterprise Server. Здесь вы найдете пошаговую инструкцию по созданию и настройке OAuth-приложения на GitHub Enterprise Server, а также информацию о различных аспектах авторизации приложений, таких как генерация токена доступа, управление разрешениями и безопасность.

Чтобы начать использовать OAuth-авторизацию в своем приложении на GitHub Enterprise Server, следуйте инструкциям в GitHub Enterprise Server 3.8 Docs - руководстве. Необходимо создать OAuth-приложение на GitHub Enterprise Server, затем настроить его параметры авторизации и реализовать обработку авторизационных запросов и обмена токена доступа.

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

Раздел 1: Регистрация приложения OAuth

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

Шаги по регистрации приложения OAuth на GitHub Enterprise Server:

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

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

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

1. Откройте веб-сайт GitHub Enterprise Server.
2. Нажмите на кнопку "Регистрация", расположенную в верхнем правом углу экрана.
3. Заполните все необходимые поля в форме регистрации, такие как имя, адрес электронной почты и пароль.
4. Подтвердите свою учетную запись, перейдя по ссылке, которую вы получите на указанную электронную почту.
5. После подтверждения учетной записи войдите на сайт используя свои учетные данные.

У вас теперь есть учетная запись разработчика на GitHub Enterprise Server, которую можно использовать для авторизации приложений.

Шаг 2: Переход на страницу "Разработчик" в настройках GitHub Enterprise Server

После успешной авторизации на GitHub Enterprise Server необходимо перейти на страницу "Разработчик" в настройках вашей учетной записи.

Для этого выполните следующие действия:

1. Нажмите на логотип GitHub в правом верхнем углу страницы. В выпадающем меню выберите пункт "Настройки".
2. На странице "Настройки" найдите вкладку "Разработчик" и нажмите на нее.

После выполнения этих шагов вы будете перенаправлены на страницу "Разработчик", где вы сможете настраивать и управлять своими приложениями OAuth на GitHub Enterprise Server.

Шаг 3: Нажатие на кнопку "Регистрация нового приложения"

После успешного входа в аккаунт на GitHub Enterprise Server вы будете перенаправлены на главную страницу настроек аккаунта. Для регистрации нового приложения следуйте следующим шагам:

1. На главной странице настроек аккаунта прокрутите вниз до раздела "OAuth Apps".

2. Нажмите на кнопку "Register a new application" (Зарегистрировать новое приложение).

3. Заполните обязательные поля формы регистрации нового приложения:

   • Application name (Название приложения): Введите уникальное имя для вашего приложения.

   • Homepage URL (URL главной страницы): Введите URL-адрес главной страницы вашего приложения.

   • Authorization callback URL (URL обратного вызова авторизации): Введите URL-адрес, на который будет перенаправлен пользователь после авторизации.

4. После заполнения всех полей, нажмите кнопку "Register application" (Зарегистрировать приложение).

Поздравляем! Вы успешно зарегистрировали новое приложение на GitHub Enterprise Server. Теперь вы можете использовать полученные данные для авторизации вашего приложения через OAuth.

Раздел 2: Настройка авторизации OAuth

Для корректной работы авторизации приложений на GitHub Enterprise Server необходимо правильно настроить процесс OAuth.

OAuth (Open Authorization) - это протокол авторизации, позволяющий пользователям предоставлять доступ к своим данным на ресурсах одного сайта третьим сторонам без необходимости сообщать пароли. В случае GitHub Enterprise Server, OAuth позволяет разработчикам создавать приложения, которые имеют доступ к репозиториям и информации пользователя.

Перед началом настройки OAuth на GitHub Enterprise Server вам потребуется иметь учетную запись администратора на сервере.

Для настройки авторизации OAuth на GitHub Enterprise Server выполните следующие шаги:

1. Войдите в учетную запись администратора на GitHub Enterprise Server.
2. Откройте раздел "Настройки" и выберите вкладку "Авторизация" или "OAuth".
3. Нажмите на кнопку "Добавить приложение" или "Создать OAuth-приложение".
4. Заполните необходимые поля: название приложения, URL обратного вызова, разрешенные области доступа.
5. Подтвердите создание приложения.

После успешной настройки OAuth вы можете использовать соответствующие ключи и секреты при создании приложений, которые будут авторизовываться на GitHub Enterprise Server.

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

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

Шаг 1: Заполнение полей описания приложения

Вам понадобится указать следующую информацию:

• Название приложения: введите название вашего приложения. Оно будет отображаться пользователям при авторизации.
• Описание: опишите ваше приложение. Укажите основные функции и возможности, которые оно предоставляет.
• Доменное имя: укажите доменное имя, которое будет привязано к вашему приложению. Это необходимо для авторизации и редиректа на вашу платформу.
• Коллекция организаций: укажите, хотите ли вы разрешить авторизацию для всех организаций на GitHub Enterprise Server или только для определенных.
• URL-адрес авторизации: укажите URL-адрес, на который GitHub Enterprise Server будет перенаправлять пользователей для авторизации.
• URL-адрес коллбека: укажите URL-адрес, на который GitHub Enterprise Server будет перенаправлять пользователей после успешной авторизации.
• URL-адрес иконки: указывается URL-адрес иконки приложения, которая будет отображаться пользователям при авторизации.

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

Шаг 2: Установка URL-адресов, необходимых для авторизации

Для успешной авторизации приложения на GitHub Enterprise Server необходимо установить URL-адреса, которые будут использоваться в процессе авторизации.

URL-адрес для главной страницы приложения

В качестве URL-адреса главной страницы приложения рекомендуется использовать адрес вашего сервера или домена приложения. Например:

https://example.com

URL-адрес для колбэка авторизации

URL-адрес колбэка авторизации – это URL-адрес, по которому будет перенаправлен пользователь после успешной авторизации. Этот адрес должен указывать на обработчик, который получит авторизационный код. В настройках GitHub Enterprise Server следует указать следующий URL-адрес:

https://example.com/callback

Обратите внимание, что URL-адрес колбэка авторизации должен использовать HTTPS-протокол для обеспечения безопасности передачи данных.

После установки этих URL-адресов, GitHub Enterprise Server будет использовать их для авторизации вашего приложения.