Indirizzi IP in Gestione API di Azure

SI APPLICA A: tutti i livelli di API Management

Questo articolo descrive come recuperare gli indirizzi IP di Gestione API di Azure. Gli indirizzi IP possono essere pubblici o privati se il servizio si trova in una rete virtuale. È possibile usare gli indirizzi IP per creare regole del firewall, filtrare il traffico in ingresso ai servizi back-end o limitare il traffico in uscita.

Indirizzi IP pubblici

Ogni istanza di gestione API nel livello Developer, Basic, Standard o Premium ha indirizzi IP pubblici esclusivi per quell'istanza. Non sono condivisi con altre risorse.

Recupera gli indirizzi IP dalla dashboard panoramica della tua risorsa nel portale Azure:

In alternativa, recuperali programmaticamente usando questa chiamata API:

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

Gli indirizzi IP pubblici compaiono nella risposta:

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

Nelle distribuzioni in più aree, ogni distribuzione a livello di area ha un indirizzo IP pubblico.

Indirizzi IP di Gestione API in una rete virtuale

Se l'istanza di Gestione API si trova all'interno di una rete virtuale, ha due tipi di indirizzi IP: public e private.

• Usa indirizzi IP pubblici per la comunicazione interna sulla porta 3443 per gestire la configurazione, ad esempio tramite Azure Resource Manager. Nella configurazione di rete virtuale esterna , utilizzarli anche per il traffico API in tempo reale. Nella configurazione della rete virtuale interna, usa indirizzi IP pubblici solo per le operazioni di gestione interna di Azure. Non espongono la tua istanza a internet.

• Utilizzare indirizzi IP virtuali privati (VIP), disponibili solo in modalità rete virtuale interna, per connettersi dall'interno della rete agli endpoint di gestione API: gateway, il portale per sviluppatori e il piano di gestione per l'accesso diretto all'API. Usa questi indirizzi per configurare i record DNS all'interno della rete.

Vedi indirizzi di entrambi i tipi nel portale Azure e nella risposta a una chiamata 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"
    ],
    ...
  },
  ...
}

Indirizzi IP per il traffico in uscita

Gestione API utilizza un indirizzo IP pubblico per una connessione esterna alla rete virtuale o a una rete virtuale collegata tramite peering. Usa un indirizzo IP privato per una connessione nella rete virtuale o in una rete virtuale con peering.

• Quando implementi API Management in una rete virtuale esterna o interna e questa si collega a backend privati (rivolti all'intranet), API Management utilizza indirizzi IP interni (IP dinamici, o indirizzi DIP) provenienti dalla subnet per il traffico API in tempo reale. Quando API Management invia una richiesta a un backend privato, un indirizzo IP privato è visibile come origine della richiesta.

  Pertanto, se gli elenchi di restrizioni IP proteggono le risorse all'interno della rete virtuale o di una rete virtuale con peering, usa l'intero intervallo della subnet di API Management con una regola IP e, in modalità interna, non solo l'indirizzo IP privato associato alla risorsa di API Management.

• Quando API Management invia una richiesta a un backend pubblico (rivolto a internet), un indirizzo IP pubblico è sempre visibile come origine della richiesta.

Indirizzi IP delle istanze di Gestione API di livello Consumo, Basic v2, Standard v2 e Premium v2

Se crei la tua istanza di gestione API in un livello di servizio che gira su un'infrastruttura condivisa, non ha un indirizzo IP dedicato. Attualmente, le istanze nei livelli di servizio seguenti vengono eseguite in un'infrastruttura condivisa e senza un indirizzo IP deterministico: A consumo, Basic v2, Standard v2, Premium v2.

Se devi aggiungere gli indirizzi IP in uscita usati dalla tua istanza Consumption, Basic v2, Standard v2 o Premium v2 a una lista di permessi, puoi aggiungere il datacenter dell'istanza (regione Azure) a una lista di permessi. Scarica un file JSON che elenca gli indirizzi IP di tutti i datacenter Azure. Trovare quindi l'elemento JSON applicabile per l'area in cui viene eseguita l'istanza.

Ad esempio, il seguente frammento JSON mostra come potrebbe essere la lista dei permessi per l'Europa occidentale:

{
  "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"
    ]
  }
}

Per informazioni sull'aggiornamento di questo file e la modifica degli indirizzi IP, espandere la sezione Dettagli della pagina dell'Area download.

Modifiche agli indirizzi IP

Nei livelli Developer, Basic, Standard e Premium di Gestione API, l'indirizzo IP pubblico o gli indirizzi VIP (VIP) e gli indirizzi VIP privati (se configurati nella modalità di rete virtuale interna) sono statici per la durata di un servizio, con le eccezioni seguenti:

• La gestione delle API è stata eliminata e quindi ricreata.

• La sottoscrizione al servizio viene disabilitata, ad esempio per mancato pagamento, e quindi ripristinata. Scopri di più sugli stati degli abbonamenti.

• (Livelli Developer e Premium) La rete virtuale di Azure viene aggiunta o rimossa dal servizio.

• (Livelli Developer e Premium) API Management si alterna tra le modalità di rete virtuale esterna e interna.

• (Livelli Developer e Premium) API Management è stata spostata in una subnet diversa o configurata con una risorsa indirizzo IP pubblico diversa.

• (Livello Premium) Le zone di disponibilità sono abilitate, aggiunte o rimosse.

• (Livello Premium) Nelle distribuzioni in più aree, l'indirizzo IP a livello di area cambia se un'area viene liberata e quindi ripristinata.

  Importante

  Quando si passa da una rete virtuale interna a una rete virtuale esterna o si modificano le subnet nella rete, è possibile configurare un indirizzo IP pubblico diverso. Se non ne viene specificato uno, viene configurato automaticamente un indirizzo IP pubblico gestito da Azure.

Contenuti correlati

• Distribuire API Management in una rete virtuale - modalità esterna
• Distribuire API Management in una rete virtuale - modalità interna
• Usare una rete virtuale con API Management di Azure