Modificación de un registro de aplicación de GitHub

Información sobre las modificaciones GitHub App

Puedes modificar el GitHub App registro para cambiar cualquiera de las configuraciones que se seleccionaron cuando la aplicación se registró inicialmente. Para obtener más información sobre la configuración que puede seleccionar al registrar un GitHub App, vea Registro de una aplicación de GitHub.

Por ejemplo, puede cambiar el nombre y la descripción de la aplicación, los permisos concedidos a la aplicación, los webhooks a los que se suscribe la aplicación o la visibilidad de la aplicación.

También puede optar por probar nuevas funciones opcionales para su GitHub App. Consulta Activación de características opcionales para aplicaciones de GitHub.

Ir a la configuración de GitHub App

Para modificar un GitHub App, vaya primero a la página de configuración de la aplicación.

1. En la esquina superior derecha de cualquier página, en GitHub, haz clic en la fotografía del perfil.

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

   • Para una aplicación propiedad de una cuenta personal, haga clic en Configuración.
   • Para una aplicación propiedad de una organización:
     1. Haga clic en Sus organizaciones.
     2. A la derecha de la organización, haga clic en Configuración.
   • Para una aplicación propiedad de una empresa:
     1. Haga clic en Configuración empresarial.

3. Navega a los ajustes de GitHub App.

   • Para una aplicación propiedad de una cuenta personal o de una organización.
     1. En la barra lateral de la izquierda, haz clic en Developer settings y luego en GitHub Apps.
   • Para una aplicación propiedad de una empresa:
     1. En la barra lateral izquierda, haz clic en Configuración y, a continuación, haz clic en GitHub Apps.

4. A la derecha de la GitHub App que desea modificar, haga clic en Edit.

Cambiar la información básica de un GitHub App

Puedes cambiar la información básica de tu GitHub App, como el nombre de la aplicación, la descripción de la aplicación y la URL de la página de inicio de la aplicación.

1. Vaya a la página de configuración de la aplicación que desea modificar. Para obtener más información, consulta Acceso a la configuración de GitHub App en este artículo.
2. En "Información básica", modifique la GitHub App información que desea cambiar.
3. Haga clic en Guardar cambios.

Solicitud de autorización de usuario (OAuth) durante la instalación

Puede pedir a los usuarios que autoricen GitHub App cuando lo instalen y generen un token de acceso de usuario. Al solicitar la autorización de usuario (OAuth) durante la instalación, también debe proporcionar una dirección URL de devolución de llamada donde se redirigirá al usuario después de autorizar la instalación. Consulta Generación de un token de acceso de usuario para una aplicación de GitHub.

1. Vaya a la página de configuración de la aplicación que desea modificar. Para obtener más información, consulta Acceso a la configuración de GitHub App en este artículo.
2. En la opción "Identificación y autorización de usuarios", seleccione o anule la selección de Solicitar autorización del usuario (OAuth) durante la instalación.
3. En "Callback URL", escriba la dirección URL completa a la cual se redirigirá a los usuarios después de que autoricen la instalación.

Habilitación o deshabilitación del flujo de dispositivo

Puede utilizar el flujo de dispositivo para autorizar usuarios en una aplicación sin interfaz gráfica, como una herramienta de línea de comandos o un administrador de credenciales de Git. Para obtener más información sobre el uso del flujo de dispositivo con GitHub Apps, consulte Generación de un token de acceso de usuario para una aplicación de GitHub.

1. Vaya a la página de configuración de la aplicación que desea modificar. Para obtener más información, consulta Acceso a la configuración de GitHub App en este artículo.
2. En la opción "Identifying and authorizing users", seleccione o anule la selección de Enable Device Flow.

Adición o actualización de una dirección URL de instalación

Puede redirigir a los usuarios a una dirección URL específica después de instalar la aplicación. Consulta Registro de una aplicación de GitHub.

Si ha seleccionado Request user authorization (OAuth) during installation, no podrá especificar una dirección URL de configuración. En su lugar, a los usuarios se les redirigirá a la URL de devolución de llamada como parte del flujo de autorización, donde puedes describir la configuración adicional. Consulta Acerca de la dirección URL de devolución de llamada de autorización de usuario.

1. Vaya a la página de configuración de la aplicación que desea modificar. Para obtener más información, consulta Acceso a la configuración de GitHub App en este artículo.
2. En "Post installation", en el campo "Setup URL", escriba la dirección URL a la que desea redirigir a los usuarios después de instalar la aplicación.
3. Opcionalmente, si quieres redirigir a los usuarios a la URL de configuración después de actualizar una instalación, selecciona Redirigir al actualizar. Una actualización incluye la adición o eliminación de un repositorio para una instalación. Si "URL de configuración" está en blanco, se omitirá.

Cambiar los permisos de un GitHub App

Puede cambiar los permisos de acceso que se conceden a GitHub App mediante los pasos siguientes.

Al agregar nuevos permisos de repositorio u organización para una aplicación, cada cuenta donde se instala la aplicación tendrá que aprobar los nuevos permisos. Al agregar permisos de cuenta para una aplicación, cada usuario que haya autorizado la aplicación tendrá que aprobar los cambios de permisos. En ambos casos, GitHub enviará un correo electrónico a cada propietario o usuario de la organización, notificándoles la solicitud para actualizar los permisos de la aplicación. Los permisos actualizados no surtirán efecto en una instalación o autorización del usuario hasta que se aprueben los nuevos permisos. Puede usar el webhook de instalación para averiguar cuándo aceptan los usuarios los nuevos permisos para la aplicación.

Si eliminas permisos o webhooks de tu GitHub App, los cambios surtirán efecto inmediatamente. Si quitas permisos concedidos previamente a la aplicación, la aplicación ya no podrá acceder a esos recursos.

Si cambia los permisos de una aplicación propiedad de una empresa, los cambios surtirán efecto inmediatamente para todas las instalaciones de la aplicación dentro de la empresa si es propietario de la empresa de la organización.

Las actualizaciones no se pueden aceptar automáticamente si agregas permisos de repositorio a una aplicación por primera vez. En ese caso, cada propietario de la organización deberá aprobar la actualización para que pueda elegir a qué repositorios tiene acceso la aplicación.

Cambiar los permisos de una aplicación también puede cambiar los webhooks a los que la aplicación puede suscribirse y las acciones que la aplicación puede realizar con la API. Consulta Elección de permisos para una aplicación de GitHub.

1. Vaya a la página de configuración de la aplicación que desea modificar. Para obtener más información, consulta Acceso a la configuración de GitHub App en este artículo.
2. En la GitHub Apps barra lateral de configuración, haga clic en Permisos y eventos.
3. En las secciones "Repository permissions", "Organization permissions" y "Account permissions", modifique los permisos que quiera cambiar. Para cada tipo de permiso, seleccione "Read-only", "Read and write" o "No access" en el menú desplegable. Consulta Elección de permisos para una aplicación de GitHub.
4. Opcionalmente, en "Agregar una nota a los usuarios", agregue una nota que indique a los usuarios por qué va a cambiar los permisos que GitHub App solicita.
5. Haga clic en Guardar cambios.

Activación o desactivación del GitHub App webhook

Puede configurar su GitHub App para recibir webhooks de eventos específicos en GitHub y actuar automáticamente en respuesta a ellos. Consulta Uso de webhooks con aplicaciones de GitHub.

1. Vaya a la página de configuración de la aplicación que desea modificar. Para obtener más información, consulta Acceso a la configuración de GitHub App en este artículo.
2. En "Webhook", para habilitar o deshabilitar el webhook, seleccione o anule la selección de la opción Active.
3. Si seleccionó Activo en el paso anterior, en "Dirección URL de webhook", escriba la dirección URL a la que GitHub se deben enviar eventos de webhook.
4. Opcionalmente, si ha seleccionado la opción Active en el paso anterior, en "Webhook secret", escriba un token secreto para proteger los webhooks. GitHub Se recomienda encarecidamente configurar un secreto del webhook.

Cambiar las suscripciones a eventos de webhook de un GitHub App

Puede cambiar los eventos de webhook a los que está suscrito GitHub App siguiendo estos pasos.

Los eventos de webhook específicos que puede seleccionar en el registro de la GitHub App vienen determinados por el tipo de permisos que has seleccionado para la aplicación. En primer lugar, deberás seleccionar los permisos que deseas que tenga la aplicación y, a continuación, puedes suscribir la aplicación a eventos de webhook relacionados con ese conjunto de permisos. Consulte Uso de webhooks con aplicaciones de GitHub.

1. Vaya a la página de configuración de la aplicación que desea modificar. Para obtener más información, consulta Acceso a la configuración de GitHub App en este artículo.
2. Active el GitHub App webhook. Consulte en este artículo cómo activar o desactivar el GitHub App webhook.
3. En la GitHub Apps barra lateral de configuración, haga clic en Permisos y eventos.
4. En las secciones "Repository permissions", "Organization permissions" y "Account permissions", seleccione los permisos necesarios para los eventos a los que se suscribirá la aplicación. Consulte Cambiar los permisos de GitHub App.
5. En "Suscribirse a eventos", seleccione los eventos de webhook que desea GitHub App recibir.
6. Haga clic en Guardar cambios.

Cambio de la visibilidad de un GitHub App

Puede cambiar la configuración de visibilidad de su GitHub App para controlar quién puede instalarlo. Las aplicaciones públicas no se pueden convertir en privadas si se han instalado en otras cuentas. Consulta Hacer que una aplicación de GitHub sea pública o privada.

No se puede cambiar la visibilidad de GitHub App, que es propiedad de una empresa. GitHub Apps propiedad de una empresa solo se puede instalar en organizaciones dentro de la empresa empresa.

1. Vaya a la página de configuración de la aplicación que desea modificar. Para obtener más información, consulta Acceso a la configuración de GitHub App en este artículo.
2. En la barra lateral de la izquierda, haga clic en Avanzado.
3. En «Zona de peligro», según la visibilidad actual de su GitHub App, haga clic en Hacer público o Hacer privado.