ip-validator

A simple library for validating IP address ranges against a blacklist/whitelist

License	GPL v3
Categories	Ant Build Tools
GroupId	com.github.philanthropix
ArtifactId	ip-validator
Last Version	0.0.3
Release Date	Aug 30, 2014
Type	jar
Description	ip-validator A simple library for validating IP address ranges against a blacklist/whitelist
Project URL	https://github.com/philanthropix/ip-validator
Source Code Management	https://github.com/philanthropix/ip-validator

Download ip-validator

Filename	Size
ip-validator-0.0.3.pom
ip-validator-0.0.3.jar	11 KB
ip-validator-0.0.3-sources.jar	6 KB
ip-validator-0.0.3-javadoc.jar	70 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.github.philanthropix/ip-validator/ -->
<dependency>
    <groupId>com.github.philanthropix</groupId>
    <artifactId>ip-validator</artifactId>
    <version>0.0.3</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.github.philanthropix/ip-validator/
implementation 'com.github.philanthropix:ip-validator:0.0.3'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.github.philanthropix/ip-validator/
implementation ("com.github.philanthropix:ip-validator:0.0.3")

Apache Buildr

'com.github.philanthropix:ip-validator:jar:0.0.3'

Apache Ivy

<dependency org="com.github.philanthropix" name="ip-validator" rev="0.0.3">
  <artifact name="ip-validator" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.github.philanthropix', module='ip-validator', version='0.0.3')
)

Scala SBT

libraryDependencies += "com.github.philanthropix" % "ip-validator" % "0.0.3"

Leiningen

[com.github.philanthropix/ip-validator "0.0.3"]

Dependencies

compile (2)

Group / Artifact	Type	Version
com.fasterxml.jackson.core : jackson-core	jar	2.2.2
com.fasterxml.jackson.core : jackson-databind	jar	2.2.2

test (1)

Group / Artifact	Type	Version
junit : junit	jar	4.8.1

Project Modules

There are no modules declared in this project.

ip-validator

A simple java library for Blacklisting / Whiltelisting IP addresses based upon a hierarchical JSON configuration

Getting ip-validator

The latest release of ip-validator is in maven central

Adding to your pom.xml

<dependency>
    <groupId>com.github.philanthropix</groupId>
    <artifactId>ip-validator</artifactId>
    <version>0.0.3</version>
</dependency>

Building ip-validator

This project should build with JDK 6 and above, and Maven 3

No special processes required, just standard a Maven build command:

mvn clean package

Dependencies

ip-validator uses jackson to parse the JSON configuration file

To use

This library is very simple to use.

1. First create a JSON file with the CIDR addresses you want to whitelist or blacklist
2. Create an instance of the RuleTree class using the RuleTreeFactory class like so:

InputStream is; //get an input stream for the JSON config file you created 

RuleTree ruleTree = RuleTreeFactory.createRuleTree(is);

3. Validate IP addresses against the whitelist/blacklist

if (ruleTree.validateIp("10.1.1.33")) {
	//do some cool stuff
}

JSON config file

The config file uses the followng format

{
 "entries" : [
   {
     "network" : "10.1.1.55",
     "cidr" : "24",
     "allowed" : true
   }
 ]
}

Versions

Version
0.0.3 Aug 30, 2014