Skip to main content

IP to AS routing data query script

Project description

# aslookup Python client for IP to ASN lookup services

aslookup is a client utility for two of the public IP/AS query services operated by the following organizations:

The client implements both a simple Python module (aslookup) as well as a CLI utility (as-lookup). The lookups are currently done using DNS, which works well for a one-off lookups. It is not optimized for bulk lookups over the Whois protocol.

Currently only IPv4 addresses are looked up. The client also maintains a listing of IP networks which are unroutable internet addresses, typically special use ranges in RFCs. In this way it can both filter out addresses from queries which are a waste of time, as well as provide context to the user on the address.

## Installation

The app has been tested on Python 3. The script requires the dnspython package. If missing, it will be installed automatically.

It’s best to install the program into a Python virtualenv.

Recommended installation using pip (make sure to use the pip or python command from your target Python 3 environment)!

pip install .

…or:

python3 setup.py install

## Usage

### Python module

The Python module defaults to querying the Shadowserver data service. The desired service may be specified by passing the service parameter to get_as_data.

`python from aslookup import get_as_data ip = '8.8.8.8' get_as_data(ip, service='cymru') `

### CLI script

It is possible to provide multiple IP addresses as arguments to the script, or to send them as a list on standard input, in which cases the script loops over them and returns output on separate lines. When providing invalid IPv4 addresses as arguments, the script reports the problem on standard error and exits with an error. When providing input on stdin, the error is reported on standard output but execution is not aborted.

as-lookup 8.8.8.8 11.22.33.44

### Test data

A list of test values for the script is included in the file test_input.txt. This can be useful to validate included IP prefix classifications and see the output format.

as-lookup < test_input.txt

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aslookup, version 1.0.2
Filename, size File type Python version Upload date Hashes
Filename, size aslookup-1.0.2-py3-none-any.whl (10.9 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size aslookup-1.0.2.tar.gz (5.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page