Freigeben über

ipv4_is_private()

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Überprüft, ob die IPv4-Zeichenfolgenadresse zu einer Gruppe privater Netzwerk-IPs gehört.

Private Netzwerkadressen wurden ursprünglich definiert, um die IPv4-Adressausschöpfung zu verzögern. IP-Pakete, die von einer privaten IP-Adresse stammen oder an diese adressiert sind, können nicht über das öffentliche Internet weitergeleitet werden.

Private IPv4-Adressen

Die Internet Engineering Task Force (IETF) hat die Internet Assigned Numbers Authority (IANA) angewiesen, die folgenden IPv4-Adressbereiche für private Netzwerke zu reservieren:

IP-Adressbereich Anzahl der Adressen Größter CIDR-Block (Subnetzmaske)
10.0.0.0–10.255.255.255 16777216 10.0.0.0/8 (255.0.0.0)
172.16.0.0–172.31.255.255 1048576 172.16.0.0/12 (255.240.0.0)
192.168.0.0–192.168.255.255 65536 192.168.0.0/16 (255.255.0.0) 
ipv4_is_private('192.168.1.1/24') == true
ipv4_is_private('10.1.2.3/24') == true
ipv4_is_private('202.1.2.3') == false
ipv4_is_private("127.0.0.1") == false

Syntax

ipv4_is_private(ip)

Erfahren Sie mehr über Syntaxkonventionen.

Parameter

Name Type Erforderlich Beschreibung
ip string ✔️ Ein Ausdruck, der eine IPv4-Adresse darstellt. IPv4-Zeichenfolgen können mithilfe der IP-Präfixnotation maskiert werden.

IP-Präfixnotation

Ip-Präfixnotation (auch als CIDR-Notation bezeichnet) ist eine präzise Möglichkeit, eine IP-Adresse und die zugehörige Netzwerkmaske darzustellen. Das Format ist <base IP>/<prefix length>, wobei die Präfixlänge die Anzahl der führenden 1 Bits in der Netzmaske ist. Die Präfixlänge bestimmt den Bereich der IP-Adressen, die zum Netzwerk gehören.

Bei IPv4 ist die Präfixlänge eine Zahl zwischen 0 und 32. Die Notation 192.168.2.0/24 stellt also die IP-Adresse 192.168.2.0 mit einer Netmask von 255.255.255.255.0 dar. Diese Netmaske hat 24 führende 1 Bit oder eine Präfixlänge von 24.

Bei IPv6 ist die Präfixlänge eine Zahl zwischen 0 und 128. Daher stellt die Notation fe80::85d:e82c:9446:7994/120 die IP-Adresse fe80::85d:e82c:9446:7994 mit einer Netmaske von ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00 dar. Diese Netmaske hat 120 führende 1 Bit oder eine Präfixlänge von 120.

Gibt zurück

  • true: Wenn die IPv4-Adresse zu einem der privaten Netzwerkbereiche gehört.
  • false:Sonst.
  • null: Wenn die Analyse der Eingabe als IPv4-Adresszeichenfolge nicht erfolgreich war.

Beispiel: Überprüfen, ob IPv4 zu einem privaten Netzwerk gehört

Abfrage ausführen

datatable(ip_string:string)
[
 '10.1.2.3',
 '192.168.1.1/24',
 '127.0.0.1',
]
| extend result = ipv4_is_private(ip_string)

Output

ip_string result
10.1.2.3 true
192.168.1.1/24 true
127.0.0.1 false

Zugehöriger Inhalt