Esta versión de GitHub Enterprise se discontinuó el 2021-09-23. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

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.

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

    • Para una GitHub App que pertenezca a una cuenta de usuario, 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. Entonces, a la derecha de la organización, haz clic en Configuración. Tus organizaciones en el menú de perfil El botón de configuración
  2. En la barra lateral izquierda, haz clic en Developer settings (Parámetros del desarrollador). Sección Developer settings (Parámetros del programador)

  3. En la barra lateral izquierda, da clic en GitHub Apps. Sección GitHub Apps

  4. Da clic en GitHub App Nueva. Botón para crear una GitHub App nueva

  5. E "Nombre dela GitHub App", teclea el nombre de tu app. Campo para nombrar tu GitHub App

    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 tu GitHub App

  7. En "URL de la página principal", teclea la URL completa del sitio web de tu app. Campo para la URL de la página de inicio de tu GitHub App

  8. En "URL de rellamado para la autorización del usuario", teclea la URL completa a la cual se redireccionará después de que un usuario autorice una instalación. Esta URL se utiliza si tu app necesita identificar y autorizar las solicitudes de usuario a servidor. Campo para la URL de rellamado para la autorización del usuario de tu GitHub App

  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 conocer más acerca de configurar un flujo de rehabilitación de tokens y acerca de los beeficios de que éstos tenga una vida útil limitada, consulta la sección "Rehabilitar los tokens de acceso de usuario a servidor". Opción para unirse a los tokens de usuario con caducidad durante la configuración de las GitHub Apps

  10. Si tu app autoriza a los usuarios que utilizan el flujo de OAuth, puedes seleccionar la opción Solicitar la autorización del usuario (OAuth) durante la instalación para permitir que las personas den autorización a la app cuando la instalen, lo cual te ahorra 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. Consulta la sección "Autorizar a los usuarios durante la instalación" para obtener más información. Solicitar una autorización de usuario durante la instalación

  11. 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 tu GitHub App

    Nota: Cuando seleccionas Solicitar la autorización del usuario (OAuth) durante la instalación en el paso anterior, este campo 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.

  12. 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 tu GitHub App

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

    Nota: Te recomendamos ampliamente que configures un token secreto. Para obtener más información, consulta la sección "Asegurar tus webhooks".

  14. En "Permisos", elige aquellos permisos que solicitará tu app. Para cada tipo de permiso, utiliza el menú desplegable, y da clic en Solo lectura, Lectura& escritura, o Sin acceso. Varios permisos para tu GitHub App

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

  16. Para elegir si la app se podrá instalar, selecciona ya sea Únicamente en esta cuenta o Cualquier cuenta. Para obtener más información sobre las opciones de instalación, selecciona "Convertir una GitHub App en pública o privada". Opciones de instalación para tu GitHub App

  17. Da clic en Crear GitHub App. Botón para crear tu GitHub App