ronin-listener
Description
ronin-listener is a small CLI utility for receiving exfiltrated data over DNS or HTTP.
Features
- Supports starting a DNS server for receiving exfiltrated data via DNS queries for a domain.
- Supports starting a HTTP server for receiving exfiltrated data via HTTP requests.
Synopsis
$ ronin-listener
Usage: ronin-listener [options]
Options:
-V, --version Prints the version and exits
-h, --help Print help information
Arguments:
[COMMAND] The command name to run
[ARGS ...] Additional arguments for the command
Commands:
completion
dns
help
http
Listen for DNS queries on 127.0.0.1
port 5553
for the domain example.com
:
ronin-listener dns -H 127.0.0.1 -p 5553 example.com
Listen for HTTP requests on 127.0.0.1
port 8080
:
ronin-listener http -H 127.0.0.1 -p 8080
Listen specifically for HTTP requests sent to example.com
:
ronin-listener http -H 127.0.0.1 -p 8080 --vhost example.com
Generate a new standalone DNS listener Ruby script:
ronin-listener new dns file.rb
Generate a new standalone HTTP listener Ruby script:
ronin-listener new http file.rb
Requirements
- Ruby >= 3.0.0
- ronin-listener-dns ~> 0.1
- ronin-listener-http ~> 0.1
- ronin-core ~> 0.2
Install
$ gem install ronin-listener
Gemfile
gem 'ronin-listener', '~> 0.1'
gemspec
gem.add_dependency 'ronin-listener', '~> 0.1'
Development
- Fork It!
- Clone It!
cd ronin-listener/
./scripts/setup
git checkout -b my_feature
- Code It!
bundle exec rake spec
git push origin my_feature
License
Copyright (c) 2023-2024 Hal Brodigan (postmodern.mod3@gmail.com)
ronin-listener is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
ronin-listener is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with ronin-listener. If not, see https://www.gnu.org/licenses/.