Примечание.
Корпоративные установки GitHub Apps находятся в Публичный предварительный просмотр системе и подлежат изменению.
Сведения об установке 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 Apps. К этим API и мутациям GraphQL относятся:
- Перечисление и создание организаций в вашей организации
- Управление пользователями в организации
- Создавайте и управляйте GitHub App установками в своих организациях
- Управление свойствами пользовательского репозитория предприятия
- Вызов API-интерфейсов SCIM предприятия
Проверьте журнал изменений на предмет обновлений новых API и разрешений для GitHub Apps.
Дополнительные сведения о доступных разрешениях и конечных точках API см. в разделе Для приложений GitHub требуются права.
Ограничения скорости для установленных предприятиями GitHub Apps
Маркер установки для установленного GitHub Apps предприятия имеет тот же предел скорости, что и GitHub Enterprise Cloud организация. Ограничения скорости на установку. Например, если приложение установлено на предприятии и в двух организациях, для доступа к ним потребуется 3 маркера установки и иметь полный, независимый бюджет ограничения скорости для каждой установки. Дополнительные сведения см. в разделе [AUTOTITLE и Ограничения скорости для REST API](/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api).
Текущие ограничения
В настоящее время GitHub Apps установлены Публичный предварительный просмотр корпоративные компоненты с указанными ниже ограничениями.
поддержка API
Пока не все API поддерживают установку GitHub Apps предприятия. По мере создания дополнительных разрешений и обновления API поддержка станет более широкой. Дополнительные сведения об API и разрешениях, поддерживающих корпоративную установку GitHub Apps, см. в разделе Для приложений GitHub требуются права.
Поддержка веб-перехватчика
Корпоративные установки в настоящее время не поддерживают веб-перехватчики. Приложения, установленные на корпоративном уровне, не могут получать события веб-перехватчика для действий корпоративного уровня. Установите их в организациях или репозиториях для получения событий веб-перехватчика для этих ресурсов.
Доступ к организации
Корпоративные установки не предоставляют доступ к организациям или репозиториям в вашей организации, за исключением API установки организации. Чтобы получить доступ к ресурсам организации или репозитория, необходимо установить приложение отдельно в каждой организации, где требуется доступ.
Если вам нужно установить одно и то же приложение во многих организациях, вы можете автоматизировать эту задачу с помощью API. См . раздел AUTOTITLE.
Следующие шаги
- Чтобы предоставить приложению доступ к определенным организациям, установите его в этих организациях. Дополнительные сведения см. в разделе Установка приложения GitHub из стороннего производителя.
- Сведения об управлении приложениями, установленными в организациях. Дополнительные сведения см. в разделе Обзор и изменение установленных приложений GitHub.