ip matching -Download - ip matching -Download

ip matching

Andere Kategorien

Release 2.1.2

Herunterladen

IP-Matching

Spenden

Eigenes Modul mit einigen praktischen Funktionen in Bezug auf IPS:

Schnelle und benutzerfreundliche Methode, um zu überprüfen, ob eine IP eine Anforderung erfüllt
Unterstützung für IPv4/IPv6 -Wildcard -Adressen, Bereiche, Subnetze und Masken.
Unterstützt sowohl Parsen als auch Ausgabe aller gängigen IPv6 -Notationen
Dienstprogrammmethoden, z. B. nächstes/vorheriges IP, Bereich zu einer Liste von CIDRs, ...
Jede Veröffentlichung wird vor der Veröffentlichung gründlich getestet und abgegeben

Installation

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

Kommt mit seinen eigenen integrierten Typoskript-Deklarationen mit enthaltenen Dokumentation.

Beispiel

 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'

HINWEIS : Die Funktion matches und alle Konstruktoren Fehler für ungültige Eingaben

Sie können sich den Testcode oder die Typscript -Deklarationen für alle Funktionen ansehen.

Zulässige Muster

IP (IPv4/IPv6)
- Regular IPv4: 10.0.0.0
- Wildcard IPv4: 10.0.0.* Oder sogar 10.*.0.*
- Regular IPv6: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
- Verkürzte IPv6: 2001:db8:85a3::8a2e:0370:7334 oder :: OR ::1 oder a::
- Wildcard IPv6: 2001::* oder sogar 2001::*:abc:*
- Gemischtes IPv6 (zugeordnetes IPv4) ::: ::ffff:127.0.0.1 (keine Wildcards im ipv4 -Teil erlaubt)
- Nicht erlaubt : 10.0.1*.0 oder 2001::a*c
IP -Bereich
- IPv4: 10.0.0.0-10.1.2.3
- IPv6: 2001::abc-2001::1:ffff
- Hinweis : Die linke Seite muss "niedriger" sein als die rechte Seite
IP -Subnetzwerk
- IPv4: 10.0.0.0/16
- IPv6: 2001::/123
IP -Maske
- IPv4: 10.0.0.0/255.0.64.0
- IPv6: 2001:abcd::/ffff:ff8::

Die IPMask -Methode des toString() vereinfacht nicht automatisch EG /255.0.0.0 bis /8 , obwohl diese gleichwertig sind. Seit 2.0.0 wird Ipmask eine Methode convertToSubnet() geliefert, die nach Möglichkeit ein äquivalentes ipsubNetwork zurückgibt, ansonsten undefined .

Vergleich mit ähnlichen Bibliotheken

Hier sind einige bekannte ähnliche NPM-Pakete und welche Funktionen sie haben, die uns fehlen und umgekehrt. In allen Fällen können Sie eine neue Funktion anfordern, wenn Sie der Meinung sind, dass es gut zu diesem Modul passt.

IP-Addesse

Unterstützt Dekodierung von Teredo -Informationen
Unterstützt das Lesen von Spezialeigenschaften (Multicast -Präfix, eindeutiges lokales Adresspräfix, ist Link Local, ...)
Unterstützt die Parsen von IPv6 -Adressen (und Ports) von URLs
Unterstützt die Parsen von IPv6 -ARPA -Adressen ( .ip6.arpa ) und Scoped (Zoned) Adressen
Unterstützt keine Wildcard -IP -Adressen
Unterstützt weder IP -Bereiche noch Masken (noch verwandte Methoden)
Unterstützt nicht, dass die Anzahl der IP -Adressen innerhalb des Subnetzes abgerufen wird
Unterstützt nicht, die vorherige/nächste IP -Adresse zu erhalten