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

Acerca de la instalación de GitHub Apps

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

Para usar una instancia de GitHub App en tus repositorios u organización, debes instalar la aplicación en tu cuenta personal o profesional. Puedes instalar la misma instancia de 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, le concedes permiso para acceder a los recursos de la organización y del repositorio solicitados. Durante el proceso de instalación, GitHub te indicará qué permisos solicitó la instancia de GitHub App. Para más información sobre las solicitudes de la API REST que GitHub App puede crear con esos permisos, consulta "Permisos que requieren las Github Apps".

Al instalar una aplicación, también elegirás a qué repositorios se va a conceder acceso a la instancia de GitHub App.

Antes de instalar una instancia de GitHub App, debes asegurarte de que confías en el propietario de esta. También debes revisar los permisos que solicita la instancia de GitHub App y asegurarte de que te sientes a gusto con la idea de concederlos. Para más información sobre las solicitudes de la API REST que GitHub App puede crear con esos permisos, consulta "Permisos que requieren las Github Apps".

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 una instancia de GitHub App, también se te pedirá que autorices la aplicación.

Al instalar la GitHub App en tu cuenta u organización, concedes a la aplicación permiso para acceder a los recursos de la organización y del repositorio que ha solicitado. También se especifica a qué repositorios puede acceder la aplicación. Durante el proceso de instalación, la GitHub App indicará qué repositorio y permisos de organización vas a conceder. Para obtener más información sobre qué permite cada permiso que haga una GitHub App, consulta "Elección de permisos para una aplicación de GitHub".

Por ejemplo, puedes conceder a la instancia de GitHub App permiso para leer los metadatos del repositorio y escribir incidencias, y podrías concederle acceso GitHub App a todos los repositorios.

Al autorizar una GitHub App, concedes a la aplicación acceso a tu cuenta de GitHub, en función de los permisos de 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. Al autorizar una GitHub App, también se concede el permiso de la aplicación para actuar en tu nombre.

Por ejemplo, puedes conceder a la instancia de GitHub App permiso para leer las direcciones de correo electrónico y escribir gists.

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

Para más información sobre cómo autorizar GitHub Apps, consulta "Autorizar GitHub Apps".

Requisitos para instalar una instancia de GitHub App

Cualquier persona puede instalar GitHub Apps en su cuenta personal.

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

Los administradores de repositorios que son propiedad de una organización también pueden instalar GitHub Apps en la organización si solo conceden a la aplicación acceso a repositorios de los que son administradores y si la aplicación no solicita ningún permiso de la organización o permiso de la “administración de repositorio”. Los propietarios de la organización pueden impedir que colaboradores externos que sean administradores del repositorio instalen GitHub Apps.

Los miembros de la organización que no son propietarios de la organización ni administradores de repositorio 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 solicitarle que la instale.

El rol "administrador de aplicaciones" de una organización no otorga a una persona el derecho a instalar una instancia de GitHub App en la organización. Consulte "Acerca de los administradores de aplicaciones de GitHub".

Instalación de una instancia de GitHub App

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

1. Selecciona la ubicación donde quieres instalar la instancia de GitHub App. Puedes seleccionar tu cuenta personal o una organización de la que seas 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 de 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 más información sobre las solicitudes de la API REST que GitHub App puede crear con esos permisos, consulta "Permisos que requieren las Github Apps".

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 más información, consulta "Requisitos para instalar una instancia de GitHub App".