{ "info": { "author": "byt3bl33d3r", "author_email": "byt3bl33d3r@gmail.com", "bugtrack_url": null, "classifiers": [ "Programming Language :: Python :: 2.7" ], "description": "BeEF-API\n=======\n\nPython library that facilitates interacting with [BeEF](http://beefproject.com/) via it's RESTful API\n\nRequires Python 2.7 and the ```requests``` package (```pip install requests```)\n\nExamples\n========\n\n- import the library and login to BeEF\n```python\nIn [1]: from beefapi import BeefAPI\n\nIn [2]: beef = BeefAPI({})\n\nIn [3]: beef.login('beef', 'beef')\nOut[3]: True\n\n```\n- Print the id and name of all available modules:\n```python\nIn [10]: for module in beef.modules: \n ....: print module.id, module.name\n ....:\n222 Replace HREFs (HTTPS)\n223 Redirect Browser (Rickroll)\n220 Replace Videos\n221 Fingerprint Ajax\n218 iOS Address Bar Spoofing\n219 Redirect Browser\n216 Get Cookie\n217 Get Page HREFs\n\n-- SNIP -- \n```\n\n- Find all modules containing the string 'd-link' and print their id and name:\n```python\nIn [7]: for module in beef.modules.findbyname('d-link'):\n ...: print module.id, module.name\n ...: \n88 D-Link DSL-2740R DNS Hijack\n67 D-Link DIR-615 Password Wipe\n120 D-Link ShareCenter Command Execution\n81 D-Link DSL-2640B DNS Hijack\n80 D-Link DSL500T CSRF\n\n```\n\n- Find all online hooked browsers that have the string 'windows' in their OS attribute\n```python\nIn [7]: beef.hooked_browsers.online.findbyos('windows')\nOut[7]: []\n\nIn [8]: beef.hooked_browsers.online.findbyos('windows')[0].id\nOut[8]: 2\n\nIn [9]: beef.hooked_browsers.online.findbyos('windows')[0].session\nOut[9]: u'0EbkU7OUmaLBSGOtcdy43wMIh1r2VtU7O2QHsSzYJKONQCJ90gMnj53CQOQnZ9IfNIkr5SLBde1puw3v'\n\nIn [10]: beef.hooked_browsers.online.findbyos('windows')[0].name\nOut[10]: u'FF'\n\nIn [11]: beef.hooked_browsers.online.findbyos('windows')[0].details\nOut[11]: \n{u'BrowserLanguage': u'en-US',\n u'BrowserName': u'FF',\n u'BrowserPlatform': u'Win32',\n u'BrowserPlugins': u'Google Update-v.1.3.27.5,Java Deployment Toolkit 6.0.300.12-v.6.0.300.12,Silverlight Plug-In-v.5.1.40416.0',\n u'BrowserReportedName': u'Mozilla/5.0 (Windows NT 6.3; rv:38.0) Gecko/20100101 Firefox/38.0',\n u'BrowserType': u'{\"C19iOS\":null,\"C20iOS\":null,\"C21iOS\":null,\"C22iOS\":null,\"C23iOS\":null,\"C24iOS\":null,\"C25iOS\":null,\"C26iOS\":null,\"C27iOS\":null,\"C28iOS\":null,\"C29iOS\":null,\"C30iOS\":null,\"C31iOS\":null,\"C32iOS\":null,\"C33iOS\":null,\"C34iOS\":null,\"C35iOS\":null,\"C36iOS\":null,\"C37iOS\":null,\"C38iOS\":null,\"C39iOS\":null,\"C40iOS\":null,\"C41iOS\":null,\"C42iOS\":null,\"C\":null,\"FF38\":true,\"FF\":true}',\n u'BrowserVersion': u'38',\n u'CPU': u'32-bit',\n\n -- SNIP--\n```\n\n- Print the id, browser and os of all online hooked browsers\n```python\nIn [13]: for hook in beef.hooked_browsers.online:\n print hook.id, hook.name, hook.os\n ....: \n2 FF Windows 8.1\n```\n\n- Run a module against all online hooked browsers:\n```\nIn [14]: for hook in beef.hooked_browsers.online:\n ....: print hook.run(223)\n ....: \n{u'success': u'true', u'command_id': u'4'}\n```\n\n- Get the results of the previously executed module\n```python\nIn [25]: beef.hooked_browsers.online\nOut[25]: []\n\nIn [18]: session = beef.hooked_browsers.online[0].session\n\nIn [20]: beef.modules.findbyid(223).results(session, 4)\nOut[20]: \n{u'0': {u'data': u'{\"data\":\"result=Rickroll Successful\"}',\n u'date': u'1433706868'}}\n```\n\n", "description_content_type": null, "docs_url": null, "download_url": null, "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/byt3bl33d3r/BeEF-API", "keywords": "beef BeEF API", "license": "GNU", "maintainer": null, "maintainer_email": null, "name": "beefapi", "package_url": "https://pypi.org/project/beefapi/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/beefapi/", "project_urls": { "Homepage": "https://github.com/byt3bl33d3r/BeEF-API" }, "release_url": "https://pypi.org/project/beefapi/0.2.1/", "requires_dist": null, "requires_python": null, "summary": "Python library that facilitates interfacing with BeEF via it's RESTful API", "version": "0.2.1" }, "last_serial": 1656596, "releases": { "0.1": [ { "comment_text": "built for Linux-3.18.2-1-archassault-x86_64-with-glibc2.2.5", "digests": { "md5": "fd70514ba2a7363529e2e4945d840c76", "sha256": "4399392992fd62eee6cd2cc16a3c6b470cfb8b49a9490c2534db4d1fb176e122" }, "downloads": -1, "filename": "beefapi-0.1.linux-x86_64.tar.gz", "has_sig": false, "md5_digest": "fd70514ba2a7363529e2e4945d840c76", "packagetype": "bdist_dumb", "python_version": "any", "requires_python": null, "size": 6441, "upload_time": "2015-06-11T13:58:34", "url": "https://files.pythonhosted.org/packages/f9/83/94972ce47a760b37a875cf6b5b2499c3e19978d1ae584f52fa03a5d09b25/beefapi-0.1.linux-x86_64.tar.gz" }, { "comment_text": "", "digests": { "md5": "1e97bc16bf5be09a3dc915fb6f961b53", "sha256": "8f7e192c5c564909fbb158ff3a2803e10590b64d907b4b0bc72821bab9482af5" }, "downloads": -1, "filename": "beefapi.tar.gz", "has_sig": false, "md5_digest": "1e97bc16bf5be09a3dc915fb6f961b53", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2958, "upload_time": "2015-06-09T10:31:09", "url": "https://files.pythonhosted.org/packages/f6/26/f5bd4ad606d4bf7c1e1ed1bc540047b63fdf985294b7d5ab170c96dc37ce/beefapi.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "d1a8a249c9096e3dc523e28471f7d0fa", "sha256": "00cfb5eaa5bfb2f828795ad4c19f5a053eb4498e85fdab9612f776c64921b54c" }, "downloads": -1, "filename": "beefapi-0.2.tar.gz", "has_sig": false, "md5_digest": "d1a8a249c9096e3dc523e28471f7d0fa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2237, "upload_time": "2015-07-29T21:45:13", "url": "https://files.pythonhosted.org/packages/f8/1b/31424f0572d957fced67bce59460c1f5c182ef57de077feee3a892059a7c/beefapi-0.2.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "ad26eb3b3dffe3ed2dc3a68925586cda", "sha256": "4100b4acd7893b224bb065c57d152bcee38c0df6824b645b83a8d4caf300dfcd" }, "downloads": -1, "filename": "beefapi-0.2.1.tar.gz", "has_sig": false, "md5_digest": "ad26eb3b3dffe3ed2dc3a68925586cda", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2242, "upload_time": "2015-07-30T12:00:41", "url": "https://files.pythonhosted.org/packages/61/49/6310151abbd6dffa809dbd9ab3dc309ecae1cfe9ac96f1822aef9c7bd063/beefapi-0.2.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "ad26eb3b3dffe3ed2dc3a68925586cda", "sha256": "4100b4acd7893b224bb065c57d152bcee38c0df6824b645b83a8d4caf300dfcd" }, "downloads": -1, "filename": "beefapi-0.2.1.tar.gz", "has_sig": false, "md5_digest": "ad26eb3b3dffe3ed2dc3a68925586cda", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2242, "upload_time": "2015-07-30T12:00:41", "url": "https://files.pythonhosted.org/packages/61/49/6310151abbd6dffa809dbd9ab3dc309ecae1cfe9ac96f1822aef9c7bd063/beefapi-0.2.1.tar.gz" } ] }