ipv4_is_private()
Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft 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 |
Contenido relacionado
- Introducción a las funciones IPv4/IPv6
- Información general sobre las funciones de coincidencia de texto IPv4