Skip to content

ronin-rb/ronin-agent-ruby

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

65 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ronin-agent-ruby

ronin-agent-ruby is a ronin agent written in Ruby.

ronin agents are programs that can be deployed to systems for defensive purposes (ex: telemetry) or offensive purposes (ex: post-exploitation).

Features

  • Uses a JSON RPC protocol
  • Supports TCP server, TCP connect back, and a HTTP server.
  • Allows opening/reading/writing files, controlling processes, executing commands, opening TCP/UDP sockets, querying DNS, etc.
  • Only uses code in Ruby stdlib.

Synopsis

$ ./build.sh
$ ./agent.rb --help
usage: ./agent.rb {--http PORT [HOST] | --listen PORT [HOST] | --connect HOST PORT}

Development

  1. Fork It!
  2. Clone It!
  3. cd ronin-agent-ruby
  4. bundle install
  5. git checkout -b my_feature
  6. Code It!
  7. Test It!
  8. git push origin my_feature

License

ronin-agent-ruby - A ronin agent written in Ruby.

Copyright (c) 2007-2021 Hal Brodigan (postmodern.mod3 at gmail.com)

ronin-agent-ruby is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

ronin-agent-ruby 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 General Public License for more details.

You should have received a copy of the GNU General Public License along with ronin-agent-ruby. If not, see https://www.gnu.org/licenses/.