Udostępnij za pośrednictwem


ipv4_is_private()

Dotyczy: ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Sprawdza, czy adres ciągu IPv4 należy do zestawu adresów IP sieci prywatnej.

Pierwotnie zdefiniowano adresy sieci prywatnej, aby ułatwić opóźnienie wyczerpania adresów IPv4. Pakiety IP pochodzące z lub adresowane do prywatnego adresu IP nie mogą być kierowane za pośrednictwem publicznego Internetu.

Prywatne adresy IPv4

Internet Engineering Task Force (IETF) przekierował Internet Assigned Numbers Authority (IANA) do zarezerwowania następujących zakresów adresów IPv4 dla sieci prywatnych:

Zakres adresów IP Liczba adresów Największy blok CIDR (maska podsieci)
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

Składnia

ipv4_is_private(Ip)

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
Ip string ✔️ Wyrażenie reprezentujące adres IPv4. Ciągi IPv4 można maskować przy użyciu notacji prefiksów IP.

Notacja prefiksu IP

Notacja prefiksów IP (znana również jako notacja CIDR) to zwięzły sposób reprezentowania adresu IP i skojarzonej maski sieciowej. Format to <base IP>/<prefix length>, gdzie długość prefiksu to liczba wiodących 1 bitów maski sieci. Długość prefiksu określa zakres adresów IP należących do sieci.

W przypadku protokołu IPv4 długość prefiksu jest liczbą z zakresu od 0 do 32. Notacja 192.168.2.0/24 reprezentuje adres IP 192.168.2.0 z maską sieciową 255.255.255.0. Ta maska sieci ma 24 wiodące 1 bity lub długość prefiksu 24.

W przypadku protokołu IPv6 długość prefiksu jest liczbą z zakresu od 0 do 128. Notacja fe80::85d:e82c:9446:7994/120 reprezentuje adres IP fe80::85d:e82c:9446:7994 z maską netmask ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00. Ta maska sieci ma 120 wiodących 1 bitów lub długość prefiksu 120.

Zwraca

  • true: Jeśli adres IPv4 należy do dowolnego z zakresów sieci prywatnej.
  • false:Inaczej.
  • null: Jeśli analizowanie danych wejściowych jako ciąg adresu IPv4 nie powiodło się.

Przykład: Sprawdzanie, czy protokół IPv4 należy do sieci prywatnej

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

Wyjście

ip_string result
10.1.2.3 prawda
192.168.1.1/24 prawda
127.0.0.1 fałsz