Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Esta versão do GitHub Enterprise foi descontinuada em 2022-06-03. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, melhorar a segurança e novos recursos, upgrade to the latest version of GitHub Enterprise. Para ajuda com a atualização, contact GitHub Enterprise support.

Criar um aplicativo GitHub

Você pode criar e registrar um aplicativo GitHub na sua conta pessoal em sob qualquer organização �  qual você tem acesso administrativo.

  1. Acesse as configurações da sua conta.

    • Para aplicativo GitHub pertencente a uma conta pessoal, no canto superior direito de qualquer página, clique na sua foto de perfil e clique em Configurações. Ícone Settings (Configurações) na barra de usuário
    • Para um aplicativo GitHub pertencente a uma organização, no canto superior direito de qualquer página, clique na sua foto do perfil e, em seguida, clique em Sua organização. Em seguida, �  direita da organização, clique em Configurações. Suas organizações no menu de perfil Botão de configurações
  2. Na barra lateral esquerda, clique em Developer settings (Configurações do desenvolvedor). Configurações do desenvolvedor

  3. Na barra lateral esquerda, clique em Aplicativos GitHub. Seção de aplicativos do GitHub

  4. Clique em Novo aplicativo GitHub. Botão para criar um novo aplicativo GitHub

  5. Em "Nome do aplicativo GitHub App", digite o nome do seu aplicativo. Campo para o nome do seu aplicativo GitHub

    Dê um nome claro e sucinto ao seu aplicativo. Seu aplicativo não pode ter o mesmo nome de uma conta existente no GitHub, a menos que seja o seu próprio nome de usuário ou da sua organização. Uma versão movida do nome do seu aplicativo será exibida na interface do usuário quando sua integração realizar uma ação.

  6. Opcionalmente, em "Descrição", digite uma descrição do aplicativo que os usuários irão ver. Campo para uma descrição do seu aplicativo GitHub

  7. Em "URL da página inicial", digite a URL completa do site do seu aplicativo. Campo para a URL da página inicial do seu aplicativo GitHub

  8. Em "URL de retorno de chamada", digite a URL completa para redirecionar após um usuário autorizar a instalação. Esta URL é usada se o aplicativo precisar identificar e autorizar solicitações de usuário para servidor.

    Você pode usar Adicionar URL de retorno de chamada para fornecer URLs de retorno de chamadas adicionais até o limite máximo de 10.

    Botão para 'Adicionar URL de retorno de chamada' e campo para URL de retorno de chamada

  9. Por padrão, para melhorar a segurança de seus aplicativos, seus aplicativos usarão os tokens de autorização do usuário. Para optar por não usar tokens do usuário expirados, você deverá desmarcar "Expirar tokens de autorização do usuário". Para saber mais sobre como configurar o fluxo de atualização do token e os benefícios de expirar os tokens do usuário, consulte "Atualizando tokens de acesso do usuário para o servidor." Opção para expirar os tokens dos usuários durante a configuração dos aplicativos GitHub

  10. Se seu aplicativo autoriza usuários a usar o fluxo OAuth, você pode selecionar Solicitar autorização de usuário (OAuth) durante a instalação para permitir que pessoas autorizem o aplicativo ao instalá-lo, economizando uma etapa. Se você selecionar esta opção, a "URL de configuração" irá tornar-se indisponível e os usuários serão redirecionados para a "URL de retorno de chamada de autorização do usuário" após a instalação do aplicativo. Consulte "Autorizando usuários durante a instalação" para obter mais informações. Request user authorization during installation

  11. Se for necessária uma configuração adicional após a instalação, adicione um "Configurar URL" para redirecionar os usuários após a instalação do seu aplicativo. Campo para a URL de configuração do seu aplicativo GitHub

    Observação: Ao selecionar Solicitar autorização do usuário (OAuth) durante a instalação na etapa anterior, este campo irá tornar-se indisponível e as pessoas serão redirecionadas para a "URL de chamada de retorno de autorização do usuário" após a instalação do aplicativo.

  12. Na "URL Webhook", digite a URL para a qual os eventos serão POST. Cada aplicativo recebe o seu próprio webhook, que irá notificá-lo sempre que o aplicativo for instalado ou modificado, bem como quaisquer outros eventos que o aplicativo assinar. Campo para a URL do webhook do seu aplicativo GitHub

  13. Opcionalmente, no "Segredo do webhook", digite um token secreto opcional usado para proteger seus webhooks. Campo para adicionar um token secreto para seu webhook

    Observação: É altamente recomendável que você defina um token secreto. Para obter mais informações, consulte "Protegendo seus webhooks".

  14. Em "Permissões", escolha as permissões que o seu aplicativo irá solicitar. Para cada tipo de permissão, use o menu suspenso e clique em somente leitura, leitura & gravação ou Sem acesso. Várias permissões para o seu aplicativo GitHub

  15. Em "Assinar eventos", escolha os eventos que você deseja que seu aplicativo receba.

  16. Para escolher o local onde o aplicativo pode ser instalado, selecione somente nesta conta ou qualquer conta. Para obter mais informações sobre as opções de instalação, consulte "Tornando um aplicativo GitHub público ou privado". Opções de instalação para o seu aplicativo GitHub

  17. Click Criar aplicativo GitHub. Botão para criar o seu aplicativo GitHub