Установка приложения 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".

Note

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

Чтобы использовать 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. Приложение запрашивает доступ на чтение к метаданным и записывает доступ к проблемам. Приложение также может запросить авторизацию пользователя для доступа на чтение к электронной почте и записи доступа к gists.

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

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

Снимок экрана: страница авторизации приложения GitHub. Приложение запрашивает доступ на чтение к электронной почте и доступ на запись к 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.

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

Note

Если ваша организация использует единый вход SAML и не отображается в списке вашей организации, может потребоваться запустить активный сеанс SAML для вашей организации. Дополнительные сведения см. в разделе ПРИЛОЖЕНИЯ SAML и GitHub.
Если приложению требуются разрешения репозитория, выберите "Все репозитории " или "Только репозитории". Приложение всегда будет иметь по крайней мере доступ только для чтения ко всем общедоступным репозиториям на GitHub.

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

Если приложение создает какие-либо репозитории, приложение автоматически будет предоставлено доступ к этим репозиториям.
Просмотрите разрешения, запрашиваемые приложением. Дополнительные сведения о REST API запрашивают GitHub App с этими разрешениями, см. в разделе "Разрешения, необходимые для приложений GitHub".
Нажмите кнопку "Установить", "Установить", "Установить" и "Запросить****". Представленная кнопка зависит от того, должна ли ваша владелец организации утвердить ни один из них, некоторые или все запрошенные права доступа для приложения. Дополнительные сведения см. в разделе "Требования к установке GitHub App".