Service to look up IP addresses in a predetermined subset of IP Lists by the FireHOL team.
See design document.
To use this service, it's necessary to have AWS configured locally. If you use the AWS CLI, for example, then that'd be the case.
Run npm run ipset-update.
It will push the serialised BST to Amazon S3. To customise the target, set the following environment variables:
AUTH0_IPSET_BUCKET(default:auth0-firehol-ipset).AUTH0_IPSET_OBJECT_KEY(default:bst.json).
The supported IP lists are available as constants in auth0-ipset-updater.js.
To start the web application server, run npm run ipset-serve. The server
will report when it's ready to start accepting connections -- That is, once
the dataset has been retrieved from Amazon S3.
To look up an IP address, you should make a request to the root of the application with the IP address included in the query string; e.g.:
curl -v 'http://localhost:8080/?ip=37.9.53.1'The service shall respond with 204 "No Content" if the IP address was found in the dataset, or 404 "Not Found" otherwise. Additionally, a 400 "Bad Request" is returned if no IP address is passed.