ronin-support 0.4.1 → 0.5.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.editorconfig +11 -0
- data/.github/workflows/ruby.yml +28 -0
- data/.ruby-version +1 -0
- data/.yardopts +1 -1
- data/ChangeLog.md +121 -33
- data/Gemfile +17 -18
- data/README.md +57 -33
- data/Rakefile +10 -3
- data/gemspec.yml +16 -7
- data/lib/ronin/binary.rb +21 -0
- data/lib/ronin/binary/hexdump.rb +20 -0
- data/lib/ronin/binary/hexdump/parser.rb +403 -0
- data/lib/ronin/binary/struct.rb +567 -0
- data/lib/ronin/binary/template.rb +454 -0
- data/lib/ronin/extensions.rb +5 -5
- data/lib/ronin/extensions/enumerable.rb +5 -5
- data/lib/ronin/extensions/file.rb +39 -33
- data/lib/ronin/extensions/ip_addr.rb +29 -31
- data/lib/ronin/extensions/kernel.rb +5 -5
- data/lib/ronin/extensions/meta.rb +5 -5
- data/lib/ronin/extensions/regexp.rb +50 -5
- data/lib/ronin/extensions/resolv.rb +7 -9
- data/lib/ronin/extensions/string.rb +10 -10
- data/lib/ronin/formatting.rb +5 -5
- data/lib/ronin/formatting/binary.rb +5 -5
- data/lib/ronin/formatting/digest.rb +5 -5
- data/lib/ronin/formatting/extensions.rb +5 -5
- data/lib/ronin/formatting/extensions/binary.rb +7 -5
- data/lib/ronin/formatting/extensions/binary/array.rb +61 -0
- data/lib/ronin/formatting/extensions/binary/base64.rb +106 -0
- data/lib/ronin/formatting/extensions/binary/file.rb +44 -11
- data/lib/ronin/formatting/extensions/binary/float.rb +65 -0
- data/lib/ronin/formatting/extensions/binary/integer.rb +66 -50
- data/lib/ronin/formatting/extensions/binary/string.rb +81 -205
- data/lib/ronin/formatting/extensions/digest.rb +5 -5
- data/lib/ronin/formatting/extensions/digest/file.rb +5 -5
- data/lib/ronin/formatting/extensions/digest/string.rb +5 -5
- data/lib/ronin/formatting/extensions/html.rb +5 -5
- data/lib/ronin/formatting/extensions/html/integer.rb +9 -13
- data/lib/ronin/formatting/extensions/html/string.rb +31 -39
- data/lib/ronin/formatting/extensions/http.rb +5 -5
- data/lib/ronin/formatting/extensions/http/integer.rb +6 -6
- data/lib/ronin/formatting/extensions/http/string.rb +7 -7
- data/lib/ronin/formatting/extensions/sql.rb +5 -5
- data/lib/ronin/formatting/extensions/sql/string.rb +22 -24
- data/lib/ronin/formatting/extensions/text.rb +5 -5
- data/lib/ronin/formatting/extensions/text/array.rb +13 -11
- data/lib/ronin/formatting/extensions/text/string.rb +70 -13
- data/lib/ronin/formatting/html.rb +5 -5
- data/lib/ronin/formatting/http.rb +5 -5
- data/lib/ronin/formatting/sql.rb +5 -5
- data/lib/ronin/formatting/text.rb +5 -5
- data/lib/ronin/fuzzing.rb +5 -5
- data/lib/ronin/fuzzing/extensions.rb +5 -5
- data/lib/ronin/fuzzing/extensions/string.rb +42 -213
- data/lib/ronin/fuzzing/fuzzer.rb +110 -0
- data/lib/ronin/fuzzing/fuzzing.rb +33 -26
- data/lib/ronin/fuzzing/mutator.rb +161 -0
- data/lib/ronin/fuzzing/repeater.rb +81 -0
- data/lib/ronin/fuzzing/template.rb +133 -0
- data/lib/ronin/mixin.rb +2 -2
- data/lib/ronin/network.rb +7 -5
- data/lib/ronin/network/dns.rb +64 -24
- data/lib/ronin/network/esmtp.rb +5 -5
- data/lib/ronin/network/extensions.rb +5 -5
- data/lib/ronin/network/extensions/dns.rb +5 -5
- data/lib/ronin/network/extensions/dns/net.rb +5 -5
- data/lib/ronin/network/extensions/esmtp.rb +5 -5
- data/lib/ronin/network/extensions/esmtp/net.rb +5 -5
- data/lib/ronin/network/extensions/http.rb +5 -5
- data/lib/ronin/network/extensions/http/net.rb +5 -5
- data/lib/ronin/network/extensions/http/uri/http.rb +5 -5
- data/lib/ronin/network/extensions/imap.rb +5 -5
- data/lib/ronin/network/extensions/imap/net.rb +5 -5
- data/lib/ronin/network/extensions/pop3.rb +5 -5
- data/lib/ronin/network/extensions/pop3/net.rb +5 -5
- data/lib/ronin/network/extensions/smtp.rb +5 -5
- data/lib/ronin/network/extensions/smtp/net.rb +5 -5
- data/lib/ronin/network/extensions/ssl.rb +5 -5
- data/lib/ronin/network/extensions/ssl/net.rb +5 -5
- data/lib/ronin/network/extensions/tcp.rb +5 -5
- data/lib/ronin/network/extensions/tcp/net.rb +5 -5
- data/lib/ronin/network/extensions/telnet.rb +5 -5
- data/lib/ronin/network/extensions/telnet/net.rb +5 -5
- data/lib/ronin/network/extensions/udp.rb +5 -5
- data/lib/ronin/network/extensions/udp/net.rb +5 -5
- data/lib/ronin/network/ftp.rb +149 -0
- data/lib/ronin/network/http.rb +5 -5
- data/lib/ronin/network/http/exceptions.rb +5 -5
- data/lib/ronin/network/http/exceptions/unknown_request.rb +5 -5
- data/lib/ronin/network/http/http.rb +65 -70
- data/lib/ronin/network/http/proxy.rb +5 -5
- data/lib/ronin/network/imap.rb +16 -15
- data/lib/ronin/network/mixins.rb +6 -5
- data/lib/ronin/network/mixins/dns.rb +5 -5
- data/lib/ronin/network/mixins/esmtp.rb +5 -5
- data/lib/ronin/network/mixins/ftp.rb +155 -0
- data/lib/ronin/network/mixins/http.rb +58 -587
- data/lib/ronin/network/mixins/imap.rb +5 -5
- data/lib/ronin/network/mixins/mixin.rb +5 -5
- data/lib/ronin/network/mixins/pop3.rb +5 -5
- data/lib/ronin/network/mixins/smtp.rb +5 -5
- data/lib/ronin/network/mixins/ssl.rb +5 -5
- data/lib/ronin/network/mixins/tcp.rb +43 -10
- data/lib/ronin/network/mixins/telnet.rb +5 -5
- data/lib/ronin/network/mixins/udp.rb +126 -6
- data/lib/ronin/network/mixins/unix.rb +279 -0
- data/lib/ronin/network/network.rb +5 -5
- data/lib/ronin/network/pop3.rb +10 -10
- data/lib/ronin/network/proxy.rb +578 -0
- data/lib/ronin/network/smtp.rb +5 -5
- data/lib/ronin/network/smtp/email.rb +6 -6
- data/lib/ronin/network/smtp/smtp.rb +12 -13
- data/lib/ronin/network/ssl.rb +16 -17
- data/lib/ronin/network/tcp.rb +7 -310
- data/lib/ronin/network/tcp/proxy.rb +417 -0
- data/lib/ronin/network/tcp/tcp.rb +452 -0
- data/lib/ronin/network/telnet.rb +34 -28
- data/lib/ronin/network/udp.rb +7 -271
- data/lib/ronin/network/udp/proxy.rb +191 -0
- data/lib/ronin/network/udp/udp.rb +452 -0
- data/lib/ronin/network/unix.rb +286 -0
- data/lib/ronin/path.rb +35 -39
- data/lib/ronin/spec/ui/output.rb +6 -12
- data/lib/ronin/support.rb +6 -5
- data/lib/ronin/support/inflector.rb +8 -12
- data/lib/ronin/support/support.rb +7 -5
- data/lib/ronin/support/version.rb +6 -6
- data/lib/ronin/templates.rb +5 -5
- data/lib/ronin/templates/erb.rb +5 -5
- data/lib/ronin/templates/template.rb +5 -5
- data/lib/ronin/ui/output.rb +5 -5
- data/lib/ronin/ui/output/helpers.rb +42 -28
- data/lib/ronin/ui/output/output.rb +17 -21
- data/lib/ronin/ui/output/terminal.rb +5 -5
- data/lib/ronin/ui/output/terminal/color.rb +15 -9
- data/lib/ronin/ui/output/terminal/raw.rb +5 -5
- data/lib/ronin/ui/shell.rb +8 -11
- data/lib/ronin/wordlist.rb +110 -30
- data/ronin-support.gemspec +39 -109
- data/spec/binary/hexdump/helpers/hexdumps.rb +13 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/ascii.bin +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/hexdump_decimal_shorts.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/hexdump_hex_bytes.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/hexdump_hex_shorts.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/hexdump_octal_bytes.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/hexdump_octal_shorts.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/hexdump_repeated.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_decimal_bytes.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_decimal_ints.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_decimal_quads.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_decimal_shorts.txt +0 -0
- data/spec/binary/hexdump/helpers/hexdumps/od_doubles.txt +17 -0
- data/spec/binary/hexdump/helpers/hexdumps/od_floats.txt +17 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_hex_bytes.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_hex_ints.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_hex_quads.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_hex_shorts.txt +0 -0
- data/spec/binary/hexdump/helpers/hexdumps/od_named_chars.txt +17 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_octal_bytes.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_octal_ints.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_octal_quads.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_octal_shorts.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/od_repeated.txt +0 -0
- data/spec/{formatting/binary → binary/hexdump}/helpers/hexdumps/repeated.bin +0 -0
- data/spec/binary/hexdump/parser_spec.rb +302 -0
- data/spec/binary/struct_spec.rb +496 -0
- data/spec/binary/template_spec.rb +416 -0
- data/spec/extensions/enumerable_spec.rb +4 -4
- data/spec/extensions/file_spec.rb +12 -14
- data/spec/extensions/ip_addr_spec.rb +76 -50
- data/spec/extensions/kernel_spec.rb +7 -7
- data/spec/extensions/regexp_spec.rb +119 -59
- data/spec/extensions/resolv_spec.rb +2 -2
- data/spec/extensions/string_spec.rb +31 -30
- data/spec/formatting/binary/array_spec.rb +26 -0
- data/spec/formatting/binary/base64_spec.rb +50 -0
- data/spec/formatting/binary/float_spec.rb +36 -0
- data/spec/formatting/binary/integer_spec.rb +76 -50
- data/spec/formatting/binary/string_spec.rb +91 -198
- data/spec/formatting/digest/string_spec.rb +5 -5
- data/spec/formatting/html/integer_spec.rb +6 -6
- data/spec/formatting/html/string_spec.rb +10 -10
- data/spec/formatting/http/integer_spec.rb +3 -3
- data/spec/formatting/http/string_spec.rb +5 -5
- data/spec/formatting/sql/string_spec.rb +21 -19
- data/spec/formatting/text/array_spec.rb +15 -15
- data/spec/formatting/text/string_spec.rb +58 -28
- data/spec/fuzzing/extensions/string_spec.rb +87 -0
- data/spec/fuzzing/fuzzer_spec.rb +109 -0
- data/spec/fuzzing/fuzzing_spec.rb +24 -0
- data/spec/fuzzing/mutator_spec.rb +112 -0
- data/spec/fuzzing/repeater_spec.rb +57 -0
- data/spec/fuzzing/template_spec.rb +54 -0
- data/spec/mixin_spec.rb +10 -12
- data/spec/network/dns_spec.rb +89 -23
- data/spec/network/ftp_spec.rb +81 -0
- data/spec/network/http/http_spec.rb +237 -144
- data/spec/network/http/proxy_spec.rb +37 -37
- data/spec/network/network_spec.rb +2 -2
- data/spec/network/proxy_spec.rb +121 -0
- data/spec/network/shared/unix_server.rb +31 -0
- data/spec/network/smtp/email_spec.rb +14 -14
- data/spec/network/ssl_spec.rb +53 -3
- data/spec/network/tcp/proxy_spec.rb +118 -0
- data/spec/network/tcp/tcp_spec.rb +316 -0
- data/spec/network/telnet_spec.rb +67 -0
- data/spec/network/udp/udp_spec.rb +298 -0
- data/spec/network/unix_spec.rb +182 -0
- data/spec/path_spec.rb +43 -18
- data/spec/spec_helper.rb +2 -3
- data/spec/support/inflector_spec.rb +4 -4
- data/spec/support_spec.rb +1 -1
- data/spec/templates/erb_spec.rb +3 -3
- data/spec/templates/template_spec.rb +10 -10
- data/spec/ui/shell_spec.rb +15 -15
- data/spec/wordlist_spec.rb +80 -19
- metadata +176 -121
- data/.gemtest +0 -0
- data/spec/formatting/binary/helpers/hexdumps.rb +0 -16
- data/spec/fuzzing/string_spec.rb +0 -158
- data/spec/network/tcp_spec.rb +0 -247
- data/spec/network/udp_spec.rb +0 -248
@@ -1,20 +1,20 @@
|
|
1
1
|
#
|
2
|
-
# Copyright (c) 2006-
|
2
|
+
# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
|
3
3
|
#
|
4
|
-
# This file is part of
|
4
|
+
# This file is part of ronin-support.
|
5
5
|
#
|
6
|
-
#
|
6
|
+
# ronin-support is free software: you can redistribute it and/or modify
|
7
7
|
# it under the terms of the GNU Lesser General Public License as published
|
8
8
|
# by the Free Software Foundation, either version 3 of the License, or
|
9
9
|
# (at your option) any later version.
|
10
10
|
#
|
11
|
-
#
|
11
|
+
# ronin-support is distributed in the hope that it will be useful,
|
12
12
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13
13
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14
14
|
# GNU Lesser General Public License for more details.
|
15
15
|
#
|
16
16
|
# You should have received a copy of the GNU Lesser General Public License
|
17
|
-
# along with
|
17
|
+
# along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
|
18
18
|
#
|
19
19
|
|
20
20
|
require 'ronin/network/tcp'
|
@@ -1,20 +1,20 @@
|
|
1
1
|
#
|
2
|
-
# Copyright (c) 2006-
|
2
|
+
# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
|
3
3
|
#
|
4
|
-
# This file is part of
|
4
|
+
# This file is part of ronin-support.
|
5
5
|
#
|
6
|
-
#
|
6
|
+
# ronin-support is free software: you can redistribute it and/or modify
|
7
7
|
# it under the terms of the GNU Lesser General Public License as published
|
8
8
|
# by the Free Software Foundation, either version 3 of the License, or
|
9
9
|
# (at your option) any later version.
|
10
10
|
#
|
11
|
-
#
|
11
|
+
# ronin-support is distributed in the hope that it will be useful,
|
12
12
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13
13
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14
14
|
# GNU Lesser General Public License for more details.
|
15
15
|
#
|
16
16
|
# You should have received a copy of the GNU Lesser General Public License
|
17
|
-
# along with
|
17
|
+
# along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
|
18
18
|
#
|
19
19
|
|
20
20
|
require 'ronin/network/extensions/telnet/net'
|
@@ -1,20 +1,20 @@
|
|
1
1
|
#
|
2
|
-
# Copyright (c) 2006-
|
2
|
+
# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
|
3
3
|
#
|
4
|
-
# This file is part of
|
4
|
+
# This file is part of ronin-support.
|
5
5
|
#
|
6
|
-
#
|
6
|
+
# ronin-support is free software: you can redistribute it and/or modify
|
7
7
|
# it under the terms of the GNU Lesser General Public License as published
|
8
8
|
# by the Free Software Foundation, either version 3 of the License, or
|
9
9
|
# (at your option) any later version.
|
10
10
|
#
|
11
|
-
#
|
11
|
+
# ronin-support is distributed in the hope that it will be useful,
|
12
12
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13
13
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14
14
|
# GNU Lesser General Public License for more details.
|
15
15
|
#
|
16
16
|
# You should have received a copy of the GNU Lesser General Public License
|
17
|
-
# along with
|
17
|
+
# along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
|
18
18
|
#
|
19
19
|
|
20
20
|
require 'ronin/network/telnet'
|
@@ -1,20 +1,20 @@
|
|
1
1
|
#
|
2
|
-
# Copyright (c) 2006-
|
2
|
+
# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
|
3
3
|
#
|
4
|
-
# This file is part of
|
4
|
+
# This file is part of ronin-support.
|
5
5
|
#
|
6
|
-
#
|
6
|
+
# ronin-support is free software: you can redistribute it and/or modify
|
7
7
|
# it under the terms of the GNU Lesser General Public License as published
|
8
8
|
# by the Free Software Foundation, either version 3 of the License, or
|
9
9
|
# (at your option) any later version.
|
10
10
|
#
|
11
|
-
#
|
11
|
+
# ronin-support is distributed in the hope that it will be useful,
|
12
12
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13
13
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14
14
|
# GNU Lesser General Public License for more details.
|
15
15
|
#
|
16
16
|
# You should have received a copy of the GNU Lesser General Public License
|
17
|
-
# along with
|
17
|
+
# along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
|
18
18
|
#
|
19
19
|
|
20
20
|
require 'ronin/network/extensions/udp/net'
|
@@ -1,20 +1,20 @@
|
|
1
1
|
#
|
2
|
-
# Copyright (c) 2006-
|
2
|
+
# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
|
3
3
|
#
|
4
|
-
# This file is part of
|
4
|
+
# This file is part of ronin-support.
|
5
5
|
#
|
6
|
-
#
|
6
|
+
# ronin-support is free software: you can redistribute it and/or modify
|
7
7
|
# it under the terms of the GNU Lesser General Public License as published
|
8
8
|
# by the Free Software Foundation, either version 3 of the License, or
|
9
9
|
# (at your option) any later version.
|
10
10
|
#
|
11
|
-
#
|
11
|
+
# ronin-support is distributed in the hope that it will be useful,
|
12
12
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13
13
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14
14
|
# GNU Lesser General Public License for more details.
|
15
15
|
#
|
16
16
|
# You should have received a copy of the GNU Lesser General Public License
|
17
|
-
# along with
|
17
|
+
# along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
|
18
18
|
#
|
19
19
|
|
20
20
|
require 'ronin/network/udp'
|
@@ -0,0 +1,149 @@
|
|
1
|
+
#
|
2
|
+
# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
|
3
|
+
#
|
4
|
+
# This file is part of ronin-support.
|
5
|
+
#
|
6
|
+
# ronin-support is free software: you can redistribute it and/or modify
|
7
|
+
# it under the terms of the GNU Lesser General Public License as published
|
8
|
+
# by the Free Software Foundation, either version 3 of the License, or
|
9
|
+
# (at your option) any later version.
|
10
|
+
#
|
11
|
+
# ronin-support is distributed in the hope that it will be useful,
|
12
|
+
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13
|
+
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14
|
+
# GNU Lesser General Public License for more details.
|
15
|
+
#
|
16
|
+
# You should have received a copy of the GNU Lesser General Public License
|
17
|
+
# along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
|
18
|
+
#
|
19
|
+
|
20
|
+
require 'net/ftp'
|
21
|
+
|
22
|
+
module Ronin
|
23
|
+
module Network
|
24
|
+
#
|
25
|
+
# Provides helper methods for communicating with FTP servers.
|
26
|
+
#
|
27
|
+
# @since 0.5.0
|
28
|
+
#
|
29
|
+
module FTP
|
30
|
+
# Default FTP port
|
31
|
+
DEFAULT_PORT = 21
|
32
|
+
|
33
|
+
# Default FTP user
|
34
|
+
DEFAULT_USER = 'anonymous'
|
35
|
+
|
36
|
+
#
|
37
|
+
# Default port used by {FTP}.
|
38
|
+
#
|
39
|
+
# @return [Integer]
|
40
|
+
# The default Ronin FTP port.
|
41
|
+
#
|
42
|
+
# @api public
|
43
|
+
#
|
44
|
+
def self.default_port
|
45
|
+
@default_port ||= DEFAULT_PORT
|
46
|
+
end
|
47
|
+
|
48
|
+
#
|
49
|
+
# Sets the default port used by {FTP}.
|
50
|
+
#
|
51
|
+
# @param [Integer] new_port
|
52
|
+
# The new default Ronin FTP port.
|
53
|
+
#
|
54
|
+
# @api public
|
55
|
+
#
|
56
|
+
def self.default_port=(new_port)
|
57
|
+
@default_port = new_port
|
58
|
+
end
|
59
|
+
|
60
|
+
#
|
61
|
+
# Creates a connection to the FTP server.
|
62
|
+
#
|
63
|
+
# @param [String] host
|
64
|
+
# The host to connect to.
|
65
|
+
#
|
66
|
+
# @param [Hash] options
|
67
|
+
# Additional options.
|
68
|
+
#
|
69
|
+
# @option options [Integer] :port (FTP.default_port)
|
70
|
+
# The port to connect to.
|
71
|
+
#
|
72
|
+
# @option options [String] :user (DEFAULT_USER)
|
73
|
+
# The user to authenticate with.
|
74
|
+
#
|
75
|
+
# @option options [String] :password
|
76
|
+
# The password to authenticate with.
|
77
|
+
#
|
78
|
+
# @option options [String] :account
|
79
|
+
# The FTP account information to send via the `ACCT` command.
|
80
|
+
#
|
81
|
+
# @option options [Boolean] :passive (true)
|
82
|
+
# Specifies whether the FTP session should use passive mode.
|
83
|
+
#
|
84
|
+
# @yield [session]
|
85
|
+
# If a block is given, it will be passed an FTP session object.
|
86
|
+
#
|
87
|
+
# @yieldparam [Net::FTP] session
|
88
|
+
# The FTP session.
|
89
|
+
#
|
90
|
+
# @return [Net::FTP]
|
91
|
+
# The FTP session.
|
92
|
+
#
|
93
|
+
# @example
|
94
|
+
# ftp_connect('www.example.com', :user => 'joe', :password => 'secret')
|
95
|
+
#
|
96
|
+
# @api public
|
97
|
+
#
|
98
|
+
def ftp_connect(host,options={})
|
99
|
+
host = host.to_s
|
100
|
+
port = (options[:port] || FTP.default_port)
|
101
|
+
user = (options[:user] || DEFAULT_USER)
|
102
|
+
password = options[:password]
|
103
|
+
acct = options[:account]
|
104
|
+
|
105
|
+
session = Net::FTP.new
|
106
|
+
session.connect(host,port)
|
107
|
+
session.login(user,password,acct)
|
108
|
+
session.passive = options.fetch(:passive,true)
|
109
|
+
|
110
|
+
yield session if block_given?
|
111
|
+
return session
|
112
|
+
end
|
113
|
+
|
114
|
+
#
|
115
|
+
# Starts a session with the FTP server.
|
116
|
+
#
|
117
|
+
# @param [String] host
|
118
|
+
# The host to connect to.
|
119
|
+
#
|
120
|
+
# @param [Hash] options
|
121
|
+
# Additional options.
|
122
|
+
#
|
123
|
+
# @yield [session]
|
124
|
+
# If a block is given, it will be passed an FTP session object.
|
125
|
+
# After the block has returned, the session will be closed.
|
126
|
+
#
|
127
|
+
# @yieldparam [Net::FTP] session
|
128
|
+
# The FTP session.
|
129
|
+
#
|
130
|
+
# @example
|
131
|
+
# ftp_session('www.example.com', :user => 'joe') do |ftp|
|
132
|
+
# # ...
|
133
|
+
# end
|
134
|
+
#
|
135
|
+
# @see #ftp_connect
|
136
|
+
#
|
137
|
+
# @api public
|
138
|
+
#
|
139
|
+
def ftp_session(host,options={})
|
140
|
+
ftp = ftp_connect(host,options)
|
141
|
+
|
142
|
+
yield ftp if block_given?
|
143
|
+
|
144
|
+
ftp.close
|
145
|
+
return nil
|
146
|
+
end
|
147
|
+
end
|
148
|
+
end
|
149
|
+
end
|
data/lib/ronin/network/http.rb
CHANGED
@@ -1,20 +1,20 @@
|
|
1
1
|
#
|
2
|
-
# Copyright (c) 2006-
|
2
|
+
# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
|
3
3
|
#
|
4
|
-
# This file is part of
|
4
|
+
# This file is part of ronin-support.
|
5
5
|
#
|
6
|
-
#
|
6
|
+
# ronin-support is free software: you can redistribute it and/or modify
|
7
7
|
# it under the terms of the GNU Lesser General Public License as published
|
8
8
|
# by the Free Software Foundation, either version 3 of the License, or
|
9
9
|
# (at your option) any later version.
|
10
10
|
#
|
11
|
-
#
|
11
|
+
# ronin-support is distributed in the hope that it will be useful,
|
12
12
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13
13
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14
14
|
# GNU Lesser General Public License for more details.
|
15
15
|
#
|
16
16
|
# You should have received a copy of the GNU Lesser General Public License
|
17
|
-
# along with
|
17
|
+
# along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
|
18
18
|
#
|
19
19
|
|
20
20
|
require 'ronin/network/http/exceptions'
|
@@ -1,20 +1,20 @@
|
|
1
1
|
#
|
2
|
-
# Copyright (c) 2006-
|
2
|
+
# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
|
3
3
|
#
|
4
|
-
# This file is part of
|
4
|
+
# This file is part of ronin-support.
|
5
5
|
#
|
6
|
-
#
|
6
|
+
# ronin-support is free software: you can redistribute it and/or modify
|
7
7
|
# it under the terms of the GNU Lesser General Public License as published
|
8
8
|
# by the Free Software Foundation, either version 3 of the License, or
|
9
9
|
# (at your option) any later version.
|
10
10
|
#
|
11
|
-
#
|
11
|
+
# ronin-support is distributed in the hope that it will be useful,
|
12
12
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13
13
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14
14
|
# GNU Lesser General Public License for more details.
|
15
15
|
#
|
16
16
|
# You should have received a copy of the GNU Lesser General Public License
|
17
|
-
# along with
|
17
|
+
# along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
|
18
18
|
#
|
19
19
|
|
20
20
|
require 'ronin/network/http/exceptions/unknown_request'
|
@@ -1,20 +1,20 @@
|
|
1
1
|
#
|
2
|
-
# Copyright (c) 2006-
|
2
|
+
# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
|
3
3
|
#
|
4
|
-
# This file is part of
|
4
|
+
# This file is part of ronin-support.
|
5
5
|
#
|
6
|
-
#
|
6
|
+
# ronin-support is free software: you can redistribute it and/or modify
|
7
7
|
# it under the terms of the GNU Lesser General Public License as published
|
8
8
|
# by the Free Software Foundation, either version 3 of the License, or
|
9
9
|
# (at your option) any later version.
|
10
10
|
#
|
11
|
-
#
|
11
|
+
# ronin-support is distributed in the hope that it will be useful,
|
12
12
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13
13
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14
14
|
# GNU Lesser General Public License for more details.
|
15
15
|
#
|
16
16
|
# You should have received a copy of the GNU Lesser General Public License
|
17
|
-
# along with
|
17
|
+
# along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
|
18
18
|
#
|
19
19
|
|
20
20
|
module Ronin
|
@@ -1,20 +1,20 @@
|
|
1
1
|
#
|
2
|
-
# Copyright (c) 2006-
|
2
|
+
# Copyright (c) 2006-2021 Hal Brodigan (postmodern.mod3 at gmail.com)
|
3
3
|
#
|
4
|
-
# This file is part of
|
4
|
+
# This file is part of ronin-support.
|
5
5
|
#
|
6
|
-
#
|
6
|
+
# ronin-support is free software: you can redistribute it and/or modify
|
7
7
|
# it under the terms of the GNU Lesser General Public License as published
|
8
8
|
# by the Free Software Foundation, either version 3 of the License, or
|
9
9
|
# (at your option) any later version.
|
10
10
|
#
|
11
|
-
#
|
11
|
+
# ronin-support is distributed in the hope that it will be useful,
|
12
12
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
13
13
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
14
14
|
# GNU Lesser General Public License for more details.
|
15
15
|
#
|
16
16
|
# You should have received a copy of the GNU Lesser General Public License
|
17
|
-
# along with
|
17
|
+
# along with ronin-support. If not, see <https://www.gnu.org/licenses/>.
|
18
18
|
#
|
19
19
|
|
20
20
|
require 'ronin/network/http/exceptions/unknown_request'
|
@@ -51,7 +51,7 @@ module Ronin
|
|
51
51
|
#
|
52
52
|
# @api public
|
53
53
|
#
|
54
|
-
def
|
54
|
+
def self.proxy
|
55
55
|
@proxy ||= if ENV['HTTP_PROXY']
|
56
56
|
Proxy.parse(ENV['HTTP_PROXY'])
|
57
57
|
else
|
@@ -74,7 +74,7 @@ module Ronin
|
|
74
74
|
#
|
75
75
|
# @api public
|
76
76
|
#
|
77
|
-
def
|
77
|
+
def self.proxy=(new_proxy)
|
78
78
|
@proxy = Proxy.create(new_proxy)
|
79
79
|
end
|
80
80
|
|
@@ -86,7 +86,7 @@ module Ronin
|
|
86
86
|
#
|
87
87
|
# @api public
|
88
88
|
#
|
89
|
-
def
|
89
|
+
def self.user_agent
|
90
90
|
@user_agent ||= nil
|
91
91
|
end
|
92
92
|
|
@@ -98,7 +98,7 @@ module Ronin
|
|
98
98
|
#
|
99
99
|
# @api public
|
100
100
|
#
|
101
|
-
def
|
101
|
+
def self.user_agent=(agent)
|
102
102
|
@user_agent = agent
|
103
103
|
end
|
104
104
|
|
@@ -113,16 +113,13 @@ module Ronin
|
|
113
113
|
#
|
114
114
|
# @api private
|
115
115
|
#
|
116
|
-
def
|
116
|
+
def self.expand_url(url)
|
117
117
|
new_options = {}
|
118
118
|
|
119
119
|
url = case url
|
120
|
-
when URI
|
121
|
-
|
122
|
-
|
123
|
-
URI::HTTP.build(url)
|
124
|
-
else
|
125
|
-
URI(url.to_s)
|
120
|
+
when URI then url
|
121
|
+
when Hash then URI::HTTP.build(url)
|
122
|
+
else URI(url.to_s)
|
126
123
|
end
|
127
124
|
|
128
125
|
new_options[:ssl] = {} if url.scheme == 'https'
|
@@ -133,12 +130,8 @@ module Ronin
|
|
133
130
|
new_options[:user] = url.user if url.user
|
134
131
|
new_options[:password] = url.password if url.password
|
135
132
|
|
136
|
-
new_options[:path] = unless url.path.empty?
|
137
|
-
|
138
|
-
else
|
139
|
-
'/'
|
140
|
-
end
|
141
|
-
new_options[:path] += "?#{url.query}" if url.query
|
133
|
+
new_options[:path] = url.path unless url.path.empty?
|
134
|
+
new_options[:query] = url.query unless url.query.nil?
|
142
135
|
|
143
136
|
return new_options
|
144
137
|
end
|
@@ -155,7 +148,7 @@ module Ronin
|
|
155
148
|
# @option options [String] :host
|
156
149
|
# The host to connect to.
|
157
150
|
#
|
158
|
-
# @option options [String] :port (
|
151
|
+
# @option options [String] :port (Net::HTTP.default_port)
|
159
152
|
# The port to connect to.
|
160
153
|
#
|
161
154
|
# @option options [String] :user
|
@@ -175,7 +168,7 @@ module Ronin
|
|
175
168
|
#
|
176
169
|
# @api private
|
177
170
|
#
|
178
|
-
def
|
171
|
+
def self.expand_options(options={})
|
179
172
|
new_options = options.dup
|
180
173
|
|
181
174
|
new_options[:port] ||= Net::HTTP.default_port
|
@@ -210,7 +203,7 @@ module Ronin
|
|
210
203
|
#
|
211
204
|
# @api private
|
212
205
|
#
|
213
|
-
def
|
206
|
+
def self.header_name(name)
|
214
207
|
words = name.to_s.split(/[\s+_-]/)
|
215
208
|
|
216
209
|
words.each { |word| word.capitalize! }
|
@@ -229,11 +222,11 @@ module Ronin
|
|
229
222
|
#
|
230
223
|
# @api private
|
231
224
|
#
|
232
|
-
def
|
225
|
+
def self.headers(options={})
|
233
226
|
headers = {}
|
234
227
|
|
235
|
-
if
|
236
|
-
headers['User-Agent'] =
|
228
|
+
if user_agent
|
229
|
+
headers['User-Agent'] = user_agent
|
237
230
|
end
|
238
231
|
|
239
232
|
if options
|
@@ -292,7 +285,7 @@ module Ronin
|
|
292
285
|
#
|
293
286
|
# @api private
|
294
287
|
#
|
295
|
-
def
|
288
|
+
def self.request(options={})
|
296
289
|
unless options[:method]
|
297
290
|
raise(ArgumentError,"the :method option must be specified")
|
298
291
|
end
|
@@ -303,31 +296,33 @@ module Ronin
|
|
303
296
|
raise(UnknownRequest,"unknown HTTP request type #{name.dump}")
|
304
297
|
end
|
305
298
|
|
306
|
-
headers =
|
299
|
+
headers = headers(options[:headers])
|
307
300
|
path = (options[:path] || '/').to_s
|
308
301
|
query = if options[:query]
|
309
|
-
|
302
|
+
options[:query].to_s
|
310
303
|
elsif options[:query_params]
|
311
304
|
URI::QueryParams.dump(options[:query_params])
|
312
305
|
end
|
313
306
|
|
314
307
|
if query
|
315
308
|
# append the query-string onto the path
|
316
|
-
path += if path.include?('?')
|
317
|
-
|
318
|
-
else
|
319
|
-
"?#{query}"
|
309
|
+
path += if path.include?('?') then "&#{query}"
|
310
|
+
else "?#{query}"
|
320
311
|
end
|
321
312
|
end
|
322
313
|
|
323
314
|
request = Net::HTTP.const_get(name).new(path,headers)
|
324
315
|
|
325
|
-
if
|
326
|
-
|
327
|
-
|
328
|
-
|
329
|
-
request.body
|
316
|
+
if options[:form_data]
|
317
|
+
case options[:form_data]
|
318
|
+
when String
|
319
|
+
request.content_type = 'application/x-www-form-urlencoded'
|
320
|
+
request.body = options[:form_data]
|
321
|
+
else
|
322
|
+
request.form_data = options[:form_data]
|
330
323
|
end
|
324
|
+
elsif options[:body]
|
325
|
+
request.body = options[:body]
|
331
326
|
end
|
332
327
|
|
333
328
|
if options[:user]
|
@@ -505,13 +500,13 @@ module Ronin
|
|
505
500
|
# If the block has an arity of 2, it will also be passed the expanded
|
506
501
|
# version of the given _options_.
|
507
502
|
#
|
508
|
-
# @yieldparam [Net::
|
503
|
+
# @yieldparam [Net::HTTPRequest] request
|
509
504
|
# The HTTP request object to use in the request.
|
510
505
|
#
|
511
506
|
# @yieldparam [Hash] options
|
512
507
|
# The expanded version of the given _options_.
|
513
508
|
#
|
514
|
-
# @return [Net::
|
509
|
+
# @return [Net::HTTPResponse]
|
515
510
|
# The response of the HTTP request.
|
516
511
|
#
|
517
512
|
# @see #http_session
|
@@ -636,10 +631,10 @@ module Ronin
|
|
636
631
|
# If a block is given, it will be passed the response received
|
637
632
|
# from the request.
|
638
633
|
#
|
639
|
-
# @yieldparam [Net::
|
634
|
+
# @yieldparam [Net::HTTPResponse] response
|
640
635
|
# The HTTP response object.
|
641
636
|
#
|
642
|
-
# @return [Net::
|
637
|
+
# @return [Net::HTTPResponse]
|
643
638
|
# The response of the HTTP request.
|
644
639
|
#
|
645
640
|
# @see #http_request
|
@@ -663,10 +658,10 @@ module Ronin
|
|
663
658
|
# If a block is given, it will be passed the response received from
|
664
659
|
# the request.
|
665
660
|
#
|
666
|
-
# @yieldparam [Net::
|
661
|
+
# @yieldparam [Net::HTTPResponse] response
|
667
662
|
# The HTTP response object.
|
668
663
|
#
|
669
|
-
# @return [Net::
|
664
|
+
# @return [Net::HTTPResponse]
|
670
665
|
# The response of the HTTP request.
|
671
666
|
#
|
672
667
|
# @see #http_request
|
@@ -699,10 +694,10 @@ module Ronin
|
|
699
694
|
# If a block is given, it will be passed the response received from
|
700
695
|
# the request.
|
701
696
|
#
|
702
|
-
# @yieldparam [Net::
|
697
|
+
# @yieldparam [Net::HTTPResponse] response
|
703
698
|
# The HTTP response object.
|
704
699
|
#
|
705
|
-
# @return [Net::
|
700
|
+
# @return [Net::HTTPResponse]
|
706
701
|
# The response of the HTTP request.
|
707
702
|
#
|
708
703
|
# @see #http_request
|
@@ -768,10 +763,10 @@ module Ronin
|
|
768
763
|
# If a block is given, it will be passed the response received from
|
769
764
|
# the request.
|
770
765
|
#
|
771
|
-
# @yieldparam [Net::
|
766
|
+
# @yieldparam [Net::HTTPResponse] response
|
772
767
|
# The HTTP response object.
|
773
768
|
#
|
774
|
-
# @return [Net::
|
769
|
+
# @return [Net::HTTPResponse]
|
775
770
|
# The response of the HTTP request.
|
776
771
|
#
|
777
772
|
# @see #http_request
|
@@ -795,10 +790,10 @@ module Ronin
|
|
795
790
|
# If a block is given, it will be passed the response received from
|
796
791
|
# the request.
|
797
792
|
#
|
798
|
-
# @yieldparam [Net::
|
793
|
+
# @yieldparam [Net::HTTPResponse] response
|
799
794
|
# The HTTP response object.
|
800
795
|
#
|
801
|
-
# @return [Net::
|
796
|
+
# @return [Net::HTTPResponse]
|
802
797
|
# The response of the HTTP request.
|
803
798
|
#
|
804
799
|
# @see #http_request
|
@@ -822,10 +817,10 @@ module Ronin
|
|
822
817
|
# If a block is given, it will be passed the response received from
|
823
818
|
# the request.
|
824
819
|
#
|
825
|
-
# @yieldparam [Net::
|
820
|
+
# @yieldparam [Net::HTTPResponse] response
|
826
821
|
# The HTTP response object.
|
827
822
|
#
|
828
|
-
# @return [Net::
|
823
|
+
# @return [Net::HTTPResponse]
|
829
824
|
# The response of the HTTP request.
|
830
825
|
#
|
831
826
|
# @see #http_request
|
@@ -849,10 +844,10 @@ module Ronin
|
|
849
844
|
# If a block is given, it will be passed the response received from
|
850
845
|
# the request.
|
851
846
|
#
|
852
|
-
# @yieldparam [Net::
|
847
|
+
# @yieldparam [Net::HTTPResponse] response
|
853
848
|
# The HTTP response object.
|
854
849
|
#
|
855
|
-
# @return [Net::
|
850
|
+
# @return [Net::HTTPResponse]
|
856
851
|
# The response of the HTTP request.
|
857
852
|
#
|
858
853
|
# @see #http_request
|
@@ -876,10 +871,10 @@ module Ronin
|
|
876
871
|
# If a block is given, it will be passed the response received from
|
877
872
|
# the request.
|
878
873
|
#
|
879
|
-
# @yieldparam [Net::
|
874
|
+
# @yieldparam [Net::HTTPResponse] response
|
880
875
|
# The HTTP response object.
|
881
876
|
#
|
882
|
-
# @return [Net::
|
877
|
+
# @return [Net::HTTPResponse]
|
883
878
|
# The response of the HTTP request.
|
884
879
|
#
|
885
880
|
# @see #http_request
|
@@ -906,10 +901,10 @@ module Ronin
|
|
906
901
|
# If a block is given, it will be passed the response received from
|
907
902
|
# the request.
|
908
903
|
#
|
909
|
-
# @yieldparam [Net::
|
904
|
+
# @yieldparam [Net::HTTPResponse] response
|
910
905
|
# The HTTP response object.
|
911
906
|
#
|
912
|
-
# @return [Net::
|
907
|
+
# @return [Net::HTTPResponse]
|
913
908
|
# The response of the HTTP request.
|
914
909
|
#
|
915
910
|
# @see #http_request
|
@@ -987,10 +982,10 @@ module Ronin
|
|
987
982
|
# If a block is given, it will be passed the response received from
|
988
983
|
# the request.
|
989
984
|
#
|
990
|
-
# @yieldparam [Net::
|
985
|
+
# @yieldparam [Net::HTTPResponse] response
|
991
986
|
# The HTTP response object.
|
992
987
|
#
|
993
|
-
# @return [Net::
|
988
|
+
# @return [Net::HTTPResponse]
|
994
989
|
# The response of the HTTP request.
|
995
990
|
#
|
996
991
|
# @see #http_request
|
@@ -1016,10 +1011,10 @@ module Ronin
|
|
1016
1011
|
# If a block is given, it will be passed the response received from
|
1017
1012
|
# the request.
|
1018
1013
|
#
|
1019
|
-
# @yieldparam [Net::
|
1014
|
+
# @yieldparam [Net::HTTPResponse] response
|
1020
1015
|
# The HTTP response object.
|
1021
1016
|
#
|
1022
|
-
# @return [Net::
|
1017
|
+
# @return [Net::HTTPResponse]
|
1023
1018
|
# The response of the HTTP request.
|
1024
1019
|
#
|
1025
1020
|
# @see #http_request
|
@@ -1052,10 +1047,10 @@ module Ronin
|
|
1052
1047
|
# If a block is given, it will be passed the response received from
|
1053
1048
|
# the request.
|
1054
1049
|
#
|
1055
|
-
# @yieldparam [Net::
|
1050
|
+
# @yieldparam [Net::HTTPResponse] response
|
1056
1051
|
# The HTTP response object.
|
1057
1052
|
#
|
1058
|
-
# @return [Net::
|
1053
|
+
# @return [Net::HTTPResponse]
|
1059
1054
|
# The response of the HTTP request.
|
1060
1055
|
#
|
1061
1056
|
# @see #http_request
|
@@ -1079,10 +1074,10 @@ module Ronin
|
|
1079
1074
|
# If a block is given, it will be passed the response received from
|
1080
1075
|
# the request.
|
1081
1076
|
#
|
1082
|
-
# @yieldparam [Net::
|
1077
|
+
# @yieldparam [Net::HTTPResponse] response
|
1083
1078
|
# The HTTP response object.
|
1084
1079
|
#
|
1085
|
-
# @return [Net::
|
1080
|
+
# @return [Net::HTTPResponse]
|
1086
1081
|
# The response of the HTTP request.
|
1087
1082
|
#
|
1088
1083
|
# @see #http_request
|
@@ -1106,10 +1101,10 @@ module Ronin
|
|
1106
1101
|
# If a block is given, it will be passed the response received from
|
1107
1102
|
# the request.
|
1108
1103
|
#
|
1109
|
-
# @yieldparam [Net::
|
1104
|
+
# @yieldparam [Net::HTTPResponse] response
|
1110
1105
|
# The HTTP response object.
|
1111
1106
|
#
|
1112
|
-
# @return [Net::
|
1107
|
+
# @return [Net::HTTPResponse]
|
1113
1108
|
# The response of the HTTP request.
|
1114
1109
|
#
|
1115
1110
|
# @see #http_request
|