Python 3 Wrapper for the binary edge API https://www.binaryedge.io/
Project description
pybinaryedge
Python 3 Wrapper for the BinaryEdge API https://www.binaryedge.io/. See the APIv2 documentation for more information.
Installation
To install this tool, it is recommended to use virtual environments.
You can install it directly from pypi with pip install pybinaryedge
.
You can Then you can install it directly from sources :
git clone https://github.com/Te-k/pybinaryedge.git
cd pybinaryedge
pip install .
If you use pipenv, you can run instead :
git clone https://github.com/Te-k/pybinaryedge.git
cd pybinaryedge
pipenv install
You need to have an account on the Binary Edge platform, create an API key, and configure the CLI tool to use it with binaryedge config --key KEY
API
Example :
from pybinaryedge import BinaryEdge
be = BinaryEdge(API_KEY)
# Iterate over the first page of IPs having specific ssh configuration
search = 'ssh.algorithms.encryption.keyword:"aes256-cbc" ssh.banner.keyword:"SSH-2.0-OpenSSH_LeadSec"'
for ip in be.host_search(search):
print('%s': % ip['origin']['ip'])
List of functions implemented :
host(IP)
: Details about an Hosthost_historical(IP)
: Details about an Host, with data up to 6 monthshost_search(QUERY, PAGE)
: List of recent events for the given queryhost_score(IP)
: IP Scoring of an host.image_ip(IP)
: Details about Remote Desktops found on an Hostimage_search(QUERY, PAGE)
: Remote Desktops based on a Queryimage_tags()
: Get the list of possible tags for the imagestorrent_ip(IP)
: Details about torrents transferred by an Hosttorrent_historical_ip(IP)
: Details about torrents transferred by an Host, with data up to 6 monthsdataleaks_email(EMAIL)
: Verify which dataleaks affect the target emaildataleaks_organization(DOMAIN)
: Verify how many emails are affected by dataleaks for a specific domaindataleaks_info()
: Get the list of dataleaks our platform keeps track.domain_subdomains(DOMAIN, PAGE)
: Return list of subdomains known from the target domaindomain_dns(DOMAIN, PAGE)
: Return list of dns results known from the target domain.domain_ip(IP, PAGE)
: Return records that have the specified IP in their A or AAAA records.
CLI
This library also implements a CLI binaryedge tool :
usage: binaryedge [-h] {config,ip,search,dataleaks} ...
Request BinaryEdge API
positional arguments:
{config,ip,search,dataleaks}
Commands
config Configure pybinary edge
ip Query an IP address
search Search in the database
dataleaks Search in the leaks database
domains Search information on a domain
optional arguments:
-h, --help show this help message and exit
Example :
$ binaryedge config --key KEY
$ binaryedge ip -i 149.202.178[.]130
{
"events": [
{
"port": 27017,
"results": [
{
"origin": {
"country": "sg",
"ip": "172.104.173.35",
"module": "grabber",
"ts": 1536782325059,
"type": "service-simple"
[SNIP]
License
This code is published under MIT license
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pybinaryedge-0.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 561e6ce121a724dfea7b882268a19af35b21619e71882d2a422a2e7d9166e8a7 |
|
MD5 | 628045a0d0515db14a433cf3d62e8529 |
|
BLAKE2b-256 | 34976d823a29a0a71df243db849da52ef81e5eefa58803057ad94336fbeb4c2c |