This repo allows to obtain data needed to run IP Intelligence examples:
- evidence files with lists of random IP addresses needed for some examples
- scripts to generate lists of random IP addresses like the above
- scripts to download 'Lite' IP Intelligence data file
- translation files to support translation engine and examples
The Lite data file is too large to commit to this repository, so one of the scripts below downloads it from 51Degrees storage instead:
| Script | Language | OS |
|---|---|---|
./get-lite-file-from-azure.ps1 |
PowerShell | Windows, Linux, macOS |
./get-lite-file-from-azure.sh |
Shell | Linux, macOS |
Run the script from this directory, because the examples and tests look for the file here:
cd ip-intelligence-data
./get-lite-file-from-azure.ps1The script downloads the archive as 51Degrees-LiteV41.ipi.gz (about 230 MB),
prints its MD5 hash and unpacks it to 51Degrees-LiteV41.ipi (about 460 MB)
in the directory it is run from. If the archive is already present the
download is skipped and the existing archive is unpacked again. Pass -Force
(PowerShell) or -f (shell) to download a fresh copy, for example when a new
monthly data file has been published. The shell script needs curl, gunzip
and md5sum (md5 on macOS) to be available.
The on-premise IP Intelligence data file for Asn properties.
The properties available in this file are:
- Asn
- AsnName
More properties are available as part of the Enterprise data file - contact us.
This file is updated monthly.
The 'lite' on-premise IP Intelligence data file.
The properties available in this file are:
- RegisteredCountry
- RegisteredName
- RegisteredOwner
More properties are available as part of the Enterprise data file - contact us.
This 'lite' file is built from a subsection of all IPs and is updated less frequently than the Enterprise IPI data file.
Convenience scripts to download (and unpack) data file, stored on Azure Blob Storage.
A script to re-/generate the "evidence" files (CSV/YML) with a designated number of random IPv4 and/or IPv6 addresses.
Useful invocations:
./evidence-gen.ps1 -v4 10000 -v6 10000 "evidence.yml"
./evidence-gen.ps1 -v4 10000 -v6 10000 -csv "evidence.csv"Pre-generated test files containing 20,000 of random IPs.
- evidence.csv - Each line contains a single IP.
- evidence.yml - A multi-record yaml file where each line contains the HTTP header name and value as the key/value pair. Values may be wrapped in single quotes.
Folder containing yaml files for translation of country names into several target languages. This data is used in examples and by the translation engine.
|--Translations | |--Translation Source (e.g. "OSM") | | |-- Translation File (e.g. "countries.fr_FR.yml")
Each translation file contains key-value pairs of "English country name: country name in target language".