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

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

Кто может использовать эту функцию?

Enterprise owners can install GitHub Apps on their enterprise. App managers cannot install apps at the enterprise level.

В этой статье

Примечание.

Корпоративные данные GitHub Apps находятся в public preview и подлежат изменению.

Установка GitHub Apps в вашей организации

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

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

Требования к установке GitHub App в вашей организации

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

Приложение должно принадлежать вашей организации или организации в вашей организации. Невозможно установить приложения, принадлежащие учетной записи за пределами предприятия.

Установка GitHub App в вашей организации

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

Если приложение можно установить, список доступных расположений установки будет включать ваше предприятие. Вы можете выбрать свое предприятие для установки приложения.

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

Какие приложения, установленные предприятием, могут выполнять

Корпоративный установленный GitHub Apps не может вызывать каждый корпоративный API, но несколько API уже были обновлены для поддержки приложений GitHub. К этим API и мутациям GraphQL относятся:

Проверьте журнал изменений для обновлений в новых API и разрешениях для GitHub Apps.

Дополнительные сведения о доступных разрешениях и конечных точках API см. в разделе Разрешения, необходимые для приложений GitHub.

Ограничения скорости для установленных предприятием данных GitHub Apps

Маркер установки для установленного предприятия GitHub Apps имеет тот же предел частоты, что и организация GitHub Enterprise Cloud. Ограничения скорости на установку. Например, если приложение установлено на предприятии и в двух организациях, для доступа к ним потребуется 3 маркера установки и иметь полный, независимый бюджет ограничения скорости для каждой установки. Дополнительные сведения см. в разделе [AUTOTITLE и Ограничения скорости для REST API](/graphql/overview/resource-limitations).

Текущие ограничения

Корпоративный установленный GitHub Apps в настоящее время находится в public preview со следующими ограничениями.

поддержка API

Пока не все API поддерживают корпоративные данные GitHub Apps. По мере создания дополнительных разрешений и обновления API поддержка станет более широкой. Дополнительные сведения об API-интерфейсах и разрешениях, поддерживающих корпоративную установку GitHub Apps, см. в разделе Разрешения, необходимые для приложений GitHub.

Поддержка веб-перехватчика

Корпоративные установки в настоящее время не поддерживают веб-перехватчики. Приложения, установленные на корпоративном уровне, не могут получать события веб-перехватчика для действий корпоративного уровня. Установите их в организациях или репозиториях для получения событий веб-перехватчика для этих ресурсов.

Доступ к организации

Корпоративные установки не предоставляют доступ к организациям или репозиториям в вашей организации, за исключением API установки организации. Чтобы получить доступ к ресурсам организации или репозитория, необходимо установить приложение отдельно в каждой организации, где требуется доступ.

Следующие шаги