Сведения об установке GitHub Apps
В этой статье описывается, как установить GitHub App непосредственно у владельца приложения, а не из GitHub Marketplace. Дополнительные сведения об установке GitHub Apps из GitHub Marketplace см. в разделах Установка Приложение GitHub из Магазин GitHub для личная учетная запись и Installing a GitHub App from GitHub Marketplace for your organizations.
Чтобы использовать 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 вам также может быть предложено авторизовать приложение.
When you install a GitHub App on your account or organization, you grant the app permission to access the organization and repository resources that it requested. You also specify which repositories the app can access.
When you authorize a GitHub App you grant the app access to your GitHub account, based on the account permissions the app requested. You also grant the app permission to act on your behalf.
You can install a GitHub App without authorizing the app. Similarly, you can authorize the app without installing the 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.
-
Выберите расположение для установки GitHub App. Вы можете выбрать личная учетная запись или организацию, членом которых вы являетесь.
-
Если приложению требуются разрешения репозитория, выберите Все репозитории или Только выберите репозитории. Приложение всегда будет иметь по крайней мере доступ только для чтения ко всем общедоступным репозиториям в GitHub.
Если приложению не требуются разрешения репозитория, эти параметры будут опущены.
-
Если на предыдущем шаге вы выбрали только выбрать репозитории , в раскрывающемся списке Выбор репозиториев выберите репозитории, к которым приложение будет получать доступ.
Если приложение создает какие-либо репозитории, ему автоматически будет предоставлен доступ к этим репозиториям.
-
Просмотрите разрешения, запрашиваемые приложением. Дополнительные сведения о запросах REST API, которые GitHub App может выполнять с этими разрешениями, см. в разделе Разрешения, необходимые для приложений GitHub.
-
Щелкните Установить, Установить и запросить или Запросить. Представленная кнопка зависит от того, должен ли ваш владелец организации утвердить некоторые или все запрошенные права доступа к приложению.