О установке GitHub Apps
Примечание.
Этот процесс установки применяется к любому GitHub App, будь то стороннее приложение или приложение, принадлежащее вашему предприятию. Приложение можно установить вручную с помощью ссылки, предоставленной владельцем приложения.
Чтобы использовать GitHub App в ресурсах, необходимо установить приложение на вашей организации организации или личная учетная запись. Один и тот же GitHub App можно установить на нескольких учетных записях. Например, если вы устанавливаете приложение на личная учетная запись и в нескольких организациях, которые вы владеете, вы сможете использовать приложение в личных репозиториях, в организациях, где установлено приложение, и на репозиториях, принадлежащих этим организациям.
При установке приложения вы предоставляете приложению разрешение на доступ к ресурсам organization и репозитория. Во время установки 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 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.