Skip to main content

Crear una GitHub App

Puedes crear y registrar una GitHub App bajo tu cuenta personal o bajo cualquier organización en la que tengas acceso administrativo.

Para obtener información sobre cómo usar los manifiestos de las aplicaciones de GitHub, que permiten a los usuarios crear aplicaciones preconfiguradas de GitHub, consulte "Creación de aplicaciones de GitHub a partir de un manifiesto".

Nota: Un usuario u organización puede poseer hasta 100 aplicaciones de GitHub.

  1. Navega a la configuración de tu cuenta.

    • Para una GitHub App que pertenezca a una cuenta personal, en la esquina superior derecha de cualquier página, haz clic en tu foto de perfil y luego en Configuración. Icono Settings (Parámetros) en la barra de usuario
    • En el caso de las GitHub App que pertenezcan a una organización, en la esquina superior derecha de cualquier página, haz clic en tu foto de perfil y luego en Tus organizaciones. A continuación, a la derecha de la organización, haz clic en Configuración. Tus organizaciones en el menú de perfil Botón Configuración
  2. In the left sidebar, click Developer settings.

  3. En la barra lateral izquierda, haga clic en GitHub Apps (Aplicaciones de Github). Sección de aplicaciones de GitHub

  4. Haga clic en New GitHub App (Nueva aplicación GitHub). Botón para crear una nueva aplicación de GitHub

  5. E "Nombre dela GitHub App", teclea el nombre de tu app. Campo para el nombre de la aplicación de GitHub

    Pónle un nombre claro y breve a tu app. Tu app no puede tener el mismo nombre que una cuenta existente de GitHub, a menos de que sea tu propio nombre de usuario u organización. Una versión simplificada del nombre de tu aplicación se mostrará en la interface de usuario cuando tu integración tome alguna acción.

  6. Opcionalmente, en "Descripción", teclea la descripción de tu app que verán los usuarios. Campo para agregar una descripción de la aplicación de GitHub

  7. Teclea la URL completa para el sitio web de tu app en "URL de la página principal". Campo para la URL de la página principal de la aplicación de GitHub

  8. En "URL de rellamado", teclea la URL completa a la cual se redirigirá a los usuarios después de que autoricen la instalación. Esta URL se utiliza si tu app necesita identificar y autorizar solicitudes de usuario a servidor.

    Puede usar la opción Add callback URL (Agregar URL de devolución de llamada) para proporcionar direcciones URL de devolución de llamada adicionales, hasta un máximo de 10.

    Botón para agregar una URL de devolución de llamada y campo para introducirla

  9. Predeterminadamente, para mejorar la seguridad de tu app, ésta utilizará un token de autorización de usuario con una vida útil limitada. Para elegir no utilizar estos tokens de usuario, debes deseleccionar la opción "Limitar la vida útil de los tokens de autorización de usuario". Para más información sobre cómo configurar un flujo de token de actualización y sobre las ventajas de expirar los tokens de usuario, consulte "Actualización de tokens de acceso de usuario a servidor". Opción para expirar los tokens de usuario durante la configuración de las aplicaciones de GitHub

  10. Si la aplicación autoriza a los usuarios mediante el flujo de OAuth, puede seleccionar Request user authorization (OAuth) during installation (Solicitar la autorización del usuario [OAuth] durante la instalación) para permitir que los usuarios autoricen la aplicación al instalarla, lo que elimina un paso. Si seleccionas esta opción, la "URL de configuración" dejará de estar disponible y se redirigirá a los usuarios a tu "URL de rellamado para autorización del usuario" después de que instalen la app. Para más información, vea "Autorización de usuarios durante la instalación". Solicitud de la autorización del usuario durante la instalación

  11. Si la aplicación de GitHub va a usar el flujo de dispositivos para identificar y autorizar usuarios, haga clic en Enable Device Flow (Habilitar flujo de dispositivos). Para obtener más información sobre el flujo de dispositivos, vea "Autorización de aplicaciones de OAuth". Captura de pantalla en la que se muestra el campo para habilitar el flujo de dispositivos

  12. Si se requiere hacer ajustes adicionales después de la instalación, agrega una "URL de configuración" para redireccionar a los usuarios después de que instalen tu app. Campo para configurar la URL de la aplicación de GitHub

    Nota: Al seleccionar Request user authorization (OAuth) during installation (Solicitar la autorización del usuario [OAuth] durante la instalación) en el paso anterior, este campo deja de estar disponible y los usuarios serán redirigidos a la URL de devolución de llamada de autorización del usuario después de instalar la aplicación.

  13. En "URL del Webhook", teclea la URL a la cual los eventos harán POST. Cada app recibe su propio webhook, el cual te notificará cada que se instale o modifique dicha app, así como sobre cualquier otor evento al cual se suscriba. Campo para la URL del webhook de la aplicación de GitHub

  14. Opcionalmente, en "Secreto del Webhook", teclea un token secreto opcional que se utilizará para asegurar tus webhooks. Campo para agregar un token secreto para el webhook

    Nota: Se recomienda encarecidamente establecer un token secreto. Para más información, vea "Protección de los webhooks".

  15. En "Permisos", elige aquellos permisos que solicitará tu app. Para cada tipo de permiso, use el menú desplegable y haga clic en Read-only (Solo lectura), Read & write (Lectura y escritura) o No access (Sin acceso). Diferentes permisos para la aplicación de GitHub

  16. En "Suscribirse a los eventos", elige aquellos que quieras que reciba tu app.

  17. Para elegir dónde se puede instalar la aplicación, seleccione Only on this account (Solo en esta cuenta) o Any account (En cualquier cuenta). Para obtener más información sobre las opciones de instalación, consulte "Configuración de una aplicación de GitHub como pública o privada". Opciones de instalación de la aplicación de GitHub

  18. Haga clic en Create GitHub App (Crear aplicación de GitHub). Botón para crear la aplicación de GitHub