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.

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 aprender cómo utilizar los manifiestos de las GitHub Apps, lo cual permite a las personas crear GitHub Apps preconfiguradas, consulta la sección "Crear GitHub Apps a partir de un manifiesto".

Nota: Un usuario u organización puede ser propietario de hasta 100 GitHub Apps.

  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. 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 decidir aceptar los tokens de usuario con vida útil limitada durante la configuración de 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 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

  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

¿Te ayudó este documento?

Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

O, learn how to contribute.