Direcciones IP en Azure API Management

SE APLICA A: todos los niveles de API Management

En este artículo se describe cómo recuperar las direcciones IP de Azure API Management. Las direcciones IP pueden ser públicas o privadas si el servicio está en una red virtual. Puede usar direcciones IP para crear reglas de firewall, filtrar el tráfico entrante a los servicios back-end o restringir el tráfico saliente.

Direcciones IP públicas

Cada instancia de gestión de API en los niveles Developer, Basic, Standard o Premium tiene direcciones IP públicas exclusivas de esa instancia. (No se comparten con otros recursos).

Recupera las direcciones IP desde el panel de resumen de tu recurso en el portal de Azure:

Captura de pantalla que muestra una dirección IP en API Management.

Alternativamente, obtenerlos programáticamente usando esta llamada a la API:

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

Las direcciones IP públicas aparecen en la respuesta:

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

En las implementaciones en varias regiones, cada implementación regional tiene una dirección IP pública.

Direcciones IP de API Management en una red virtual

Si la instancia de API Management está dentro de una red virtual, tiene dos tipos de direcciones IP: pública y privada.

  • Utiliza direcciones IP públicas para la comunicación interna en el puerto 3443 y así gestionar la configuración, como a través de Azure Resource Manager. En la configuración de la red virtual externa, úsalos también para el tráfico de la API en tiempo de ejecución. En la configuración de red virtual interna, usa direcciones IP públicas solo para las operaciones de gestión interna de Azure. No exponen tu instancia a Internet.

  • Utiliza direcciones IP virtuales privadas (VIP), disponibles solo en modo de red virtual interna, para conectarte desde dentro de la red a los puntos finales de gestión de API: gateways, el portal de desarrolladores y el plano de gestión para acceder directamente a la API. Utiliza estas direcciones para configurar los registros DNS dentro de la red.

Ves direcciones de ambos tipos en el portal de Azure y en la respuesta de una llamada a la API:

Captura de pantalla que muestra una dirección VIP en API Management. 

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"
    ],
    ...
  },
  ...
}

Importante

El balanceador de carga interno y las unidades de gestión de API obtienen direcciones IP privadas de forma dinámica. No puedes anticipar la IP privada de la instancia de Gestión de API antes de su despliegue. Además, cambiar a otra subred y luego devolverla podría provocar un cambio en la dirección IP privada.

Direcciones IP para el tráfico saliente

API Management usa una dirección IP pública para una conexión fuera de la red virtual o una red virtual emparejada. Usa una dirección IP privada para una conexión en la red virtual o una red virtual emparejada.

  • Cuando despliegas la Gestión de APIs en una red virtual externa o interna y se conecta a backends privados (orientados a la intranet), la Gestión de la API utiliza direcciones IP internas (IP dinámica, o direcciones DIP) de la subred para el tráfico API en tiempo de ejecución. Cuando la Administración de API envía una solicitud a un backend privado, una dirección IP privada es visible como el origen de la petición.

    Por lo tanto, si las listas de restricción de IP protegen recursos dentro de la red virtual o de una red virtual emparejada, usa todo el intervalo de la subred de API Management con una regla de IP y, en modo interno, no solo la dirección IP privada asociada al recurso de API Management.

  • Cuando API Management envía una solicitud a un backend público (orientado a internet), una dirección IP pública siempre es visible como origen de la solicitud.

Direcciones IP de las instancias de API Management de nivel Consumo, Básico v2, Estándar v2 y Premium v2

Si creas tu instancia de gestión de API en un nivel de servicio que funciona en una infraestructura compartida, no tiene una dirección IP dedicada. Actualmente, las instancias de los siguientes niveles de servicio se ejecutan en una infraestructura compartida y sin una dirección IP determinista: Consumption, Basic v2, Standard v2, Premium v2.

Si necesitas añadir las direcciones IP salientes que usan tu instancia de nivel Consumption, Basic v2, Standard v2 o Premium v2 a una lista de permisos, puedes añadir el centro de datos de la instancia (región de Azure) a una lista de permisos. Descarga un archivo JSON que lista las direcciones IP de todos los centros de datos de Azure. Luego, busque el fragmento JSON que se aplique a la región en la que se ejecuta la instancia.

Por ejemplo, el siguiente fragmento JSON es cómo podría ser la lista de permisos para Europa Occidental:

{
  "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 obtener información acerca de cuándo se actualiza este archivo y cuando cambian las direcciones IP, expanda la sección Details (Detalles) de la página del Centro de descarga.

Cambios en las direcciones IP

En los niveles Desarrollador, Básico, Estándar y Premium de API Management, la dirección IP pública o las direcciones IP (VIP) y las direcciones VIP privadas (si están configuradas en el modo de red virtual interna) son estáticas durante la vigencia de un servicio, con las siguientes excepciones:

  • API Management se elimina y luego se vuelve a crear.

  • La suscripción al servicio se deshabilita o se advierte (por ejemplo, por falta de pago) y luego se reinstaura. Infórmate más sobre los estados de suscripción.

  • (Niveles Developer y Premium) Azure Virtual Network se agrega o se quita del servicio.

  • (niveles Desarrollador y Premium) API Management se puede cambiar entre el modo de implementación en red virtual externa y el modo interno.

  • (Niveles De desarrollador y Premium) API Management se mueve a una subred diferente o se configura con un recurso de dirección IP pública diferente.

  • (Nivel Premium) Las zonas de disponibilidad se habilitan, agregan o quitan.

  • (Nivel Premium) En las implementaciones en varias regiones, la dirección IP regional cambia si una región está vacía y, posteriormente, se restituye.

    Importante

    Al cambiar de una red virtual interna a externa o cambiar las subredes de la red, puede configurar una dirección IP pública diferente. Si no proporciona una, se configura automáticamente una dirección IP pública administrada por Azure.

Contenido relacionado

  • Se actualizó por última vez el