Configurar a autenticação em um aplicativo de página única Angular de exemplo usando o Azure Ative Directory B2C

Este artigo usa um exemplo de aplicativo de página única (SPA) Angular para ilustrar como adicionar a autenticação do Azure Ative Directory B2C (Azure AD B2C) aos seus aplicativos Angular.

Visão geral

O OpenID Connect (OIDC) é um protocolo de autenticação baseado no OAuth 2.0 que pode utilizar para iniciar de forma segura a sessão de um utilizador numa aplicação. Este exemplo Angular usa o MSAL Angular e o MSAL Browser. O MSAL é uma biblioteca fornecida pela Microsoft que simplifica a adição de suporte de autenticação e autorização a SPAs Angulares.

Fluxo de login

O fluxo de entrada envolve as seguintes etapas:

1. O usuário abre o aplicativo e seleciona Entrar.
2. O aplicativo inicia uma solicitação de autenticação e redireciona o usuário para o Azure AD B2C.
3. O utilizador regista-se ou inicia sessão erepõe a palavra-passe ou inicia sessão com uma conta social.
4. Após a entrada bem-sucedida, o Azure AD B2C retorna um código de autorização para o aplicativo. O aplicativo executa as seguintes ações:
   1. Troca o código de autorização por um token de ID, token de acesso e token de atualização.
   2. Lê as declarações do token de identificação.
   3. Armazena o token de acesso e o token de atualização em um cache na memória para uso posterior. O token de acesso permite que o usuário chame recursos protegidos, como uma API da Web. O token de atualização é usado para adquirir um novo token de acesso.

Registo na aplicação

Para permitir que seu aplicativo entre com o Azure AD B2C e chame uma API Web, você deve registrar dois aplicativos em seu locatário do Azure AD B2C:

• O registo de aplicação de página única (Angular) permite que a sua aplicação entre com o Azure AD B2C. Durante o registro do aplicativo, você especifica o URI de redirecionamento. O URI de redirecionamento é o ponto de extremidade para o qual o usuário é redirecionado depois de se autenticar com o Azure AD B2C. O processo de registro do aplicativo gera uma ID do aplicativo, também conhecida como ID do cliente, que identifica exclusivamente seu aplicativo. Este artigo usa o exemplo ID do aplicativo: 1.

• O registro da API da Web permite que seu aplicativo chame uma API da Web protegida. O registro expõe as permissões da API da Web (escopos). O processo de registro do aplicativo gera uma ID de aplicativo que identifica exclusivamente sua API da Web. Este artigo usa o exemplo ID do aplicativo: 2. Conceda ao seu aplicativo (ID do aplicativo: 1) permissões para os escopos da API da Web (ID do aplicativo: 2).

O diagrama a seguir descreve os registros do aplicativo e a arquitetura do aplicativo.

Chamada para uma API da Web

Depois que a autenticação é concluída, os usuários interagem com o aplicativo, que invoca uma API da Web protegida. A API da Web usa autenticação por token portador. O token de portador é o token de acesso que o aplicativo obteve do Azure AD B2C. O aplicativo passa o token no cabeçalho de autorização da solicitação HTTPS.

Authorization: Bearer <access token>

Se o escopo do token de acesso não corresponder aos escopos da API da Web, a biblioteca de autenticação obterá um novo token de acesso com os escopos corretos.

Fluxo de saída

O fluxo de saída envolve as seguintes etapas:

1. Os utilizadores terminam sessão na aplicação.
2. O aplicativo limpa seus objetos de sessão e a biblioteca de autenticação limpa seu cache de token.
3. A aplicação leva os utilizadores ao endpoint de terminação do Azure AD B2C para encerrar a sessão do Azure AD B2C.
4. Os usuários são redirecionados de volta para o aplicativo.

Pré-requisitos

Antes de seguir os procedimentos neste artigo, certifique-se de que o computador está em execução:

• Visual Studio Code ou qualquer outro editor de código.
• Node.js tempo de execução e npm.
• CLI angular.

Etapa 1: Configurar o fluxo de usuários

Quando os utilizadores tentam entrar na sua aplicação, a aplicação inicia uma solicitação de autenticação para o ponto de extremidade de autorização por meio de um fluxo de utilizador. O fluxo do usuário define e controla a experiência do usuário. Depois que os usuários concluem o fluxo de usuários, o Azure AD B2C gera um token e, em seguida, redireciona os usuários de volta para seu aplicativo.

Se ainda não tiver feito isso, crie um fluxo de usuário ou uma política personalizada. Repita as etapas para criar três fluxos de usuário separados da seguinte maneira:

• Um fluxo de usuário combinado de login e inscrição , como susi. Esse fluxo de usuário também suporta a experiência Esqueceu sua senha .
• Um fluxo de edição de perfil do utilizador, como .
• Um fluxo de redefinição de senha de utilizador, como reset_password.

Azure AD B2C adiciona B2C_1_ no início do nome do fluxo de utilizador. Por exemplo, susi passa a B2C_1_susi.

Passo 2: Registe o seu SPA e API Angular

Nesta etapa, você cria os registros para o SPA Angular e o aplicativo API Web. Você também especifica os escopos de sua API da Web.

2.1 Registrar o aplicativo API da Web

Para criar o registro do aplicativo de API da Web (ID do aplicativo: 2), siga estas etapas:

1. Inicie sessão no portal Azure.

2. Verifique se você está usando o diretório que contém seu locatário do Azure AD B2C. Selecione o ícone Diretórios + assinaturas na barra de ferramentas do portal.

3. Nas configurações do Portal | Página Diretórios + assinaturas , localize seu diretório do Azure AD B2C na lista Nome do diretório e selecione Alternar.

4. No portal do Azure, procure e selecione Azure AD B2C.

5. Selecione Registos de aplicaçõese, em seguida, selecione Novo registo.

6. Em Name, insira um nome para o aplicativo (por exemplo, my-api1). Deixe os valores padrão para URI de redirecionamento e tipos de conta suportados.

7. Selecione Register.

8. Depois que o registro do aplicativo for concluído, selecione Visão geral.

9. Registre o valor da ID do aplicativo (cliente) para uso posterior ao configurar o aplicativo Web.

   

2.2 Configurar escopos

1. Selecione o aplicativo my-api1 que você criou (ID do aplicativo: 2) para abrir a página Visão geral.

2. Em Gerenciar, selecione Expor uma API.

3. Ao lado de URI do ID da Aplicação, selecione o link Definir. Substitua o valor padrão (GUID) por um nome exclusivo (por exemplo, tasks-api) e selecione Salvar.

   Quando seu aplicativo Web solicita um token de acesso para a API da Web, ele deve adicionar esse URI como o prefixo para cada escopo que você define para a API.

4. Em Escopos definidos por esta API, selecione Adicionar um escopo.

5. Para criar um escopo que define o acesso de leitura à API:

   1. Em Nome do escopo, insira tasks.read.
   2. Para Nome de exibição do consentimento do administrador, insira Acesso de leitura à API de tarefas.
   3. Para Descrição do consentimento do administrador, insira Permite acesso de leitura à API de tarefas.

6. Selecione Adicionar escopo.

7. Selecione Adicionar um escopo e adicione um escopo que define o acesso de escrita à API:

   1. Em Nome do escopo, insira tasks.write.
   2. Para Nome de exibição do consentimento do administrador, digite Acesso de gravação à API de Tarefas.
   3. Para Descrição do consentimento do administrador, insira Permite permissão de escrita na API de tarefas.

8. Selecione Adicionar escopo.

2.3 Registar a aplicação Angular

Siga estas etapas para criar o registro do aplicativo Angular:

1. Inicie sessão no portal Azure.
2. Se tiver acesso a vários inquilinos, selecione o ícone Definições no menu superior para mudar para o inquilino do Azure AD B2C no menu Diretórios + subscrições.
3. No portal do Azure, procure e selecione Azure AD B2C.
4. Selecione Registos de aplicaçõese, em seguida, selecione Novo registo.
5. Em Nome, insira um nome para o aplicativo. Por exemplo, digite MyApp.
6. Em Tipos de conta suportados, selecione Contas em qualquer provedor de identidade ou diretório organizacional (para autenticar usuários com fluxos de usuários).
7. Em Redirecionar URI, selecione Aplicativo de página única (SPA) e digite http://localhost:4200 na caixa URL.
8. Em Permissões, marque a caixa de seleção Conceder consentimento de administrador para permissões de acesso openid e offline.
9. Selecione Register.
10. Registre o valor da ID do aplicativo (cliente) para uso em uma etapa posterior ao configurar o aplicativo Web.

2.5 Conceder permissões

Para conceder permissões ao seu aplicativo (ID do aplicativo: 1), siga estas etapas:

1. Selecione Registos de aplicações e, em seguida, selecione a aplicação que criou (ID da aplicação: 1).

2. Em Gerenciar, selecione permissões de API.

3. Em Permissões configuradas, selecione Adicionar uma permissão.

4. Selecione o separador Minhas APIs.

5. Selecione a API (ID do aplicativo: 2) à qual o aplicativo Web deve ter acesso. Por exemplo, digite my-api1.

6. Em Permissão, expanda tarefas e selecione os escopos definidos anteriormente (por exemplo, tasks.read e tasks.write).

7. Selecione Adicionar permissões.

8. Selecione Conceder consentimento de administrador para <o nome> do seu inquilino.

9. Selecione Sim.

10. Selecione Atualizar e verifique se Concedido para ... aparece em Estado para ambos os escopos.

11. Na lista Permissões configuradas, selecione seu escopo e copie o nome completo do escopo.

    

Etapa 3: Obter o código de exemplo Angular

Este exemplo demonstra como um aplicativo de página única Angular pode usar o Azure AD B2C para inscrição e entrada de usuários. Em seguida, o aplicativo adquire um token de acesso e chama uma API da Web protegida.

Baixe um arquivo .zip do exemplo ou clone o exemplo do repositório GitHub usando o seguinte comando:

git clone https://github.com/Azure-Samples/ms-identity-javascript-angular-tutorial.git

3.1 Configurar o exemplo Angular

Agora que você obteve o exemplo de SPA, atualize o código com seus valores de API Web e B2C do Azure AD. Na pasta de exemplo, na pasta src/app , abra o arquivo auth-config.ts . Atualize as chaves com os valores correspondentes:

Seu código src/app/auth-config.ts resultante deve ser semelhante ao exemplo a seguir:

export const b2cPolicies = {
     names: {
         signUpSignIn: "b2c_1_susi_reset_v2",
         editProfile: "b2c_1_edit_profile_v2"
     },
     authorities: {
         signUpSignIn: {
             authority: "https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/b2c_1_susi_reset_v2",
         },
         editProfile: {
             authority: "https://your-tenant-name.b2clogin.com/your-tenant-name.onmicrosoft.com/b2c_1_edit_profile_v2"
         }
     },
     authorityDomain: "your-tenant-name.b2clogin.com"
 };
 
 
export const msalConfig: Configuration = {
     auth: {
         clientId: '<your-MyApp-application-ID>',
         authority: b2cPolicies.authorities.signUpSignIn.authority,
         knownAuthorities: [b2cPolicies.authorityDomain],
         redirectUri: '/', 
     },
    // More configuration here
 }

export const protectedResources = {
  todoListApi: {
    endpoint: "http://localhost:5000/api/todolist",
    scopes: ["https://your-tenant-namee.onmicrosoft.com/api/tasks.read"],
  },
}

Etapa 4: Obter o código de exemplo da API da Web

Agora que a API Web está registrada e você definiu seus escopos, configure o código da API Web para trabalhar com seu locatário do Azure AD B2C.

Baixe um arquivo *.zip ou clone o projeto de API da Web de exemplo do GitHub. Você também pode navegar diretamente para o projeto Azure-Samples/active-directory-b2c-javascript-nodejs-webapi no GitHub usando o seguinte comando:

git clone https://github.com/Azure-Samples/active-directory-b2c-javascript-nodejs-webapi.git

4.1 Configurar a API da Web

Na pasta de exemplo, abra o arquivo config.json . Este arquivo contém informações sobre seu provedor de identidade do Azure AD B2C. A aplicação de API web utiliza estas informações para validar o token de acesso que a aplicação web passa como um token portador. Atualize as seguintes propriedades das configurações do aplicativo:

O seu ficheiro de configuração final deve ser semelhante ao seguinte JSON:

{
    "credentials": {
        "tenantName": "<your-tenant-name>",
        "clientID": "<your-webapi-application-ID>",
        "issuer": "https://<your-tenant-name>.b2clogin.com/<your-tenant-ID>/v2.0/"
    },
    "policies": {
        "policyName": "b2c_1_susi"
    },
    "resource": {
        "scope": ["tasks.read"] 
    },
    // More settings here
} 

Etapa 5: Executar o SPA Angular e a API da Web

Agora você está pronto para testar o acesso com escopo do Angular à API. Nesta etapa, execute a API da Web e o aplicativo Angular de exemplo em sua máquina local. Em seguida, entre no aplicativo Angular e selecione o botão TodoList para iniciar uma solicitação para a API protegida.

Executar a API da Web

1. Abra uma janela do console e mude para o diretório que contém o exemplo de API da Web. Por exemplo:

   cd active-directory-b2c-javascript-nodejs-webapi
   

2. Execute os seguintes comandos:

   npm install && npm update
   node index.js
   

   A janela do console exibe o número da porta onde o aplicativo está hospedado:

   Listening on port 5000...
   

Execute o aplicativo Angular

1. Abra outra janela do console e mude para o diretório que contém o exemplo Angular. Por exemplo:

   cd ms-identity-javascript-angular-tutorial-main/3-Authorization-II/2-call-api-b2c/SPA
   

2. Execute os seguintes comandos:

   npm install && npm update
   npm start
   

   A janela do console exibe o número da porta de onde o aplicativo está hospedado:

   Listening on port 4200...
   

3. Aceda a http://localhost:4200 no seu browser para ver a aplicação.

4. Selecione Login.

   

5. Conclua o processo de inscrição ou login.

6. Após o início de sessão bem-sucedido, deverá ver o seu perfil. No menu, selecione TodoList.

   

7. Selecione Adicionar para adicionar novos itens à lista ou use os ícones para excluir ou editar itens.

   

Implementar a sua aplicação

Em um aplicativo de produção, o URI de redirecionamento para o registro do aplicativo geralmente é um ponto de extremidade acessível publicamente onde seu aplicativo está sendo executado, como https://contoso.com.

Você pode adicionar e modificar URIs de redirecionamento em seus aplicativos registrados a qualquer momento. As seguintes restrições se aplicam aos URIs de redirecionamento:

• O URL de resposta deve começar com o esquema https.
• O URL de resposta diferencia maiúsculas de minúsculas. Seu caso deve corresponder ao caso do caminho da URL do seu aplicativo em execução.

Conteúdo relacionado

• Saiba mais sobre o exemplo de código
• Habilite a autenticação em seu próprio aplicativo Angular
• Configurar opções de autenticação em seu aplicativo Angular
• Habilite a autenticação em sua própria API da Web