Freigeben über


ipv4_is_private()

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

Private Netzwerkadressen wurden ursprünglich definiert, um die Erschöpfung von IPv4-Adressen 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 Typ 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 Netzmaske von 255.255.255.255.0 dar. Diese Netzmaske hat 24 führende 1 Bits oder eine Präfixlänge von 24.

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

Gibt zurück

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

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

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

Ausgabe

ip_string result
10.1.2.3 true
192.168.1.1/24 true
127.0.0.1 false