Al registrar un GitHub App, puede especificar una dirección URL de configuración. Cuando los usuarios instalan tu GitHub App, se les redirige a la URL de configuració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, incluye un installation_id parámetro de consulta. Ciberdelincuentes pueden utilizar esta dirección URL con un installation_id falso. Por tanto, no debes confiar en la validez del parámetro installation_id. En su lugar, debe 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 más información, consulta Generación de un token de acceso de usuario para una aplicación de GitHub.
La URL de configuración es diferente de la URL de devolución de llamada. Los usuarios se redirigen a la dirección URL de configuración después de instalar un GitHub App. Se redirige a los usuarios a la URL de retorno cuando autorizan un GitHub App mediante el flujo de la aplicación web. Para más información, consulta Acerca de la dirección URL de devolución de llamada de autorización de usuario.
Para obtener más información sobre cómo registrar un GitHub App, vea Registro de una aplicación de GitHub. Para obtener más información sobre cómo modificar un GitHub App registro, consulte Modificación de un registro de aplicación de GitHub.