Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Esta versión de GitHub Enterprise se discontinuó el 2020-11-12. 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. En la esquina superior derecha de cualquier página, da clic en tu foto de perfil y después da clic en Configuración.

    Icono Settings (Parámetros) en la barra de usuario

  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 un usuario 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. 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

  10. 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.

  11. 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

  12. 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".

  13. 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

  14. En "Suscribirse a los eventos", elige si quieres suscribir a tu app a los eventos de Etiquetas, Públicos, Repositorios, o Observar.

    Opciones de suscripción a los eventos para tu GitHub App

  15. 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

  16. Da clic en Crear GitHub App.

    Botón para crear tu GitHub App