Nota:
Las instancias de GitHub Apps instaladas en la empresa están actualmente en versión preliminar pública y sujetas a cambios.
Acerca de la instalación de GitHub Apps en tu empresa
Las instancias de GitHub Apps instalados en la empresa son aplicaciones que solicitan permisos de nivel empresarial y que pueden realizar operaciones en tu 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 una instancia de GitHub App en la empresa, a la aplicación se le concederán los permisos de empresa que ha solicitado. 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 una instancia de GitHub App en tu empresa
La instancia de GitHub App debe solicitar permisos de nivel de empresa. 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.
Instalación de una instancia de GitHub App en tu empresa
Para instalar una aplicación en tu empresa, navega a la página de instalación de GitHub App. 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 se parecerá a https://github.com/apps/APP-NAME/installations/new, donde APP-NAME es el nombre de la instancia 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
Las instancias de GitHub Apps instaladas por la empresa no pueden llamar a todas las API empresariales, pero ya se han actualizado varias API para admitir aplicaciones de GitHub. 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 instalaciones de GitHub App en tus organizaciones
- Administración de propiedades de repositorios personalizados de empresa
- Llamada a las API de SCIM empresariales
Comprueba el registro de cambios para ver las actualizaciones de 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 que requieren las Github Apps.
Limites de frecuencia para instancias de GitHub Apps instaladas por la empresa
El token de instalación de una instancia de GitHub Apps instalada por la empresa tiene el mismo límite de frecuencia que una organización GitHub Enterprise Cloud. Los límites de frecuencia 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 volumen de la API de REST y Límites de volumen y límites de nodo para GraphQL API.
Limitaciones actuales
Las instancias de GitHub Apps instaladas por la empresa están actualmente en versión preliminar pública con las limitaciones siguientes.
compatibilidad de API
No todas las API admiten todavía las instancias de 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 más información sobre las API los permisos que admiten instancias de GitHub Apps instaladas por la empresa, consulta Permisos que requieren las Github Apps.
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. Debes instalarlas 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.
Pasos siguientes
- Para conceder a la aplicación acceso a organizaciones específicas, debes instarla 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 las Aplicaciones de GitHub instaladas.