Partilhar via

ipv4_is_private()

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Verifica se o endereço de string IPv4 pertence a um conjunto de IPs de rede privada.

Os endereços de rede privada foram originalmente definidos para ajudar a retardar o esgotamento do endereço IPv4. Os pacotes IP originados ou endereçados a um endereço IP privado não podem ser roteados pela Internet pública.

Endereços IPv4 privados

A Internet Engineering Task Force (IETF) instruiu a Internet Assigned Numbers Authority (IANA) a reservar os seguintes intervalos de endereços IPv4 para redes privadas:

Intervalo de endereços IP Número de endereços Maior bloco CIDR (máscara de sub-rede)
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

Sintaxe

ipv4_is_private(ip)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome Digitar Obrigatória Descrição
ip string ✔️ Uma expressão que representa um endereço IPv4. As strings IPv4 podem ser mascaradas usando notação de prefixo IP.

Notação de prefixo IP

A notação de prefixo IP (também conhecida como notação CIDR) é uma maneira concisa de representar um endereço IP e sua máscara de rede associada. O formato é <base IP>/<prefix length>, onde o comprimento do prefixo é o número de bits 1 à esquerda na máscara de rede. O comprimento do prefixo determina o intervalo de endereços IP que pertencem à rede.

Para IPv4, o comprimento do prefixo é um número entre 0 e 32. Portanto, a notação 192.168.2.0/24 representa o endereço IP 192.168.2.0 com uma máscara de rede de 255.255.255.0. Essa máscara de rede tem 24 bits 1 à esquerda ou um comprimento de prefixo de 24.

Para IPv6, o comprimento do prefixo é um número entre 0 e 128. Portanto, a notação fe80::85d:e82c:9446:7994/120 representa o endereço IP fe80::85d:e82c:9446:7994 com uma máscara de rede de ffff:ffff:ffff:ffff:ffff:ffff:ffff:ff00. Essa máscara de rede tem 120 bits 1 à esquerda ou um comprimento de prefixo de 120.

Devoluções

  • true: Se o endereço IPv4 pertencer a qualquer um dos intervalos de rede privada.
  • false:Caso contrário.
  • null: Se a análise da entrada como cadeia de caracteres de endereço IPv4 não tiver sido bem-sucedida.

Exemplo: verificar se o IPv4 pertence a uma rede 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)

Saída

ip_string result
10.1.2.3 true
192.168.1.1/24 true
127.0.0.1 false

Conteúdo relacionado