ipv4_is_private()
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
Vérifie si l’adresse de chaîne IPv4 appartient à un ensemble d’adresses IP de réseau privé.
Les adresses réseau privées ont été définies à l’origine pour retarder l’épuisement des adresses IPv4. Les paquets IP provenant ou adressés à une adresse IP privée ne peuvent pas être routés via l’Internet public.
Adresses IPv4 privées
Internet Engineering Task Force (IETF) a dirigé internet Assigned Numbers Authority (IANA) pour réserver les plages d’adresses IPv4 suivantes pour les réseaux privés :
Plage d'adresses IP | Nombre d’adresses | Plus grand bloc CIDR (masque de sous-réseau) |
---|---|---|
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
Syntaxe
ipv4_is_private(
ip)
En savoir plus sur les conventions de syntaxe.
Paramètres
Nom | Type | Requise | Description |
---|---|---|---|
ip | string |
✔️ | Expression représentant une adresse IPv4. Les chaînes IPv4 peuvent être masquées à l’aide de la notation de préfixe IP. |
Notation de préfixe IP
La notation de préfixe IP (également appelée notation CIDR) est un moyen concis de représenter une adresse IP et son masque réseau associé. Le format est <base IP>/<prefix length>
, où la longueur du préfixe est le nombre de 1 bits de début dans le masque net. La longueur du préfixe détermine la plage d’adresses IP qui appartiennent au réseau.
Pour IPv4, la longueur du préfixe est un nombre compris entre 0 et 32. Ainsi, la notation 192.168.2.0/24 représente l’adresse IP 192.168.2.0 avec un masque netmask de 255.255.255.255.0. Ce masque net a 24 bits de début 1 ou une longueur de préfixe de 24.
Pour IPv6, la longueur du préfixe est un nombre compris entre 0 et 128. Ainsi, la notation fe80 ::85d :e82c :9446:7994/120 représente l’adresse IP fe80 ::85d :e82c :9446:7994 avec un masque net de ffff :ffff :ffff :ffff :ffff :ff00. Ce masque net a 120 bits de début 1 ou une longueur de préfixe de 120.
Retours
true
: si l’adresse IPv4 appartient à l’une des plages de réseau privé.false
:Autrement.null
: Si l’analyse de l’entrée en tant que chaîne d’adresse IPv4 n’a pas réussi.
Exemple : vérifier si IPv4 appartient à un réseau privé
datatable(ip_string:string)
[
'10.1.2.3',
'192.168.1.1/24',
'127.0.0.1',
]
| extend result = ipv4_is_private(ip_string)
Sortie
ip_string | result |
---|---|
10.1.2.3 | true |
192.168.1.1/24 | true |
127.0.0.1 | false |
Contenu connexe
- Vue d’ensemble des fonctions IPv4/IPv6
- Vue d’ensemble des fonctions de correspondance de texte IPv4