Endereços IP no Gerenciamento de API do Azure

APLICA-SE A: Todas as camadas de gerenciamento de API

Este artigo descreve como recuperar os endereços IP do Gerenciamento de API do Azure. Os endereços IP podem ser públicos ou privados se o serviço estiver em uma rede virtual. Você pode usar endereços IP para criar regras de firewall, filtrar o tráfego de entrada para serviços de back-end ou restringir o tráfego de saída.

Endereços IP públicos

Cada instância de Gestão de APIs no nível Developer, Basic, Standard ou Premium tem endereços IP públicos exclusivos dessa instância. (Eles não são compartilhados com outros recursos.)

Recupere os endereços IP do painel de visão geral do seu recurso no portal Azure:

Alternativamente, obtém-los programaticamente usando esta chamada API:

GET https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.ApiManagement/service/<service-name>?api-version=<api-version>

Endereços IP públicos aparecem na resposta:

{
  ...
  "properties": {
    ...
    "publicIPAddresses": [
      "172.31.0.1"
    ],
    ...
  }
  ...
}

Em implantações multirregionais, cada implantação regional tem um endereço IP público.

Endereços IP do Gerenciamento de API em uma rede virtual

Se sua instância de Gerenciamento de API estiver dentro de uma rede virtual, ela terá dois tipos de endereços IP: público e privado.

• Use endereços IP públicos para comunicação interna na porta 3443 para gerir a configuração, como através do Azure Resource Manager. Na configuração de rede virtual externa , utilize-os também para tráfego de API em tempo de execução. Na configuração de rede virtual interna, use endereços IP públicos apenas para operações de gestão interna do Azure. Eles não expõem a sua instância à internet.

• Use endereços IP virtuais privados (VIP), disponíveis apenas em modo de rede virtual interna, para se ligar dentro da rede aos endpoints de Gestão de API: gateways, o portal de programadores e o plano de gestão para acesso direto à API. Use estes endereços para configurar registos DNS dentro da rede.

Vê endereços de ambos os tipos no portal Azure e na resposta a uma chamada API:

GET https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.ApiManagement/service/<service-name>?api-version=<api-version>

{
  ...
  "properties": {
    ...
    "publicIPAddresses": [
      "172.31.0.1"
    ],
    "privateIPAddresses": [
      "192.168.1.5"
    ],
    ...
  },
  ...
}

Endereços IP para tráfego de saída

O Gerenciamento de API usa um endereço IP público para uma conexão fora da rede virtual ou de uma rede virtual emparelhada. Utiliza um endereço IP privado para uma ligação na rede virtual ou numa rede virtual emparelhada.

• Quando implementa a Gestão de APIs numa rede virtual externa ou interna e esta se liga a backends privados (voltados para a intranet), a Gestão de APIs utiliza endereços IP internos (endereços IP dinâmicos ou DIP) da sub-rede para o tráfego API em tempo de execução. Quando a API Management envia um pedido para um backend privado, um endereço IP privado é visível como a origem do pedido.

  Portanto, se as listas de restrição de IP protegerem recursos dentro da rede virtual ou de uma rede virtual emparelhada, utilize todo o intervalo da sub-rede do API Management numa regra de IP e (no modo interno) não apenas o endereço IP privado associado ao recurso do API Management.

• Quando a API Management envia um pedido para um backend público (virado para a internet), um endereço IP público é sempre visível como a origem do pedido.

Endereços IP das instâncias de Gestão de API dos escalões Consumption, Basic v2, Standard v2 e Premium v2

Se criares a tua instância de Gestão de API num nível de serviço que corre numa infraestrutura partilhada, não tem um endereço IP dedicado. Atualmente, as instâncias nas seguintes camadas de serviço são executadas em uma infraestrutura compartilhada e sem um endereço IP determinístico: Consumption, Basic v2, Standard v2, Premium v2.

Se precisares de adicionar os endereços IP de saída que a tua instância Consumption, Basic v2, Standard v2 ou Premium v2 usa a uma lista de permissões, podes adicionar o datacenter da instância (região Azure) a uma lista de autorizações. Descarregue um ficheiro JSON que liste os endereços IP de todos os datacenters do Azure. Em seguida, localize o fragmento JSON que se aplica à região em que sua instância é executada.

Por exemplo, o seguinte fragmento JSON mostra como poderá ser a lista de autorização para a Europa Ocidental:

{
  "name": "AzureCloud.westeurope",
  "id": "AzureCloud.westeurope",
  "properties": {
    "changeNumber": 9,
    "region": "westeurope",
    "platform": "Azure",
    "systemService": "",
    "addressPrefixes": [
      "13.69.0.0/17",
      "13.73.128.0/18",
      ... Some IP addresses not shown here
     "213.199.183.0/24"
    ]
  }
}

Para obter informações sobre quando esse arquivo é atualizado e quando os endereços IP são alterados, expanda a seção Detalhes da página Centro de Download.

Alterações aos endereços IP

Nas camadas Developer, Basic, Standard e Premium do Gerenciamento de API, o endereço ou endereços IP públicos (VIP) e os endereços VIP privados (se configurados no modo de rede virtual interna) são estáticos durante o tempo de vida de um serviço, com as seguintes exceções:

• O Gerenciamento de API é excluído e, em seguida, recriado.

• A subscrição do serviço é desativada ou avisada (por exemplo, por falta de pagamento) e, em seguida, restabelecida. Saiba mais sobre os estados de subscrição.

• (Níveis Developer e Premium) A Rede Virtual do Azure é adicionada ou removida do serviço.

• (Níveis Developer e Premium) O Gerenciamento de API é alternado entre o modo de implantação de rede virtual externa e interna.

• (Níveis Developer e Premium) O Gerenciamento de API é movido para uma sub-rede diferente ou configurado com um recurso de endereço IP público diferente.

• (Nível Premium) As zonas de disponibilidade são ativadas, adicionadas ou removidas.

• (Nível Premium) Em implantações multirregionais, o endereço IP regional muda se uma região for desocupada e, em seguida, restabelecida.

  Importante

  Ao mudar de uma rede virtual interna para externa ou alterar sub-redes na rede, você pode configurar um endereço IP público diferente. Se você não fornecer um, um endereço IP público gerenciado pelo Azure será configurado automaticamente.

Conteúdos relacionados

• Implantar o Gerenciamento de API em uma rede virtual - modo externo
• Implantar o Gerenciamento de API em uma rede virtual - modo interno
• Usando uma rede virtual com o Gerenciamento de API do Azure