Aufrufer-IPs beschränken

GILT FÜR: Alle API Management-Ebenen

Die ip-filter-Richtlinie filtert (erlaubt/blockiert) Aufrufe von bestimmten IP-Adressen und/oder Adressbereichen.

Hinweis

Legen Sie die Elemente und untergeordneten Elemente einer Richtlinie in der Reihenfolge fest, die in der Richtlinienanweisung angegeben ist. Das Portal unterstützt Sie bei der Konfiguration dieser Richtlinie durch einen formularbasierten, angeleiteten Editor. Erfahren Sie mehr darüber, wie Sie API Management-Richtlinien festlegen oder bearbeiten.

Richtlinienanweisung

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

Attribute

Attribut	BESCHREIBUNG	Erforderlich	Standard
action	Gibt an, ob Aufrufe für die angegebenen IP-Adressen oder -Adressbereiche zugelassen (allow) oder blockiert (forbid) werden sollen. Richtlinienausdrücke sind zulässig.	Ja	–

Elemente

Element	BESCHREIBUNG	Erforderlich
address	Fügen Sie eines oder mehrere dieser Elemente hinzu, um eine einzelne IP-Adresse anzugeben, nach der gefiltert werden soll. Richtlinienausdrücke sind zulässig.	Mindestens ein address- oder address-range-Element ist erforderlich.
address-range	Fügen Sie eines oder mehrere dieser Elemente hinzu, um einen Bereich von IP-Adressen anzugeben, nach dem gefiltert werden soll: from „Adresse“ to „Adresse“.	Mindestens ein address- oder address-range-Element ist erforderlich.

Verwendung

• Richtlinienabschnitte: inbound
• Richtlinienbereiche: global, Arbeitsbereich, Produkt, API, Vorgang
• Gateways: klassisch, v2, Verbrauch, selbstgehostet, Arbeitsbereich

Hinweise zur Verwendung

Wenn Sie diese Richtlinie für mehr als einen Bereich konfigurieren, wird die IP-Filterung in der Reihenfolge der Richtlinienauswertung in Ihrer Richtliniendefinition angewendet.

Beispiel

Im folgenden Beispiel lässt die Richtlinie nur Anforderungen zu, die entweder von der angegebenen einzelnen IP-Adresse oder von dem angegebenen IP-Adressbereich stammen.

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

Verwandte Richtlinien

• Authentifizierung und Autorisierung

Zugehöriger Inhalt

Weitere Informationen zum Arbeiten mit Richtlinien finden Sie hier:

• Tutorial: Transformieren und Schützen Ihrer API
• Unter Richtlinien für die API-Verwaltung finden Sie eine komplette Liste der Richtlinienanweisungen und der zugehörigen Einstellungen.
• Richtlinienausdrücke
• Festlegen oder Bearbeiten von Richtlinien
• Wiederverwenden von Richtlinienkonfigurationen
• Repository für Richtliniencodeausschnitte
• Erstellen von Richtlinien mit Microsoft Copilot in Azure