Proteja um aplicativo de página única com login do usuário

O guia a seguir refere-se a um aplicativo hospedado em um servidor de conteúdo ou com dependências mínimas de servidor Web. O aplicativo fornece recursos protegidos protegidos apenas para usuários do Microsoft Entra. O objetivo do cenário é permitir que o aplicativo Web se autentique na ID do Microsoft Entra e chame as APIs REST do Azure Maps em nome do usuário.

Para exibir os detalhes de autenticação da sua conta do Azure Maps no portal do Azure:

1. Inicie sessão no portal do Azure.

2. Navegue até o menu do portal do Azure. Selecione Todos os recursos e, em seguida, selecione a sua conta do Azure Maps.

3. Em Configurações no painel esquerdo, selecione Autenticação.

   

Três valores são criados quando a conta do Azure Maps é criada. Eles são usados para dar suporte a dois tipos de autenticação no Azure Maps:

• Autenticação do Microsoft Entra: O Client ID representa a conta que deve ser usada para solicitações de API REST. O Client ID valor deve ser armazenado na configuração do aplicativo e, em seguida, deve ser recuperado antes de fazer solicitações HTTP do Azure Maps que usam a autenticação do Microsoft Entra.
• Autenticação de Chave Compartilhada: Os Primary Key e Secondary Key são usados como a chave de assinatura para autenticação de Chave Compartilhada. A autenticação de Chave Partilhada depende da passagem da chave gerada pela conta do Azure Maps com cada pedido para o Azure Maps. Recomendamos que regenere regularmente as suas chaves. Para manter as conexões atuais durante a regeneração, duas chaves são fornecidas. Uma chave pode estar em uso, enquanto regenera a outra. Quando volta a gerar as suas chaves, tem de atualizar todas as aplicações que acedam a esta conta no sentido de utilizar as novas chaves. Para obter mais informações, consulte Autenticação com o Azure Maps

Criar um registro de aplicativo no Microsoft Entra ID

Crie o aplicativo Web no Microsoft Entra ID para que os usuários entrem. O aplicativo Web delega o acesso do usuário às APIs REST do Azure Maps.

1. No portal do Azure, na lista de serviços do Azure, selecione Registros>do aplicativo Microsoft Entra ID>Novo registro.

   

2. Insira um Nome, escolha um tipo de conta de suporte, forneça um URI de redirecionamento que represente a url na qual o ID do Microsoft Entra emite o token e é a url onde o controle de mapa está hospedado. Para obter um exemplo detalhado, consulte Exemplos de ID do Microsoft Entra do Azure Maps. Em seguida, selecione Registar.

3. Para atribuir permissões de API delegadas ao Azure Maps, vá para o aplicativo. Em seguida, em Registros de aplicativos, selecione Permissões>de API Adicionar uma permissão. Em APIs que minha organização usa, pesquise e selecione Azure Maps.

   

4. Marque a caixa de seleção ao lado de Acessar o Azure Maps e selecione Adicionar permissões.

   

5. Ative oauth2AllowImplicitFlow. Para habilitá-lo, na seção Manifesto do registro do seu aplicativo, defina oauth2AllowImplicitFlow como true.

6. Copie a ID do aplicativo Microsoft Entra e a ID do locatário do Microsoft Entra do registro do aplicativo para usar no SDK da Web. Adicione os detalhes de registro do aplicativo Microsoft Entra e a x-ms-client-id conta do Mapa do Azure ao SDK da Web.

       <link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.css" type="text/css" />
       <script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.js" />
       <script>
           var map = new atlas.Map("map", {
               center: [-122.33, 47.64],
               zoom: 12,
               language: "en-US",
               authOptions: {
                   authType: "aad",
                   clientId: "<insert>",  // azure map account client id
                   aadAppId: "<insert>",  // azure ad app registration id
                   aadTenant: "<insert>", // azure ad tenant id
                   aadInstance: "https://login.microsoftonline.com/"
               }
           });
       </script>   
   

7. Configure o controle de acesso baseado em função do Azure (Azure RBAC) para usuários ou grupos. Consulte as seções a seguir para habilitar o Azure RBAC.

Conceder acesso baseado em função para usuários ao Azure Maps

Você pode conceder o controle de acesso baseado em função do Azure (Azure RBAC) atribuindo um grupo ou entidade de segurança do Microsoft Entra a uma ou mais definições de função do Azure Maps.

Para exibir as definições de função do Azure disponíveis para o Azure Maps, consulte Exibir definições de função internas do Azure Maps.

Para obter etapas detalhadas sobre como atribuir uma função disponível do Azure Maps à identidade gerenciada criada ou à entidade de serviço, consulte Atribuir funções do Azure usando o portal do Azure

Para gerenciar com eficiência o aplicativo Azure Maps e o acesso a recursos de uma grande quantidade de usuários, consulte Grupos do Microsoft Entra.

Importante

Para que os usuários tenham permissão para se autenticar em um aplicativo, os usuários devem primeiro ser criados no Microsoft Entra ID. Para mais informações, consulte Adicionar ou eliminar utilizadores com o Microsoft Entra ID.

Para saber mais sobre como gerenciar efetivamente um diretório grande para usuários, consulte ID do Microsoft Entra.

Aviso

As definições de função internas do Azure Maps fornecem um acesso de autorização muito grande a muitas APIs REST do Azure Maps. Para restringir o acesso às APIs ao mínimo, consulte Criar uma definição de função personalizada e atribuir a identidade atribuída pelo sistema à definição de função personalizada. Isso permite o menor privilégio necessário para o aplicativo acessar o Azure Maps.

Próximos passos

Compreensão adicional do cenário de aplicativo de página única:

Aplicação de página única

Encontre as métricas de uso da API para sua conta do Azure Maps:

Ver métricas de utilização

Explore exemplos que mostram como integrar o Microsoft Entra ID com o Azure Maps:

Exemplos do Azure Maps