Configure a sua aplicação App Service ou Azure Functions para usar Iniciar sessão com o GitHub

• Microsoft Entra
• Facebook
• Google
• GitHub
• X
• provedor de identidade OpenID Connect
• Iniciar sessão com a Apple (pré-visualização)

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 o seu URL, que está em domínio Padrão na página Visão Geral. 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 da candidatura, note o ID do Cliente. Você precisará dele mais tarde.

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

5. Anota o valor secreto do cliente, que precisarás mais tarde.

   Importante

   O segredo do cliente é uma credencial de segurança importante. Não partilhe este segredo com ninguém nem o distribua na 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 vá para seu aplicativo.

2. Selecione Configurações>de Autenticação no menu de navegação. Selecione Adicionar provedor de identidade.

3. Selecione GitHub na lista pendente 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. Podes atualizar essa definição mais tarde para usar referências do Key Vault se quiseres gerir o segredo no Azure Key Vault.

4. Se este fornecedor de identidade for o primeiro configurado para a aplicação, verá também uma secção de definições de autenticação do App Service. 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. As seleções padrão redirecionam todas as solicitações para entrar com o novo provedor. Pode alterar este comportamento agora ou ajustar estas definições mais tarde a partir do ecrã principal de Autenticação , selecionando Editar ao lado de Definições de Autenticação. Para saber mais sobre essas opções, consulte Fluxo de autenticação.

5. Selecione Adicionar.

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