Metadata-Version: 2.1
Name: hibp-harvester
Version: 1.0.7
Summary: A python tool to harvest haveibeenpwned.com via domain search
Home-page: https://github.com/security-companion/hibp-harvester
Author: Joachim Mammele
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click
Requires-Dist: requests

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)![Gitub Actions](https://github.com/security-companion/hibp-harvester/actions/workflows/python-app.yml/badge.svg)![Python](https://img.shields.io/badge/programming_language-python-blue)
# hibp-harvester
A python tool to harvest haveibeenpwned.com via domain search

## Setup

* add your domains to the domain search dashboard on haveibeenpwend.com
* purchase a subscription to get an API key
* run pip install hibp-harvester
* run hibp-harvester --api_key xxxx  --wait_time 3
* open created csv-file eg. in Excel
* filter for single breach names so that you can inform users about eg. latest breach or filter for dates

Please do not run the harvester too often. 
haveibeenpwned informs you automatically about new breaches via mail for verified domains. If you get a mail about new breach then you can run the script once to get an updated csv-file which you can then filter

## Todo

Add automated tests, will be done once a test API key is avaiable, see [uservoice](https://haveibeenpwned.uservoice.com/forums/275398-general/suggestions/48189713-implement-test-api-key-for-automated-domain-search)

## Contributions
Contributions are always welcome, please open a pull request or an issue

## Author

hibp-harvester is developed and maintained by [Joachim Mammele](https://security-companion.net)
