Dela via


ipv4_is_private()

Kontrollerar om IPv4-strängadressen tillhör en uppsättning privata nätverks-IP-adresser.

Privata nätverksadresser definierades ursprungligen för att fördröja IPv4-adressöverbelastning. IP-paket som kommer från eller adresseras till en privat IP-adress kan inte dirigeras via det offentliga Internet.

Privata IPv4-adresser

IETF (Internet Engineering Task Force) har instruerat IANA (Internet Assigned Numbers Authority) att reservera följande IPv4-adressintervall för privata nätverk:

IP-adressintervall Antal adresser Största CIDR-block (nätmask)
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)

Läs mer om syntaxkonventioner.

Parametrar

Namn Typ Obligatorisk Beskrivning
Ip string ✔️ Ett uttryck som representerar en IPv4-adress. IPv4-strängar kan maskeras med IP-prefixnotation.

IP-prefixnotation

IP-prefixnotation (kallas även CIDR-notation) är ett koncist sätt att representera en IP-adress och dess associerade nätverksmask. Formatet är <base IP>/<prefix length>, där prefixets längd är antalet inledande 1 bitar i nätmasken. Prefixets längd avgör intervallet med IP-adresser som tillhör nätverket.

För IPv4 är prefixets längd ett tal mellan 0 och 32. Notationen 192.168.2.0/24 representerar alltså IP-adressen 192.168.2.0 med en nätmask på 255.255.255.0. Den här nätmasken har 24 inledande 1 bitar eller en prefixlängd på 24.

För IPv6 är prefixets längd ett tal mellan 0 och 128. Så notationen fe80::85d:e82c:9446:7994/120 representerar IP-adressen fe80::85d:e82c:9446:7994 med en netmask av ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffffff:ffffff:ffffff:ffff:ffffff:ffffff:ffffff:ffffff:ffff00. Den här nätmasken har 120 inledande 1 bitar eller en prefixlängd på 120.

Returer

  • true: Om IPv4-adressen tillhör något av de privata nätverksintervallen.
  • false:Annars.
  • null: Om parsning av indata som IPv4-adresssträng inte lyckades.

Exempel: Kontrollera om IPv4 tillhör ett privat nätverk

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

Resultat

ip_string resultat
10.1.2.3 true
192.168.1.1/24 true
127.0.0.1 falskt