ip matching

Pencocokan ip

Modul mandiri dengan beberapa fitur praktis mengenai IPS:

• Cara cepat dan mudah digunakan untuk memeriksa apakah IP memenuhi persyaratan
• Dukungan untuk alamat wildcard IPv4/IPv6, rentang, subnetworks dan topeng.
• Mendukung penguraian dan mengeluarkan semua notasi IPv6 umum
• Metode utilitas, misalnya IP berikutnya/sebelumnya, rentang ke daftar CIDRS, ...
• Setiap rilis diuji secara menyeluruh dan diceras sebelum diterbitkan

Instalasi

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

Dilengkapi dengan deklarasi naskah bawaannya sendiri dengan dokumentasi yang disertakan.

Contoh

 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'

Catatan : Fungsi matches dan semua kesalahan konstruktor untuk input yang tidak valid

Anda dapat melihat kode uji atau deklarasi TypeScript untuk semua fitur.

Pola yang diizinkan

• IP (IPv4/IPv6)
  • IPV4 reguler: 10.0.0.0
  • Wildcard IPv4: 10.0.0.* Atau bahkan 10.*.0.*
  • IPv6 reguler: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
  • Singkat IPv6: 2001:db8:85a3::8a2e:0370:7334 atau :: atau ::1 atau a::
  • Wildcard IPv6: 2001::* atau bahkan 2001::*:abc:*
  • Campuran IPv6 (dipetakan IPv4): ::ffff:127.0.0.1 (tidak ada wildcard yang diizinkan di bagian IPv4)
  • Tidak diizinkan : 10.0.1*.0 atau 2001::a*c
• Rentang IP
  • IPv4: 10.0.0.0-10.1.2.3
  • IPv6: 2001::abc-2001::1:ffff
  • Catatan : Sisi kiri harus "lebih rendah" dari sisi kanan
• IP Subnetwork
  • IPv4: 10.0.0.0/16
  • IPv6: 2001::/123
• IP Mask
  • IPv4: 10.0.0.0/255.0.64.0
  • IPv6: 2001:abcd::/ffff:ff8::

Metode IPMASK toString() tidak secara otomatis menyederhanakan EG /255.0.0.0 hingga /8 , meskipun itu setara. Sejak 2.0.0, IPMASK dilengkapi dengan metode convertToSubnet() yang mengembalikan ipsubnetwork yang setara jika memungkinkan, jika undefined .

Perbandingan dengan perpustakaan yang serupa

Berikut adalah beberapa paket NPM serupa yang terkenal dan fitur apa yang mereka miliki dan sebaliknya. Dalam semua kasus, jangan ragu untuk meminta fitur baru jika Anda pikir itu cocok untuk modul ini.

IP-TEPATKAN

• Mendukung decoding informasi teredo
• Mendukung Membaca Properti Khusus (Prefix Multicast, Awalan Alamat Lokal Unik, adalah tautan lokal, ...)
• Mendukung parsing alamat IPv6 (dan port) dari URLS
• Mendukung Parsing IPv6 ARPA Address ( .ip6.arpa ) dan scoped (Zoned) alamat
• Tidak mendukung alamat ip wildcard
• Tidak mendukung rentang atau topeng IP (atau metode terkait)
• Tidak mendukung mendapatkan jumlah alamat IP dalam subnet
• Tidak mendukung mendapatkan alamat IP sebelumnya/terdekat

aku p

• Ditinggalkan selama lebih dari 4 tahun (sejak awal 2017)
• Mendukung pengambilan alamat IP lokal
• Mendukung Tidak/atau Operasi di/Antara Alamat IP
• Mendukung alamat IPv4/IPv6 biasa
• Mendukung Subnet IPv4 (dengan Subnet Properties)
• Tidak mendukung alamat IP wildcard atau subnet IPv6
• Tidak mendukung rentang atau topeng IP (atau metode terkait)
• Tidak mendukung mendapatkan alamat IP sebelumnya/terdekat

netmask

• Hanya mendukung blok CIDR IPv4 (dengan informasi subnet)
• Mendukung mendapatkan subnet berikutnya dengan ukuran yang sama
• Mendukung memeriksa apakah satu subnet adalah bagian dari yang lain
• Tidak mendukung apa pun selain subnet IPv4

Tautan

• Github: https://github.com/schoofskelvin/ip-catching
• NPM: https://www.npmjs.com/package/ip-catching