{ "info": { "author": "Tek", "author_email": "tek@randhome.io", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# pybinaryedge\n\nPython 3 Wrapper for the BinaryEdge API https://www.binaryedge.io/. See the [APIv2 documentation](https://docs.binaryedge.io/api-v2/) for more information, or the documentation for this library on [Read the Docs](https://pybinaryedge.readthedocs.io/en/latest/index.html).\n\n## Installation\n\nTo install this tool, it is recommended to use [virtual environments](https://docs.python.org/3/tutorial/venv.html).\n\nYou can install it directly from [pypi](https://pypi.org/) with `pip install pybinaryedge`.\n\nYou can Then you can install it directly from sources :\n```\ngit clone https://github.com/Te-k/pybinaryedge.git\ncd pybinaryedge\npip install .\n```\n\nIf you use [pipenv](https://pipenv.readthedocs.io/en/latest/), you can run instead :\n```\ngit clone https://github.com/Te-k/pybinaryedge.git\ncd pybinaryedge\npipenv install\n```\n\nYou need to have an account on the [Binary Edge platform](https://www.binaryedge.io/), create an API key, and configure the CLI tool to use it with `binaryedge config --key KEY`\n\n## API\n\nSee the documentation on [Read the Docs](https://pybinaryedge.readthedocs.io/en/latest/index.html).\n\nExample :\n```python\nfrom pybinaryedge import BinaryEdge\n\nbe = BinaryEdge(API_KEY)\n# Iterate over the first page of IPs having specific ssh configuration\nsearch = 'ssh.algorithms.encryption.keyword:\"aes256-cbc\" ssh.banner.keyword:\"SSH-2.0-OpenSSH_LeadSec\"'\nresults = be.host_search(search)\nfor ip in results['events']:\n print(\"%s\" %(ip['target']['ip']))\n```\n\nList of functions implemented :\n* `host(IP)` : [Details about an Host](https://docs.binaryedge.io/api-v2/#v2queryiptarget)\n* `host_historical(IP)` : [Details about an Host, with data up to 6 months](https://docs.binaryedge.io/api-v2/#v2queryiphistoricaltarget)\n* `host_search(QUERY, PAGE)` : [List of recent events for the given query](https://docs.binaryedge.io/api-v2/#v2querysearch)\n* `host_score(IP)` : [IP Scoring of an host.](https://docs.binaryedge.io/api-v2/#v2queryscoreiptarget)\n* `host_vulnerabilities(IP)` : list of CVE vulnerabilities that may affect a host\n* `image_ip(IP)` : [Details about Remote Desktops found on an Host](https://docs.binaryedge.io/api-v2/#v2queryimageipip)\n* `image_search(QUERY, PAGE)` : [Remote Desktops based on a Query](https://docs.binaryedge.io/api-v2/#v2queryimagesearch)\n* `image_tags()` : [Get the list of possible tags for the images](https://docs.binaryedge.io/api-v2/#v2queryimagetags)\n* `torrent_ip(IP)` : [Details about torrents transferred by an Host](https://docs.binaryedge.io/api-v2/#v2querytorrentiptarget)\n* `torrent_historical_ip(IP)` : [Details about torrents transferred by an Host, with data up to 6 months](https://docs.binaryedge.io/api-v2/#v2querytorrenthistoricaltarget)\n* `dataleaks_email(EMAIL)` : [Verify which dataleaks affect the target email](https://docs.binaryedge.io/api-v2/#v2querydataleaksemailemail)\n* `dataleaks_organization(DOMAIN)` : [Verify how many emails are affected by dataleaks for a specific domain](https://docs.binaryedge.io/api-v2/#v2querydataleaksorganizationdomain)\n* `dataleaks_info()` : [Get the list of dataleaks our platform keeps track.](https://docs.binaryedge.io/api-v2/#v2querydataleaksinfo)\n* `domain_subdomains(DOMAIN, PAGE)` : [Return list of subdomains known from the target domain](https://docs.binaryedge.io/api-v2/#v2querydomainssubdomaintarget)\n* `domain_dns(DOMAIN, PAGE)` : [Return list of dns results known from the target domain.](https://docs.binaryedge.io/api-v2/#v2querydomainsdnstarget)\n* `domain_ip(IP, PAGE)`: [Return records that have the specified IP in their A or AAAA records.](https://docs.binaryedge.io/api-v2/#v2querydomainsiptarget)\n* `sensor_ip(TARGET)`: [Details about an Scanner. List of recent events form the specified host, including details of scanned ports, payloads and tags.](https://docs.binaryedge.io/api-v2/#v2querysensorsiptarget)\n* `sensor_search(QUERY, PAGE)`: [Events based on a Query.](https://docs.binaryedge.io/api-v2/#v2querysensorssearch)\n* `sensor_search_status(QUERY, TYPE, DAYS)`: [Statistics of events for the given query.](https://docs.binaryedge.io/api-v2/#v2querysensorssearchstats)\n: `stats(QUERY, TYPE, PAGE)`: [Statistics of recent events for the given query.](https://docs.binaryedge.io/api-v2/#v2querysearchstats)\n\n## CLI\n\nThis library also implements a CLI binaryedge tool :\n```\nusage: binaryedge [-h] {config,ip,search,dataleaks} ...\n\nRequest BinaryEdge API\n\npositional arguments:\n {config,ip,search,dataleaks}\n Commands\n config Configure pybinary edge\n ip Query an IP address\n search Search in the database\n dataleaks Search in the leaks database\n domains Search information on a domain\n\noptional arguments:\n -h, --help show this help message and exit\n```\n\nExample :\n```\n$ binaryedge config --key KEY\n$ binaryedge ip -i 149.202.178[.]130\n{\n \"events\": [\n {\n \"port\": 27017,\n \"results\": [\n {\n \"origin\": {\n \"country\": \"sg\",\n \"ip\": \"172.104.173.35\",\n \"module\": \"grabber\",\n \"ts\": 1536782325059,\n \"type\": \"service-simple\"\n[SNIP]\n```\n\n## Changelog\n\n* 0.5 : fix bugs in the doc and code. Add support for `host_vulnerabilities`\n* 0.4: Add support for [BinaryEdge sensors](https://docs.binaryedge.io/api-v2/#v2querysensorsiptarget)\n\n## License\n\nThis code is published under MIT license", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Te-k/pybinaryedge", "keywords": "osint", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "pybinaryedge", "package_url": "https://pypi.org/project/pybinaryedge/", "platform": "", "project_url": "https://pypi.org/project/pybinaryedge/", "project_urls": { "Homepage": "https://github.com/Te-k/pybinaryedge" }, "release_url": "https://pypi.org/project/pybinaryedge/0.5/", "requires_dist": null, "requires_python": "", "summary": "Python 3 Wrapper for the binary edge API https://www.binaryedge.io/", "version": "0.5" }, "last_serial": 4930743, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "28bb180459b9b4a1a05458d0cb612df3", "sha256": "094ab2080d73575e59967cf5e6f9095e5fd51ef25c76a62b3944cb13c86fe91a" }, "downloads": -1, "filename": "pybinaryedge-0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "28bb180459b9b4a1a05458d0cb612df3", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 5711, "upload_time": "2018-12-03T00:01:36", "url": "https://files.pythonhosted.org/packages/e6/fb/f9dc8d232cac1bc55495f6352481d2bb64b20345344bb8edea642b89e0ae/pybinaryedge-0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e0b6428cf86a45f506894748c567fa66", "sha256": "cff00d74609f6b7ff57c26755a182b3ecc8d9ee4ed48cc0a7ae84d51b2dfd4c0" }, "downloads": -1, "filename": "pybinaryedge-0.1.tar.gz", "has_sig": false, "md5_digest": "e0b6428cf86a45f506894748c567fa66", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4954, "upload_time": "2018-12-03T00:01:38", "url": "https://files.pythonhosted.org/packages/51/ae/307cf8bd438eec2152d9ccab75705ce244788ca63c1aae7758da294fde4d/pybinaryedge-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "628045a0d0515db14a433cf3d62e8529", "sha256": "561e6ce121a724dfea7b882268a19af35b21619e71882d2a422a2e7d9166e8a7" }, "downloads": -1, "filename": "pybinaryedge-0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "628045a0d0515db14a433cf3d62e8529", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7593, "upload_time": "2018-12-12T22:22:17", "url": "https://files.pythonhosted.org/packages/34/97/6d823a29a0a71df243db849da52ef81e5eefa58803057ad94336fbeb4c2c/pybinaryedge-0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b49a0e426ec2aaf3ef78978e20f25c80", "sha256": "c7c3b90db3611e19aab94bc0c833ede98f5e8fe0278bb50e00a55ffce785d0c6" }, "downloads": -1, "filename": "pybinaryedge-0.2.tar.gz", "has_sig": false, "md5_digest": "b49a0e426ec2aaf3ef78978e20f25c80", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5809, "upload_time": "2018-12-12T22:22:18", "url": "https://files.pythonhosted.org/packages/5c/ef/e6d95179eef7f338515399a4a2d8b9884480f340bb9ba91de9b530d82dab/pybinaryedge-0.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "a5c2709cb0570fc310868680bfa424a8", "sha256": "1e9d8d875ef66cb1132214e72bad3ad2be5a711dd81cfcbce6452f605decdc42" }, "downloads": -1, "filename": "pybinaryedge-0.3-py3-none-any.whl", "has_sig": false, "md5_digest": "a5c2709cb0570fc310868680bfa424a8", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7808, "upload_time": "2019-01-24T21:34:06", "url": "https://files.pythonhosted.org/packages/57/e7/45f782dcfecfdbbe2a93bcd17e440768a052f1f050e04631d158129e5352/pybinaryedge-0.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "c4b789eecf39985bde19664b1bf1adac", "sha256": "016404cd8c5b8c72601c711b952ac325c7141771b8b2218e1f393fc060339d51" }, "downloads": -1, "filename": "pybinaryedge-0.3.tar.gz", "has_sig": false, "md5_digest": "c4b789eecf39985bde19664b1bf1adac", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6525, "upload_time": "2019-01-24T21:34:08", "url": "https://files.pythonhosted.org/packages/b9/e3/ca3cf797e2e00d3811c953c4e92e6768cc8a4df91a3daf97ee5f7b92cc99/pybinaryedge-0.3.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "7a726fc333edebb484cb4c51c739f10a", "sha256": "dce8d50628263ce1fd678a8e2eebc7db1da54dfc0944c397386b9e6eba058ec9" }, "downloads": -1, "filename": "pybinaryedge-0.4-py3-none-any.whl", "has_sig": false, "md5_digest": "7a726fc333edebb484cb4c51c739f10a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8432, "upload_time": "2019-02-13T15:14:55", "url": "https://files.pythonhosted.org/packages/b6/09/79eef2119aa7dc0b93e291878dcbfd4dbe6bf73b1f46231cce1a039371a3/pybinaryedge-0.4-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "094374f6e66b4dd6b7c8fbe195b3086d", "sha256": "9cac9a22053893f88aed7f326a689b86895e1085b1fee743837419a1534822ee" }, "downloads": -1, "filename": "pybinaryedge-0.4.tar.gz", "has_sig": false, "md5_digest": "094374f6e66b4dd6b7c8fbe195b3086d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7236, "upload_time": "2019-02-13T15:14:57", "url": "https://files.pythonhosted.org/packages/4c/5f/054cfa6971052316e6d09382b41c9e9d6e3c8512a8d98c5bffae8ca9e574/pybinaryedge-0.4.tar.gz" } ], "0.5": [ { "comment_text": "", "digests": { "md5": "eafabdfc8683859894f49bc15779692e", "sha256": "00cf2f253aa44c7d6589a56d70c5b820a5060c3a0a2aee018f0b4ed732fe7632" }, "downloads": -1, "filename": "pybinaryedge-0.5.tar.gz", "has_sig": false, "md5_digest": "eafabdfc8683859894f49bc15779692e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7351, "upload_time": "2019-03-12T15:52:04", "url": "https://files.pythonhosted.org/packages/f0/fe/a6720295e366f1571d521cd8a2745e74a0ca058611d54ca7e1a3634bd4a1/pybinaryedge-0.5.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "eafabdfc8683859894f49bc15779692e", "sha256": "00cf2f253aa44c7d6589a56d70c5b820a5060c3a0a2aee018f0b4ed732fe7632" }, "downloads": -1, "filename": "pybinaryedge-0.5.tar.gz", "has_sig": false, "md5_digest": "eafabdfc8683859894f49bc15779692e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7351, "upload_time": "2019-03-12T15:52:04", "url": "https://files.pythonhosted.org/packages/f0/fe/a6720295e366f1571d521cd8a2745e74a0ca058611d54ca7e1a3634bd4a1/pybinaryedge-0.5.tar.gz" } ] }