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 ou o código em relação ao 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 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 você a solucionar problemas do seu aplicativo expondo exceções, registro em log e telemetria acionáveis.
| 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 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 |
Linguagens e Frameworks MSAL
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, 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 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 Reagir | MSAL Reagir | Aplicativos de página única com bibliotecas baseadas em React e React (Next.js, Gatsby.js) |
| MSAL Go (Pré-visualização) | MSAL Go (Pré-visualização) | Windows, macOS, Linux |
Migrar aplicativos que usam ADAL para MSAL
A Biblioteca de Autenticação do Ative Directory (ADAL) encerrou o suporte. Recomendamos que os clientes garantam que seus aplicativos sejam migrados para o MSAL. O MSAL integra-se com o ponto de extremidade da plataforma de identidade da Microsoft (v2.0), que é a unificação de contas pessoais e contas profissionais da Microsoft em um único sistema de autenticação. A ADAL integra-se com um ponto de extremidade v1.0 que não suporta contas pessoais.
Para obter mais informações sobre como migrar para o MSAL, consulte Migrar aplicativos para a Biblioteca de Autenticação da Microsoft (MSAL).