ipv4_is_private()
Verifica se o endereço de cadeia de caracteres IPv4 pertence a um conjunto de IPs de rede privada.
Os endereços de rede privada foram originalmente definidos para ajudar a atrasar o esgotamento do endereço IPv4. Os pacotes IP provenientes ou endereçados para um endereço IP privado não podem ser roteados pela Internet pública.
Endereços IPv4 privados
A IETF (Internet Engineering Task Force) orientou a IANA (Internet Assigned Numbers Authority) 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
Syntax
ipv4_is_private(
Ip)
Saiba mais sobre as convenções de sintaxe.
Parâmetros
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
Ip | string |
✔️ | Uma expressão que representa um endereço IPv4. As cadeias de caracteres 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>
, em que o comprimento do prefixo é o número de 1 bits à 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 à 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:ffff:ffff:ffff:ffff Essa máscara de rede tem 120 bits à esquerda ou um comprimento de prefixo de 120.
Retornos
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 foi 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
- Visão geral das funções IPv4/IPv6
- Visão geral das funções de correspondência de texto IPv4
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de