Integrar o Key Vault ao Link Privado do Azure

O Serviço de Link Privado do Azure permite acessar os Serviços do Azure (por exemplo, o Azure Key Vault, o Armazenamento do Azure e o Azure Cosmos DB) e serviços de parceiros/clientes hospedados no Azure em um Ponto de Extremidade Privado em sua rede virtual.

Um Ponto de Extremidade Privado do Azure é um adaptador de rede que conecta você de maneira privada e segura a um serviço com tecnologia do Link Privado do Azure. O ponto de extremidade privado usa um endereço IP privado de sua VNet, colocando efetivamente em sua VNet. Todo o tráfego para o serviço pode ser roteado por meio do ponto de extremidade privado; assim, nenhum gateway, nenhum dispositivo NAT, nenhuma conexão ExpressRoute ou VPN e nenhum endereço IP público é necessário. O tráfego entre a rede virtual e o serviço percorre a rede de backbone da Microsoft, eliminando a exposição da Internet pública. Você pode se conectar a uma instância de um recurso do Azure, fornecendo o nível mais alto de granularidade no controle de acesso.

Para obter mais informações, confira O que é o Link Privado do Azure?

Pré-requisitos

Para integrar um cofre de chaves ao Link Privado do Azure, você precisará:

• Um cofre de chaves.
• Uma rede virtual do Azure.
• Uma sub-rede na rede virtual.
• Permissões de proprietário ou colaborador para o cofre de chaves e a rede virtual.

Seu ponto de extremidade privado e a rede virtual devem estar na mesma região. Quando você selecionar uma região para o ponto de extremidade privado usando o portal, ele filtrará automaticamente apenas as redes virtuais que estiverem nessa região. Seu cofre de chaves pode estar em uma região diferente.

Seu ponto de extremidade privado usa um endereço IP privado em sua rede virtual.

Azure portal

Estabelecer uma conexão de link privado com o Key Vault usando o portal do Azure

Primeiro, crie uma rede virtual seguindo as etapas em Criar uma rede virtual usando o portal do Azure

Você pode criar um cofre de chaves ou estabelecer uma conexão de link privado com um cofre de chaves existente.

Criar um cofre de chaves e estabelecer uma conexão de link privado

É possível criar um cofre de chaves com o portal do Azure, a CLI do Azure ou o Azure PowerShell.

Após configurar os conceitos básicos do cofre de chaves, selecione a guia Rede e siga estas etapas:

1. Desabilite o acesso público desativando o botão de opção.

2. Selecione o botão "+ Criar um ponto de extremidade privado" para adicionar um ponto de extremidade privado.

   

3. No campo “Localização” da Folha do Ponto de Extremidade Privado, selecione a região na qual sua rede virtual está localizada.

4. No campo “Nome”, crie um nome descritivo que permitirá identificar esse ponto de extremidade privado.

5. Selecione a rede virtual e a sub-rede na qual você deseja que esse ponto de extremidade privado seja criado no menu suspenso.

6. Deixe a opção "integrar-se ao DNS de zona privada" inalterada.

7. Selecione "Ok".

   

Agora, você poderá ver o ponto de extremidade privado configurado. Você pode excluir e editar esse ponto de extremidade privado. Selecione o botão “Examinar + Criar” e crie o cofre de chaves. Levará entre 5 e 10 minutos para a implantação ser concluída.

Estabelecer uma conexão de link privado com o cofre de chaves existente

Se você já tem um cofre de chaves, pode criar uma conexão de link privado seguindo estas etapas:

1. Entre no portal do Azure.

2. Na barra de pesquisa, digite “cofres de chaves”.

3. Selecione o cofre de chaves na lista à qual você deseja adicionar um ponto de extremidade privado.

4. Selecione a guia "Rede" em Configurações.

5. Selecione a guia "Conexões de ponto de extremidade privado", na parte superior da página.

6. Clique no botão "+ Criar" na parte superior da página.

   

7. Em "Detalhes do projeto", selecione o Grupo de Recursos que contém a rede virtual que você criou como um pré-requisito para este tutorial. Em "Detalhes da instância", insira "myPrivateEndpoint" como o Nome e selecione o mesmo local que a rede virtual que você criou como um pré-requisito para este tutorial.

   Você pode optar por criar um ponto de extremidade privado para qualquer recurso do Azure ao usar esta folha. Você pode usar os menus suspensos para selecionar um tipo de recurso e selecionar um recurso em seu diretório ou pode se conectar a qualquer recurso do Azure usando uma ID do recurso. Deixe a opção "integrar-se ao DNS de zona privada" inalterada.

8. Avance para a folha "Recursos". Para "Tipo de recurso", selecione "Microsoft.KeyVault/vaults"; para "Recurso", selecione o cofre de chaves que você criou como um pré-requisito para este tutorial. "Sub-recurso de destino" será preenchido automaticamente com "cofre".

9. Avance para "Rede Virtual". Selecione a rede virtual e a sub-rede que você criou como um pré-requisito para este tutorial.

10. Avance pelas folhas "DNS" e "Marcas", aceitando os padrões.

11. Na página "Examinar + Criar", selecione "Criar".

Quando você cria um ponto de extremidade privado, a conexão deve ser aprovada. Se o recurso para o qual você está criando um ponto de extremidade privado estiver em seu diretório, você poderá aprovar a solicitação de conexão desde que tenha permissões suficientes; se você estiver se conectando a um recurso do Azure em outro diretório, deverá aguardar até que o proprietário desse recurso aprove sua solicitação de conexão.

Há quatro estados de provisionamento:

Ação de serviço	Estado de ponto de extremidade privado do consumidor do serviço	Descrição
Nenhum	Pendente	A conexão é criada manualmente e está pendente de aprovação do proprietário do recurso do Link Privado.
Aprovar	Aprovado	A conexão foi aprovada automaticamente ou manualmente e está pronta para ser usada.
Rejeitar	Rejeitado	A conexão foi rejeitada pelo proprietário do recurso do link privado.
Remover	Desconectado	A conexão foi removida pelo proprietário do recurso do link privado, o ponto de extremidade privado se torna informativo e deve ser excluído para limpeza.

Como gerenciar uma conexão de ponto de extremidade privado com o Key Vault usando o portal do Azure

1. Faça logon no Portal do Azure.

2. Na barra de pesquisa, digite “cofres de chaves”

3. Selecione o cofre de chaves que você deseja gerenciar.

4. Selecione a guia “Rede”.

5. Se existirem conexões pendentes, você verá uma conexão listada com "Pendente" no estado de provisionamento.

6. Selecione o ponto de extremidade privado que você deseja aprovar

7. Selecione o botão aprovar.

8. Se houver conexões de ponto de extremidade privado que você deseja rejeitar, seja uma solicitação pendente ou uma conexão existente, selecione a conexão e selecione o botão "Rejeitar".

   

CLI do Azure

Estabelecer uma conexão de link privado com o Key Vault usando a CLI (Configuração Inicial)

az login                                                         # Login to Azure CLI
az account set --subscription {SUBSCRIPTION ID}                  # Select your Azure Subscription
az group create -n {RESOURCE GROUP} -l {REGION}                  # Create a new Resource Group
az provider register -n Microsoft.KeyVault                       # Register KeyVault as a provider
az keyvault create -n {VAULT NAME} -g {RG} -l {REGION}           # Create a Key Vault
az keyvault update -n {VAULT NAME} -g {RG} --default-action deny # Turn on Key Vault Firewall
az network vnet create -g {RG} -n {vNet NAME} -location {REGION} # Create a Virtual Network

    # Create a Subnet
az network vnet subnet create -g {RG} --vnet-name {vNet NAME} --name {subnet NAME} --address-prefixes {addressPrefix}

    # Disable Virtual Network Policies
az network vnet subnet update --name {subnet NAME} --resource-group {RG} --vnet-name {vNet NAME} --disable-private-endpoint-network-policies true

    # Create a Private DNS Zone
az network private-dns zone create --resource-group {RG} --name privatelink.vaultcore.azure.net

    # Link the Private DNS Zone to the Virtual Network
az network private-dns link vnet create --resource-group {RG} --virtual-network {vNet NAME} --zone-name privatelink.vaultcore.azure.net --name {dnsZoneLinkName} --registration-enabled true

Criar um Ponto de Extremidade Privado (Aprovar Automaticamente)

az network private-endpoint create --resource-group {RG} --vnet-name {vNet NAME} --subnet {subnet NAME} --name {Private Endpoint Name}  --private-connection-resource-id "/subscriptions/{AZURE SUBSCRIPTION ID}/resourceGroups/{RG}/providers/Microsoft.KeyVault/vaults/{KEY VAULT NAME}" --group-ids vault --connection-name {Private Link Connection Name} --location {AZURE REGION}

Criar um Ponto de Extremidade Privado (Solicitar Aprovação Manualmente)

az network private-endpoint create --resource-group {RG} --vnet-name {vNet NAME} --subnet {subnet NAME} --name {Private Endpoint Name}  --private-connection-resource-id "/subscriptions/{AZURE SUBSCRIPTION ID}/resourceGroups/{RG}/providers/Microsoft.KeyVault/vaults/{KEY VAULT NAME}" --group-ids vault --connection-name {Private Link Connection Name} --location {AZURE REGION} --manual-request

Gerenciar conexões do Link Privado

# Show Connection Status
az network private-endpoint show --resource-group {RG} --name {Private Endpoint Name}

# Approve a Private Link Connection Request
az keyvault private-endpoint-connection approve --approval-description {"OPTIONAL DESCRIPTION"} --resource-group {RG} --vault-name {KEY VAULT NAME} –name {PRIVATE LINK CONNECTION NAME}

# Deny a Private Link Connection Request
az keyvault private-endpoint-connection reject --rejection-description {"OPTIONAL DESCRIPTION"} --resource-group {RG} --vault-name {KEY VAULT NAME} –name {PRIVATE LINK CONNECTION NAME}

# Delete a Private Link Connection Request
az keyvault private-endpoint-connection delete --resource-group {RG} --vault-name {KEY VAULT NAME} --name {PRIVATE LINK CONNECTION NAME}

Adicionar registros de DNS privado

# Determine the Private Endpoint IP address
az network private-endpoint show -g {RG} -n {PE NAME}      # look for the property networkInterfaces then id; the value must be placed on {PE NIC} below.
az network nic show --ids {PE NIC}                         # look for the property ipConfigurations then privateIpAddress; the value must be placed on {NIC IP} below.

# https://learn.microsoft.com/azure/dns/private-dns-getstarted-cli#create-an-additional-dns-record
az network private-dns zone list -g {RG}
az network private-dns record-set a add-record -g {RG} -z "privatelink.vaultcore.azure.net" -n {KEY VAULT NAME} -a {NIC IP}
az network private-dns record-set list -g {RG} -z "privatelink.vaultcore.azure.net"

# From home/public network, you wil get a public IP. If inside a vnet with private zone, nslookup will resolve to the private ip.
nslookup {KEY VAULT NAME}.vault.azure.net
nslookup {KEY VAULT NAME}.privatelink.vaultcore.azure.net

Validar se a conexão de link privado funciona

Você deve validar se os recursos dentro da mesma sub-rede do recurso de ponto de extremidade privado estão se conectando ao cofre de chaves por um endereço IP privado e se eles têm a integração de zona DNS privada correta.

Primeiro, crie uma máquina virtual seguindo as etapas em Criar uma máquina virtual do Windows no portal do Azure

Na guia “Rede”:

1. especifique a Rede virtual e a Sub-rede. Você pode criar uma rede virtual ou selecionar uma existente. Se você estiver selecionando uma existente, verifique se a região é correspondente.
2. Especifique um recurso de IP Público.
3. No "grupo de segurança de rede da NIC", selecione "Nenhum".
4. No “Balanceamento de carga”, selecione “Não”.

Abra a linha de comando e execute o seguinte comando:

nslookup <your-key-vault-name>.vault.azure.net

Se você executar o comando NS Lookup para resolver o endereço IP de um cofre de chaves em um ponto de extremidade público, verá um resultado parecido com este:

c:\ >nslookup <your-key-vault-name>.vault.azure.net

Non-authoritative answer:
Name:    
Address:  (public IP address)
Aliases:  <your-key-vault-name>.vault.azure.net

Se você executar o comando NS Lookup para resolver o endereço IP de um cofre de chaves em um ponto de extremidade privado, verá um resultado parecido com este:

c:\ >nslookup your_vault_name.vault.azure.net

Non-authoritative answer:
Name:    
Address:  10.1.0.5 (private IP address)
Aliases:  <your-key-vault-name>.vault.azure.net
          <your-key-vault-name>.privatelink.vaultcore.azure.net

Guia de solução de problemas

• Verifique se o ponto de extremidade privado está no estado aprovado.

  1. É possível verificar e corrigir isso no portal do Azure. Abra o recurso Key Vault e clique na opção Rede.
  2. Em seguida, selecione a guia Conexões de ponto de extremidade privado.
  3. Verifique se o estado da conexão é Aprovado e se o estado do provisionamento é Êxito.
  4. Você também pode navegar até o recurso de ponto de extremidade privado e revisar as mesmas propriedades e verificar se a rede virtual corresponde à que você está utilizando.

• Verifique se você tem um recurso de Zona DNS Privada.

  1. Você precisa ter um recurso de Zona DNS Privada com o nome exato: privatelink.vaultcore.azure.net.
  2. Para saber como configurá-lo, confira o link a seguir. Zonas DNS Privadas

• Confirme se a zona DNS privada está vinculada à Rede Virtual. Esse pode ser o problema se você ainda estiver recebendo o endereço IP público retornado.

  1. Se o DNS da Zona Privada não estiver vinculado à rede virtual, a consulta DNS originada da rede virtual retornará o endereço IP público do cofre de chaves.
  2. Navegue até o recurso de Zona DNS Privada no portal do Azure e clique na opção de links de rede virtual.
  3. A rede virtual que executará chamadas para o cofre de chaves deve estar listada.
  4. Se não estiver, adicione-a.
  5. Para ver as etapas detalhadas, confira o documento a seguir Vincular Rede Virtual a Zona DNS Privada

• Verifique se há um registro A ausente na Zona DNS Privada para o cofre de chaves.

  1. Navegue até a página da Zona DNS Privada.
  2. Selecione Visão geral e verifique se há um registro A com o nome simples do seu cofre de chaves (ou seja, fabrikam). Não especifique nenhum sufixo.
  3. Verifique a ortografia e crie ou corrija o registro A. É possível usar um TTL de 600 (10 minutos).
  4. Não deixe de especificar o endereço IP privado correto.

• Verifique se o registro A tem o endereço IP correto.

  1. Confirme o endereço IP abrindo o recurso Ponto de Extremidade Privado no portal do Azure.
  2. Navegue até o recurso Microsoft.Network/privateEndpoints no portal do Azure (e não até o recurso Key Vault)
  3. Na página de visão geral, procure por Adaptador de rede e clique nesse link.
  4. O link mostrará a Visão geral do recurso NIC, que contém o Endereço IP Privado da propriedade.
  5. Verifique se esse é o endereço IP correto especificado no registro A.

• Se estiver se conectando a partir de um recurso local a um Key Vault, verifique se todos os encaminhadores condicionais necessários no ambiente local estão habilitados.

  1. Revise a configuração do DNS do Ponto de Extremidade Privado do Azure para obter as zonas necessárias e verifique se você tem encaminhadores condicionais para vault.azure.net e vaultcore.azure.net no seu DNS local.
  2. Verifique se você tem encaminhadores condicionais para essas zonas que roteiam para um Resolvedor de DNS Privado do Azure ou alguma outra plataforma DNS com acesso à resolução do Azure.

Limitações e considerações de design

Limites: confira Limites do Link Privado do Azure

Preços: confira Preços do Link Privado do Azure.

Limitações: confira Serviço Link Privado do Azure: Limitações

Próximas etapas

• Saiba mais sobre o Link Privado do Azure
• Saiba mais sobre o Azure Key Vault