httpbl

Project Honeypot Http:BL API Client


Keywords
honeypot, client, httpbl, python
License
BSD-3-Clause
Install
pip install httpbl==1.0.1

Documentation

httpbl

Project Honeypot Http:BL API Package

Requires a Http:BL API key from https://www.projecthoneypot.org/

Version Status Coverage License

Response Format

dict with keys:

  • days_since_last_activity
  • name
  • threat_score
  • types - a list of visitor types (int values)

The list types are enumerated in the module:

  • httpbl.COMMENT_SPAMMER
  • httpbl.HARVESTER
  • httpbl.SEARCH_ENGINE
  • httpbl.SUSPICIOUS

Text descriptions are available in the httpbl.DESCRIPTIONS dict.

Example

import httpbl

ip_address = '127.5.20.3'

bl = httpbl.HttpBL('my-key')
response = bl.query(ip_address)

print('IP Address: {}'.format(ip_address)
print('Threat Score: {}'.format(response['threat_score'])
print('Days since last activity: {}'.format(response['days_since_last_activity'])
print('Visitor type: {}'.format(', '.join([httpbl.DESCRIPTIONS[t] for t in response['type']]))