Usar os pontos de extremidade privados com o Azure Mapas (versão preliminar)

O Azure Mapas dá suporte ao Link Privado do Azure, permitindo acesso seguro aos serviços do Azure Mapas por meio de um ponto de extremidade privado em sua rede virtual. Um ponto de extremidade privado atribui um endereço IP privado de sua rede virtual ao serviço Azure Mapas, portanto, o tráfego entre seus aplicativos e o Azure Mapas permanece na rede de backbone da Microsoft em vez da Internet pública. Isso fornece segurança e isolamento de rede aprimorados. Você pode criar um ponto de extremidade privado ao criar uma conta do Azure Mapas ou adicionar uma a uma conta existente.

Benefícios dos pontos de extremidade privados para o Azure Mapas

Os pontos de extremidade privados oferecem os seguintes benefícios para contas do Azure Maps:

  • Sem exposição pública à Internet: Você pode isolar sua conta do Azure Mapas da Internet pública para reduzir a exposição a ameaças externas. Somente os clientes em sua rede privada podem acessar a conta. Isso pode ser feito bloqueando o acesso externo por meio do recurso publicNetworkAccess .
  • Comunicação VNet segura: Os recursos em sua rede virtual (como VMs e contêineres) se comunicam com o Azure Mapas usando endereços IP privados. O tráfego permanece dentro da VNet, simplificando a segurança de rede e evitando redes públicas, o que ajuda a atender aos requisitos internos de segurança e conformidade.

Observação

Todas as APIs REST do Azure Mapas (incluindo Renderização, Pesquisa, Roteamento e Clima) têm suporte total com o Link Privado, sem perda de funcionalidade. O uso do Azure Mapas com o Link Privado funciona da mesma forma que o acesso público, com segurança adicional.

Pré-requisitos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

  • Uma conta do Azure Mapas. Use uma conta do Mapas e uma rede virtual na mesma região do Azure para obter um desempenho ideal.
  • Uma Rede Virtual e Sub-rede: Uma rede virtual e uma sub-rede em sua assinatura do Azure para o ponto de extremidade privado. A sub-rede deve ter endereços IP disponíveis.
  • Permissões necessárias
    • Para criar um ponto de extremidade privado aprovado automaticamente, você precisa:
      • Colaborador do Azure Mapas na conta do Azure Mapas
      • Colaborador de rede na rede virtual
    • Para criar um ponto de extremidade privado que exija aprovação manual, somente a função Colaborador de Rede é necessária.
  • Escolha se o Azure gerencia automaticamente o DNS para o ponto de extremidade privado usando o DNS Privado do Azure ou gerencia o DNS manualmente. Na maioria dos casos, o DNS Privado do Azure fornece a configuração mais simples.

Configurar um endpoint privado para o Azure Maps

Para habilitar a conectividade privada para uma conta do Azure Mapas, crie um ponto de extremidade privado e configure o DNS para rotear o tráfego por meio de sua rede virtual.

1. Criar o endpoint privado (Portal ou CLI)

No portal do Azure, vá para Criar um recurso e pesquise por ponto de extremidade privado. Você também pode criar um ponto de extremidade privado na seção Rede do recurso do Azure Mapas. Selecione Criar para abrir o assistente.

  • Básico: Selecione a assinatura e o grupo de recursos adequados para o recurso de ponto de extremidade e escolha um Nome e Região (use a mesma região que sua VNet).
  • Recurso: Para o método Connection, escolha Conectar a um recurso do Azure em meu diretório. Em seguida, defina:
    • Tipo de recurso = Microsoft.Maps/accounts. Isso informa ao Azure que você deseja um link privado para uma conta do Azure Mapas.
    • Recurso = O nome da conta do Azure Maps. Escolher a conta específica do Azure Mapas
    • Sub-recurso de destino = mapsAccount. O Azure Mapas tem um único sub-recurso de link privado que representa o plano de dados da conta.
  • Configuração: Selecione a Rede Virtual e a Sub-rede em que o ponto de extremidade privado é colocado. Verifique se a sub-rede tem espaço para um IP. Deixe a integração DNS privada habilitada, a menos que você planeje configurar o DNS manualmente. Com a integração de DNS ativada, o Azure cria uma zona DNS privada para privatelink.account.maps.azure.com e adiciona automaticamente o registro DNS necessário.

Após a criação, acesse sua conta do Azure Mapas no portal e acesse Rede > Conexões de ponto de extremidade privado. Você deve ver uma nova conexão listada. Se o criador do ponto de extremidade privado possui ou tem as permissões adequadas na conta do Azure Mapas, a conexão normalmente é aprovada automaticamente (o status mostra "Aprovado"). Se ele mostrar "Pendente", a aprovação manual poderá ser necessária. Após a aprovação, o link privado é estabelecido.

Exemplo – Usando a CLI do Azure

O seguinte comando da CLI do Azure cria um ponto de extremidade privado para uma conta do Azure Mapas, equivalente às etapas do portal acima:

az network private-endpoint create \
  --name <MyPrivateEndpointName> \
  --resource-group <MyResourceGroup> \
  --vnet-name <MyVNetName> \
  --subnet <MySubnetName> \
  --private-connection-resource-id "/subscriptions/<SubscriptionID>/resourceGroups/<MyResourceGroup>/providers/Microsoft.Maps/accounts/<MyMapsAccountName>" \
  --group-id mapsAccount \
  --connection-name <MyConnectionName>

Este comando especifica a ID do recurso da conta do Maps e o mapsAccount sub-recurso, juntamente com a rede virtual e a sub-rede usadas para o ponto de extremidade privado.

2. Configurar o DNS para o ponto de extremidade privado

Se você habilitou a integração de DNS privado ao criar o ponto de extremidade privado (o padrão), o Azure criará automaticamente uma zona DNS privada para privatelink.account.maps.azure.com sua assinatura e a vinculará à sua rede virtual.

Dentro dessa zona, um registro DNS mapeia o ID exclusivo e a região da sua conta do Azure Mapas para o endereço IP privado do ponto de extremidade. Por exemplo, se o ID do cliente da sua conta do Maps for abc123 e a região for East US, o registro DNS resolverá esse nome de host para o endereço IP do ponto de extremidade privado:

  • Nome do registro:abc123.eastus.account.maps.azure.com
  • Valor do registro:10.x.y.z - O endereço IP privado atribuído ao ponto de extremidade.

Clientes dentro da rede virtual resolvem o nome do host para um endereço IP privado, permitindo a conectividade privada; enquanto clientes fora da rede resolvem o mesmo nome do host para o endpoint público do Azure Maps. Essa abordagem de DNS de horizonte dividido permite que você use uma única URL de ponto de extremidade dentro e fora da rede virtual.

Se você não usar a integração automática de DNS, configure o DNS manualmente para que o nome de host da conta do Azure Mapas
(<maps-account-client-id>.<location>.account.maps.azure.com) seja resolvido para o endereço IP do ponto de extremidade privado dentro da sua rede. Para obter mais informações, consulte a documentação do DNS do Ponto de Extremidade Privado do Azure.

3. Use o ponto de extremidade privado em seus aplicativos

Para usar o ponto de extremidade privado, configure seus aplicativos para chamar o ponto de extremidade específico da conta do Azure Mapas. Você pode encontrar esse ponto de extremidade nas páginas visão geral ou autenticação da conta do Azure Mapas ou no recurso de ponto de extremidade privado na configuração de DNS (FQDNs visíveis para o cliente).

Uma captura de tela mostrando um menu da barra lateral do portal do Azure para um recurso de ponto de extremidade privado, destacando a opção de configuração de DNS em Configurações. O menu inclui opções como Visão Geral, Log de atividades, IAM de controle de acesso, Tags, Diagnosticar e Resolver Problemas, Visualizador de Recursos, Grupos de Segurança do Aplicativo, Configuração de DNS e Propriedades.

O padrão de acesso é:

https://{maps-account-client-id}.{location}.account.maps.azure.com

Importante

Se o aplicativo continuar a usar o ponto de extremidade padrão do Azure Mapas (como atlas.microsoft.com), as solicitações não serão roteadas por meio do ponto de extremidade privado. Os SDKs do Azure Mapas oferecem suporte à substituição do ponto de extremidade padrão; portanto, configure seu SDK ou código de conexão para usar o nome de host específico da sua conta do Azure Mapas. Quando configuradas, as solicitações de dentro da rede são roteadas automaticamente por meio do Link Privado.

4. [Opcional] Desabilitar o acesso à rede pública

Mesmo depois de criar um ponto de extremidade privado, os pontos de extremidade públicos da sua conta do Azure Mapas permanecem ativos por padrão. Isso permite que os aplicativos existentes fora da rede virtual continuem funcionando até que você os restrinja intencionalmente. Se você precisar de acesso privado exclusivo, desabilite o acesso à rede pública para a conta mapas.

No portal do Azure, abra sua conta dos Mapas e vá para Rede. Defina o acesso público para desabilitar e salvar. Após a conclusão, o Azure Mapas rejeita qualquer tentativa de conexão pelo ponto de extremidade público. Isso adiciona uma camada extra de proteção: mesmo que alguém tenha sua chave de autenticação do Mapas ou token SAS, ela não poderá usá-la da Internet quando o acesso público estiver desativado.

Você também pode desabilitar o acesso público por meio de modelos do ARM ou da CLI do Azure definindo a propriedade publicNetworkAccess como Disabled.

Depois de desabilitar o acesso à rede pública, valide a conectividade de cada aplicativo. Os pontos de extremidade públicos (por exemplo, atlas.microsoft.com) são bloqueados por design, portanto, atualize todas as configurações de aplicativo e SDK para usar o ponto de extremidade DNS privado.

Outras considerações

  • Resolução DNS: Se você não conseguir se conectar ao Azure Mapas por meio do ponto de extremidade privado, verifique sua configuração de DNS, pois os problemas de DNS são uma causa comum de problemas de conectividade.
  • Várias redes: Você pode criar vários pontos de extremidade privados para uma única conta do Azure Mapas para se conectar de diferentes redes virtuais. Cada ponto de extremidade privado usa um endereço IP da sub-rede selecionada.

O uso do Link Privado do Azure com o Azure Mapas mantém todo o tráfego de aplicativos em redes privadas. Isso melhora a segurança e dá suporte a políticas de rede corporativas, mantendo a funcionalidade completa do Azure Mapas. O Azure Mapas é acessado por meio de endereços IP privados e DNS, garantindo que o tráfego permaneça dentro do limite de rede controlado.

Pergunte ao Copilot