Descrição geral da Biblioteca de Autenticação da Microsoft (MSAL)
A Biblioteca de Autenticação da Microsoft (MSAL) permite que os desenvolvedores adquiram tokens de segurança da plataforma de identidade da Microsoft para autenticar usuários e acessar APIs da Web seguras. Ele pode ser usado para fornecer acesso seguro ao Microsoft Graph, outras APIs da Microsoft, APIs da Web de terceiros ou sua própria API da Web. O MSAL suporta muitas arquiteturas e plataformas de aplicativos diferentes, incluindo .NET, JavaScript, Java, Python, Android e iOS.
A MSAL fornece várias maneiras de obter tokens de segurança, com uma API consistente para muitas plataformas. O uso do MSAL oferece os seguintes benefícios:
- Não há necessidade de usar diretamente as bibliotecas OAuth nem de programar contra o protocolo na sua aplicação.
- Pode adquirir tokens em nome de um usuário ou aplicativo (quando aplicável à plataforma).
- Mantém um cache de token para você e lida com atualizações de token quando elas estão perto de expirar.
- Ajuda a especificar em qual público você deseja que seu aplicativo entre. O público de entrada pode incluir contas pessoais da Microsoft, identidades sociais com organizações B2C do Azure AD, trabalho, escola ou usuários em nuvens soberanas e nacionais.
- Ajuda você a configurar seu aplicativo a partir de arquivos de configuração.
- Ajuda a solucionar problemas do seu aplicativo através da exposição de exceções acionáveis, registo de eventos e telemetria.
| Tipos de aplicação e cenários | Tutoriais |
|---|---|
| Aplicativos de página única (JavaScript) | Tutorial: Iniciar sessão de utilizadores numa aplicação React Single-page (SPA) |
| Aplicações Web | Tutorial: Iniciar sessão de utilizadores numa aplicação Web ASP.NET Core |
| APIs da Web | Tutorial: Implementar um ponto de extremidade protegido em uma API ASP.NET Core |
| Aplicações móveis e nativas | Aplicativo móvel chamando uma API da Web em nome do usuário que está conectado interativamente. |
| Daemons e aplicativos do lado do servidor | Aplicativo daemon de desktop/serviço chamando API da Web em nome próprio |
MSAL Linguagens e Frameworks
Você pode consultar a documentação a seguir para saber mais sobre as diferentes bibliotecas MSAL.
| Documentação do MSAL | Biblioteca MSAL | Plataformas e estruturas suportadas |
|---|---|---|
| MSAL.NET | MSAL.NET | .NET Framework, .NET, .NET MAUI, WINUI |
| MSAL para Android | MSAL para Android | Android |
| MSAL Angular | MSAL Angular | Aplicativos de página única com estruturas Angular e Angular.js |
| MSAL para iOS e macOS | MSAL para iOS e macOS | iOS e macOS |
| MSAL Java | MSAL Java | Windows, macOS, Linux |
| MSAL.js | MSAL.js | Estruturas JavaScript/TypeScript, como Vue.js, Ember.js ou Durandal.js |
| Nó MSAL | Nó MSAL | Aplicações Web com Express, aplicações de ambiente de trabalho com Electron, aplicações de consola multiplataforma |
| MSAL Python | MSAL Python | Windows, macOS, Linux |
| MSAL React | MSAL React | Aplicações de página única com React e bibliotecas baseadas em React (Next.js, Gatsby.js) |
| MSAL Go (Pré-visualização) | MSAL Go (Pré-visualização) | Windows, macOS, Linux |
Importante
A Biblioteca de Autenticação do Ative Directory (ADAL) encerrou o suporte. Os clientes precisam garantir que seus aplicativos sejam migrados para o MSAL. O MSAL integra-se com o endpoint da plataforma de identidade da Microsoft (v2.0), que une contas pessoais e contas profissionais da Microsoft num único sistema de autenticação. O ADAL integra-se com um endpoint v1.0 que não dá suporte a contas pessoais.