Crear una GitHub App

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

En la barra lateral izquierda, haz clic en Developer settings (Parámetros del desarrollador).

En la barra lateral izquierda, da clic en GitHub Apps.

Da clic en GitHub App Nueva.

E "Nombre dela GitHub App", teclea el nombre de tu 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.

Opcionalmente, en "Descripción", teclea la descripción de tu app que verán los usuarios.

En "URL de la página principal", teclea la URL completa del sitio web de tu app.

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.

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

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.

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.

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.

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

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.

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

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

Da clic en Crear GitHub App.