# # ronin-web - A collection of useful web helper methods and commands. # # Copyright (c) 2006-2023 Hal Brodigan (postmodern.mod3 at gmail.com) # # ronin-web 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-web 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-web. If not, see . # require 'ronin/web/cli/command' require 'ronin/core/cli/logging' require 'ronin/web/server/reverse_proxy' module Ronin module Web class CLI module Commands # # Starts a HTTP proxy server. # # ## Usage # # ronin-web reverse-proxy [options] [--host HOST] [--port PORT] # # ## Options # # -H, --host HOST Host to listen on (Default: localhost) # -p, --port PORT Port to listen on (Default: 8080) # -b, --show-body Print the request and response bodies # --rewrite-requests /REGEXP/:REPLACE # Rewrite request bodies # --rewrite-responses /REGEXP/:REPLACE # Rewrite response bodies # -h, --help Print help information # # @api private # class ReverseProxy < Command include Core::CLI::Logging command_name 'reverse-proxy' usage '[options] [--host HOST] [--port PORT]' option :host, short: '-H', value: { type: String, usage: 'HOST', default: 'localhost' }, desc: 'Host to listen on' option :port, short: '-p', value: { type: Integer, usage: 'PORT', default: 8080 }, desc: 'Port to listen on' option :show_body, short: '-b', desc: 'Print the request and response bodies' option :rewrite_requests, value: { type: String, usage: '/REGEXP/:REPLACE' }, desc: 'Rewrite request bodies' do |str| @rewrite_requests << parse_rewrite_rule(str) end option :rewrite_responses, value: { type: String, usage: '/REGEXP/:REPLACE' }, desc: 'Rewrite response bodies' do |str| @rewrite_responses << parse_rewrite_rule(str) end description 'Starts a HTTP proxy server' man_page 'ronin-web-reverse-proxy.1' # # Initializes the `reverse-proxy` command. # # @param [Hash{Symbol => Object}] kwargs # Additional keyword arguments. # def initialize(**kwargs) super(**kwargs) @rewrite_requests = [] @rewrite_responses = [] end # # Runs the `ronin-web reverse-proxy` command. # def run proxy = Ronin::Web::Server::ReverseProxy.new do |proxy| proxy.on_request do |request| puts "[#{request.ip} -> #{request.host_with_port}] #{request.request_method} #{request.url}" request.headers.each do |name,value| puts "> #{name}: #{value}" end puts unless @rewrite_requests.empty? request.body = rewrite_body(request.body,@rewrite_requests) end print_body(request.body) if options[:show_body] end proxy.on_response do |response| puts "< HTTP/1.1 #{response.status}" response.headers.each do |name,value| puts "< #{name}: #{value}" end puts unless @rewrite_responses.empty? response.body = rewrite_body(response.body,@rewrite_responses) end print_body(response.body) if options[:show_body] end end log_info "Starting proxy server on #{options[:host]}:#{options[:port]} ..." begin proxy.run!(host: options[:host], port: options[:port]) rescue Errno::EADDRINUSE => error log_error(error.message) exit(1) end log_info "shutting down ..." end # # Prints a request or response body. # # @param [IO, StringIO, Array, String] body # The request/response body to print. May be a IO/StringIO object, # an Array of Strings, or a String. # def print_body(body) case body when StringIO, IO body.each_line do |line| puts line end body.rewind else puts body end end # # Parses a rewrite rule. # # @param [String] value # # @return [(Regexp, String), (String, String)] # def parse_rewrite_rule(value) if (index = value.rindex('/:')) regexp = Regexp.new(value[1...index]) replace = value[index+2..] return [regexp, replace] elsif (index = value.rindex(':')) string = value[0...index] replace = value[(index+1)..] return [string, replace] end end # # Rewrites a request or response body. # # @param [IO, StringIO, Array, String] body # # @return [String] # def rewrite_body(body,rules) body = case body when StringIO, IO then body.read when Array then body.join else body.to_s end rules.each do |(pattern,replace)| body.gsub!(pattern,replace) end return body end end end end end end