Guia de início rápido: adicionar início de sessão com a Microsoft a um aplicativo web em Python

Neste guia de início rápido, faz download e executa um exemplo de código que demonstra como uma aplicação web em Python pode autenticar utilizadores e obter um token de acesso para chamar a Microsoft Graph API. Os utilizadores com uma conta Microsoft pessoal ou uma conta em qualquer organização do Microsoft Entra podem iniciar sessão na aplicação.

Pré-requisitos

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

Etapa 1: Configurar seu aplicativo no portal do Azure

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

1. Adicione uma 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: Descarregue o seu 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, o framework Flask 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. Execute 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

Obter o MSAL

MSAL é a biblioteca usada para autenticar utilizadores e solicitar tokens utilizados para aceder a uma API protegida pela plataforma de identidade da Microsoft. Você pode adicionar MSAL Python ao seu aplicativo usando Pip.

pip install msal

Inicialização do 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 aplicações web que apelam a uma API na nossa série de cenários em várias partes.