Nota:
Los elementos instalados por la empresa GitHub Apps están en versión preliminar pública y sujetos a cambios.
Información sobre la instalación de GitHub Apps en la empresa
Las aplicaciones instaladas por GitHub Apps la empresa son aplicaciones que solicitan permisos de nivel empresarial y pueden realizar operaciones en su cuenta empresarial. A diferencia de las instalaciones de organización o usuario, no tienen acceso a ningún permiso de la organización o de repositorio; solo administran la propia empresa.
Cuando un propietario de la empresa instala un GitHub App elemento en la empresa, se le concederá a la aplicación los permisos de empresa que solicitó. Estos permisos permiten a la aplicación realizar operaciones como la creación de organizaciones en la empresa, la instalación de aplicaciones entre organizaciones y la administración del aprovisionamiento de SCIM.
Requisitos para instalar un GitHub App en su empresa
GitHub App debe solicitar permisos de nivel empresarial. También puede solicitar otros permisos, pero durante la instalación solo se concederán los permisos de empresa.
La aplicación debe ser propiedad de tu empresa o de una organización dentro de tu empresa. No puedes instalar aplicaciones propiedad de una cuenta externa a tu empresa.
Instalar un GitHub App en su empresa
Para instalar una aplicación en la empresa, vaya a la página de GitHub App instalación. El desarrollador de la aplicación puede proporcionarlo como vínculo de instalación o bien puedes encontrarlo en el registro de la aplicación. La dirección URL tendrá un aspecto similar a https://github.com/apps/APP-NAME/installations/new, donde APP-NAME es el nombre de GitHub App.
Si se puede instalar la aplicación, en la lista de ubicaciones de instalación disponibles se incluirá tu empresa. Puedes seleccionar tu empresa para instalar la aplicación.
Después de la instalación, la aplicación podrá crear un token de instalación para tu empresa o iniciar sesión en los miembros de la empresa con el fin de actuar en su nombre en el nivel empresarial. Para actuar en nombre de un usuario es necesario que el usuario pueda realizar las operaciones deseadas dentro de la empresa. Por ejemplo, si la aplicación necesita invitar a un usuario a una empresa, el usuario también debe tener permiso para invitar a miembros a la empresa.
Qué pueden hacer las aplicaciones instaladas por la empresa
La instalación empresarial GitHub Apps no puede llamar a todas las API empresariales, pero ya se han actualizado varias API para admitir GitHub Apps. Estas API y mutaciones de GraphQL incluyen las siguientes:
- Enumeración y creación de organizaciones en tu empresa
- Administración de usuarios en tu empresa
- Creación y administración de GitHub App instalaciones en las organizaciones
- Gestión de propiedades personalizadas del repositorio corporativo
- Llamar a las API SCIM empresariales
Compruebe el registro de cambios para obtener actualizaciones en las nuevas API y permisos para GitHub Apps.
Para más información sobre los permisos disponibles y los puntos de conexión de API, consulta Permisos necesarios para aplicaciones de GitHub.
Límites de tasa para las instalaciones empresariales GitHub Apps
El token de instalación de una empresa instalada GitHub Apps tiene el mismo límite de velocidad que una GitHub Enterprise Cloud organización. Los límites de tasa son para cada instalación. Por ejemplo, si una aplicación está instalada en una empresa y dos organizaciones, necesitará tres tokens de instalación para acceder a ellas y tener un presupuesto de límite de frecuencia independiente completo para cada instalación. Para más información, consulta Límites de tasa de la API REST y Límites de frecuencia y consulta para GraphQL API.
Limitaciones actuales
Los GitHub Apps instalados por la empresa están actualmente en versión preliminar pública con las siguientes limitaciones.
soporte de API
Todavía no todas las API admiten GitHub Apps instaladas por la empresa. A medida que se creen más permisos y se actualicen las API, la compatibilidad será más amplia. Para obtener más información sobre las API y los permisos que admiten la instalación GitHub Appsempresarial, consulte Permisos necesarios para aplicaciones de GitHub.
Compatibilidad con webhook
Actualmente las instalaciones de empresa no admiten webhooks. Las aplicaciones instaladas en el nivel empresarial no pueden recibir eventos de webhook para actividades de nivel empresarial. Instálalas en organizaciones o repositorios a fin de recibir eventos de webhook para esos recursos.
Acceso a la organización
Las instalaciones empresariales no tienen acceso a organizaciones o repositorios dentro de tu empresa, a excepción de la API de instalaciones de la organización. Para acceder a recursos de la organización o del repositorio, debes instalar la aplicación por separado en cada organización en la que se necesite acceso.
Si necesita instalar la misma aplicación en muchas organizaciones, puede automatizarla con una API. Consulta Automatización de instalaciones de aplicaciones en las organizaciones de la empresa.
Pasos siguientes
- Para conceder a la aplicación acceso a organizaciones específicas, debes instalarla en esas organizaciones. Para más información, consulta Instalación de una instancia de GitHub App desde un tercero.
- Más información sobre cómo administrar aplicaciones instaladas en tus organizaciones. Para más información, consulta Revisión y modificación de aplicaciones de GitHub instaladas.