Find where to report a domain for abuse
Project description
abuse_whois
Yet another way to find where to report an abuse.
This tool is highly inspired from the following libraries:
Requirements
- Python 3.10+
Installation
pip install abuse_whois
# or if you want to use built-in REST API
pip install abuse_whois[api]
Usage
As a library
from abuse_whois import get_abuse_contacts
await get_abuse_contacts("1.1.1.1")
await get_abuse_contacts("github.com")
await get_abuse_contacts("https://github.com")
await get_abuse_contacts("foo@example.com")
As a CLI tool
$ abuse_whois 1.1.1.1 | jq .
As a REST API
$ uvicorn abuse_whois.api.main:app
INFO: Started server process [2283]
INFO: Waiting for application startup.
INFO: Application startup complete.
INFO: Uvicorn running on http://127.0.0.1:8000 (Press CTRL+C to quit)
$ http localhost:8000/api/whois/ address=https://github.com
With Docker
git clone https://github.com/ninoseki/abuse_whois
cd abuse_whois
docker build . -t abuse-whois
docker run -i -d -p 8000:8000 abuse-whois
Settings
All settings can be done via environment variables or .env
file.
Name | Type | Default | Desc. |
---|---|---|---|
WHOIS_LOOKUP_TIMEOUT | int | 10 | Timeout value for whois lookup (seconds) |
WHOIS_LOOKUP_CACHE_SIZE | int | 1024 | Cache size for whois lookup |
WHOIS_LOOKUP_CACHE_TTL | int | 3600 | Cache TTL value for whois lookup (seconds) |
WHOIS_LOOKUP_MAX_RETRIES | int | 3 | Max retries on timeout error |
IP_ADDRESS_LOOKUP_TIMEOUT | int | 10 | Timeout value for IP address lookup (seconds) |
IP_ADDRESS_LOOKUP_CACHE_SIZE | int | 1024 | Cache size for IP address lookup |
IP_ADDRESS_LOOKUP_CACHE_TTL | int | 3600 | Cache TTL value for IP address lookup (seconds) |
RULE_EXTENSIONS | CommaSeparatedStrings | yaml,yml | Rule file extensions |
ADDITIONAL_WHOIS_RULE_DIRECTORIES | CommaSeparatedStrings | Additional directories contain whois rule files | |
ADDITIONAL_SHARED_HOSTING_RULE_DIRECTORIES | CommaSeparatedStrings | Additional directories contain shared hosting rule files |
Contributions
abuse_whois
works based on a combination of static rules and a parsing result of whois response.
Please submit a PR (or submit a feature request) if you find something missing.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
abuse_whois-0.7.2.tar.gz
(15.1 kB
view hashes)
Built Distribution
Close
Hashes for abuse_whois-0.7.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8c4aa647a52600826e4d48c002b7991c16102e1d707cf7f047e6a166d42aca68 |
|
MD5 | 5086824dafd20a30f4c2be5fa6eee86a |
|
BLAKE2b-256 | 4e3851579701de3e73cebc0dc5d7f5bea68c4ce0f527d0ac966c1bf532550da3 |