Установка приложения GitHub из стороннего производителя

Установка GitHub Apps

В этой статье описывается, как установить GitHub App непосредственно от владельца приложения вместо GitHub Marketplace. Дополнительные сведения об установке GitHub Apps из GitHub Marketplaceсм. в разделе[ "AUTOTITLE" иУстановка приложения GitHub из GitHub Marketplace для личная учетная запись](/apps/using-github-apps/installing-a-github-app-in-your-organization)". Дополнительные сведения об установке GitHub Apps см. в разделе "Установка собственного приложения GitHub".

Чтобы использовать GitHub App в репозиториях или организации, необходимо установить приложение в организации или личная учетная запись. Один и тот же GitHub App можно установить на нескольких учетных записях. Например, если вы устанавливаете приложение на личная учетная запись и в нескольких организациях, которые вы владеете, вы сможете использовать приложение в личных репозиториях, в организациях, где установлено приложение, и на репозиториях, принадлежащих этим организациям.

При установке приложения вы предоставляете приложению разрешение на доступ к запрошенным ресурсам организации и репозитория. Во время установки GitHub сообщит вам, какие разрешения запрашивают GitHub App. Дополнительные сведения о REST API запрашивают GitHub App с этими разрешениями, см. в разделе "Разрешения, необходимые для приложений GitHub".

При установке приложения вы также выберете репозитории для предоставления доступа к GitHub App.

Перед установкой GitHub Appнеобходимо доверять владельцу данных GitHub App. Вы также должны просмотреть разрешения, которые запрашивает GitHub App и убедитесь, что вы комфортно предоставляете эти разрешения. Дополнительные сведения о REST API запрашивают GitHub App с этими разрешениями, см. в разделе "Разрешения, необходимые для приложений GitHub".

Нет ограничения на количество установленных приложений.

Разница между установкой и авторизацией

После установки GitHub Appтакже может потребоваться авторизовать приложение.

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

Например, вы можете предоставить разрешение GitHub App для чтения метаданных репозитория и записи, и вы можете предоставить GitHub App доступ ко всем репозиториям.

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

Например, можно предоставить разрешение GitHub App для чтения адресов электронной почты и записи gists.

Вы можете установить GitHub App без авторизации приложения. Аналогичным образом можно авторизовать приложение без установки приложения.

Дополнительные сведения об авторизации GitHub Appsсм. в разделе "Авторизация приложений GitHub".

Требования к установке GitHub App

Любой пользователь может установить GitHub Apps на личная учетная запись.

Владельцы организации могут устанавливать GitHub Apps в своей организации.

Администраторы репозиториев, принадлежащих организации, также могут устанавливать GitHub Apps в организации, если они предоставляют только приложению доступ к репозиториям, которыми они являются администратором, и если приложение не запрашивает разрешения организации или разрешение "администрирование репозитория". Владельцы организации могут запретить внешний участник совместной работы, которые являются администраторами репозитория, устанавливать GitHub Apps.

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

Роль "диспетчер приложений" в организации не дает пользователю возможность устанавливать GitHub App в организации. См. раздел "Сведения о диспетчерах приложений GitHub".

Установка GitHub App

Во время установки владелец приложения будет направлять вас на URL-адрес GitHub для установки GitHub App. URL-адрес будет выглядеть примерно так https://github.com/apps/APP-NAME/installations/new: APP-NAME имя GitHub App.

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

2. Если приложению требуются разрешения репозитория, выберите "Все репозитории " или "Только репозитории". Приложение всегда будет иметь по крайней мере доступ только для чтения ко всем общедоступным репозиториям на GitHub.

   Если приложению не требуются разрешения репозитория, эти параметры будут опущены.

3. Если вы выбрали только репозитории на предыдущем шаге, в раскрывающемся списке "Выбор репозиториев" выберите репозитории, к которым требуется получить доступ к приложению.

   Если приложение создает какие-либо репозитории, приложение автоматически будет предоставлено доступ к этим репозиториям.

4. Просмотрите разрешения, запрашиваемые приложением. Дополнительные сведения о REST API запрашивают GitHub App с этими разрешениями, см. в разделе "Разрешения, необходимые для приложений GitHub".

5. Нажмите кнопку "Установить", "Установить", "Установить" и "Запросить****". Представленная кнопка зависит от того, должна ли ваша владелец организации утвердить ни один из них, некоторые или все запрошенные права доступа для приложения. Дополнительные сведения см. в разделе "Требования к установке GitHub App".