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, area di lavoro
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
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