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

Después de registrar una GitHub App, puedes realizar cambios en ella.

En este artículo

Acerca de las modificaciones de GitHub App

Puedes modificar el registro de tu aplicación de GitHub App para cambiar cualquiera de las configuraciones seleccionadas cuando 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 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 puedes optar por probar nuevas características opcionales para la GitHub App. Consulta 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.

  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. Si usa Enterprise Managed Users, haga clic en Su empresa para ir directamente a la configuración de la cuenta empresarial.
      2. Si usa cuentas personales, haga clic en Sus empresas y, a continuación, a la derecha de la empresa, haga clic en Configuración.

  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, en "Configuración", haz clic en GitHub Apps.

  4. 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, consulta 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. 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 flujo de dispositivos 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 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 agregar un nuevo permiso de repositorio, organización o empresa para una aplicación, cada cuenta donde se instala la aplicación deberá 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 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.

Si quitas permisos o webhooks de la instancia de 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 cambias 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 eres propietario de la empresa. Si eres administrador de aplicaciones, los cambios solo se aceptarán automáticamente en organizaciones donde seas propietario 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 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. Consulta 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. 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 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.

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. 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. Active el webhook de GitHub App. Consulte Activar o desactivar el 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. Consulte Cambio de los permisos de una GitHub App.
  5. En "Suscribirse a Eventos", seleccione los eventos de webhook que desea que reciba su GitHub App.
  6. Haga clic en Guardar cambios.

Cambiar 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. Consulta Hacer que una aplicación de GitHub sea pública o privada.

No puede cambiar la visibilidad de una GitHub App propiedad de una empresa. Las GitHub Apps que pertenecen a una empresa solo se pueden instalar en organizaciones dentro de la empresa o en la empresa misma .

  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", dependiendo de la visibilidad actual de tu GitHub App, haz clic en Hacer público o Hacer privado.