Modificar una GitHub App

Acerca de las modificaciones de GitHub App

Puede modificar GitHub App para cambiar cualquiera de las opciones que se seleccionaron al crear la aplicación. Para obtener más información sobre las opciones que puede seleccionar al crear una instancia de GitHub App, consulte "Crear una 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 «Activating optional features for GitHub Apps».

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.

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

   • Para una GitHub App que pertenezca a una cuenta personal, 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. A continuación, a la derecha de la organización, haz clic en Configuración.

     

2. En la barra lateral izquierda, haz clic en Configuración del desarrollador.

3. En la barra lateral de la izquierda, haz clic en GitHub App . 1. 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.

1. 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.
2. En "Basic information", modifique la información de GitHub App que quiere 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 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».

1. 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.
2. En la opción "Identifying and authorizing users", seleccione o anule la selección de Request user authorization (OAuth) during installation.
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 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".

1. 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.
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. Para obtener más información, vea «Crear una 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».

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

1. 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.
2. En la barra lateral de configuración de GitHub Apps, haz 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. Para obtener más información, vea «Elección de permisos para una aplicación de GitHub».
4. 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.
5. 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».

1. 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.
2. En "Webhook", para habilitar o deshabilitar el webhook, seleccione o anule la selección de la opción Active.
3. 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.
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 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.

The specific webhook events that you can select in your app settings are determined by the type of permissions you selected for your app. You will first need to select the permissions you would like your app to have, and then you can subscribe your app to webhook events that are related to that set of permissions. Para más información, 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, consulte "Acceso a la configuración de GitHub App en este artículo.
2. 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.
3. En la barra lateral de configuración de GitHub Apps, haz 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. Para obtener más información, consulte "Cambio de los permisos de una instancia de GitHub App".
5. En "Subscribe to Events", seleccione los eventos de webhook que desea que reciba la instancia de GitHub App.
6. 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».

1. 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. 1. En la barra lateral de la izquierda, haga clic en Avanzado.
2. 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.