ip matching

IP-correspondance

Module autonome avec des fonctionnalités pratiques concernant les IP:

• Moyen rapide et facile à utiliser pour vérifier si une IP répond à une exigence
• Prise en charge des adresses, des gammes, des sous-réseaux et des masques IPv4 / IPv6.
• Prend en charge à la fois l'analyse et la sortie de toutes les notations IPv6 courantes
• Méthodes d'utilité, par exemple IP suivant / précédente, plage à une liste de CIDRS, ...
• Chaque version est entièrement testée et lignée avant la publication

Installation

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

Livré avec ses propres déclarations de dactylographie intégrées avec une documentation incluse.

Exemple

 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'

Remarque : la fonction matches et tous les constructeurs pour les entrées non valides

Vous pouvez jeter un œil au code de test ou aux déclarations de typeScript pour toutes les fonctionnalités.

Motifs autorisés

• Ip (ipv4 / ipv6)
  • IPv4 ordinaire: 10.0.0.0
  • Wildcard IPv4: 10.0.0.* Ou même 10.*.0.*
  • IPv6 régulier: 2001:0db8:85a3:0000:0000:8a2e:0370:7334
  • IPv6 raccourci: 2001:db8:85a3::8a2e:0370:7334 ou :: ou ::1 ou a::
  • Wildcard IPv6: 2001::* ou même 2001::*:abc:*
  • IPv6 mixte (IPv4 mappé): ::ffff:127.0.0.1 (pas de caractères génériques autorisés dans la pièce IPv4)
  • Non autorisé : 10.0.1*.0 ou 2001::a*c
• Gamme IP
  • IPv4: 10.0.0.0-10.1.2.3
  • IPv6: 2001::abc-2001::1:ffff
  • Remarque : le côté gauche doit être "plus bas" que le côté droit
• Sous-réseau IP
  • IPv4: 10.0.0.0/16
  • IPv6: 2001::/123
• Masque IP
  • IPv4: 10.0.0.0/255.0.64.0
  • IPv6: 2001:abcd::/ffff:ff8::

La méthode toString() de l'IPMask ne simplifie pas automatiquement EG /255.0.0.0 à /8 , même si celles-ci sont équivalentes. Depuis 2.0.0, IPMask est livré avec une méthode convertToSubnet() qui renvoie un IPSubNetwork équivalent si possible, autrement undefined .

Comparaison avec des bibliothèques similaires

Voici quelques packages NPM similaires bien connus et les fonctionnalités qu'ils ont qui nous manquent et vice versa. Dans tous les cas, n'hésitez pas à demander une nouvelle fonctionnalité si vous pensez que c'est un bon ajustement pour ce module.

adresse IP

• Prend en charge le décodage des informations Teredo
• Prend en charge la lecture de propriétés spéciales (préfixe de multidiffusion, préfixe d'adresse locale unique, est lien local, ...)
• Prend en charge l'analyse des adresses (et ports) IPv6 à partir des URL
• Prend en charge l'analyse des adresses ARPA IPv6 ( .ip6.arpa ) et des adresses étendus (zoné)
• Ne prend pas en charge les adresses IP génériques
• Ne prend pas en charge les gammes IP ou les masques (ni aucune méthode connexe)
• Ne prend pas en charge l'obtention du nombre d'adresses IP dans le sous-réseau
• Ne prend pas en charge l'obtention de la précédente / à côté d'une adresse IP

IP

• Abandonné depuis plus de 4 ans (depuis début 2017)
• Prend en charge la récupération de l'adresse IP locale
• Prend en charge les adresses IP non / ou entre les adresses IP
• Prend en charge les adresses IPv4 / IPv6 régulières
• Prend en charge les sous-réseaux IPv4 (avec des propriétés de sous-réseau)
• Ne prend pas en charge les adresses IP génériques ou les sous-réseaux IPv6
• Ne prend pas en charge les gammes IP ou les masques (ni aucune méthode connexe)
• Ne prend pas en charge l'obtention de la précédente / à côté d'une adresse IP

masque de file

• Prend en charge uniquement les blocs IPv4 CIDR (avec des informations de sous-réseau)
• Prend en charge l'obtention du prochain sous-réseau de la même taille
• Prend en charge la vérification si un sous-réseau fait partie d'un autre
• Ne prend rien d'autre que les sous-réseaux IPv4

Links

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