Instalación de una instancia de GitHub App desde un tercero

Acerca de la instalación GitHub Apps

En este artículo se describe cómo instalar directamente GitHub App desde el propietario de la aplicación en lugar de desde GitHub Marketplace. Para obtener más información sobre la instalación GitHub Apps desde GitHub Marketplace, vea Instalación de una aplicación de GitHub desde GitHub Marketplace en tu cuenta personal y Instalación de una instancia de GitHub App desde GitHub Marketplace en las organizaciones. Para obtener más información sobre la instalación GitHub Apps que posee, consulte Instalación de su propia aplicación de GitHub.

Para poder usar un GitHub App en sus recursos, debe instalar la aplicación en su de organización o personal. Puede instalar lo mismo GitHub App en varias cuentas. Por ejemplo, si instalas la aplicación en tu cuenta personal y en algunas organizaciones que poseas, podrás usarla en los repositorios personales, en las organizaciones donde instalaste la aplicación y en los repositorios que pertenezcan a esas organizaciones.

Cuando instalas una aplicación, otorgas a la aplicación permiso para acceder a los recursos de la organización y del repositorio que solicitó. Durante el proceso de instalación, GitHub le indicará los permisos GitHub App solicitados. Para obtener más información sobre las solicitudes de API REST que GitHub App puede realizar con esos permisos, consulte Permisos necesarios para aplicaciones de GitHub.

Al instalar una aplicación que solicita permisos de repositorio, también elegirá a qué repositorios conceder GitHub App el acceso.

Antes de instalar un GitHub App, debe asegurarse de que confía en el propietario del GitHub App. También debe revisar los permisos que GitHub App solicita y asegurarse de que le resulte cómodo conceder esos permisos. Para obtener más información sobre las solicitudes de API REST que GitHub App puede realizar con esos permisos, consulte Permisos necesarios para aplicaciones de GitHub.

No hay ningún límite en el número de aplicaciones que se pueden instalar.

Diferencia entre autorización e instalación

Después de instalar un GitHub App, también se le pedirá que autorice la aplicación.

Cuando instala una GitHub App en su cuenta u organización, otorga a la aplicación permiso para acceder a los recursos de la organización y del repositorio que esta solicitó. También se especifica a qué repositorios puede acceder la aplicación. Durante el proceso de instalación, GitHub App indicará qué repositorio y permisos de organización va a conceder. Para obtener más información sobre qué permisos diferentes permiten GitHub App hacer, consulte Elección de permisos para una aplicación de GitHub.

Por ejemplo, podría conceder al GitHub App permiso para leer los metadatos del repositorio y escribir incidencias, y podría conceder al GitHub App acceso a todos sus repositorios.

Al autorizar un GitHub App, concede a la aplicación acceso a su GitHub cuenta, en función de los permisos de la cuenta que solicitó la aplicación. Durante el proceso de autorización, la aplicación indicará a qué recursos puede acceder la aplicación en tu cuenta. Cuando autoriza a GitHub App, también le concede permiso a la aplicación para actuar en su nombre.

Por ejemplo, podrías otorgar a GitHub App permiso para leer tus direcciones de correo electrónico y escribir gists.

Puede instalar un GitHub App sin autorizar la aplicación. Del mismo modo, puedes autorizar la aplicación sin instalar la aplicación.

Para obtener más información sobre cómo autorizar GitHub Apps, vea Autorización de aplicaciones GitHub.

Requisitos para instalar un GitHub App

Cualquier persona puede instalar GitHub Apps en su cuenta personal.

Los propietarios de la organización pueden instalar GitHub Apps en su organización.

Los administradores del repositorio pueden instalar GitHub Apps en la organización a la que pertenece el repositorio si la aplicación no solicita ningún permiso de organización ni el permiso de "administración del repositorio". Al hacerlo, solo pueden instalar la aplicación con acceso a los repositorios que administran. Los propietarios de la organización pueden restringir la GitHub App instalación por parte de los administradores del repositorio. Cuando esta restricción está habilitada, los administradores del repositorio no pueden instalar GitHub Apps y deben solicitar que los propietarios de la organización instalen la aplicación deseada. Para obtener más información, consulte Limitación de las solicitudes de acceso y las instalaciones de la aplicación OAuth y la aplicación GitHub.

Los miembros de la organización y los colaboradores externos que no pueden instalar una aplicación en la organización todavía pueden seleccionar la organización durante el proceso de instalación. En lugar de instalar la aplicación, GitHub enviará una notificación al propietario de la organización para solicitar al propietario de la organización que instale la aplicación. La capacidad de realizar estas solicitudes se puede controlar mediante directivas de solicitud de acceso a aplicaciones. Consulta Limitación de las solicitudes de acceso y las instalaciones de la aplicación OAuth y la aplicación GitHub.

El rol de "administrador de aplicaciones" no proporciona a una persona la capacidad de instalar GitHub App en la organización. Consulta Acerca de los gestores de aplicaciones de GitHub.

Instalación de un GitHub App

Durante el proceso de instalación, el propietario de la aplicación le dirigirá a la GitHub URL para instalar el GitHub App. 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.

1. Seleccione la ubicación en la que desea instalar el GitHub App. Puede seleccionar su cuenta personal o una organización de la que sea miembro.

2. Si la aplicación necesita permisos de repositorio, selecciona Todos los repositorios o Solo repositorios seleccionados. La aplicación siempre tendrá al menos acceso de solo lectura a todos los repositorios públicos en GitHub.

   Si la aplicación no requiere permisos de repositorio, estas opciones se omitirán.

3. Si elegiste Solo repositorios seleccionados en el paso anterior, en la lista desplegable Seleccionar repositorios, elige los repositorios a los que quieres que acceda la aplicación.

   Si la aplicación crea algún repositorio, esta también tendrá automáticamente acceso a esos repositorios.

4. Revisa los permisos que solicita la aplicación. Para obtener más información sobre las solicitudes de API REST que GitHub App puede realizar con esos permisos, consulte Permisos necesarios para aplicaciones de GitHub.

5. Haz clic en Instalar, Instalar y solicitar o Solicitar. El botón que se presenta depende de si el propietario de la organización debe aprobar ninguno, algunos o todos los accesos solicitados para la aplicación. Para obtener más información, vea Requisitos para instalar un GitHub App.