Skip to main content

Acerca de la URL de configuración

Puedes especificar una dirección URL a la que se redirigirán los usuarios después de instalar una GitHub App.

Al registrar una instancia de GitHub App, puedes especificar una dirección URL de instalación. Cuando los usuarios instalen GitHub App, se les redirigirá a la URL de instalación. Si se necesita configuración adicional después de la instalación, puedes usar esta dirección URL para indicar a los usuarios qué pasos realizar a continuación.

Si especificas una dirección URL de configuración, también puedes seleccionar Redirigir al actualizar para especificar que los usuarios deben redirigirse a la dirección URL de configuración después de actualizar una instalación. Una actualización incluye la adición o eliminación del acceso a un repositorio para una instalación.

Advertencia: cuando GitHub redirige a los usuarios a la dirección URL de configuración, se incluye un parámetro installation_id de consulta. Actores malintencionados pueden acceder a esta dirección URL con un installation_id falso. Por tanto, no debes confiar en la validez del parámetro installation_id. En vez de eso, debes generar un token de acceso de usuario para el usuario que instaló GitHub App y, a continuación, comprobar que la instalación está asociada a ese usuario. Para obtener más información, vea «Generación de un token de acceso de usuario para una aplicación de GitHub».

Aunque la dirección URL de instalación es opcional durante el registro de GitHub App, es obligatoria si quieres permitir que los usuarios compren la aplicación en GitHub Marketplace. Para obtener más información, vea «Gestionar las compras nuevas y las pruebas gratuitas».

La URL de configuración es diferente de la URL de devolución de llamada. Se redirigirá a los usuarios a la URL de configuración después de que instalen una GitHub App. Se les redirigirá a la URL de devolución de llamada cuando autoricen la GitHub App a través del flujo de la aplicación web. Para obtener más información, vea «Acerca de la dirección URL de devolución de llamada de autorización de usuario».

Para más información sobre el registro de una instancia de GitHub App, consulta "Registro de una instancia de GitHub App". Para más información sobre cómo modificar el registro de una instancia de GitHub App, consulta "Modificación del registro de una instancia de GitHub App".