Установка приложения OAuth в организации - GitHub Enterprise Cloud Docs

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

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

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

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

Установка OAuth приложения на GitHub Enterprise Cloud

GitHub Enterprise Cloud позволяет организациям создавать и использовать приложения с помощью протокола OAuth. OAuth позволяет пользователям авторизовывать третьесторонние приложения для доступа к их аккаунту на GitHub. В этом разделе описан шаг за шагом процесс установки OAuth приложения на GitHub Enterprise Cloud.

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

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

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

1. Откройте страницу Настройки разработчика в своей организации GitHub.
2. Нажмите кнопку "Зарегистрировать новое приложение".
3. Заполните поля "Имя приложения" и "URL авторизации". Имя приложения может быть произвольным, это имя будет отображаться при запросе авторизации пользователя. В поле "URL авторизации" укажите URL адрес, который будет использоваться для авторизации пользователей вашего приложения.
4. Выберите тип приложения - "Веб" или "Мобильное". В случае выбора "Веб" укажите домен вашего приложения в поле "URL авторизации". В случае выбора "Мобильное" укажите "Адрес перенаправления OAuth".
5. Укажите разрешения, которые ваше приложение будет запрашивать у пользователей GitHub. Например, доступ к учетной записи, право на чтение репозиториев и другие. Выберите нужные разрешения из предложенного списка.
6. Нажмите кнопку "Зарегистрировать приложение".

После регистрации приложения вам будут предоставлены Client ID и Client Secret - уникальные идентификаторы вашего приложения. При необходимости, сохраните их для использования при дальнейшей настройке.

Перейдите к следующему шагу для настройки вашего приложения OAuth в организации GitHub Enterprise Cloud.

Шаг 2: Настройка на стороне организации

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

1. Зайдите в настройки организации на GitHub Enterprise Cloud.
2. Выберите вкладку "OAuth приложения".
3. Нажмите кнопку "Настроить OAuth приложение".
4. Введите название приложения, которое будет отображаться для пользователей при авторизации через OAuth.
5. Укажите URL-адрес вашего сервера OAuth. Этот URL-адрес будет использоваться GitHub для перенаправления пользователей после успешной авторизации.
6. Укажите URL-адрес страницы с информацией о приложении для пользователей.
7. Выберите необходимые разрешения для приложения. Разрешения определяют, какие операции на сервере GitHub будет разрешено выполнять приложению OAuth.
8. Нажмите кнопку "Добавить приложение", чтобы сохранить настройки.

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

Настройка GitHub Enterprise Cloud Docs

Для настройки GitHub Enterprise Cloud Docs в организации необходимо выполнить следующие шаги:

1. Войдите в аккаунт администратора организации в GitHub.
2. Перейдите на вкладку "Settings" (Настройки) вашей организации.
3. Выберите вкладку "Security" (Безопасность).
4. Прокрутите страницу вниз до раздела "OAuth Apps" (Приложения OAuth).
5. Нажмите кнопку "New OAuth App" (Создать приложение OAuth).
6. Заполните поле "Application name" (Название приложения) и "Homepage URL" (URL домашней страницы) для вашего приложения.
7. Укажите URL-адрес авторизации "Authorization callback URL" (URL обратного вызова авторизации).
8. Выберите необходимые разрешения для вашего приложения.
9. Нажмите кнопку "Register application" (Зарегистрировать приложение).
10. Скопируйте и сохраните Client ID и Client Secret вашего приложения.

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

Шаг 3: Добавление приложения в GitHub

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

1. Войдите в ваш аккаунт на GitHub и перейдите на страницу настроек вашей организации.

2. В меню слева выберите "Настройки" и перейдите на вкладку "OAuth приложения".

3. Нажмите на кнопку "Зарегистрировать новое приложение".

4. Введите название приложения и домен приложения. Домен приложения должен быть доступен из Интернета и вести на ваш сервер с установленным приложением OAuth.

5. Укажите URL коллбэка, который будет использоваться для перенаправления обратно из GitHub после успешной аутентификации. В зависимости от ваших настроек сервера, URL коллбэка может иметь следующий формат: https://example.com/callback.

6. Укажите домен настройки OAuth, который будет использоваться для привязки других приложений к вашему OAuth. Введите его в формате: https://example.com.

7. Укажите область видимости для вашего приложения. Область видимости определяет, какие ресурсы GitHub пользователь сможет просматривать и редактировать через ваше приложение. Выберите только необходимые права доступа для вашего приложения.

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

9. После регистрации приложения вы получите идентификатор клиента и секретный ключ приложения. Сохраните эти данные в безопасном месте, так как они понадобятся для настройки аутентификации OAuth в вашем приложении.

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

Шаг 4: Настройка прав доступа и ограничений

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

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

Права доступа могут включать возможность чтения, записи, создания и удаления репозиториев и других объектов в GitHub Enterprise Cloud. Ограничения могут включать ограничение доступа к определенным репозиториям, веткам, комментариям и задачам.

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

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

• Выберите вкладку "Настройки" в профиле пользователя или команды.
• Настройте права доступа и ограничения в соответствии с потребностями вашего проекта.
• Сохраните изменения.

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