Visão geral da MSAL (Biblioteca de Autenticação da Microsoft)
A MSAL (Biblioteca de Autenticação da Microsoft) permite que os desenvolvedores adquiram tokens de segurança a partir da plataforma de identidade da Microsoft para autenticar usuários e acessar APIs Web seguras. Ele pode ser usado para fornecer acesso seguro a Microsoft Graph, outras APIs da Microsoft, APIs Web de terceiros ou sua própria API Web. O MSAL dá suporte a várias 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 da MSAL oferece os seguintes benefícios:
- Não é necessário usar diretamente as bibliotecas OAuth ou o código no protocolo em seu aplicativo.
- Pode adquirir tokens em nome de um usuário ou aplicativo (quando aplicável à plataforma).
- Mantém um cache de token para você e manipula atualizações de token quando eles estão perto de expirar.
- Ajuda a especificar em qual público você deseja que o aplicativo se conecte. O público-alvo de entrada pode incluir contas pessoais da Microsoft, identidades sociais com organizações do Azure AD B2C, trabalho, escola ou usuários em nuvens soberanas e nacionais.
- Ajuda você a configurar seu aplicativo com base nos arquivos de configuração.
- Ajuda você a solucionar problemas do aplicativo expondo exceções, log e telemetria acionáveis.
| Tipos e cenários de aplicativos | Tutoriais |
|---|---|
| Aplicativos de página única (JavaScript) | Tutorial: conectar usuários a um aplicativo de página única (SPA) em React |
| Aplicativos Web | Tutorial: conectar usuários a um aplicativo Web do ASP.NET Core |
| APIs da Web | Tutorial: implementar uma API do ASP.NET Core de ponto de extremidade protegido |
| Aplicativos nativos e móveis | Aplicativo móvel que chama uma API Web em nome do usuário conectado de forma interativa. |
| Daemons e aplicativos do lado do servidor | Aplicativo daemon da área de trabalho/de serviço que chama uma API Web em seu próprio nome |
Linguagens e estruturas da MSAL
Você pode consultar a documentação a seguir para saber mais sobre as diferentes bibliotecas MSAL.
| Documentação da MSAL | Biblioteca MSAL | Plataformas e estruturas compatíveis |
|---|---|---|
| MSAL.NET | MSAL.NET | .NET Framework, .NET, .NET MAUI, WINUI, Xamarin Android, Xamarin iOS, Plataforma Universal do Windows |
| 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 de JavaScript/TypeScript, como Vue.js, Ember.js ou Durandal.js |
| Nó MSAL | Nó MSAL | Aplicativos Web com Expresso, aplicativos da área de trabalho com Electron, aplicativos de console de plataforma cruzada |
| MSAL Python | MSAL Python | Windows, macOS, Linux |
| MSAL React | MSAL React | Aplicativos de página única com bibliotecas baseadas em reagir e reagir (Next.js, Gatsby.js) |
| MSAL Go (visualização) | MSAL Go (visualização) | Windows, macOS, Linux |
Migrar aplicativos que usam a ADAL para a MSAL
A Biblioteca de Autenticação do Active Directory (ADAL) encerrou o suporte. Recomendamos que os clientes garantam que seus aplicativos sejam migrados para a MSAL. A MSAL integra-se ao ponto de extremidade da plataforma de identidade da Microsoft (v2.0), que é a unificação de contas pessoais e contas corporativas da Microsoft em um único sistema de autenticação. A ADAL integra-se a um ponto de extremidade v1.0 que não dá suporte a contas pessoais.
Para obter mais informações sobre como migrar para a MSAL, confira Migrar aplicativos para a MSAL (Biblioteca de Autenticação da Microsoft).