{"id":13481850,"url":"https://github.com/mushorg/snare","last_synced_at":"2025-04-05T20:01:49.979Z","repository":{"id":34738282,"uuid":"38716676","full_name":"mushorg/snare","owner":"mushorg","description":"Super Next generation Advanced Reactive honEypot","archived":false,"fork":false,"pushed_at":"2024-06-10T19:38:38.000Z","size":266,"stargazers_count":461,"open_issues_count":25,"forks_count":138,"subscribers_count":34,"default_branch":"main","last_synced_at":"2025-03-29T19:01:10.037Z","etag":null,"topics":["hacktoberfest","honeypot","security"],"latest_commit_sha":null,"homepage":"http://mushmush.org","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/mushorg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["mushorg"]}},"created_at":"2015-07-07T21:47:52.000Z","updated_at":"2025-03-23T17:57:02.000Z","dependencies_parsed_at":"2023-02-13T19:50:58.737Z","dependency_job_id":"f0906987-a6d7-4f43-b95b-73016d5d09bb","html_url":"https://github.com/mushorg/snare","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mushorg%2Fsnare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mushorg%2Fsnare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mushorg%2Fsnare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mushorg%2Fsnare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mushorg","download_url":"https://codeload.github.com/mushorg/snare/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247393545,"owners_count":20931811,"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":["hacktoberfest","honeypot","security"],"created_at":"2024-07-31T17:00:56.681Z","updated_at":"2025-04-05T20:01:49.922Z","avatar_url":"https://github.com/mushorg.png","language":"Python","readme":"SNARE\n=====\n\n[![Documentation Status](https://readthedocs.org/projects/snare/badge/?version=latest)](http://snare.readthedocs.io/en/latest/?badge=latest)\n[![Build Status](https://travis-ci.org/mushorg/snare.svg?branch=master)](https://travis-ci.org/mushorg/snare)\n[![Coverage Status](https://coveralls.io/repos/github/mushorg/snare/badge.svg?branch=master)](https://coveralls.io/github/mushorg/snare?branch=master)\n\n_**Super Next generation Advanced Reactive honEypot**_\n\nAbout\n-----\n\nSNARE is a web application honeypot sensor attracting all sort of maliciousness from the Internet.\n\nDocumentation\n--------------\n\nThe documentation can be found [here](http://snare.readthedocs.io).\n\nBasic Concepts\n--------------\n\n- Surface first. Focus on the attack surface generation.\n- Sensors and masters. Lightweight collectors (SNARE) and central decision maker (tanner).\n\nGetting started\n---------------\n\n- You need Python3.6 to run SNARE\n- This was tested with a recent Ubuntu based Linux.\n\n#### Steps to setup\n\n1. Get SNARE: `git clone https://github.com/mushorg/snare.git` and `cd snare`\n2. [Optional] Make virtual environment: `python3 -m venv venv`\n3. [Optional] Activate virtual environment: `. venv/bin/activate`\n\n**Note:** Do not use sudo with below commands if you're running snare in virtual environment.\n\n4. Install requirements: `sudo pip3 install -r requirements.txt`\n5. Setup snare: `sudo python3 setup.py install`\n6. Clone a page: `sudo clone --target http://example.com --path \u003cpath to base dir\u003e`\n7. Run SNARE: `sudo snare --port 8080 --page-dir example.com --path \u003cpath to base dir\u003e`\n8. Test: Visit http://localhost:8080/index.html\n9. (Optionally) Have your own [tanner](https://github.com/mushorg/tanner) service running.\n\n[Note : Cloner clones the whole website, to restrict to a desired depth of cloning add `--max-depth` parameter]\n\n#### Docker build instructions\n\n1. Change current directory to `snare` project directory\n2. `docker-compose build`\n3. `docker-compose up`\n4. Snare will start on 0.0.0.0 with port 80.\nMore information about running `docker-compose` can be found [here.](https://docs.docker.com/compose/gettingstarted/)\n\nIn case of an error while running `docker-compose up`, check the availability of port 80, if it is occupied then refer to Docker documentation to change the default port.\n\nYou obviously want to bind to 0.0.0.0 and port 80 when running in _production_.\n\n## Testing\n\nIn order to run the tests and receive a test coverage report, we recommend running `pytest`:\n\n```\n    pip install pytest pytest-cov\n    sudo pytest --cov-report term-missing --cov=snare snare/tests/\n```\n\n## Sample Output\n\n```shell\n\n    # sudo snare --port 8080 --page-dir example.com\n\n       _____ _   _____    ____  ______\n      / ___// | / /   |  / __ \\/ ____/\n      \\__ \\/  |/ / /| | / /_/ / __/\n     ___/ / /|  / ___ |/ _, _/ /___\n    /____/_/ |_/_/  |_/_/ |_/_____/\n\n\n    privileges dropped, running as \"nobody:nogroup\"\n    serving with uuid 9c10172f-7ce2-4fb4-b1c6-abc70141db56\n    Debug logs will be stored in /opt/snare/snare.log\n    Error logs will be stored in /opt/snare/snare.err\n    ======== Running on http://127.0.0.1:8080 ========\n    (Press CTRL+C to quit)\n    you are running the latest version\n\n```","funding_links":["https://github.com/sponsors/mushorg"],"categories":["Honeypots","\u003ca id=\"a2df15c7819a024c2f5c4a7489285597\"\u003e\u003c/a\u003e密罐\u0026\u0026Honeypot","Python","\u003ca name=\"honeypots\"\u003e\u003c/a\u003e Honeypots","\u003ca id=\"a53d22b9c5d09dc894413453f4755658\"\u003e\u003c/a\u003e未分类"],"sub_categories":["\u003ca id=\"d20acdc34ca7c084eb52ca1c14f71957\"\u003e\u003c/a\u003e密罐"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmushorg%2Fsnare","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmushorg%2Fsnare","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmushorg%2Fsnare/lists"}