О установке GitHub Apps
Примечание.
Этот процесс установки применяется к любому GitHub App, будь то стороннее приложение или приложение, принадлежащее вашему предприятию. Приложение можно установить вручную с помощью ссылки, предоставленной владельцем приложения.
Чтобы использовать GitHub App ресурсы, необходимо установить приложение в вашей организации или личной учетной записи. Вы можете установить одно и то же GitHub App в нескольких учетных записях. Например, если вы устанавливаете приложение на личная учетная запись и в нескольких организациях, которые вы владеете, вы сможете использовать приложение в личных репозиториях, в организациях, где установлено приложение, и на репозиториях, принадлежащих этим организациям.
При установке приложения вы предоставляете приложению разрешение на доступ к репозитория, запрошенным им. Во время установки вы узнаете, GitHub какие разрешения запрошены GitHub App . Для получения дополнительной информации о запросах GitHub App REST API, которые можно делать с этими разрешениями, см. Для приложений GitHub требуются права.
При установке приложения, запрашивающего разрешения репозитория, вы также выберете репозитории для предоставления GitHub App доступа.
Перед установкой GitHub Appнеобходимо убедиться, что вы доверяете владельцу GitHub Appобъекта. Вы также должны просмотреть разрешения, запрашиваемые и убедиться, GitHub App что вы комфортно предоставляете эти разрешения. Для получения дополнительной информации о запросах GitHub App REST API, которые можно делать с этими разрешениями, см. Для приложений 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 App администраторами репозитория. Если это ограничение включено, администраторы репозитория не могут установить GitHub Apps и вместо этого запрашивают, чтобы владельцы организации установили нужное приложение. Для получения дополнительной информации см. Ограничение запросов и установок доступа приложений OAuth и GitHub.
Члены организации и внешние сотрудники, которые не могут установить приложение, всё равно могут выбрать её в процессе установки. Вместо установки приложения GitHub я отправлю уведомление владельцу организации с просьбой установить приложение. Возможность делать такие запросы можно контролировать с помощью политики запросов на доступ приложений. См . раздел AUTOTITLE.
Роль «менеджера приложения» не даёт человеку возможности установить GitHub App приложение в организацию или предприятие. См . раздел AUTOTITLE.
Установка GitHub App
В процессе установки владелец приложения направит вас по GitHub URL для установки GitHub App. URL будет выглядеть примерно http(s)://HOSTNAME/github-apps/APP-NAME/installations/newтак , где APP-NAME — это имя GitHub App.
-
Выберите место, где хотите установить GitHub App. Вы можете выбрать свой личный аккаунт или организацию, членом которой являетесь.
-
Если приложению требуются разрешения репозитория, выберите "Все репозитории " или "Только репозитории". Приложение всегда будет иметь хотя бы доступ только для чтения ко всем публичным репозиториям на GitHub.
Если приложению не требуются разрешения репозитория, эти параметры будут опущены.
-
Если вы выбрали только репозитории на предыдущем шаге, в раскрывающемся списке "Выбор репозиториев" выберите репозитории, к которым требуется получить доступ к приложению.
Если приложение создает какие-либо репозитории, приложение автоматически будет предоставлено доступ к этим репозиториям.
-
Просмотрите разрешения, запрашиваемые приложением. Для получения дополнительной информации о запросах GitHub App REST API, которые можно делать с этими разрешениями, см. Для приложений GitHub требуются права.
-
Нажмите кнопку "Установить", "Установить", "Установить" и "Запросить****". Кнопка зависит от того, должен ли владелец вашей организации одобрить ни один или часть или весь запрошенный доступ к приложению. Для получения дополнительной информации см. Требования к установке GitHub App.