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.
- En la esquina superior derecha de cualquier página, en GitHub, haz clic en la fotografía del perfil.
- 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:
- Haga clic en Sus organizaciones.
- A la derecha de la organización, haga clic en Configuración.
- En la barra lateral de la izquierda, haz clic en Developer settings.
- En la barra lateral de la izquierda, haga clic en GitHub Apps .
- 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.
- 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.
- En "Información básica", modifique la GitHub App información que desea cambiar.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
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.
- 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.
- En la GitHub Apps barra lateral de configuración, haga clic en Permisos y eventos.
- 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.
- 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.
- 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.
- 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.
- En "Webhook", para habilitar o deshabilitar el webhook, seleccione o anule la selección de la opción Active.
- 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.
- 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.
- 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.
- Active el GitHub App webhook. Consulte en este artículo cómo activar o desactivar el GitHub App webhook.
- En la GitHub Apps barra lateral de configuración, haga clic en Permisos y eventos.
- 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.
- En "Suscribirse a eventos", seleccione los eventos de webhook que desea GitHub App recibir.
- 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.
- 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.
- En la barra lateral de la izquierda, haga clic en Avanzado.
- En «Zona de peligro», según la visibilidad actual de su GitHub App, haga clic en Hacer público o Hacer privado.