Guia de início rápido: adicionar entrada com a Microsoft a um aplicativo Web Python

Neste início rápido, você baixa e executa um exemplo de código que demonstra como um aplicativo Web Python pode entrar em usuários e obter um token de acesso para chamar a API do Microsoft Graph. Os utilizadores com uma conta Microsoft pessoal ou uma conta em qualquer organização do Microsoft Entra podem iniciar sessão na aplicação.

Consulte Como funciona o exemplo para obter uma ilustração.

Pré-requisitos

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
• Python 2.7+ ou Python 3+
• Flask, Flask-Session, pedidos
• MSAL Python

Passo 1: Configurar a aplicação no portal do Azure

Para que o exemplo de código neste início rápido funcione:

1. Adicione um URL de resposta como http://localhost:5000/getAToken.
2. Crie um segredo do cliente.
3. Adicione a permissão delegada User.ReadBasic.All da API do Microsoft Graph.

Passo 2: Transferir o projeto

Baixe o projeto e extraia o arquivo zip para uma pasta local mais próxima da pasta raiz - por exemplo, C:\Azure-Samples

Etapa 3: Executar o exemplo de código

1. Você precisará instalar a biblioteca MSAL Python, Flask framework, Flask-Sessions para gerenciamento de sessão do lado do servidor e solicitações usando pip da seguinte maneira:

   pip install -r requirements.txt
   

2. Executar app.py a partir do shell ou da linha de comando:

   python app.py
   

   Importante

   Este aplicativo de início rápido usa um segredo do cliente para se identificar como cliente confidencial. Como o segredo do cliente é adicionado como um texto sem formatação aos arquivos do projeto, por motivos de segurança, é recomendável usar um certificado em vez de um segredo do cliente antes de considerar o aplicativo como aplicativo de produção. Para obter mais informações sobre como usar um certificado, consulte estas instruções.

Mais informações

Como funciona a amostra

Obter o MSAL

MSAL é a biblioteca usada para entrar usuários e solicitar tokens usados para acessar uma API protegida pela plataforma de identidade da Microsoft. Você pode adicionar MSAL Python ao seu aplicativo usando Pip.

pip install msal

Inicialização da MSAL

Você pode adicionar a referência ao MSAL Python adicionando o seguinte código à parte superior do arquivo onde você usará o MSAL:

import msal

Ajuda e suporte

Se precisar de ajuda, quiser comunicar um problema ou quiser saber mais sobre as suas opções de suporte, consulte Ajuda e suporte para programadores.

Próximos passos

Saiba mais sobre as aplicações Web que iniciam sessão de utilizadores na nossa série de cenários com várias partes.