Ao registrar um GitHub App, você pode especificar uma URL de instalação. Quando os usuários instalam seu GitHub App, eles são redirecionados para a URL de configuração. Se uma instalação adicional for necessária após a instalação, use essa URL para informar os usuários sobre as próximas etapas que devem ser seguidas.
Se você especificar uma URL de instalação, também poderá selecionar Redirecionar na atualização para especificar que os usuários devem ser redirecionados para a URL de instalação após atualizarem uma instalação. Uma atualização inclui a adição ou a remoção de acesso a um repositório para uma instalação.
Aviso
Quando GitHub redireciona os usuários para a URL de instalação, ela inclui um installation_id parâmetro de consulta. Agentes mal-intencionados podem acessar essa URL com um installation_id falsificado. Portanto, você não deve confiar na validade do parâmetro installation_id. Em vez disso, você deve gerar um token de acesso de usuário para o usuário que instalou o GitHub App e, em seguida, verificar se a instalação está associada a esse usuário. Para saber mais, confira Gerando um token de acesso do usuário para um aplicativo GitHub.
Embora a URL de instalação seja opcional durante GitHub App o registro, ela será necessária se você quiser permitir que os usuários comprem seu aplicativo.GitHub Marketplace Para saber mais, confira Gerenciar novas compras e testes grátis.
A URL de instalação é diferente da URL de retorno de chamada. Os usuários são redirecionados para a URL de instalação depois que instalam um GitHub App. Os usuários são redirecionados para a URL de callback quando autorizam um GitHub App por meio do fluxo de aplicativo da Web. Para saber mais, confira Sobre a URL de retorno de chamada de autorização do usuário.
Para obter mais informações sobre como registrar um GitHub App, consulte Registrando um aplicativo GitHub. Para obter mais informações sobre como modificar um GitHub App registro, consulte Modificando um registro de aplicativo GitHub.