Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
Locatários externos (saiba mais)
Abordagem de autenticação: Autenticação nativa inserida.
Neste início rápido, você configura um exemplo do React Next.js para autenticação nativa incorporada com Biblioteca do Microsoft Authenticator (MSAL) para JavaScript 5.29.0. O fluxo de email e senha usa um domínio personalizado do locatário verificado, com CORS (Compartilhamento de Recursos entre Origens) na borda da rede.
Importante
A API de Autenticação Nativa V2 está em prévia. A API de Autenticação Nativa V1 permanece disponível em geral. Consulte os Termos de Uso Complementares para visualizações de Microsoft Azure para termos legais que se aplicam aos recursos de visualização.
Prerequisites
- Um locatário externo e um aplicativo cliente público configurado para autenticação nativa inserida. Concluir Configurar um aplicativo.
- Um domínio personalizado verificado pelo locatário, a ID do aplicativo e o GUID do locatário do diretório.
- CORS na borda do domínio personalizado configurada para a origem do navegador do exemplo,
http://localhost:3000. Aplique o contrato de proxy compartilhado para origens, pré-vôo, cabeçalhos SDK e respostas de êxito e erro. - Uma conta de cliente com email e senha. Se a política do locatário exigir MFA (autenticação multifator), prepare um fator de email habilitado ou um fator SMS para esse percurso de exemplo.
- Node.js 20.9.0 ou posterior, npm, Git e um editor de código.
- Porta 3000 disponível para o aplicativo.
Obter o exemplo
O exemplo tem um inicializador unificado para V1 e V2. Use a revisão fixada e a versão do SDK abaixo para seguir este início rápido:
Clone o repositório, confira a revisão de exemplo e abra seu aplicativo React Next.js:
git clone https://github.com/Azure-Samples/ms-identity-ciam-native-javascript-samples cd ms-identity-ciam-native-javascript-samples git checkout --detach 49c4e250a1e6eb97e2b813e9fce6670c996a2808 cd typescript/native-auth/react-nextjs-sampleInstale a versão exata do SDK com as dependências de exemplo:
npm install --save-exact "@azure/msal-browser@5.29.0"
Configurar o aplicativo
Use https://<tenant-verified-custom-domain>/<tenant-GUID> para ambas, a autoridade de serviço e a base de transporte da API do SDK, nesta rota de borda. Mantenha os links hal absolutos opacos para essa autoridade inalterados. Não adicione um segredo do cliente à configuração do navegador.
- Abra o
src/config/auth-config.ts. - Substitua
Enter_the_Application_Id_Herepela ID do aplicativo. - Substitua o valor completo de
https://<tenant-verified-custom-domain>/<tenant-GUID>porauth.authority, substituindo seu nome de host verificado e GUID do locatário. - Adicione
auth.knownAuthoritiescomo uma matriz que contém o nome do host verificado, sem um esquema ou caminho. - Defina a cadeia de caracteres necessária
customAuth.authApiProxyUrlpara a mesma autoridade completahttps://<tenant-verified-custom-domain>/<tenant-GUID>. Inclua o GUID do locatário em ambas as configurações de URL do SDK. - Salve o arquivo de configuração. O exemplo V2 usa os escopos padrão do SDK sem declarações personalizadas. Os requisitos de MFA vêm da política do locatário, não da seleção da V2.
Execute o exemplo
Execute o aplicativo no diretório de exemplo. Essa configuração de borda de domínio personalizado não usa o proxy CORS local do exemplo:
Inicie o aplicativo:
npm run devAbra
http://localhost:3000em um navegador e selecione V2. Mantenha o processo do aplicativo em execução durante o teste.
Entrar como o cliente de teste
Use o inicializador unificado do exemplo para testar apenas os métodos habilitados para a transação atual.
- Insira o endereço de email do cliente de teste e selecione Entrar.
- Se o serviço oferecer vários métodos de primeiro fator, selecione o método de senha. Insira a senha quando solicitado e selecione Entrar.
- Se o serviço solicitar MFA, selecione um método por e-mail ou SMS e insira seu código de verificação.
- Confirme se os relatórios de exemplo concluíram o login. Não exponha tokens em capturas de tela, logs ou saída de suporte.
O login com código de uso único por email usa uma conta de cliente e um fluxo de usuário configurado para esse método. Este guia de início rápido segue o fluxo de email e senha.
Limpar a sessão
Encerre o teste local sem excluir a configuração de locatário compartilhado.
A saída do exemplo não encerra outras sessões de aplicativo ou navegador.
- Saia do exemplo e limpe a interface do usuário do aplicativo relacionada à conta.
- Interrompa o processo do aplicativo em seu terminal.