ronin-exploits 0.3.1 → 1.0.0.beta2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (338) hide show
  1. checksums.yaml +7 -0
  2. data/.document +4 -0
  3. data/.editorconfig +11 -0
  4. data/.github/workflows/ruby.yml +31 -0
  5. data/.gitignore +13 -0
  6. data/.mailmap +1 -0
  7. data/.rspec +1 -0
  8. data/.ruby-version +1 -0
  9. data/.yardopts +1 -0
  10. data/COPYING.txt +161 -335
  11. data/{History.txt → ChangeLog.md} +119 -16
  12. data/Gemfile +50 -0
  13. data/README.md +454 -0
  14. data/Rakefile +37 -23
  15. data/bin/ronin-exploits +13 -6
  16. data/data/new/exploit.rb.erb +158 -0
  17. data/gemspec.yml +44 -0
  18. data/lib/ronin/exploits/advisory.rb +84 -0
  19. data/lib/ronin/exploits/cli/command.rb +39 -0
  20. data/lib/ronin/exploits/cli/commands/irb.rb +57 -0
  21. data/lib/ronin/exploits/cli/commands/list.rb +80 -0
  22. data/lib/ronin/exploits/cli/commands/new.rb +332 -0
  23. data/lib/ronin/exploits/cli/commands/run.rb +396 -0
  24. data/lib/ronin/exploits/cli/commands/show.rb +290 -0
  25. data/lib/ronin/exploits/cli/exploit_command.rb +114 -0
  26. data/lib/ronin/exploits/cli/exploit_methods.rb +114 -0
  27. data/lib/ronin/exploits/cli/ruby_shell.rb +51 -0
  28. data/lib/ronin/exploits/cli.rb +51 -0
  29. data/lib/ronin/exploits/client_side_web_vuln.rb +69 -0
  30. data/lib/ronin/exploits/exceptions.rb +27 -17
  31. data/lib/ronin/exploits/exploit.rb +501 -582
  32. data/lib/ronin/exploits/heap_overflow.rb +50 -0
  33. data/lib/ronin/exploits/lfi.rb +141 -0
  34. data/lib/ronin/exploits/loot/file.rb +113 -0
  35. data/lib/ronin/exploits/loot.rb +119 -0
  36. data/lib/ronin/exploits/memory_corruption.rb +53 -0
  37. data/lib/ronin/exploits/metadata/arch.rb +83 -0
  38. data/lib/ronin/exploits/metadata/cookie_param.rb +80 -0
  39. data/lib/ronin/exploits/metadata/default_filename.rb +69 -0
  40. data/lib/ronin/exploits/metadata/default_port.rb +69 -0
  41. data/lib/ronin/exploits/metadata/header_name.rb +80 -0
  42. data/lib/ronin/exploits/metadata/os.rb +117 -0
  43. data/lib/ronin/exploits/metadata/shouts.rb +85 -0
  44. data/lib/ronin/exploits/metadata/url_path.rb +82 -0
  45. data/lib/ronin/exploits/metadata/url_query_param.rb +80 -0
  46. data/lib/ronin/exploits/mixins/binary.rb +106 -0
  47. data/lib/ronin/exploits/mixins/build_dir.rb +61 -0
  48. data/lib/ronin/exploits/mixins/file_builder.rb +102 -0
  49. data/lib/ronin/exploits/mixins/format_string.rb +87 -0
  50. data/lib/ronin/exploits/mixins/has_payload.rb +202 -0
  51. data/lib/ronin/exploits/mixins/has_targets.rb +297 -0
  52. data/lib/ronin/exploits/mixins/html.rb +213 -0
  53. data/lib/ronin/exploits/mixins/http.rb +866 -0
  54. data/lib/ronin/exploits/mixins/loot.rb +84 -0
  55. data/lib/ronin/exploits/mixins/nops.rb +121 -0
  56. data/lib/ronin/exploits/mixins/remote_tcp.rb +272 -0
  57. data/lib/ronin/exploits/mixins/remote_udp.rb +264 -0
  58. data/lib/ronin/exploits/mixins/seh.rb +136 -0
  59. data/lib/ronin/exploits/mixins/stack_overflow.rb +124 -0
  60. data/lib/ronin/exploits/mixins/text.rb +65 -0
  61. data/lib/ronin/exploits/mixins.rb +32 -0
  62. data/lib/ronin/exploits/open_redirect.rb +103 -0
  63. data/lib/ronin/exploits/params/base_url.rb +84 -0
  64. data/lib/ronin/exploits/params/bind_host.rb +53 -0
  65. data/lib/ronin/exploits/params/bind_port.rb +53 -0
  66. data/lib/ronin/exploits/params/filename.rb +71 -0
  67. data/lib/ronin/exploits/params/host.rb +56 -0
  68. data/lib/ronin/exploits/params/port.rb +71 -0
  69. data/lib/ronin/exploits/registry.rb +32 -0
  70. data/lib/ronin/exploits/rfi.rb +106 -0
  71. data/lib/ronin/exploits/root.rb +28 -0
  72. data/lib/ronin/exploits/seh_overflow.rb +90 -0
  73. data/lib/ronin/exploits/sqli.rb +172 -0
  74. data/lib/ronin/exploits/ssti.rb +108 -0
  75. data/lib/ronin/exploits/stack_overflow.rb +90 -0
  76. data/lib/ronin/exploits/target.rb +63 -103
  77. data/lib/ronin/exploits/test_result.rb +80 -0
  78. data/lib/ronin/exploits/use_after_free.rb +50 -0
  79. data/lib/ronin/exploits/version.rb +11 -12
  80. data/lib/ronin/exploits/web.rb +18 -89
  81. data/lib/ronin/exploits/web_vuln.rb +378 -0
  82. data/lib/ronin/exploits/xss.rb +102 -0
  83. data/lib/ronin/exploits.rb +19 -26
  84. data/man/ronin-exploits-irb.1 +31 -0
  85. data/man/ronin-exploits-irb.1.md +22 -0
  86. data/man/ronin-exploits-list.1 +37 -0
  87. data/man/ronin-exploits-list.1.md +27 -0
  88. data/man/ronin-exploits-new.1 +98 -0
  89. data/man/ronin-exploits-new.1.md +73 -0
  90. data/man/ronin-exploits-run.1 +117 -0
  91. data/man/ronin-exploits-run.1.md +87 -0
  92. data/man/ronin-exploits-show.1 +45 -0
  93. data/man/ronin-exploits-show.1.md +33 -0
  94. data/man/ronin-exploits.1 +55 -0
  95. data/man/ronin-exploits.1.md +41 -0
  96. data/ronin-exploits.gemspec +62 -0
  97. data/spec/advisory_spec.rb +71 -0
  98. data/spec/cli/exploit_command_spec.rb +68 -0
  99. data/spec/cli/exploit_methods_spec.rb +208 -0
  100. data/spec/cli/ruby_shell_spec.rb +14 -0
  101. data/spec/client_side_web_vuln_spec.rb +117 -0
  102. data/spec/exploit_spec.rb +538 -0
  103. data/spec/exploits_spec.rb +3 -4
  104. data/spec/heap_overflow_spec.rb +14 -0
  105. data/spec/lfi_spec.rb +162 -0
  106. data/spec/loot/file_spec.rb +131 -0
  107. data/spec/loot_spec.rb +138 -0
  108. data/spec/memory_corruption_spec.rb +22 -0
  109. data/spec/metadata/arch_spec.rb +82 -0
  110. data/spec/metadata/cookie_param_spec.rb +67 -0
  111. data/spec/metadata/default_filename_spec.rb +62 -0
  112. data/spec/metadata/default_port_spec.rb +62 -0
  113. data/spec/metadata/header_name_spec.rb +67 -0
  114. data/spec/metadata/os_spec.rb +164 -0
  115. data/spec/metadata/shouts_spec.rb +100 -0
  116. data/spec/metadata/url_path_spec.rb +67 -0
  117. data/spec/metadata/url_query_param_spec.rb +67 -0
  118. data/spec/mixins/binary_spec.rb +129 -0
  119. data/spec/mixins/build_dir.rb +66 -0
  120. data/spec/mixins/file_builder_spec.rb +67 -0
  121. data/spec/mixins/format_string_spec.rb +44 -0
  122. data/spec/mixins/has_payload_spec.rb +333 -0
  123. data/spec/mixins/has_targets_spec.rb +434 -0
  124. data/spec/mixins/html_spec.rb +772 -0
  125. data/spec/mixins/http_spec.rb +1227 -0
  126. data/spec/mixins/loot_spec.rb +20 -0
  127. data/spec/mixins/nops_spec.rb +165 -0
  128. data/spec/mixins/remote_tcp_spec.rb +217 -0
  129. data/spec/mixins/remote_udp_spec.rb +217 -0
  130. data/spec/mixins/seh_spec.rb +89 -0
  131. data/spec/mixins/stack_overflow_spec.rb +87 -0
  132. data/spec/mixins/text_spec.rb +43 -0
  133. data/spec/open_redirect_spec.rb +71 -0
  134. data/spec/params/base_url_spec.rb +71 -0
  135. data/spec/params/bind_host_spec.rb +34 -0
  136. data/spec/params/bind_port_spec.rb +35 -0
  137. data/spec/params/filename_spec.rb +77 -0
  138. data/spec/params/host_spec.rb +34 -0
  139. data/spec/params/port_spec.rb +77 -0
  140. data/spec/rfi_spec.rb +107 -0
  141. data/spec/seh_overflow_spec.rb +18 -0
  142. data/spec/spec_helper.rb +6 -10
  143. data/spec/sqli_spec.rb +306 -0
  144. data/spec/ssti_spec.rb +121 -0
  145. data/spec/stack_overflow_spec.rb +18 -0
  146. data/spec/target_spec.rb +92 -0
  147. data/spec/test_result_spec.rb +32 -0
  148. data/spec/use_after_free_spec.rb +14 -0
  149. data/spec/web_spec.rb +12 -0
  150. data/spec/web_vuln_spec.rb +854 -0
  151. data/spec/xss_spec.rb +69 -0
  152. metadata +361 -324
  153. data/Manifest.txt +0 -196
  154. data/README.txt +0 -274
  155. data/bin/ronin-exploit +0 -12
  156. data/bin/ronin-gen-binary-payload +0 -12
  157. data/bin/ronin-gen-exploit +0 -12
  158. data/bin/ronin-gen-ftp-exploit +0 -12
  159. data/bin/ronin-gen-http-exploit +0 -12
  160. data/bin/ronin-gen-local-exploit +0 -12
  161. data/bin/ronin-gen-nops +0 -12
  162. data/bin/ronin-gen-payload +0 -12
  163. data/bin/ronin-gen-remote-exploit +0 -12
  164. data/bin/ronin-gen-remote-tcp-exploit +0 -12
  165. data/bin/ronin-gen-remote-udp-exploit +0 -12
  166. data/bin/ronin-gen-shellcode +0 -12
  167. data/bin/ronin-gen-web-exploit +0 -12
  168. data/bin/ronin-payload +0 -12
  169. data/bin/ronin-payloads +0 -12
  170. data/lib/ronin/controls/behaviors.rb +0 -133
  171. data/lib/ronin/controls/exceptions/not_implemented.rb +0 -27
  172. data/lib/ronin/controls/exceptions/program_not_found.rb +0 -27
  173. data/lib/ronin/controls/exceptions.rb +0 -23
  174. data/lib/ronin/controls/file_system.rb +0 -145
  175. data/lib/ronin/controls/helpers/command_exec.rb +0 -143
  176. data/lib/ronin/controls/helpers/dir_create.rb +0 -42
  177. data/lib/ronin/controls/helpers/dir_listing.rb +0 -62
  178. data/lib/ronin/controls/helpers/dir_remove.rb +0 -42
  179. data/lib/ronin/controls/helpers/file_ctime.rb +0 -52
  180. data/lib/ronin/controls/helpers/file_mtime.rb +0 -53
  181. data/lib/ronin/controls/helpers/file_ownership.rb +0 -53
  182. data/lib/ronin/controls/helpers/file_read.rb +0 -62
  183. data/lib/ronin/controls/helpers/file_remove.rb +0 -51
  184. data/lib/ronin/controls/helpers/file_write.rb +0 -62
  185. data/lib/ronin/controls/helpers/memory_read.rb +0 -39
  186. data/lib/ronin/controls/helpers/memory_write.rb +0 -39
  187. data/lib/ronin/controls/helpers.rb +0 -33
  188. data/lib/ronin/controls.rb +0 -23
  189. data/lib/ronin/exploits/control.rb +0 -47
  190. data/lib/ronin/exploits/exceptions/exception.rb +0 -27
  191. data/lib/ronin/exploits/exceptions/exploit_not_built.rb +0 -29
  192. data/lib/ronin/exploits/exceptions/payload_size.rb +0 -29
  193. data/lib/ronin/exploits/exceptions/restricted_char.rb +0 -29
  194. data/lib/ronin/exploits/exceptions/target_data_missing.rb +0 -29
  195. data/lib/ronin/exploits/exceptions/target_unspecified.rb +0 -29
  196. data/lib/ronin/exploits/exceptions/unknown_helper.rb +0 -29
  197. data/lib/ronin/exploits/exploit_author.rb +0 -33
  198. data/lib/ronin/exploits/ftp.rb +0 -42
  199. data/lib/ronin/exploits/helpers/binary.rb +0 -50
  200. data/lib/ronin/exploits/helpers/buffer_overflow.rb +0 -115
  201. data/lib/ronin/exploits/helpers/file_based.rb +0 -112
  202. data/lib/ronin/exploits/helpers/format_string.rb +0 -117
  203. data/lib/ronin/exploits/helpers/padding.rb +0 -101
  204. data/lib/ronin/exploits/helpers.rb +0 -26
  205. data/lib/ronin/exploits/http.rb +0 -49
  206. data/lib/ronin/exploits/local.rb +0 -40
  207. data/lib/ronin/exploits/remote.rb +0 -40
  208. data/lib/ronin/exploits/remote_tcp.rb +0 -87
  209. data/lib/ronin/exploits/remote_udp.rb +0 -87
  210. data/lib/ronin/exploits/targets/buffer_overflow.rb +0 -46
  211. data/lib/ronin/exploits/targets/format_string.rb +0 -43
  212. data/lib/ronin/exploits/targets.rb +0 -27
  213. data/lib/ronin/exploits/verifiers.rb +0 -121
  214. data/lib/ronin/generators/exploits/exploit.rb +0 -70
  215. data/lib/ronin/generators/exploits/ftp.rb +0 -42
  216. data/lib/ronin/generators/exploits/http.rb +0 -42
  217. data/lib/ronin/generators/exploits/local.rb +0 -42
  218. data/lib/ronin/generators/exploits/remote.rb +0 -42
  219. data/lib/ronin/generators/exploits/remote_tcp.rb +0 -44
  220. data/lib/ronin/generators/exploits/remote_udp.rb +0 -44
  221. data/lib/ronin/generators/exploits/static.rb +0 -30
  222. data/lib/ronin/generators/exploits/web.rb +0 -45
  223. data/lib/ronin/generators/exploits.rb +0 -23
  224. data/lib/ronin/generators/payloads/binary_payload.rb +0 -42
  225. data/lib/ronin/generators/payloads/nops.rb +0 -42
  226. data/lib/ronin/generators/payloads/payload.rb +0 -66
  227. data/lib/ronin/generators/payloads/shellcode.rb +0 -42
  228. data/lib/ronin/generators/payloads/static.rb +0 -30
  229. data/lib/ronin/generators/payloads.rb +0 -23
  230. data/lib/ronin/model/has_default_port.rb +0 -54
  231. data/lib/ronin/model/targets_arch.rb +0 -68
  232. data/lib/ronin/model/targets_os.rb +0 -69
  233. data/lib/ronin/model/targets_product.rb +0 -68
  234. data/lib/ronin/payloads/asm_payload.rb +0 -40
  235. data/lib/ronin/payloads/binary_payload.rb +0 -42
  236. data/lib/ronin/payloads/control.rb +0 -47
  237. data/lib/ronin/payloads/encoders/encoder.rb +0 -92
  238. data/lib/ronin/payloads/encoders/xor.rb +0 -79
  239. data/lib/ronin/payloads/encoders.rb +0 -32
  240. data/lib/ronin/payloads/exceptions/exception.rb +0 -27
  241. data/lib/ronin/payloads/exceptions/not_implemented.rb +0 -29
  242. data/lib/ronin/payloads/exceptions/unknown_helper.rb +0 -29
  243. data/lib/ronin/payloads/exceptions.rb +0 -23
  244. data/lib/ronin/payloads/has_payload.rb +0 -111
  245. data/lib/ronin/payloads/helpers/chained.rb +0 -61
  246. data/lib/ronin/payloads/helpers/rpc.rb +0 -93
  247. data/lib/ronin/payloads/helpers.rb +0 -23
  248. data/lib/ronin/payloads/nops.rb +0 -39
  249. data/lib/ronin/payloads/payload.rb +0 -350
  250. data/lib/ronin/payloads/payload_author.rb +0 -33
  251. data/lib/ronin/payloads/shellcode.rb +0 -40
  252. data/lib/ronin/payloads/web_payload.rb +0 -41
  253. data/lib/ronin/payloads.rb +0 -36
  254. data/lib/ronin/ui/command_line/commands/exploit.rb +0 -193
  255. data/lib/ronin/ui/command_line/commands/exploits.rb +0 -154
  256. data/lib/ronin/ui/command_line/commands/gen_binary_payload.rb +0 -34
  257. data/lib/ronin/ui/command_line/commands/gen_exploit.rb +0 -34
  258. data/lib/ronin/ui/command_line/commands/gen_ftp_exploit.rb +0 -34
  259. data/lib/ronin/ui/command_line/commands/gen_http_exploit.rb +0 -34
  260. data/lib/ronin/ui/command_line/commands/gen_local_exploit.rb +0 -34
  261. data/lib/ronin/ui/command_line/commands/gen_nops.rb +0 -34
  262. data/lib/ronin/ui/command_line/commands/gen_payload.rb +0 -34
  263. data/lib/ronin/ui/command_line/commands/gen_remote_exploit.rb +0 -34
  264. data/lib/ronin/ui/command_line/commands/gen_remote_tcp_exploit.rb +0 -34
  265. data/lib/ronin/ui/command_line/commands/gen_remote_udp_exploit.rb +0 -34
  266. data/lib/ronin/ui/command_line/commands/gen_shellcode.rb +0 -34
  267. data/lib/ronin/ui/command_line/commands/gen_web_exploit.rb +0 -34
  268. data/lib/ronin/ui/command_line/commands/payload.rb +0 -129
  269. data/lib/ronin/ui/command_line/commands/payloads.rb +0 -128
  270. data/lib/ronin/vuln/behavior.rb +0 -165
  271. data/spec/controls/behaviors_examples.rb +0 -38
  272. data/spec/exploits/binary_exploit_spec.rb +0 -44
  273. data/spec/exploits/buffer_overflow_exploit_spec.rb +0 -70
  274. data/spec/exploits/exploit_spec.rb +0 -313
  275. data/spec/exploits/file_based_exploit_spec.rb +0 -48
  276. data/spec/exploits/format_string_exploit_spec.rb +0 -32
  277. data/spec/exploits/ftp_spec.rb +0 -13
  278. data/spec/exploits/http_spec.rb +0 -17
  279. data/spec/exploits/padding_exploit_spec.rb +0 -44
  280. data/spec/exploits/remote_tcp_spec.rb +0 -28
  281. data/spec/exploits/remote_udp_spec.rb +0 -28
  282. data/spec/exploits/target_spec.rb +0 -98
  283. data/spec/exploits/targets/buffer_overflow_spec.rb +0 -22
  284. data/spec/exploits/web_spec.rb +0 -35
  285. data/spec/generators/exploits/exploit_examples.rb +0 -24
  286. data/spec/generators/exploits/exploit_spec.rb +0 -42
  287. data/spec/generators/exploits/ftp_spec.rb +0 -42
  288. data/spec/generators/exploits/http_spec.rb +0 -42
  289. data/spec/generators/exploits/local_spec.rb +0 -42
  290. data/spec/generators/exploits/remote_spec.rb +0 -42
  291. data/spec/generators/exploits/remote_tcp_spec.rb +0 -47
  292. data/spec/generators/exploits/remote_udp_spec.rb +0 -47
  293. data/spec/generators/exploits/web_spec.rb +0 -52
  294. data/spec/generators/payloads/binary_payload_spec.rb +0 -31
  295. data/spec/generators/payloads/nops_spec.rb +0 -31
  296. data/spec/generators/payloads/payload_examples.rb +0 -16
  297. data/spec/generators/payloads/payload_spec.rb +0 -31
  298. data/spec/generators/payloads/shellcode_spec.rb +0 -31
  299. data/spec/helpers/database.rb +0 -5
  300. data/spec/helpers/objects.rb +0 -22
  301. data/spec/model/has_default_port_spec.rb +0 -27
  302. data/spec/model/models/default_port_model.rb +0 -13
  303. data/spec/model/models/non_default_port_model.rb +0 -11
  304. data/spec/model/models/targets_arch_model.rb +0 -11
  305. data/spec/model/models/targets_os_model.rb +0 -11
  306. data/spec/model/models/targets_product_model.rb +0 -11
  307. data/spec/model/targets_arch_spec.rb +0 -32
  308. data/spec/model/targets_os_spec.rb +0 -33
  309. data/spec/model/targets_product_spec.rb +0 -35
  310. data/spec/objects/exploits/example.rb +0 -25
  311. data/spec/objects/exploits/simple.rb +0 -24
  312. data/spec/objects/payloads/simple.rb +0 -19
  313. data/spec/payloads/encoders/encoder_spec.rb +0 -30
  314. data/spec/payloads/encoders/xor_spec.rb +0 -20
  315. data/spec/payloads/payload_spec.rb +0 -156
  316. data/spec/vuln/behavior_spec.rb +0 -15
  317. data/static/ronin/generators/exploits/_cache.erb +0 -14
  318. data/static/ronin/generators/exploits/_header.erb +0 -1
  319. data/static/ronin/generators/exploits/_helpers.erb +0 -4
  320. data/static/ronin/generators/exploits/exploit.erb +0 -24
  321. data/static/ronin/generators/exploits/ftp.erb +0 -24
  322. data/static/ronin/generators/exploits/http.erb +0 -26
  323. data/static/ronin/generators/exploits/local.erb +0 -24
  324. data/static/ronin/generators/exploits/remote.erb +0 -24
  325. data/static/ronin/generators/exploits/remote_tcp.erb +0 -26
  326. data/static/ronin/generators/exploits/remote_udp.erb +0 -26
  327. data/static/ronin/generators/exploits/web.erb +0 -28
  328. data/static/ronin/generators/payloads/_cache.erb +0 -10
  329. data/static/ronin/generators/payloads/_header.erb +0 -1
  330. data/static/ronin/generators/payloads/_helpers.erb +0 -2
  331. data/static/ronin/generators/payloads/binary_payload.erb +0 -25
  332. data/static/ronin/generators/payloads/nops.erb +0 -19
  333. data/static/ronin/generators/payloads/payload.erb +0 -25
  334. data/static/ronin/generators/payloads/shellcode.erb +0 -25
  335. data/tasks/spec.rb +0 -10
  336. data/tasks/yard.rb +0 -13
  337. data.tar.gz.sig +0 -0
  338. metadata.gz.sig +0 -0
@@ -0,0 +1,69 @@
1
+ #
2
+ # ronin-exploits - A Ruby library for ronin-rb that provides exploitation and
3
+ # payload crafting functionality.
4
+ #
5
+ # Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
6
+ #
7
+ # ronin-exploits is free software: you can redistribute it and/or modify
8
+ # it under the terms of the GNU Lesser General Public License as published
9
+ # by the Free Software Foundation, either version 3 of the License, or
10
+ # (at your option) any later version.
11
+ #
12
+ # ronin-exploits is distributed in the hope that it will be useful,
13
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
14
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15
+ # GNU Lesser General Public License for more details.
16
+ #
17
+ # You should have received a copy of the GNU Lesser General Public License
18
+ # along with ronin-exploits. If not, see <https://www.gnu.org/licenses/>.
19
+ #
20
+
21
+ module Ronin
22
+ module Exploits
23
+ module Metadata
24
+ #
25
+ # Metadata mixin that allows an exploit to define a default port number.
26
+ #
27
+ module DefaultPort
28
+ #
29
+ # Adds an {ClassMethods#default_port default_port} metadata attribute
30
+ # to the exploit.
31
+ #
32
+ # @param [Class<Ronin::Exploits::Exploit>] exploit
33
+ # The exploit class that is including {Metadata::DefaultPort}.
34
+ #
35
+ # @api private
36
+ #
37
+ def self.included(exploit)
38
+ exploit.extend ClassMethods
39
+ end
40
+
41
+ module ClassMethods
42
+ #
43
+ # Gets or sets the exploits's default port.
44
+ #
45
+ # @param [Integer, nil] new_default_port
46
+ # The optional new default port number to set.
47
+ #
48
+ # @return [Integer, nil]
49
+ # The exploit's default port number.
50
+ #
51
+ # @example
52
+ # default_port 143
53
+ #
54
+ # @api public
55
+ #
56
+ def default_port(new_default_port=nil)
57
+ if new_default_port
58
+ @default_port = new_default_port
59
+ else
60
+ @default_port ||= if superclass.kind_of?(ClassMethods)
61
+ superclass.default_port
62
+ end
63
+ end
64
+ end
65
+ end
66
+ end
67
+ end
68
+ end
69
+ end
@@ -0,0 +1,80 @@
1
+ #
2
+ # ronin-exploits - A Ruby library for ronin-rb that provides exploitation and
3
+ # payload crafting functionality.
4
+ #
5
+ # Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
6
+ #
7
+ # ronin-exploits is free software: you can redistribute it and/or modify
8
+ # it under the terms of the GNU Lesser General Public License as published
9
+ # by the Free Software Foundation, either version 3 of the License, or
10
+ # (at your option) any later version.
11
+ #
12
+ # ronin-exploits is distributed in the hope that it will be useful,
13
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
14
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15
+ # GNU Lesser General Public License for more details.
16
+ #
17
+ # You should have received a copy of the GNU Lesser General Public License
18
+ # along with ronin-exploits. If not, see <https://www.gnu.org/licenses/>.
19
+ #
20
+
21
+ module Ronin
22
+ module Exploits
23
+ module Metadata
24
+ #
25
+ # Adds a {HeaderName::ClassMethods#header_name header_name} metadata
26
+ # attribute to an exploit class.
27
+ #
28
+ module HeaderName
29
+ #
30
+ # Adds {ClassMethods} to the exploit class.
31
+ #
32
+ # @param [Class<Exploit>] exploit
33
+ # The exploit class including {URLQueryParam}.
34
+ #
35
+ # @api private
36
+ #
37
+ def self.included(exploit)
38
+ exploit.extend ClassMethods
39
+ end
40
+
41
+ module ClassMethods
42
+ #
43
+ # Get or sets the target HTTP Header name of the exploit.
44
+ #
45
+ # @param [String, nil] new_header_name
46
+ # The optional new HTTP Header name to set.
47
+ #
48
+ # @return [String, nil]
49
+ # The set HTTP Header name value.
50
+ #
51
+ # @api public
52
+ #
53
+ def header_name(new_header_name=nil)
54
+ if new_header_name
55
+ @header_name = new_header_name
56
+ else
57
+ @header_name ||= if superclass.kind_of?(ClassMethods)
58
+ superclass.header_name
59
+ end
60
+ end
61
+ end
62
+ end
63
+
64
+ #
65
+ # The target HTTP Header name of the exploit.
66
+ #
67
+ # @return [String, nil]
68
+ # The HTTP Header name to exploit.
69
+ #
70
+ # @api public
71
+ #
72
+ # @see ClassMethods#header_name
73
+ #
74
+ def header_name
75
+ self.class.header_name
76
+ end
77
+ end
78
+ end
79
+ end
80
+ end
@@ -0,0 +1,117 @@
1
+ #
2
+ # ronin-exploits - A Ruby library for ronin-rb that provides exploitation and
3
+ # payload crafting functionality.
4
+ #
5
+ # Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
6
+ #
7
+ # ronin-exploits is free software: you can redistribute it and/or modify
8
+ # it under the terms of the GNU Lesser General Public License as published
9
+ # by the Free Software Foundation, either version 3 of the License, or
10
+ # (at your option) any later version.
11
+ #
12
+ # ronin-exploits is distributed in the hope that it will be useful,
13
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
14
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15
+ # GNU Lesser General Public License for more details.
16
+ #
17
+ # You should have received a copy of the GNU Lesser General Public License
18
+ # along with ronin-exploits. If not, see <https://www.gnu.org/licenses/>.
19
+ #
20
+
21
+ module Ronin
22
+ module Exploits
23
+ module Metadata
24
+ #
25
+ # Metadata mixin that allows a exploit to define which
26
+ # Operating System (OS) it specifically targets.
27
+ #
28
+ module OS
29
+ #
30
+ # Adds an {ClassMethods#os os} and {ClassMethods#os_version os_version}
31
+ # metadata attributes to the exploit.
32
+ #
33
+ # @param [Class<Ronin::Exploits::Exploit>] exploit
34
+ # The exploit class that is including {Metadata::OS}.
35
+ #
36
+ # @api private
37
+ #
38
+ def self.included(exploit)
39
+ exploit.extend ClassMethods
40
+ end
41
+
42
+ module ClassMethods
43
+ #
44
+ # Gets or sets the exploit's targeted Operating System (OS).
45
+ #
46
+ # @param [:unix, :bsd, :freebsd, :openbsd, :netbsd, :linux, :macos, :windows, nil] new_os
47
+ # The optional new Operating System (OS) to set.
48
+ #
49
+ # @return [:unix, :bsd, :freebsd, :openbsd, :netbsd, :linux, :macos, :windows, nil]
50
+ # The exploit's Operating System (OS).
51
+ #
52
+ # @example
53
+ # os :linux
54
+ #
55
+ # @api public
56
+ #
57
+ def os(new_os=nil)
58
+ if new_os
59
+ @os = new_os
60
+ else
61
+ @os ||= if superclass.kind_of?(ClassMethods)
62
+ superclass.os
63
+ end
64
+ end
65
+ end
66
+
67
+ #
68
+ # Gets or sets the exploit's targeted Operating System (OS) version.
69
+ #
70
+ # @param [String, nil] new_os_version
71
+ # The optional new Operating System (OS) version to set.
72
+ #
73
+ # @return [String, nil]
74
+ # The exploit's Operating System (OS) version.
75
+ #
76
+ # @example
77
+ # os :linux
78
+ # os_version '5.x'
79
+ #
80
+ # @api public
81
+ #
82
+ def os_version(new_os_version=nil)
83
+ if new_os_version
84
+ @os_version = new_os_version
85
+ else
86
+ @os_version ||= if superclass.kind_of?(ClassMethods)
87
+ superclass.os_version
88
+ end
89
+ end
90
+ end
91
+ end
92
+
93
+ #
94
+ # The Operating System (OS) that the exploit targets.
95
+ #
96
+ # @return [:unix, :bsd, :freebsd, :openbsd, :netbsd, :linux, :macos, :windows, nil]
97
+ #
98
+ # @see ClassMethods#os
99
+ #
100
+ def os
101
+ self.class.os
102
+ end
103
+
104
+ #
105
+ # The Operating System (OS) version that the exploit targets.
106
+ #
107
+ # @return [String, nil]
108
+ #
109
+ # @see ClassMethods#os_version
110
+ #
111
+ def os_version
112
+ self.class.os_version
113
+ end
114
+ end
115
+ end
116
+ end
117
+ end
@@ -0,0 +1,85 @@
1
+ #
2
+ # ronin-exploits - A Ruby library for ronin-rb that provides exploitation and
3
+ # payload crafting functionality.
4
+ #
5
+ # Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
6
+ #
7
+ # ronin-exploits is free software: you can redistribute it and/or modify
8
+ # it under the terms of the GNU Lesser General Public License as published
9
+ # by the Free Software Foundation, either version 3 of the License, or
10
+ # (at your option) any later version.
11
+ #
12
+ # ronin-exploits is distributed in the hope that it will be useful,
13
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
14
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15
+ # GNU Lesser General Public License for more details.
16
+ #
17
+ # You should have received a copy of the GNU Lesser General Public License
18
+ # along with ronin-exploits. If not, see <https://www.gnu.org/licenses/>.
19
+ #
20
+
21
+ module Ronin
22
+ module Exploits
23
+ module Metadata
24
+ #
25
+ # Adds a {Shouts::ClassMethods#shouts shouts} metadata
26
+ # attribute to a class.
27
+ #
28
+ # ### Example
29
+ #
30
+ # require 'ronin/exploits/metadata/shouts'
31
+ #
32
+ # class MyExploit < Exploit
33
+ #
34
+ # include Metadata::Shouts
35
+ #
36
+ # shouts ['Ultra Laser', 'Dr.Doom']
37
+ #
38
+ # end
39
+ #
40
+ module Shouts
41
+ #
42
+ # Adds {ClassMethods} to the class.
43
+ #
44
+ # @param [Class] base
45
+ # The base class which is including {Shouts}.
46
+ #
47
+ # @api private
48
+ #
49
+ def self.included(base)
50
+ base.extend ClassMethods
51
+ end
52
+
53
+ module ClassMethods
54
+ #
55
+ # Gets or sets the exploit's shouts.
56
+ #
57
+ # @param [Array<String>, nil] new_shouts
58
+ # The optional new shout list to set.
59
+ #
60
+ # @return [Array<String>]
61
+ # The previously set shout list.
62
+ #
63
+ # @example Set the shouts:
64
+ # shouts ['Ultra Laser', 'Dr.Doom']
65
+ #
66
+ # @example Get the shout links:
67
+ # MyExploit.shouts
68
+ # # => ["Ultra Laser", "Dr.Doom"]
69
+ #
70
+ def shouts(new_shouts=nil)
71
+ if new_shouts
72
+ @shouts = shouts() + new_shouts
73
+ else
74
+ @shouts || if superclass.kind_of?(ClassMethods)
75
+ superclass.shouts
76
+ else
77
+ []
78
+ end
79
+ end
80
+ end
81
+ end
82
+ end
83
+ end
84
+ end
85
+ end
@@ -0,0 +1,82 @@
1
+ #
2
+ # ronin-exploits - A Ruby library for ronin-rb that provides exploitation and
3
+ # payload crafting functionality.
4
+ #
5
+ # Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
6
+ #
7
+ # ronin-exploits is free software: you can redistribute it and/or modify
8
+ # it under the terms of the GNU Lesser General Public License as published
9
+ # by the Free Software Foundation, either version 3 of the License, or
10
+ # (at your option) any later version.
11
+ #
12
+ # ronin-exploits is distributed in the hope that it will be useful,
13
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
14
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15
+ # GNU Lesser General Public License for more details.
16
+ #
17
+ # You should have received a copy of the GNU Lesser General Public License
18
+ # along with ronin-exploits. If not, see <https://www.gnu.org/licenses/>.
19
+ #
20
+
21
+ module Ronin
22
+ module Exploits
23
+ module Metadata
24
+ #
25
+ # Adds a {URLPath::ClassMethods#url_path url_path} metadata attribute
26
+ # to an exploit class.
27
+ #
28
+ module URLPath
29
+ #
30
+ # Adds {ClassMethods} to the exploit class.
31
+ #
32
+ # @param [Class<Exploit>] exploit
33
+ # The exploit class including {URLQueryParam}.
34
+ #
35
+ # @api private
36
+ #
37
+ def self.included(exploit)
38
+ exploit.extend ClassMethods
39
+ end
40
+
41
+ module ClassMethods
42
+ #
43
+ # Get or sets the target URL path of the exploit.
44
+ #
45
+ # @param [String, nil] new_url_path
46
+ # The optional new URL path value to set.
47
+ #
48
+ # @return [String]
49
+ # The URL path value. Defaults to `"/"` if not set.
50
+ #
51
+ # @api public
52
+ #
53
+ def url_path(new_url_path=nil)
54
+ if new_url_path
55
+ @url_path = new_url_path
56
+ else
57
+ @url_path ||= if superclass.kind_of?(ClassMethods)
58
+ superclass.url_path
59
+ else
60
+ '/'
61
+ end
62
+ end
63
+ end
64
+ end
65
+
66
+ #
67
+ # The target URL path of the exploit.
68
+ #
69
+ # @return [String]
70
+ # The URL path to exploit. Defaults to `"/"` if not set in the class.
71
+ #
72
+ # @api public
73
+ #
74
+ # @see ClassMethods#url_path
75
+ #
76
+ def url_path
77
+ self.class.url_path
78
+ end
79
+ end
80
+ end
81
+ end
82
+ end
@@ -0,0 +1,80 @@
1
+ #
2
+ # ronin-exploits - A Ruby library for ronin-rb that provides exploitation and
3
+ # payload crafting functionality.
4
+ #
5
+ # Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
6
+ #
7
+ # ronin-exploits is free software: you can redistribute it and/or modify
8
+ # it under the terms of the GNU Lesser General Public License as published
9
+ # by the Free Software Foundation, either version 3 of the License, or
10
+ # (at your option) any later version.
11
+ #
12
+ # ronin-exploits is distributed in the hope that it will be useful,
13
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
14
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15
+ # GNU Lesser General Public License for more details.
16
+ #
17
+ # You should have received a copy of the GNU Lesser General Public License
18
+ # along with ronin-exploits. If not, see <https://www.gnu.org/licenses/>.
19
+ #
20
+
21
+ module Ronin
22
+ module Exploits
23
+ module Metadata
24
+ #
25
+ # Adds a {URLQueryParam::ClassMethods#url_query_param url_query_param}
26
+ # metadata attribute to an exploit class.
27
+ #
28
+ module URLQueryParam
29
+ #
30
+ # Adds {ClassMethods} to the exploit class.
31
+ #
32
+ # @param [Class<Exploit>] exploit
33
+ # The exploit class including {URLQueryParam}.
34
+ #
35
+ # @api private
36
+ #
37
+ def self.included(exploit)
38
+ exploit.extend ClassMethods
39
+ end
40
+
41
+ module ClassMethods
42
+ #
43
+ # Get or sets the target URL query param of the exploit.
44
+ #
45
+ # @param [String, nil] new_url_query_param
46
+ # The optional new URL query param value to set.
47
+ #
48
+ # @return [String, nil]
49
+ # The set URL query param value.
50
+ #
51
+ # @api public
52
+ #
53
+ def url_query_param(new_url_query_param=nil)
54
+ if new_url_query_param
55
+ @url_query_param = new_url_query_param
56
+ else
57
+ @url_query_param ||= if superclass.kind_of?(ClassMethods)
58
+ superclass.url_query_param
59
+ end
60
+ end
61
+ end
62
+ end
63
+
64
+ #
65
+ # The target URL query param of the exploit.
66
+ #
67
+ # @return [String, nil]
68
+ # The URL query param name to exploit.
69
+ #
70
+ # @api public
71
+ #
72
+ # @see ClassMethods#url_query_param
73
+ #
74
+ def url_query_param
75
+ self.class.url_query_param
76
+ end
77
+ end
78
+ end
79
+ end
80
+ end
@@ -0,0 +1,106 @@
1
+ #
2
+ # ronin-exploits - A Ruby library for ronin-rb that provides exploitation and
3
+ # payload crafting functionality.
4
+ #
5
+ # Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
6
+ #
7
+ # ronin-exploits is free software: you can redistribute it and/or modify
8
+ # it under the terms of the GNU Lesser General Public License as published
9
+ # by the Free Software Foundation, either version 3 of the License, or
10
+ # (at your option) any later version.
11
+ #
12
+ # ronin-exploits is distributed in the hope that it will be useful,
13
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
14
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15
+ # GNU Lesser General Public License for more details.
16
+ #
17
+ # You should have received a copy of the GNU Lesser General Public License
18
+ # along with ronin-exploits. If not, see <https://www.gnu.org/licenses/>.
19
+ #
20
+
21
+ require 'ronin/exploits/exceptions'
22
+ require 'ronin/support/binary/ctypes'
23
+
24
+ module Ronin
25
+ module Exploits
26
+ module Mixins
27
+ #
28
+ # Adds methods for packing binary data.
29
+ #
30
+ # @api public
31
+ #
32
+ # @since 1.0.0
33
+ #
34
+ module Binary
35
+ #
36
+ # Validates that the exploit defines an `arch` method and that all
37
+ # required params are set.
38
+ #
39
+ # @raise [ValidationError]
40
+ # The exploit did not define an `arch` method, usually defined by
41
+ # {Mixins::HasTargets} or {Metadata::Arch}.
42
+ #
43
+ # @raise [Ronin::Core::Params::RequiredParam]
44
+ # One of the required params was not set.
45
+ #
46
+ # @api semipublic
47
+ #
48
+ def perform_validate
49
+ unless respond_to?(:arch)
50
+ raise(ValidationError,"exploit #{self.class} did not include Ronin::Exploits::Metadata::Arch or Ronin::Exploits::Mixins::HasTargets")
51
+ end
52
+
53
+ unless arch
54
+ raise(ValidationError,"exploit #{self.class} did not include define an architecture")
55
+ end
56
+
57
+ super()
58
+ end
59
+
60
+ #
61
+ # The target platform.
62
+ #
63
+ # @return [Ronin::Support::Binary::CTypes,
64
+ # Ronin::Support::Binary::CTypes::LittleEndian,
65
+ # Ronin::Support::Binary::CTypes::BigEndian,
66
+ # Ronin::Support::Binary::CTypes::Network,
67
+ # Ronin::Support::Binary::CTypes::Arch::ARM,
68
+ # Ronin::Support::Binary::CTypes::Arch::ARM::BigEndian,
69
+ # Ronin::Support::Binary::CTypes::Arch::ARM64,
70
+ # Ronin::Support::Binary::CTypes::Arch::ARM64::BigEndian,
71
+ # Ronin::Support::Binary::CTypes::Arch::MIPS,
72
+ # Ronin::Support::Binary::CTypes::Arch::MIPS::LittleEndian,
73
+ # Ronin::Support::Binary::CTypes::Arch::MIPS64,
74
+ # Ronin::Support::Binary::CTypes::Arch::MIPS64::LittleEndian,
75
+ # Ronin::Support::Binary::CTypes::Arch::PPC,
76
+ # Ronin::Support::Binary::CTypes::Arch::PPC64,
77
+ # Ronin::Support::Binary::CTypes::Arch::X86,
78
+ # Ronin::Support::Binary::CTypes::Arch::X86_64,
79
+ # Ronin::Support::Binary::CTypes::OS]
80
+ #
81
+ def platform
82
+ @platform ||= Support::Binary::CTypes.platform(
83
+ arch: arch,
84
+ os: (os if respond_to?(:os))
85
+ )
86
+ end
87
+
88
+ #
89
+ # Packs a binary value for the given type.
90
+ #
91
+ # @param [Symbol] type
92
+ # The type name to pack for.
93
+ #
94
+ # @param [Integer, Float, String] value
95
+ # The value to pack.
96
+ #
97
+ # @return [String]
98
+ # The packed value.
99
+ #
100
+ def pack(type,value)
101
+ platform[type].pack(value)
102
+ end
103
+ end
104
+ end
105
+ end
106
+ end
@@ -0,0 +1,61 @@
1
+ # frozen_string_literal: true
2
+ #
3
+ # ronin-exploits - A Ruby library for ronin-rb that provides exploitation and
4
+ # payload crafting functionality.
5
+ #
6
+ # Copyright (c) 2007-2023 Hal Brodigan (postmodern.mod3 at gmail.com)
7
+ #
8
+ # ronin-exploits is free software: you can redistribute it and/or modify
9
+ # it under the terms of the GNU Lesser General Public License as published
10
+ # by the Free Software Foundation, either version 3 of the License, or
11
+ # (at your option) any later version.
12
+ #
13
+ # ronin-exploits is distributed in the hope that it will be useful,
14
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
15
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16
+ # GNU Lesser General Public License for more details.
17
+ #
18
+ # You should have received a copy of the GNU Lesser General Public License
19
+ # along with ronin-exploits. If not, see <https://www.gnu.org/licenses/>.
20
+ #
21
+
22
+ require 'tmpdir'
23
+ require 'fileutils'
24
+
25
+ module Ronin
26
+ module Exploits
27
+ module Mixins
28
+ #
29
+ # Sets up a temporary build directory for the exploit.
30
+ #
31
+ # @api public
32
+ #
33
+ module BuildDir
34
+ # The build directory for the exploit.
35
+ #
36
+ # @return [String, nil]
37
+ attr_reader :build_dir
38
+
39
+ #
40
+ # Sets {#build_dir} and then builds the exploit.
41
+ #
42
+ def perform_build
43
+ exploit_name = self.class.id.tr('/','-')
44
+ @build_dir = Dir.mktmpdir("ronin-exploit-#{exploit_name}-")
45
+
46
+ super
47
+ end
48
+
49
+ #
50
+ # Cleans up the exploit and deletes the {#build_dir}.
51
+ #
52
+ def perform_cleanup
53
+ super
54
+
55
+ FileUtils.rm_r(@build_dir)
56
+ @build_dir = nil
57
+ end
58
+ end
59
+ end
60
+ end
61
+ end