ip matching

IPマッチング

IPSに関する便利な機能を備えたスタンドアロンモジュール：

• IPが要件を満たしているかどうかを確認するための迅速で使いやすい方法
• IPv4/IPv6ワイルドカードアドレス、範囲、サブネットワーク、マスクのサポート。
• すべての一般的なIPv6表記の解析と出力の両方をサポートします
• ユーティリティ方法、例：次/以前のIP、cidrsのリストの範囲、...
• すべてのリリースは、公開される前に徹底的にテストされ、まとめられています

インストール

npm install --save ip-matching
# or
yarn add ip-matching

含まれたドキュメントを含む独自の組み込みのタイプスクリプト宣言が付属しています。

例

 import { getMatch , IPMatch , IPSubnetwork , IPRange , matches } from 'ip-matching' ;

// matches(ip: string | IP, target: string | IPMatch): boolean;

matches ( '10.0.0.1' , '10.0.0.0/24' ) ; // true
matches ( '10.0.1.1' , '10.0.0.0/24' ) ; // false
matches ( 'abc::def' , 'abc:*::def' ) ; // true
matches ( 'abc::def' , 'abc:9::def' ) ; // false
matches ( '0001:2:3:4:5:6:7' , '1:2:3:4:5:6:7' ) ; // true

// getMatch returns an instance of
// IPv4, IPv6, IPRange, IPSubnetwork or IPMask, all extending IPMatch
const mySubnet : IPMatch = getMatch ( 'fefe::0001:abcd/112' ) ;
mySubnet . type ; // 'IPSubnetwork'
mySubnet instanceof IPSubnetwork ; // true
mySubnet instanceof IPMatch ; // true
mySubnet . toString ( ) ; // 'fefe::1:0/112'
mySubnet . matches ( 'FEFE::1:bbbb' ) ; // true
mySubnet . matches ( 'FEFE::2:bbbb' ) ; // false
mySubnet . equals ( new IPSubnetwork ( new IPv6 ( 'fefe::1:abcd' ) , 112 ) ) ; // true
mySubnet . getAmount ( ) ; // 65536
( mySubnet as IPSubnetwork ) . getLast ( ) . toString ( ) ; // 'fefe::1:ffff'

const myIp = new IPv6 ( 'a:0:0::B:0:C' ) ;
myIp . toString ( ) ; // 'a::b:0:c'
myIp . toLongString ( ) ; // 'a:0:0:0:0:b:0:c'
myIp . toFullString ( ) ; // '000a:0000:0000:0000:0000:000b:0000:000c'
new IPv6 ( '::ffff:a9db:*' ) . toMixedString ( ) ; // '::ffff:169.219.*.*'

const myRange = getMatch ( '10.0.0.0-10.1.2.3' ) as IPRange ;
myRange . convertToMasks ( ) . map ( ( mask : IPMask ) => mask . convertToSubnet ( ) . toString ( ) ) ;
// [ '10.0.0.0/16', '10.1.0.0/23', '10.1.2.0/30' ]

const mask1 = getMatch ( '10.0.1.0/255.0.255.0' ) as IPMask ;
const mask2 = getMatch ( '10.0.0.0/128.0.0.0' ) as IPMask ;
mask1 . isSubsetOf ( mask2 ) ; // true
mask2 . getAmount ( ) ; // 2147483648

getMatch ( 'a::abbc:1234/ffff::ff80:000f' ) . toString ( ) ; // 'a::ab80:4/ffff::ff80:f'

注： matches関数と無効な入力のすべてのコンストラクターエラー

すべての機能のテストコードまたはタイプスクリプト宣言を見ることができます。

許可されたパターン

• IP（IPv4/IPv6）
  • 通常のIPv4： 10.0.0.0
  • ワイルドカードIPv4： 10.0.0.*または10.*.0.*
  • 通常のIPv6： 2001:0db8:85a3:0000:0000:8a2e:0370:7334
  • 短縮IPv6： 2001:db8:85a3::8a2e:0370:7334または:: or ::1またはa::
  • WildCard IPv6： 2001::*または2001::*:abc:*
  • 混合IPv6（マッピングIPv4） ::ffff:127.0.0.1 （IPv4パーツではワイルドカードが許可されていません）
  • 許可されていない： 10.0.1*.0または2001::a*c
• IP範囲
  • IPv4： 10.0.0.0-10.1.2.3
  • IPv6： 2001::abc-2001::1:ffff
  • 注：左側は右側よりも「低」でなければなりません
• IPサブネットワーク
  • IPv4： 10.0.0.0/16
  • IPv6： 2001::/123
• IPマスク
  • IPv4： 10.0.0.0/255.0.64.0
  • IPv6： 2001:abcd::/ffff:ff8::

IPMASKのtoString()メソッドは、EG /255.0.0.0から/8自動的に簡素化しませんが、それらは同等です。 2.0.0以降、IPMASKには、可能であれば、同等のiPSubnetworkを返すメソッドundefined convertToSubnet()が付属しています。

同様のライブラリとの比較

よく知られている類似したNPMパッケージと、私たちに欠けている機能をいくつか紹介します。その逆も同様です。いずれの場合も、このモジュールに適していると思われる場合は、新しい機能をお気軽にお問い合わせください。

IPアドレス

• テレド情報のデコードをサポートします
• 特別なプロパティの読み取りをサポートします（マルチキャストプレフィックス、一意のローカルアドレスプレフィックス、リンクローカル、...）
• URLからIPv6アドレス（およびポート）の解析をサポートします
• IPv6 ARPAアドレスの解析（ .ip6.arpa ）およびスコープ（ゾーン）アドレスをサポートする
• ワイルドカードIPアドレスをサポートしていません
• IP範囲やマスク（関連する方法も）をサポートしていません
• サブネット内のIPアドレスの量を取得することをサポートしていません
• IPアドレスの前/次への取得をサポートしていません

IP

• 4年以上放棄された（2017年初頭以降）
• ローカルIPアドレスの取得をサポートします
• IPアドレスの操作ではない/または操作をサポートします
• 通常のIPv4/IPv6アドレスをサポートします
• IPv4サブネットをサポートします（サブネットプロパティ付き）
• ワイルドカードIPアドレスまたはIPv6サブネットをサポートしていません
• IP範囲やマスク（関連する方法も）をサポートしていません
• IPアドレスの前/次への取得をサポートしていません

ネットマスク

• IPv4 CIDRブロックのみをサポートします（サブネット情報付き）
• 同じサイズの次のサブネットを取得することをサポートします
• あるサブネットが別のサブネットの一部であるかどうかを確認することをサポートします
• IPv4サブネット以外のものは何もサポートしていません

リンク

• github：https：//github.com/schoofskelvin/ip-matching
• NPM：https：//www.npmjs.com/package/ip-matching