{"id":23007576,"url":"https://github.com/ice-wzl/tracker","last_synced_at":"2025-04-02T15:22:06.312Z","repository":{"id":259637773,"uuid":"879042629","full_name":"ice-wzl/TRACKER","owner":"ice-wzl","description":"This repo is designed as an implant tracker for Red Teams. It provies a way to track different implant version used, in addition to where implants are deployed.","archived":false,"fork":false,"pushed_at":"2025-01-05T17:58:37.000Z","size":161,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-08T06:17:14.935Z","etag":null,"topics":["flask-application","implant","pentest","pentest-tool","pentesting","redteam","redteam-tools","redteaming","sql"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/ice-wzl.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-10-26T20:03:23.000Z","updated_at":"2025-01-05T17:58:40.000Z","dependencies_parsed_at":"2024-10-27T02:25:12.808Z","dependency_job_id":"62308326-8dd3-417f-99fa-9752d5e6d989","html_url":"https://github.com/ice-wzl/TRACKER","commit_stats":null,"previous_names":["ice-wzl/trackkit","ice-wzl/tracker"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ice-wzl%2FTRACKER","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ice-wzl%2FTRACKER/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ice-wzl%2FTRACKER/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ice-wzl%2FTRACKER/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ice-wzl","download_url":"https://codeload.github.com/ice-wzl/TRACKER/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246837768,"owners_count":20841939,"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":["flask-application","implant","pentest","pentest-tool","pentesting","redteam","redteam-tools","redteaming","sql"],"created_at":"2024-12-15T08:16:27.919Z","updated_at":"2025-04-02T15:22:06.281Z","avatar_url":"https://github.com/ice-wzl.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TRACKER\n![Screenshot from 2024-10-26 19-54-09](https://github.com/user-attachments/assets/cecf893c-0d62-4acd-91fa-4f6b3554b13d)\n- This repo is designed for Red Teams to track their implant deployments across different engagements. It provies an ability to track locations, implant versions, target IDs, and campaign IDs. It further provies a way to centralize engagement notes allowing different Red Team operators to have access to all the notes across an engagement.\n\n## Install\n- This repo should work across Linux distributions, however it has only been tested and verified on Ubuntu 24.04\n- I recommend using a virtual enviroment to avoid dependency conflicts.\n````\nsudo apt update\n# install required dependencies \nsudo apt install -y pkg-config python3-dev libmysqlclient-dev build-essential\ncd application/\npython3 -m venv venv\nsource venv/bin/activate \npip3 install -r requirements.txt\n# fix Werkzeug deprecation issues\npip3 install --upgrade Flask Werkzeug\npip install --upgrade mysql-connector-python\n````\n## Database Setup\n- Install mysql database \n````\nsudo apt install mysql-server\n````\n- If youre using socket authentication connect with `sudo mysql`\n- Connect to your database `mysql -u root -p`\n- Run the files in order listed below \n````\nsource users.sql\nsource DDL.sql\nsource procedure_functions.sql\nsource permissions.sql\n````\n## Run the application \n- Once your database is set up you can `cd application/` and run the application with \n````\npython3 app.py\n````\n## Example Systemd service file \n````\n/etc/systemd/system/tracker.service\n[Unit]\nDescription=tracker\nAfter=network.target\n\n[Service]\nUser=www-data\nGroup=www-data\nWorkingDirectory=/opt/tracker/application\nExecStart=/opt/tracker/application/venv/bin/python3 /opt/tracker/application/app.py\nRestart=always\nEnvironment=\"PATH=/opt/tracker/application/venv/bin\"\nEnvironment=\"VIRTUAL_ENV=/opt/tracker/application/venv\"\n\n[Install]\nWantedBy=multi-user.target\n````\n## How to use this application\n### Add Location\n- Start by adding a location that your Red Team will be operating in. Input the State and the Country.\n![Screenshot from 2024-10-26 20-01-02](https://github.com/user-attachments/assets/05bdb090-5055-4ef2-b39e-8eb3502ecf5d)\n### Add Campaign\n- Then create a Campaign\n![Screenshot from 2024-10-26 20-02-08](https://github.com/user-attachments/assets/22292c36-f978-414d-bbf7-983372bbfc6f)\n### Add Targets\n- After creating a campaign, you can now identify target hosts and add them as targets tying them to a campaign. This will keep your targets organized and all linked to your specific Red Team campaign.\n- You can either name hosts in the target network numberically or by hostname, either is possible.\n![image](https://github.com/user-attachments/assets/77d9d831-3372-4854-badb-5c4f54435af3)\n## Add Implants\n- You can add implants that your Red Team is using and track their version\n- You will need to have implants added before you create and implant deployment on a target.\n- For example you can add `Sliver v5.4` and `Meterpreter 6.3`. This will assign the implant an implant ID which you can use in the `add_deployment` page.\n## Add Deployment\n- This page will allow you to track deployed implants in the Red Team engangement. You will need your Campaign ID, Target ID, and Implant ID. These can be gathered from the respective pages. You can further annotate any automatic kill-date along with the Red Team operator that installed the implant.\n![Screenshot from 2024-10-26 20-12-20](https://github.com/user-attachments/assets/5b3c76ae-5d00-461d-82fd-eb90042cb23e)\n\n\n## FAQ\n1. Why did you not pull some of the Javascript libs from a cdn and instead include them in the repo?\n  - I wanted to be able to run this application on a host that cannot reach the internet. This would have caused all the libs to fail to load. Many Red Teams might want to host this application on a host that is not internet accessible.\n3. Where did the name come from\n  - TRACKER should make your red team engagements faster and more organized.\n## Bugs?\n- If you find a bug, please open an Issue or submit a PR, happy to accept PRs!\n\n## TO DO \n- add ability to modify any data after processing except notes. important notes are not allowed to be changed\n- fix css from overflowing in notes\n- have notes search start collapsed, too much data\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fice-wzl%2Ftracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fice-wzl%2Ftracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fice-wzl%2Ftracker/lists"}