Compartir a través de


ipv4_is_private()

Se aplica a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft Sentinel

Comprueba si la dirección de cadena IPv4 pertenece a un conjunto de direcciones IP de red privada.

Las direcciones de red privada se definieron originalmente para ayudar a retrasar el agotamiento de direcciones IPv4. Los paquetes IP que se originan o se dirigen a una dirección IP privada no se pueden enrutar a través de la red pública de Internet.

Direcciones IPv4 privadas

El Grupo de Tareas de Ingeniería de Internet (IETF) ha dirigido a la autoridad de números asignados a Internet (IANA) para reservar los siguientes intervalos de direcciones IPv4 para redes privadas:

Intervalo de direcciones IP Número de direcciones Bloque CIDR más grande (máscara de subred)
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

Sintaxis

ipv4_is_private(ip)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre Type Obligatorio Descripción
ip string ✔️ Expresión que representa una dirección IPv4. Las cadenas IPv4 se pueden enmascarar mediante la notación de prefijo IP.

Notación de prefijo IP

La notación de prefijo IP (también conocida como notación CIDR) es una manera concisa de representar una dirección IP y su máscara de red asociada. El formato es <base IP>/<prefix length>, donde la longitud del prefijo es el número de 1 bits iniciales en la máscara de red. La longitud del prefijo determina el intervalo de direcciones IP que pertenecen a la red.

Para IPv4, la longitud del prefijo es un número comprendido entre 0 y 32. Por lo tanto, la notación 192.168.2.0/24 representa la dirección IP 192.168.2.0 con una máscara de red de 255.255.255.0. Esta máscara de red tiene 24 bits iniciales o una longitud de prefijo de 24.

Para IPv6, la longitud del prefijo es un número comprendido entre 0 y 128. Por lo tanto, la notación fe80::85d:e82c:9446:7994/120 representa la dirección IP fe80::85d:e82c:9446:7994 con una máscara de red de ffff:ffff:ffff:ffff:ffff:ffff:ff00. Esta máscara de red tiene 120 bits iniciales o una longitud de prefijo de 120.

Devoluciones

  • true: si la dirección IPv4 pertenece a cualquiera de los intervalos de red privados.
  • false:De otra manera.
  • null: si el análisis de la entrada como cadena de dirección IPv4 no se realizó correctamente.

Ejemplo: Comprobación de si IPv4 pertenece a una red privada

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

Salida

ip_string resultado
10.1.2.3 true
192.168.1.1/24 true
127.0.0.1 false