{"id":13794356,"url":"https://github.com/omererdem/honeything","last_synced_at":"2025-05-12T21:30:55.300Z","repository":{"id":33088699,"uuid":"36726128","full_name":"omererdem/honeything","owner":"omererdem","description":"TR-069 Honeypot","archived":false,"fork":false,"pushed_at":"2016-03-16T09:57:37.000Z","size":1574,"stargazers_count":122,"open_issues_count":4,"forks_count":43,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-11-18T08:56:51.548Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/omererdem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-06-02T10:37:00.000Z","updated_at":"2024-09-21T11:54:51.000Z","dependencies_parsed_at":"2022-09-12T17:51:22.638Z","dependency_job_id":null,"html_url":"https://github.com/omererdem/honeything","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omererdem%2Fhoneything","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omererdem%2Fhoneything/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omererdem%2Fhoneything/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/omererdem%2Fhoneything/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/omererdem","download_url":"https://codeload.github.com/omererdem/honeything/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253824988,"owners_count":21970113,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T23:00:39.555Z","updated_at":"2025-05-12T21:30:54.509Z","avatar_url":"https://github.com/omererdem.png","language":"Python","funding_links":[],"categories":["Honeypots","\u003ca id=\"a53d22b9c5d09dc894413453f4755658\"\u003e\u003c/a\u003e未分类"],"sub_categories":[],"readme":"# HoneyThing\nHoneyThing is a honeypot for Internet of TR-069 things. It's designed to act as completely a modem/router that has RomPager embedded web server and supports [TR-069 (CWMP)](https://www.broadband-forum.org/technical/download/TR-069_Amendment-5.pdf) protocol.\n\nProject idea was created by [Ali Ikinci](https://github.com/aikinci) and offered as [Honeynet GSoC](https://honeynet.org/gsoc/ideas#project15) project in 2015.\n\n## Features\nBasic features:\n\n - Emulates some popular vulnerabilities for RomPager as [Misfortune Cookie](http://mis.fortunecook.ie/), [Rom-0](https://ripe69.ripe.net/presentations/61-rom0-vuln.pdf) etc.\n - TR-069 protocol support. Implements mostly used TR-069 CPE commands. e.g: GetRPCMethods, Get/Set ParameterValues, Download...\n - Modem web interface to increase the interaction with attacker.\n - All communication with services (http.log, cwmp.log) and state of honeypot (started/stopped, error etc. to honeything.log) are logged in parsable text format.\n \n## Download\nDebian and RPM packages will be available soon.\n\n## Installation\nThere're 2 ways to install HoneyThing:\n\nFor all of them, your system must have Python 2.7 (or above) and [PycURL](https://pypi.python.org/pypi/pycurl) package.\n\n - **Setup Script:** Using setup script requires [python setuptools](https://pypi.python.org/pypi/setuptools) package installed on the system. After downloading and extracting HoneyThing, you can simply go to extracted directory and run; \n\u003e python setup.py install\n\n - **Pre-Built Packages:** HoneyThing can be installed by using pre-built packages for Ubuntu and CentOS. Packages can be downloaded from [download section](#download) and will be added for any stable release.\n \n For Ubuntu;\n\u003e dpkg -i honeything_x.y.z.deb\n \n For CentOS;\n\u003e rpm -i honeything_x.y.z.rpm\n\n## Configuration\nAfter installation, some parameters can be changed optional by using [configuration file](https://github.com/omererdem/honeything/blob/master/src/config/config.ini). There're 4 section in config file:\n\n - **http:** HTTP listen address/port can be edited in this section.\n - **cwmp:** Some TR-069 parameters as listen address/port, ACS url, download directory for *\"download\"* CPE command, connection request path etc. can be edited.\n - **cpe:** In cpe section, there're lots of variables related to modem/router device like manufacturer, serial number, model name etc. They can be edited to provide device variety in ACS communication.\n - **logging:** Log file paths, log level and some protocol specific parameters can be changed in this section.\n\n## Run\nIf you installed HoneyThing with setup script or pre-built packages, honeything can be run by using following commands:\n\n\u003e service honeything {start|stop|restart|status}\n\nor\n\u003e /etc/init.d/honeything {start|stop|restart|status}\n\n## Documentation\nA paper about this project is published (in TURKISH) at International Conference on Information Security and Cryptology [[ISCTurkey 2015]](http://www.iscturkey.org/en). It is accessible online from [here](http://www.iscturkey.org/s/2226/i/HoneyThing_Revised_Last.pdf).\n\n## Credits\nThe project:\n\n - Developed by [Ömer Erdem](https://github.com/omererdem)\n - Idea by [Ali Ikinci](https://github.com/aikinci)\n - Advisor [Dr. Mehmet Kara](https://tr.linkedin.com/in/mehmet-kara-b2335947)\n\nand special thanks to [Bâkır Emre](https://github.com/bemre) for taking the first step.\n\n\n**Note:** This project is also being developed as Istanbul Sehir University master's thesis.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomererdem%2Fhoneything","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fomererdem%2Fhoneything","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fomererdem%2Fhoneything/lists"}