{ "info": { "author": "Romain Bezut", "author_email": "blacknet@xdec.net", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: Implementation :: CPython" ], "description": "==========\nBlacknet 2\n==========\n\n.. image:: https://travis-ci.org/morian/blacknet.svg?branch=master\n :target: https://travis-ci.org/morian/blacknet\n\n.. image:: https://coveralls.io/repos/github/morian/blacknet/badge.svg?branch=master\n :target: https://coveralls.io/github/morian/blacknet?branch=master\n\n.. image:: https://img.shields.io/badge/license-MIT-blue.svg\n :target: https://github.com/morian/blacknet/blob/master/LICENSE\n\n\nWhat\n----\n\nBlacknet is a low interaction SSH multi-head honeypot system with logging\ncapabilities.\n\nYou can use it to gather all SSH attempts performed on multiple IPv4 address\nyou own on the internet and draw and export statistics out of it.\nA dedicated web interface allows live tracking of what happens on your\nhoneypots, which IP addresses are targeting you and from where.\n\n\nRequirements\n------------\n* Python dependencies:\n\t- CPython_ >= 2.7 or >= 3.4\n\t- MsgPack_\n\t- PyMySQL_\n\t- Paramiko_\n\n* MySQL Server:\n\t- MySQL_ (tested with only 5.2+)\n\t- MariaDB_\n\n.. _CPython: https://www.python.org\n.. _MsgPack: https://msgpack.org\n.. _PyMySQL: https://github.com/PyMySQL/PyMySQL\n.. _Paramiko: http://www.paramiko.org\n.. _MySQL: http://www.mysql.com/\n.. _MariaDB: https://mariadb.org/\n\n\nInstallation\n------------\nBlacknet provides two components, a SSH Server (sensor) and a master server.\nThe master server (blacknet-master) is where the database is located.\nThe SSH server (blacknet-sensor) is just a honeypot instance communicating with\nthe master server.\nPlease read --help from both commands and read blacknet.cfg.example carefully.\n\nYou need to generate SSL certificates in order to make blacknet work\ncorrectly over network stacks (please see next section).\n\n- Installation using ``pip``:\n $ pip install blacknet\n\n- Take a copy of blacknet.cfg.example and make your own configuration in\n ``/etc/blacknet/`` or ``${HOME}/.blacknet/``\n\n- Run `blacknet-install.sql`_ in your MySQL database.\n- You can update (and fill) the database with geolocation updates using\n the command ``blacknet-updater``.\n- You can also scrub your data to generate reports or perform metadata checks\n using ``blacknet-scrubber`` (please consult --help for details)\n- Command ``blacknet-scrubber`` might be best run in a crontab (with --quiet)\n- You might want to filter out some specific users for some or all honeypots.\n Please see blacklist.cfg.example and put it in an appropriate directory.\n\n.. _`blacknet-install.sql`: https://github.com/morian/blacknet/blob/master/share/blacknet-install.sql\n\n\nCreate your SSL certificates\n----------------------------\nPlease use EasyRSA_ or equivalent to generate your own PKI and deliver\ncertificates between your server and your honeypots.\n\n.. _EasyRsa: https://github.com/OpenVPN/easy-rsa\n\n.. code:: bash\n\n # First clone the easyrsa repository\n cd /tmp/\n git clone https://github.com/OpenVPN/easy-rsa.git\n\n # Then create a new Authority\n cd /tmp/easy-rsa/easyrsa3\n ./easyrsa init-pki\n\n # When asked provide a Common Name for your CA (eg: Blacknet CA)\n ./easyrsa build-ca nopass\n\n # Generate and sign a certificate for master server (here called maestro)\n ./easyrsa gen-req maestro nopass\n ./easyrsa sign server maestro\n\n # Same for sensors\n ./easyrsa gen-req honeypot_00 nopass\n ./easyrsa sign client honeypot_00\n\nPEM file format used by Blacknet starts with the private key and then\nconcatenates with the certificate (example bellow).\n\n.. code:: bash\n\n cat pki/private/maestro.key pki/issued/maestro.crt > maestro.pem\n\n\nHistory\n-------\nThe initial project featured a modified VirtualBox environment as a high\ninteraction honeypot, gathering commands and events such as password changes.\nWe then moved to supporting Kippo, a medium interaction SSH honeypot written\nin Python. Today's version uses a lightweight paramiko server as a\nlow-interaction honeypot since there are no more plans (and no more time) to\nhandle commands and events automatically\n(there are many security concerns around doing high interaction automatically).\nThe underlying MySQL schemes still refers to commands or events but they are\nmostly kept for backward compatibility reasons.\n\nIntegration with Cowrie_ should not be hard to extend Blacknet features and\nmake it highly interactive again.\n\nThis project was initially conducted during our engineering studies in 2010.\nIt was rewritten in 2017 to lower maintenance and installation efforts and to\nfit with modern python programming standards.\n\n.. _Cowrie: http://github.com/micheloosterhof/cowrie/\n\n\nCredits\n-------\n- Romain Bezut (2010, 2017)\n- Vivien Bernet-Rollande (2010)\n\n\nThanks\n------\n- We would like to thank the UTC_ (Universit\u00e9 de Technologie de Compi\u00e8gne).\n Our school brought us support and have made this project possible during\n class. Special thanks go to our teacher who supervised this project.\n- We would like to thank all our friends who helped finding issues and\n review this project in its early versions.\n- The hackers and bots who contributed in spite of themselves to this project.\n\n.. _UTC: https://www.utc.fr\n\n\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/morian/blacknet/", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "blacknet", "package_url": "https://pypi.org/project/blacknet/", "platform": "", "project_url": "https://pypi.org/project/blacknet/", "project_urls": { "Homepage": "http://github.com/morian/blacknet/" }, "release_url": "https://pypi.org/project/blacknet/2.0.9/", "requires_dist": [ "PyMySQL", "configparser", "msgpack-python", "paramiko" ], "requires_python": "", "summary": "Multi-head SSH honeypot system", "version": "2.0.9" }, "last_serial": 3133175, "releases": { "2.0.0": [ { "comment_text": "", "digests": { "md5": "5c38b7dab3c088dfef5ecf530e8e4467", "sha256": "e976756c3c4c725545785bbb3b8a5d02bc4f2311588a0a72cff76e08bfd3ecea" }, "downloads": -1, "filename": "blacknet-2.0.0-py2.7.egg", "has_sig": false, "md5_digest": "5c38b7dab3c088dfef5ecf530e8e4467", "packagetype": "bdist_egg", "python_version": "2.7", "requires_python": null, "size": 55011, "upload_time": "2017-05-21T21:44:07", "url": "https://files.pythonhosted.org/packages/a2/ce/8bf498e574f95b10b633b4ed5559bc954bf849bcdc9b75bf4f8d645ca83c/blacknet-2.0.0-py2.7.egg" }, { "comment_text": "", "digests": { "md5": "967a87d9bb4101cb0bb5db407e552986", "sha256": "61ed00d86db360604f73188dd2f2b534c990bf3440989e5de7fcd39fe45cf236" }, "downloads": -1, "filename": "blacknet-2.0.0.tar.gz", "has_sig": false, "md5_digest": "967a87d9bb4101cb0bb5db407e552986", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24631, "upload_time": "2017-05-21T21:41:36", "url": "https://files.pythonhosted.org/packages/d4/cc/b570d339a2d7783bc4f334fd1567bb530bf19ed02dce21140e08494c59d3/blacknet-2.0.0.tar.gz" } ], "2.0.2": [ { "comment_text": "", "digests": { "md5": "0ba97f4c2960cbb2dda5990754c5155b", "sha256": "282b37ec9eb84cfc764fa078916cb66b600e79ba40809207c8a88dd981a5f6dd" }, "downloads": -1, "filename": "BlackNet-2.0.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "0ba97f4c2960cbb2dda5990754c5155b", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 31261, "upload_time": "2017-06-03T13:12:59", "url": "https://files.pythonhosted.org/packages/b8/ef/cfbc7c263a85ee39172ff7f790d34f3765fde3b5f61e81390b936802985f/BlackNet-2.0.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3bc9738d9b6542980d3178f78f73e53d", "sha256": "50333ba6e72f927798f9e3e9b4be3ad5dc2e1b7c08eeb22e828bd1d2c8699bf9" }, "downloads": -1, "filename": "BlackNet-2.0.2.tar.gz", "has_sig": false, "md5_digest": "3bc9738d9b6542980d3178f78f73e53d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 32171, "upload_time": "2017-06-03T13:24:57", "url": "https://files.pythonhosted.org/packages/25/c6/b130fe4b4a149d26bd3ff7a4999ee7494bcb4563535013fb9c2763f8e548/BlackNet-2.0.2.tar.gz" } ], "2.0.3": [ { "comment_text": "", "digests": { "md5": "e87f1bcf2e98519f2af41d679e163efe", "sha256": "f875a819059a8fe5a3a5c20c3f7fe2633217eb04ca36820bef604f36585fa1b5" }, "downloads": -1, "filename": "blacknet-2.0.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e87f1bcf2e98519f2af41d679e163efe", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 31239, "upload_time": "2017-06-03T14:08:56", "url": "https://files.pythonhosted.org/packages/b7/8c/46dfee4abc6178c4c37bd2d6bbccb91a3359656ecf534216ceb1f46b7c65/blacknet-2.0.3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "e5a059ef4c4f2be8446376840e70c53c", "sha256": "679ec4e489eddf0c6dba3112f9c61921a970e3204721a16cf042bcf0c10317b4" }, "downloads": -1, "filename": "blacknet-2.0.3.tar.gz", "has_sig": false, "md5_digest": "e5a059ef4c4f2be8446376840e70c53c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29735, "upload_time": "2017-06-03T14:09:01", "url": "https://files.pythonhosted.org/packages/91/7f/78b00878680d9e1b0ae08fd0ea2b85049975da0201ca314be2178162af9b/blacknet-2.0.3.tar.gz" } ], "2.0.4": [ { "comment_text": "", "digests": { "md5": "e2d98769c6cfd78b5969d181240f17ab", "sha256": "79af11f933e88ee986f9cab6a70ec0e363e8fa9a763bf696f92a0fa68f9616ff" }, "downloads": -1, "filename": "blacknet-2.0.4-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e2d98769c6cfd78b5969d181240f17ab", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 38994, "upload_time": "2017-06-04T19:14:35", "url": "https://files.pythonhosted.org/packages/3d/61/cad927e41ba470ac68431f3559972e99f92163310df58bd71947e3555a74/blacknet-2.0.4-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "cdb58b93ef8ead0434dab782f3228171", "sha256": "d4cf957f189844ed8660f7293283646604a0224337d3de84c7c0413f55d82cc7" }, "downloads": -1, "filename": "blacknet-2.0.4.tar.gz", "has_sig": false, "md5_digest": "cdb58b93ef8ead0434dab782f3228171", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 27128, "upload_time": "2017-06-04T19:14:36", "url": "https://files.pythonhosted.org/packages/6d/da/abbf7ba473c1a6a1a288ecced71ba07aebb841ad00863eb02298a4a24655/blacknet-2.0.4.tar.gz" } ], "2.0.5": [ { "comment_text": "", "digests": { "md5": "cdfcc7268172f30e6729d1f4decc5c3f", "sha256": "65fcc7e088910f6dffbc598a103e03f42feed7a733c02222c5fca09600692cf9" }, "downloads": -1, "filename": "blacknet-2.0.5-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "cdfcc7268172f30e6729d1f4decc5c3f", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 39644, "upload_time": "2017-06-05T20:59:34", "url": "https://files.pythonhosted.org/packages/68/5f/d96ed34331c9cd201b47f53f4241e6ad0dc48a7a2a29a8cf596edfdb4465/blacknet-2.0.5-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f7a260e6325e79b6944513c932a98fc1", "sha256": "53cc9edb919ea008b65f192f1fa768a44aecebd52f4b2e3cd071548ba3ab37cb" }, "downloads": -1, "filename": "blacknet-2.0.5.tar.gz", "has_sig": false, "md5_digest": "f7a260e6325e79b6944513c932a98fc1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30904, "upload_time": "2017-06-05T20:59:37", "url": "https://files.pythonhosted.org/packages/2e/26/48d421d7daa37d5f526737c5cc1bab0bfbc1db771bded783b680a11c6ca7/blacknet-2.0.5.tar.gz" } ], "2.0.6": [ { "comment_text": "", "digests": { "md5": "81f412c55540784f2be630c37049b2e0", "sha256": "b4a2e92b29bd7d8fa15c9fcd6754c397ce3c45f0a5c8e6fa1bd0ca6a46bccd52" }, "downloads": -1, "filename": "blacknet-2.0.6-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "81f412c55540784f2be630c37049b2e0", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 32886, "upload_time": "2017-06-07T21:17:45", "url": "https://files.pythonhosted.org/packages/7b/b6/9039b6702705d2ae94a206e060500cdfff0e3a76c7d6e31e180524e344c7/blacknet-2.0.6-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ae82c0c8a4567aab7de9d1c858a8a076", "sha256": "e0a9162b3b3db8b98e53c00c311cdc1e657447e84ca885f24fe1297365a3cf31" }, "downloads": -1, "filename": "blacknet-2.0.6.tar.gz", "has_sig": false, "md5_digest": "ae82c0c8a4567aab7de9d1c858a8a076", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 29041, "upload_time": "2017-06-07T21:17:46", "url": "https://files.pythonhosted.org/packages/1a/e7/d338c2cbd2ada4b5fead9afdf216cef32d30cd61466a4cd228a515ebf349/blacknet-2.0.6.tar.gz" } ], "2.0.7": [ { "comment_text": "", "digests": { "md5": "f7195c950e74177241df270020e059ff", "sha256": "b040d2533770df32cab881b43b6cd413053ee7ae16b1e1941c3378fa425db95e" }, "downloads": -1, "filename": "blacknet-2.0.7-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "f7195c950e74177241df270020e059ff", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 33055, "upload_time": "2017-06-10T11:31:51", "url": "https://files.pythonhosted.org/packages/7d/0f/17a68e1f5cd74241da51ed78c90aebb2e271ab7a7078391eb199703b24c7/blacknet-2.0.7-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "0bcf6354fdba52243ad42958b4ef2659", "sha256": "4425634094bcf0a9f63e3a15f30c9413d4b53ae28300efa1c016ea0b9efd2815" }, "downloads": -1, "filename": "blacknet-2.0.7.tar.gz", "has_sig": false, "md5_digest": "0bcf6354fdba52243ad42958b4ef2659", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 31718, "upload_time": "2017-06-10T11:31:53", "url": "https://files.pythonhosted.org/packages/e9/65/3c56b5e55665117c8eedbbd6bb325c3fe315b8396bc84769a8934e5528d2/blacknet-2.0.7.tar.gz" } ], "2.0.8": [ { "comment_text": "", "digests": { "md5": "7c7b1dcd4711c07dc5e23230907f601c", "sha256": "b133f79a0602127b34b61bbb80654ad583b934f7480b4131749b5f18ad903a16" }, "downloads": -1, "filename": "blacknet-2.0.8-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "7c7b1dcd4711c07dc5e23230907f601c", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 33477, "upload_time": "2017-08-20T21:16:24", "url": "https://files.pythonhosted.org/packages/01/dd/f7c15b19a1dfc3fd5c8059f67ad5fbe2328885d346a5d0b84cb1c478b7dc/blacknet-2.0.8-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "428266ce891e79987c2b2f821f55ddf9", "sha256": "69572e934d6b0b105dd768561a4964df4185b485ce683b1b47f0d7e6c2be8df4" }, "downloads": -1, "filename": "blacknet-2.0.8.tar.gz", "has_sig": false, "md5_digest": "428266ce891e79987c2b2f821f55ddf9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 34011, "upload_time": "2017-08-20T21:16:26", "url": "https://files.pythonhosted.org/packages/27/4d/5a804cdac0217c3a848354f1bc2fe20164e46ef49bda25c6d3f63384ecc0/blacknet-2.0.8.tar.gz" } ], "2.0.9": [ { "comment_text": "", "digests": { "md5": "63d6db4772fb124116db86aeb7897ebc", "sha256": "6ab9263a81ec1befb06a7a18f53888d2ae38697f920a68ae6921ab3f46996d67" }, "downloads": -1, "filename": "blacknet-2.0.9-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "63d6db4772fb124116db86aeb7897ebc", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 33733, "upload_time": "2017-08-29T21:51:06", "url": "https://files.pythonhosted.org/packages/1f/ef/0ba4a0d1bcdb741f21843ebf970a8571a7b8c2fcf365ba94bbf885c4253f/blacknet-2.0.9-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "94bb2d4d3edbee5bb8ee92fbe86dd6db", "sha256": "54289e87fe4791e9ad322184e2a1e3f53f0c5fec0ad22f1677b032c86b29969f" }, "downloads": -1, "filename": "blacknet-2.0.9.tar.gz", "has_sig": false, "md5_digest": "94bb2d4d3edbee5bb8ee92fbe86dd6db", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30045, "upload_time": "2017-08-29T21:51:09", "url": "https://files.pythonhosted.org/packages/fb/e5/6a90c224eabfa892b58ab0f4960f16883b2e4d9ffa8722ff5f83ee341675/blacknet-2.0.9.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "63d6db4772fb124116db86aeb7897ebc", "sha256": "6ab9263a81ec1befb06a7a18f53888d2ae38697f920a68ae6921ab3f46996d67" }, "downloads": -1, "filename": "blacknet-2.0.9-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "63d6db4772fb124116db86aeb7897ebc", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 33733, "upload_time": "2017-08-29T21:51:06", "url": "https://files.pythonhosted.org/packages/1f/ef/0ba4a0d1bcdb741f21843ebf970a8571a7b8c2fcf365ba94bbf885c4253f/blacknet-2.0.9-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "94bb2d4d3edbee5bb8ee92fbe86dd6db", "sha256": "54289e87fe4791e9ad322184e2a1e3f53f0c5fec0ad22f1677b032c86b29969f" }, "downloads": -1, "filename": "blacknet-2.0.9.tar.gz", "has_sig": false, "md5_digest": "94bb2d4d3edbee5bb8ee92fbe86dd6db", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30045, "upload_time": "2017-08-29T21:51:09", "url": "https://files.pythonhosted.org/packages/fb/e5/6a90c224eabfa892b58ab0f4960f16883b2e4d9ffa8722ff5f83ee341675/blacknet-2.0.9.tar.gz" } ] }