ip-filter

SI APPLICA A: Tutti i livelli di Gestione API

Il criterio ip-filter filtra (permette/rifiuta) le chiamate da indirizzi IP e/o intervalli di indirizzi IP specifici.

Nota

Impostare gli elementi e gli elementi figlio del criterio nell'ordine specificato nell'istruzione del criterio. Per configurare questo criterio, il portale fornisce un editor guidato basato su moduli. Altre informazioni su come impostare o modificare i criteri di API Management.

Istruzione del criterio

<ip-filter action="allow | forbid">
    <address>address</address>
    <address-range from="address" to="address" />
</ip-filter>

Attributi

Attributo	Descrizione	Richiesto	Valore predefinito
action	Specifica se le chiamate devono essere consentite (allow) o rifiutate (forbid) per gli indirizzi e gli intervalli di indirizzi IP specificati. Le espressioni di criteri sono consentite.	Sì	N/D

Elementi

Elemento	Descrizione	Richiesto
address	Aggiungere uno o più di questi elementi per specificare un singolo indirizzo IP in cui filtrare. Le espressioni di criteri sono consentite.	È obbligatorio almeno un elemento address o address-range.
address-range	Aggiungere uno o più di questi elementi per specificare un intervallo di indirizzi IP from "address" to "address" su cui filtrare.	È obbligatorio almeno un elemento address o address-range.

Utilizzo

• Sezioni del criterio: inbound
• Ambiti del criterio: globale, area di lavoro, prodotto, API, operazione
• Gateway: classico, v2, consumo, self-hosted

Note sull'utilizzo

Se si configura questo criterio in più ambiti, il filtro IP viene applicato nell'ordine di valutazione dei criteri nella definizione dei criteri.

Esempio

Nell'esempio seguente, il criterio consente solo le richieste provenienti dal singolo indirizzo IP o dall'intervallo di indirizzi IP specificato.

<ip-filter action="allow">
    <address>13.66.201.169</address>
    <address-range from="13.66.140.128" to="13.66.140.143" />
</ip-filter>

Criteri correlati

• Autenticazione e autorizzazione

Contenuto correlato

Per ulteriori informazioni sull'utilizzo dei criteri, vedere:

• Esercitazione: trasformare e proteggere l'API
• Informazioni di riferimento sui criteri per un elenco completo delle istruzioni dei criteri e delle relative impostazioni
• Espressioni di criteri
• Impostare o modificare criteri
• Riutilizzare le configurazioni dei criteri
• Repository dei frammenti di criteri
• Creare criteri usando Microsoft Copilot in Azure