Acerca de las modificaciones de GitHub App
Puedes modificar el registro de tu instancia de GitHub App para cambiar la configuración que se seleccionó cuando la aplicación se registró inicialmente. Para más información sobre las opciones que puedes seleccionar al registrar una instancia de GitHub App, consulta "Registro de una instancia de GitHub App".
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 puedes optar por probar nuevas características opcionales para la GitHub App. Para obtener más información, vea «Activación de características opcionales para Aplicaciones de GitHub».
Acceso a la configuración de GitHub App
Para modificar una instancia de 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 Enterprise Server, haga clic en su fotografía de 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 izquierda, haz clic en Configuración del desarrollador.
- 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.
Cambio de la información básica de una instancia de GitHub App
Puede cambiar la información básica de la instancia de GitHub App, como el nombre de la aplicación, la descripción de la aplicación y la dirección URL de la página principal 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, consulte "Acceso a la configuración de GitHub App en este artículo.
- En "Basic information", modifique la información de GitHub App que quiere cambiar.
- Haga clic en Guardar cambios.
Solicitud de autorización de usuario (OAuth) durante la instalación
Puede pedir a los usuarios que autoricen a GitHub App cuando la 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. Para obtener más información, vea «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, consulte "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 Request user authorization (OAuth) during installation.
- 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 usar el flujo de dispositivo para autorizar a los usuarios para una aplicación sin encabezado, como una herramienta de la CLI o un administrador de credenciales de Git. Para más información sobre el flujo del dispositivo con GitHub Apps, 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, consulte "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. Para obtener más información, vea «Registro de una instancia de GitHub App».
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. Para obtener más información, vea «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, consulte "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 "Dirección URL de instalación" está en blanco, se omitirá.
Cambio de los permisos de una instancia de GitHub App
Puede cambiar los permisos de acceso que se conceden a la instancia de GitHub App mediante los pasos siguientes.
Al cambiar los permisos de repositorio o de organización de una aplicación, cada cuenta en la que está instalada la aplicación deberá aprobar los nuevos permisos. Al cambiar los permisos de cuenta de 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 de 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.
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. Para obtener más información, vea «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, consulte "Acceso a la configuración de GitHub App en este artículo.
- En la barra lateral de configuración de GitHub Apps, haz 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. Para obtener más información, vea «Elección de permisos para una aplicación de GitHub».
- Opcionalmente, en "Add a note to users", agregue una nota que indique a los usuarios el motivo del cambio de los permisos que solicita la aplicación GitHub App.
- Haga clic en Guardar cambios.
Activación o desactivación del webhook de GitHub App
Puedes configurar tu GitHub App para recibir webhooks para eventos específicos en GitHub y tomar medidas automáticamente en ellos. Para obtener más información, vea «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, consulte "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 ha seleccionado la opción Active en el paso anterior, en "Webhook URL", escriba la dirección URL a la que GitHub debe enviar los 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 recomienda establecer un secreto de webhook.
Cambio de las suscripciones de eventos de webhook de una instancia de GitHub App
Puede cambiar los eventos de webhook a los que se suscribe una instancia de GitHub App mediante los pasos siguientes.
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. Para más información, 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, consulte "Acceso a la configuración de GitHub App en este artículo.
- Active el webhook de GitHub App. Para obtener más información, consulte "Activación o desactivación del webhook de GitHub App" en este artículo.
- En la barra lateral de configuración de GitHub Apps, haz 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. Para obtener más información, consulte "Cambio de los permisos de una instancia de GitHub App".
- En "Subscribe to Events", seleccione los eventos de webhook que desea que reciba la instancia de GitHub App.
- Haga clic en Guardar cambios.
Cambio de la visibilidad de una instancia de GitHub App
Puede cambiar la configuración de visibilidad de la instancia de GitHub App para controlar quién puede instalarla. Las aplicaciones públicas no se pueden convertir en privadas si se han instalado en otras cuentas. Para obtener más información, vea «Hacer pública o privada a una GitHub App».
- Vaya a la página de configuración de la aplicación que desea modificar. Para obtener más información, consulte "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", en función de la visibilidad actual de la instancia de GitHub App, haga clic en Make public o Make private.