ipv4_is_private()

IPv4 文字列アドレスがプライベート ネットワーク IP のセットに属しているかどうかを確認します。

プライベート ネットワーク アドレス は、もともと IPv4 アドレスの枯渇を遅らせるために定義されていました。 プライベート IP アドレスからの IP パケットまたはプライベート IP アドレスへのアドレス指定された IP パケットは、パブリック インターネット経由でルーティングできません。

プライベート IPv4 アドレス

Internet Engineering Task Force (IETF) は、Internet Assigned Numbers Authority (IANA) に対して以下の IPv4 アドレス範囲をプライベート ネットワーク用に予約するように指示しています。

IP アドレスの範囲	アドレスの数	最大 CIDR ブロック (サブネット マスク)
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

構文

ipv4_is_private(Ip)

構文規則について詳しく知る。

パラメーター

名前	型	必須	説明
Ip	string	✔️	IPv4 アドレスを表す式。 IPv4 文字列は IP プレフィックス表記を使用してマスクできます。

IP - プレフィックスの表記

IP プレフィックス表記 (CIDR 表記とも呼ばれます) は、IP アドレスとそれに関連付けられているネットワーク マスクを表す簡潔な方法です。 形式は です <base IP>/<prefix length>。プレフィックスの長さは、ネットマスク内の先頭の 1 ビットの数です。 プレフィックスの長さは、ネットワークに属する IP アドレスの範囲を決定します。

IPv4 の場合、プレフィックスの長さは 0 ~ 32 の数値です。 そのため、表記 192.168.2.0/24 は IP アドレス 192.168.2.0 を表し、ネットマスクは 255.255.255.0 です。 このネットマスクの先頭は 24 ビット、プレフィックス長は 24 です。

IPv6 の場合、プレフィックスの長さは 0 ~ 128 の数値です。 そのため、表記 fe80::85d:e82c:9446:7994/120 は、ffff:ffff:ffff:ffff:ffff:ff00 のネットマスクを含む IP アドレス fe80::85d:e82c:9446:7994 を表します。 このネットマスクの先頭は 120 ビット、プレフィックス長は 120 です。

戻り値

• true: その IPv4 アドレスがプライベート ネットワークの範囲のいずれかに属している場合。
• false: それ以外の場合。
• null: IPv4 アドレス文字列としての入力の解析に成功しなかった場合。

例: IPv4 がプライベート ネットワークに属しているかどうかを確認する

クエリを実行する

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

出力

ip_string	結果
10.1.2.3	TRUE
192.168.1.1/24	TRUE
127.0.0.1	false

関連コンテンツ

• IPv4/IPv6 関数の概要
• IPv4 テキスト一致関数の概要