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

• Microsoft Entra
• Facebook
• Google
• X
• Um provedor do OpenID Connect
• Entrar com a Apple (Versão prévia)

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 descrito neste artigo, você precisará ter uma conta do GitHub. Para criar uma conta do GitHub, acesse GitHub.

Registre seu aplicativo no GitHub

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

2. Siga as instruções para criar um aplicativo OAuth no GitHub. Na seção URLs de retorno de chamada de autorização, insira a URL HTTPS do aplicativo e acrescente 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 você precisará mais tarde.

   Importante

   O segredo do cliente é uma credencial de segurança importante. Não compartilhe esse segredo com ninguém nem o distribua com seu aplicativo.

Adicionar informações do GitHub ao seu aplicativo

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

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

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

   O segredo será armazenado como uma configuração de aplicativo de slot-adesivo denominada GITHUB_PROVIDER_AUTHENTICATION_SECRET. Você poderá atualizar essa configuração posteriormente para usar referências do Key Vault se quiser gerenciar o segredo no Azure Key Vault.

4. Se este for o primeiro provedor de identidade configurado para o aplicativo, você também receberá um prompt da seção de Configurações de autenticação do Serviço de Aplicativo. Caso contrário, passe 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 logon com esse novo provedor. Você pode alterar e personalizar esse comportamento agora ou ajustar essas configurações posteriormente na tela principal de Autenticação escolhendo Editar ao lado de Configurações de autenticação. Para saber mais sobre essas opções, confira Fluxo de autenticação.

5. Clique em Adicionar.

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