Nota: La GitHub App tendrá acceso a los repositorios que cree, incluso si alguien la instala únicamente en repositorios seleccionados.
Instalar tu GitHub App privada en tu repositorio
Una vez que creas una GitHub App privada, puedes instalarla en uno de tuos repositorios de usuario o de organización. Para obtener más información, vea «Hacer pública o privada a una GitHub App».
- En la página de configuración de Aplicaciones de GitHub, seleccione la aplicación.
- En la barra lateral de la izquierda, haga clic en Install App (Instalar aplicación).
- Haz clic en Instalar junto a la cuenta personal o de organización que contiene el repositorio correcto.
- Selecciona Todos los repositorios o Solo seleccionar repositorios.
- Si eliges "Solo seleccionar repositorios", selecciona el menú desplegable Seleccionar repositorios y haz clic en los repositorios en los que quieres instalar la aplicación.
- Haga clic en Instalar. Una vez instalada, verás las opciones de configuración para la app en tu cuenta seleccionada. Puedes hacer cambios aquí, o repetir los pasos anteriores para instalar la app en otra cuenta.
Permitir que las personas instalen tu app pública en su repositorio
Puedes habilitar a otras personas para que instalen tu app pública si les proporcionas la URL de instalación en lugares como la página principal de tu app. Entonces puedes dirigirlos a la página principal de tu app desde la página de llegada en GitHub.
Si estás migrándote desde una App de OAuth hacia una GitHub App, puedes utilizar los parámetros de consulta para preseleccionar los repositorios y la cuenta cuando instalen esta GitHub App. Consulta "Migrar de Apps de OAuth a GitHub Apps" para obtener más información.
En estos pasos se da por hecho que ha creado una GitHub App:
- En la página de configuración de Aplicaciones de GitHub, seleccione la aplicación pública que quiere configurar para que otros usuarios la instalen.
- En la pestaña "General", en URL de la página principal", escribe la URL de la página principal de la aplicación y haz clic en Guardar cambios.
- GitHub proporciona una página de llegada para tu app, la cual incluye un enlace a la "URL de la Página Principal" de la misma. Para visitar la página de llegada en GitHub, copia la URL de "Enlace público" y pégala en un buscador.
- Cree una página principal para la aplicación que incluya la dirección URL de instalación de la aplicación:
http(s)://HOSTNAME/github-apps/<app name>/installations/new.
Autorizar a los usuarios durante la instalación
Puedes simplificar el proceso de autorización si lo completas durante la instalación de la app. Para ello, seleccione Request user authorization (OAuth) during installation (Solicitar la autorización del usuario (OAuth) durante la instalación) al crear o modificar la aplicación en GitHub. Consulta "" para obtener más información.
Una vez que alguien instale tu app, necesitarás obtener un token de acceso para el usuario. Para obtener más información, vea «Generación de un token de acceso de usuario para una aplicación de GitHub».
Preservar el estado de una aplicación durante su instalación
Puede proporcionar un parámetro state en la URL de instalación de una aplicación para conservar el estado de la página de la aplicación y devolver a los usuarios a ese estado después de que instalen, se autentiquen o acepten actualizaciones de su aplicación de GitHub. Por ejemplo, puede utilizar state a fin de correlacionar una instalación para un usuario o cuenta.
Para preservar el estado, agrégalo a la URL de instalación:
http(s)://HOSTNAME/github-apps/<app name>/installations/new?state=AB12t