Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
A biblioteca MSAL para JavaScript permite que aplicações JavaScript no lado do cliente autentiquem utilizadores utilizando contas profissionais e escolares do Microsoft Entra ID, contas pessoais da Microsoft (MSA) e fornecedores de identidade social, como o Facebook, o Google, o LinkedIn e contas pessoais da Microsoft, etc., através do serviço Azure AD B2C. Também permite que a sua aplicação obtenha tokens para aceder a serviços da Microsoft Cloud, como o Microsoft Graph.
O @azure/msal-browser pacote permite autenticação em aplicações JavaScript de página única usando o OAuth 2.0 Authorization Code Flow com PKCE. Não suporta o fluxo implícito. A versão atual é MSAL.js v5.x. Se estiveres a usar uma versão mais antiga, consulta os guias de migração para atualizar.
Pré-requisitos
@azure/msal-browserdestina-se a ser utilizado em cenários de aplicação de página única.Antes de utilizar
@azure/msal-browser, terá de registar uma aplicação de página única no Microsoft Entra ID para obter umclientIdválido para configuração e para registar as rotas nas quais a sua aplicação aceitará tráfego de redirecionamento.
Principais características
O MSAL Browser oferece as seguintes funcionalidades para as suas aplicações de página única:
- Iniciar sessão de utilizadores com fluxos de pop-up ou de redirecionamento
- Adquira tokens silenciosamente a partir da cache ou através de refresh
- Suporte para fluxos popup Cross-Origin-Opener-Policy (COOP)
- Autenticação pelo Protocolo de Contexto de Modelo (MCP)
- Tokens ligados ao dispositivo via platform broker (WAM)
- Cache de tokens encriptada com AES-GCM no localStorage
- tokens de Prova de Posse (PoP)
- Início de sessão único em separadores e aplicações
- Autenticação de Aplicações Incorporadas (NAA) para aplicações Microsoft 365
Instalação
Via NPM
npm install @azure/msal-browser
Samples
A msal-browser-samples pasta contém exemplos de aplicações para as nossas bibliotecas.
Mais instruções para executar os samples podem ser encontradas no README.md ficheiro da pasta VanillaJSTestApp2.0.
Exemplos mais avançados, acompanhados de um tutorial, podem ser encontrados no espaço Azure Samples no GitHub:
- SPA JavaScript a chamar a API Web do Express.js
- SPA em JavaScript que chama o Microsoft Graph através de uma API Web Express.js com o fluxo on-behalf-of
- Tutorial de implementação para Serviço de Aplicações do Azure e Armazenamento do Azure
Encapsuladores de Framework
Se estiver a usar um framework como Angular ou React, poderá estar interessado em usar uma das nossas bibliotecas de wrappers:
- Angular:
@azure/msal-angular(atual: v5.1.1) - Reagir:
@azure/msal-react(atual: v5.0.6)