Configure seu Serviço de Aplicativo ou aplicativo do Azure Functions para usar o logon do GitHub

Este artigo mostra como configurar o Serviço de Aplicativo do Azure ou o Azure Functions para usar o GitHub como um provedor de autenticação.

Para concluir o procedimento neste artigo, você precisa de uma conta do GitHub. Para criar uma nova conta do GitHub, vá para o GitHub.

Registre seu aplicativo no GitHub

Para registrar seu aplicativo no GitHub:

1. Entre no portal do Azure e vá para seu aplicativo. Copie a URL. Você o usará para configurar seu aplicativo GitHub.

2. Siga as instruções para criar um aplicativo OAuth no GitHub. Na seção URL de retorno de chamada de autorização, insira a URL HTTPS do seu aplicativo e adicione o caminho /.auth/login/github/callback. Por exemplo, https://contoso.azurewebsites.net/.auth/login/github/callback.

3. Na página do aplicativo, anote a ID do cliente, que você precisará mais tarde.

4. Em Segredos do cliente, selecione Gerar um novo segredo do cliente.

5. Anote o valor do segredo do cliente, que irá precisar mais tarde.

   Importante

   O segredo do cliente é uma credencial de segurança importante. Não partilhe este segredo com ninguém nem distribua-o com a sua aplicação.

Adicionar informações do GitHub ao seu aplicativo

Para adicionar informações do GitHub ao seu aplicativo:

1. Entre no portal do Azure e navegue até seu aplicativo.

2. Selecione Autenticação no menu à esquerda. Clique em Adicionar provedor de identidade.

3. Selecione GitHub na lista suspensa do provedor de identidade. Cole os Client ID valores e Client secret que você obteve anteriormente.

   O segredo será armazenado como uma configuração de aplicativo adesivo de slot chamada GITHUB_PROVIDER_AUTHENTICATION_SECRET. Você pode atualizar essa configuração posteriormente para usar referências do Cofre da Chave se desejar gerenciar o segredo no Cofre da Chave do Azure.

4. Se este for o primeiro provedor de identidade configurado para a aplicação, ser-lhe-á também apresentada uma secção de definições de autenticação do Serviço de Aplicações. Caso contrário, você pode passar para a próxima etapa.

   Essas opções determinam como seu aplicativo responde a solicitações não autenticadas e as seleções padrão redirecionarão todas as solicitações para fazer login com esse novo provedor. Você pode alterar esse comportamento agora ou ajustar essas configurações posteriormente na tela principal Autenticação escolhendo Editar ao lado de Configurações de autenticação. Para saber mais sobre essas opções, consulte Fluxo de autenticação.

5. Clique em Adicionar.

Agora você está pronto para usar o GitHub para autenticação em seu aplicativo. O provedor será listado na tela Autenticação . A partir daí, você pode editar ou excluir essa configuração do provedor.