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 2021-03-02. 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. No canto superior direito de qualquer página, clique na sua foto de perfil e, em seguida, clique em Configurações.

    Ícone Settings (Configurações) na barra de usuário

  2. Na barra lateral esquerda, clique em Developer settings (Configurações do desenvolvedor).

    Seção de 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 um usuário 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 chamada de retorno de autorização do usuário", digite a URL completa para redirecionamento após um usuário autorizar uma instalação. Esta URL é usada se o aplicativo precisar identificar e autorizar solicitações de usuário para servidor.

    Campo para a URL de chamada de retorno de autorização do usuário do seu aplicativo GitHub

  1. 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.

    Solicitar autorização de usuário durante a instalação

  2. 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.

  3. 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

  4. 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".

  5. 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

  6. Em "Assinar eventos", escolha se deseja assinar seu aplicativo para eventos de etiqueta, públicos, repositório or inspeção.

    Inscreva-se nas opções de eventos para seu aplicativo GitHub

  7. 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

  8. Click Criar aplicativo GitHub.

    Botão para criar o seu aplicativo GitHub