The project is in a healthy, maintained state
ronin-listener-dns is a DNS server for receiving exfiltrated data sent via DNS queries. ronin-listener-dns can be used to test for XML external entity (XXE) injection.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.0

Runtime

~> 1.0
 Project Readme

ronin-listener-dns

CI Code Climate

Description

ronin-listener-dns is a DNS server for receiving exfiltrated data sent via DNS queries. ronin-listener-dns can be used to test for XML external entity (XXE) injection.

Features

  • Supports receiving any DNS query for a given domain.
  • Always returns with NXDOMAIN to prevent DNS caching.

Examples

require 'ronin/listener/dns'

Ronin::Listener::DNS.listen('example.com', host: '127.0.0.1', port: 5553) do |query|
  puts "Received query for #{query.type} #{query.label} from #{query.source}"
end

Then try running host -p 5553 s3cr3t.example.com 127.0.0.1 to test the server.

Received query for A s3cr3t.example.com from 127.0.0.1:59042

Note: if you wish to run the server on 0.0.0.0 and port 53, the ruby script must be ran as root.

Requirements

Install

$ gem install ronin-listener-dns

Gemfile

gem 'ronin-listener-dns', '~> 0.1'

gemspec

gem.add_dependency 'ronin-listener-dns', '~> 0.1'

Development

  1. Fork It!
  2. Clone It!
  3. cd ronin-listener-dns/
  4. bundle install
  5. git checkout -b my_feature
  6. Code It!
  7. bundle exec rake spec
  8. git push origin my_feature

License

Copyright (c) 2023-2024 Hal Brodigan (postmodern.mod3@gmail.com)

ronin-listener-dns 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-dns 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-dns. If not, see https://www.gnu.org/licenses/.