Como autorizar as contas de programador ao utilizar o Azure Active Directory B2C na Gestão de API do Azure

  • Artigo

APLICA-SE A: Developer | Básico | Básico v2 | Padrão | Padrão v2 | Prémio

O Azure Active Directory B2C é uma solução de gestão de identidades na cloud para aplicações móveis e Web direcionadas para o consumidor. Pode utilizá-la para gerir o acesso ao portal do programador na Gestão de API.

Neste tutorial, você aprenderá a configuração necessária em seu serviço de Gerenciamento de API para integração com o Azure Ative Directory B2C.

Para obter uma descrição geral das opções para proteger o portal do programador, veja Proteger o acesso ao portal do programador na Gestão de API.

Importante

  • Este artigo foi atualizado com etapas para configurar um aplicativo Azure AD B2C usando a Biblioteca de Autenticação da Microsoft (MSAL).
  • Se você configurou anteriormente um aplicativo do Azure AD B2C para entrada de usuário usando a Biblioteca de Autenticação do Azure AD (ADAL), recomendamos que migre para o MSAL.

Pré-requisitos

  • Um locatário B2C do Azure Ative Directory no qual criar um aplicativo. Para obter mais informações, consulte Visão geral do Azure Ative Directory B2C.
  • Uma instância de gerenciamento de API. Se você ainda não tiver uma, crie uma instância de Gerenciamento de API do Azure.

Configurar o fluxo de usuário de inscrição e entrada

Nesta seção, você criará um fluxo de usuário em seu locatário B2C do Azure Ative Directory contendo políticas de inscrição e entrada. Para obter etapas detalhadas, consulte Criar fluxos de usuário e políticas personalizadas no Azure Ative Directory B2C.

  1. No portal do Azure, acesse seu locatário do Azure Ative Directory B2C.
  2. Em Políticas, selecione Fluxos> de usuário+ Novo fluxo de usuário.
  3. Na página Criar um fluxo de usuário, selecione o fluxo de usuário Inscrever-se e entrar. Selecione a versão recomendada e, em seguida, selecione Criar.
  4. Na página Criar, forneça as seguintes informações:
    1. Insira um nome exclusivo para o fluxo de usuário.
    2. Em Provedores de identidade, selecione Inscrição por email.
    3. Em Atributos de usuário e declarações de token, selecione os seguintes atributos e declarações necessários para o portal do desenvolvedor do Gerenciamento de API.

      • Coletar atributos: Nome Próprio, Sobrenome

      • Declarações de retorno: Nome Próprio, Sobrenome, Endereços de E-mail, ObjectID do Usuário

        Captura de ecrã de atributos e declarações no portal

  5. Selecione Criar.

Configurar o provedor de identidade para o portal do desenvolvedor

  1. Em uma guia separada do portal do Azure, navegue até sua instância de Gerenciamento de API.

  2. Em Portal do desenvolvedor, selecione Identidades>+ Adicionar.

  3. Na página Adicionar provedor de identidade, selecione Azure Ative Directory B2C. Uma vez selecionado, você poderá inserir outras informações necessárias.

    • Na lista suspensa Biblioteca de clientes, selecione MSAL.
    • Para adicionar outras configurações, consulte as etapas mais adiante no artigo.

  4. Na janela Adicionar provedor de identidade, copie a URL de redirecionamento.

    Captura de ecrã do URL de redirecionamento no portal.

  5. Retorne à guia do navegador para seu locatário do Azure Ative Directory B2C no portal do Azure. Selecione Registos> na aplicação+ Novo registo.

  6. Na página Registar uma candidatura, introduza as informações de registo da sua candidatura.

    • Na seção Nome, insira um nome de aplicativo de sua escolha.
    • Na seção Tipos de conta suportados, selecione Contas em qualquer diretório organizacional (para autenticar usuários com fluxos de usuários). Para obter mais informações, consulte Registrar um aplicativo.
    • Em URI de redirecionamento, selecione Aplicativo de página única (SPA) e cole a URL de redirecionamento salva de uma etapa anterior.
    • Em Permissões, selecione Conceder consentimento de administrador para permissões openid e offline_access.
    • Selecione Registar para criar a aplicação.

    Captura de ecrã do registo de uma nova aplicação no portal.

  7. Na página Visão geral do aplicativo, localize a ID do aplicativo (cliente) e copie o valor para a área de transferência.

    Captura de ecrã da página Descrição Geral no portal.

  8. Volte para a página Gerenciamento de API Adicionar provedor de identidade e cole o ID na caixa de texto ID do cliente.

  9. Volte para o registro do aplicativo B2C. Selecione Certificados & segredos>+ Novo segredo do cliente. Captura de tela da criação de um segredo do cliente no portal.

    • Na página Adicionar um segredo do cliente, insira uma Descrição e selecione Adicionar.
    • Registre o valor em um local seguro. Este valor secreto nunca mais é apresentado depois de sair desta página.

  10. Volte para a página Gerenciamento de API Adicionar provedor de identidade e cole a chave na caixa de texto Segredo do cliente.

  11. Continuando na página Adicionar provedor de identidade:

    • Em Locatário de entrada, especifique o nome de domínio do locatário do Azure Ative Directory B2C.

    • O campo Autoridade permite controlar a URL de logon do Azure Ative Directory B2C a ser usada. Defina o valor como <your_b2c_tenant_name.b2clogin.com>.

    • Especifique a Política de Inscrição e a Política de Entrada usando o nome do fluxo de usuário criado em uma etapa anterior.

    • Opcionalmente, forneça a Política de Edição de Perfil e a Política de Redefinição de Senha.

      Captura de tela da configuração do provedor de identidade B2C do Ative Directory no portal.

  12. Depois de especificar a configuração desejada, selecione Adicionar.

  13. Republique o portal do desenvolvedor para que a configuração do Azure AD B2C entre em vigor. No menu à esquerda, em Portal do desenvolvedor, selecione Visão geral do>portal Publicar.

Depois que as alterações forem salvas, os desenvolvedores poderão criar novas contas e entrar no portal do desenvolvedor usando o Azure Ative Directory B2C.

Migrar para o MSAL

Se você configurou anteriormente um aplicativo Azure AD B2C para entrada de usuário usando a ADAL, poderá usar o portal para migrar o aplicativo para MSAL e atualizar o provedor de identidade no Gerenciamento de API.

Atualizar o aplicativo Azure AD B2C para compatibilidade com MSAL

Para conhecer as etapas para atualizar o aplicativo Azure AD B2C, consulte Alternar URIs de redirecionamento para o tipo de aplicativo de página única.

Atualizar a configuração do provedor de identidade

  1. No menu esquerdo da instância de Gerenciamento de API, em Portal do desenvolvedor, selecione Identidades.
  2. Selecione Azure Ative Directory B2C na lista.
  3. Na lista suspensa Biblioteca de clientes, selecione MSAL.
  4. Selecione Atualizar.
  5. Republique seu portal do desenvolvedor.

Portal do desenvolvedor - adicionar autenticação de conta B2C do Azure Ative Directory

Importante

Você precisa publicar novamente o portal do desenvolvedor ao criar ou atualizar as definições de configuração do Azure Ative Directory B2C para que as alterações entrem em vigor.

No portal do desenvolvedor, entrar com o Azure Ative Directory B2C é possível com o botão Entrar: widget OAuth . O widget já está incluído na página de entrada do conteúdo padrão do portal do desenvolvedor.

  1. Para entrar usando o Azure Ative Directory B2C, abra uma nova janela do navegador e vá para o portal do desenvolvedor. Selecione Iniciar sessão.

  2. Na página Entrar, selecione Azure Ative Directory B2C.

    Captura de ecrã a mostrar o início de sessão no portal do programador.

  3. Você será redirecionado para a política de inscrição configurada na seção anterior. Escolha se inscrever usando seu endereço de email no locatário B2C do Ative Directory.

Quando a inscrição estiver concluída, você será redirecionado de volta para o portal do desenvolvedor. Agora você está conectado ao portal do desenvolvedor para sua instância de serviço de Gerenciamento de API.

Login concluído no portal do desenvolvedor

Embora uma nova conta seja criada automaticamente sempre que um novo usuário entrar com o Azure Ative Directory B2C, você pode considerar adicionar o mesmo widget à página de inscrição.

O formulário de inscrição: widget OAuth representa um formulário usado para se inscrever com OAuth.

Próximos passos