contrast-agent 3.8.4 → 6.9.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (676) hide show
  1. checksums.yaml +4 -4
  2. data/.dockerignore +0 -1
  3. data/.flayignore +1 -0
  4. data/.gitignore +8 -5
  5. data/.gitmodules +0 -3
  6. data/.rspec +0 -1
  7. data/.rspec_parallel +6 -0
  8. data/.simplecov +6 -2
  9. data/Gemfile +1 -1
  10. data/LICENSE.txt +1 -1
  11. data/Rakefile +5 -2
  12. data/ext/build_funchook.rb +27 -11
  13. data/ext/cs__assess_array/cs__assess_array.c +45 -7
  14. data/ext/cs__assess_array/cs__assess_array.h +5 -1
  15. data/ext/cs__assess_array/extconf.rb +3 -0
  16. data/ext/cs__assess_basic_object/cs__assess_basic_object.c +39 -17
  17. data/ext/cs__assess_basic_object/cs__assess_basic_object.h +2 -1
  18. data/ext/cs__assess_basic_object/extconf.rb +3 -0
  19. data/ext/cs__assess_fiber_track/cs__assess_fiber_track.c +9 -13
  20. data/ext/cs__assess_fiber_track/cs__assess_fiber_track.h +3 -4
  21. data/ext/cs__assess_fiber_track/extconf.rb +3 -0
  22. data/ext/cs__assess_hash/cs__assess_hash.c +46 -21
  23. data/ext/cs__assess_hash/cs__assess_hash.h +5 -6
  24. data/ext/cs__assess_hash/extconf.rb +3 -0
  25. data/ext/cs__assess_kernel/cs__assess_kernel.c +29 -15
  26. data/ext/cs__assess_kernel/cs__assess_kernel.h +3 -0
  27. data/ext/cs__assess_kernel/extconf.rb +3 -0
  28. data/ext/cs__assess_marshal_module/cs__assess_marshal_module.c +55 -23
  29. data/ext/cs__assess_marshal_module/cs__assess_marshal_module.h +6 -3
  30. data/ext/cs__assess_marshal_module/extconf.rb +3 -0
  31. data/ext/cs__assess_module/cs__assess_module.c +82 -23
  32. data/ext/cs__assess_module/cs__assess_module.h +10 -0
  33. data/ext/cs__assess_module/extconf.rb +3 -0
  34. data/ext/cs__assess_regexp/cs__assess_regexp.c +28 -9
  35. data/ext/cs__assess_regexp/cs__assess_regexp.h +3 -0
  36. data/ext/cs__assess_regexp/extconf.rb +3 -0
  37. data/ext/cs__assess_string/cs__assess_string.c +53 -21
  38. data/ext/cs__assess_string/cs__assess_string.h +7 -1
  39. data/ext/cs__assess_string/extconf.rb +3 -0
  40. data/ext/cs__assess_string_interpolation/cs__assess_string_interpolation.c +39 -0
  41. data/ext/cs__assess_string_interpolation/cs__assess_string_interpolation.h +13 -0
  42. data/ext/cs__assess_string_interpolation/extconf.rb +5 -0
  43. data/ext/cs__assess_test/cs__assess_test.h +9 -0
  44. data/ext/cs__assess_test/cs__assess_tests.c +22 -0
  45. data/ext/cs__assess_test/extconf.rb +5 -0
  46. data/ext/cs__assess_yield_track/cs__assess_yield_track.c +30 -0
  47. data/ext/cs__assess_yield_track/cs__assess_yield_track.h +11 -0
  48. data/ext/cs__assess_yield_track/extconf.rb +5 -0
  49. data/ext/cs__common/cs__common.c +246 -10
  50. data/ext/cs__common/cs__common.h +71 -2
  51. data/ext/cs__common/extconf.rb +3 -16
  52. data/ext/cs__contrast_patch/cs__contrast_patch.c +255 -155
  53. data/ext/cs__contrast_patch/cs__contrast_patch.h +13 -14
  54. data/ext/cs__contrast_patch/extconf.rb +3 -0
  55. data/ext/cs__os_information/cs__os_information.c +34 -0
  56. data/ext/cs__os_information/cs__os_information.h +7 -0
  57. data/ext/cs__os_information/extconf.rb +5 -0
  58. data/ext/cs__scope/cs__scope.c +755 -55
  59. data/ext/cs__scope/cs__scope.h +75 -20
  60. data/ext/cs__scope/extconf.rb +3 -0
  61. data/ext/cs__tests/cs__tests.c +12 -0
  62. data/ext/cs__tests/cs__tests.h +3 -0
  63. data/ext/cs__tests/extconf.rb +5 -0
  64. data/ext/extconf_common.rb +4 -34
  65. data/lib/contrast/agent/assess/contrast_object.rb +54 -0
  66. data/lib/contrast/agent/assess/events/event_data.rb +30 -0
  67. data/lib/contrast/agent/assess/finalizers/freeze.rb +15 -0
  68. data/lib/contrast/agent/assess/finalizers/hash.rb +107 -0
  69. data/lib/contrast/agent/assess/policy/dynamic_source_factory.rb +58 -36
  70. data/lib/contrast/agent/assess/policy/patcher.rb +13 -48
  71. data/lib/contrast/agent/assess/policy/policy.rb +20 -37
  72. data/lib/contrast/agent/assess/policy/policy_node.rb +96 -200
  73. data/lib/contrast/agent/assess/policy/policy_node_utils.rb +50 -0
  74. data/lib/contrast/agent/assess/policy/policy_scanner.rb +15 -12
  75. data/lib/contrast/agent/assess/policy/preshift.rb +50 -19
  76. data/lib/contrast/agent/assess/policy/propagation_method.rb +200 -192
  77. data/lib/contrast/agent/assess/policy/propagation_node.rb +49 -41
  78. data/lib/contrast/agent/assess/policy/propagator/append.rb +32 -15
  79. data/lib/contrast/agent/assess/policy/propagator/base.rb +5 -3
  80. data/lib/contrast/agent/assess/policy/propagator/buffer.rb +119 -0
  81. data/lib/contrast/agent/assess/policy/propagator/center.rb +12 -8
  82. data/lib/contrast/agent/assess/policy/propagator/custom.rb +7 -3
  83. data/lib/contrast/agent/assess/policy/propagator/database_write.rb +34 -25
  84. data/lib/contrast/agent/assess/policy/propagator/insert.rb +15 -11
  85. data/lib/contrast/agent/assess/policy/propagator/keep.rb +23 -6
  86. data/lib/contrast/agent/assess/policy/propagator/match_data.rb +118 -0
  87. data/lib/contrast/agent/assess/policy/propagator/next.rb +7 -6
  88. data/lib/contrast/agent/assess/policy/propagator/prepend.rb +13 -6
  89. data/lib/contrast/agent/assess/policy/propagator/rack_protection.rb +73 -0
  90. data/lib/contrast/agent/assess/policy/propagator/remove.rb +53 -41
  91. data/lib/contrast/agent/assess/policy/propagator/replace.rb +5 -3
  92. data/lib/contrast/agent/assess/policy/propagator/reverse.rb +7 -6
  93. data/lib/contrast/agent/assess/policy/propagator/select.rb +45 -36
  94. data/lib/contrast/agent/assess/policy/propagator/splat.rb +44 -21
  95. data/lib/contrast/agent/assess/policy/propagator/split.rb +176 -22
  96. data/lib/contrast/agent/assess/policy/propagator/substitution.rb +7 -132
  97. data/lib/contrast/agent/assess/policy/propagator/substitution_utils.rb +190 -0
  98. data/lib/contrast/agent/assess/policy/propagator/trim.rb +74 -52
  99. data/lib/contrast/agent/assess/policy/propagator.rb +21 -18
  100. data/lib/contrast/agent/assess/policy/source_method.rb +176 -177
  101. data/lib/contrast/agent/assess/policy/source_node.rb +3 -17
  102. data/lib/contrast/agent/assess/policy/source_validation/cross_site_validator.rb +32 -0
  103. data/lib/contrast/agent/assess/policy/source_validation/source_validation.rb +34 -0
  104. data/lib/contrast/agent/assess/policy/trigger/reflected_xss.rb +102 -0
  105. data/lib/contrast/agent/assess/policy/trigger/xpath.rb +57 -0
  106. data/lib/contrast/agent/assess/policy/trigger_method.rb +160 -173
  107. data/lib/contrast/agent/assess/policy/trigger_node.rb +162 -39
  108. data/lib/contrast/agent/assess/policy/trigger_validation/redos_validator.rb +60 -0
  109. data/lib/contrast/agent/assess/policy/trigger_validation/ssrf_validator.rb +8 -38
  110. data/lib/contrast/agent/assess/policy/trigger_validation/trigger_validation.rb +22 -7
  111. data/lib/contrast/agent/assess/policy/trigger_validation/xss_validator.rb +6 -15
  112. data/lib/contrast/agent/assess/properties.rb +15 -354
  113. data/lib/contrast/agent/assess/property/evented.rb +58 -0
  114. data/lib/contrast/agent/assess/property/tagged.rb +246 -0
  115. data/lib/contrast/agent/assess/property/updated.rb +131 -0
  116. data/lib/contrast/agent/assess/rule/provider/hardcoded_key.rb +58 -19
  117. data/lib/contrast/agent/assess/rule/provider/hardcoded_password.rb +22 -17
  118. data/lib/contrast/agent/assess/rule/provider/hardcoded_value_rule.rb +93 -81
  119. data/lib/contrast/agent/assess/rule/provider.rb +4 -4
  120. data/lib/contrast/agent/assess/rule/response/auto_complete_rule.rb +69 -0
  121. data/lib/contrast/agent/assess/rule/response/base_rule.rb +121 -0
  122. data/lib/contrast/agent/assess/rule/response/body_rule.rb +107 -0
  123. data/lib/contrast/agent/assess/rule/response/cache_control_header_rule.rb +195 -0
  124. data/lib/contrast/agent/assess/rule/response/click_jacking_header_rule.rb +26 -0
  125. data/lib/contrast/agent/assess/rule/response/csp_header_insecure_rule.rb +100 -0
  126. data/lib/contrast/agent/assess/rule/response/csp_header_missing_rule.rb +26 -0
  127. data/lib/contrast/agent/assess/rule/response/framework/rails_support.rb +34 -0
  128. data/lib/contrast/agent/assess/rule/response/header_rule.rb +70 -0
  129. data/lib/contrast/agent/assess/rule/response/hsts_header_rule.rb +36 -0
  130. data/lib/contrast/agent/assess/rule/response/parameters_pollution_rule.rb +61 -0
  131. data/lib/contrast/agent/assess/rule/response/x_content_type_header_rule.rb +26 -0
  132. data/lib/contrast/agent/assess/rule/response/x_xss_protection_header_rule.rb +34 -0
  133. data/lib/contrast/agent/assess/tag.rb +84 -41
  134. data/lib/contrast/agent/assess/tracker.rb +70 -0
  135. data/lib/contrast/agent/assess.rb +7 -29
  136. data/lib/contrast/agent/at_exit_hook.rb +28 -17
  137. data/lib/contrast/agent/deadzone/policy/deadzone_node.rb +11 -6
  138. data/lib/contrast/agent/deadzone/policy/policy.rb +11 -7
  139. data/lib/contrast/agent/disable_reaction.rb +6 -10
  140. data/lib/contrast/agent/excluder.rb +224 -0
  141. data/lib/contrast/agent/exclusion_matcher.rb +40 -74
  142. data/lib/contrast/agent/inventory/database_config.rb +174 -0
  143. data/lib/contrast/agent/inventory/dependencies.rb +52 -0
  144. data/lib/contrast/agent/inventory/dependency_analysis.rb +34 -0
  145. data/lib/contrast/agent/inventory/dependency_usage_analysis.rb +120 -0
  146. data/lib/contrast/agent/inventory/policy/datastores.rb +51 -0
  147. data/lib/contrast/agent/inventory/policy/policy.rb +5 -5
  148. data/lib/contrast/agent/inventory/policy/trigger_node.rb +2 -2
  149. data/lib/contrast/agent/inventory.rb +14 -0
  150. data/lib/contrast/agent/middleware.rb +146 -299
  151. data/lib/contrast/agent/module_data.rb +5 -4
  152. data/lib/contrast/agent/patching/policy/after_load_patch.rb +54 -7
  153. data/lib/contrast/agent/patching/policy/after_load_patcher.rb +103 -27
  154. data/lib/contrast/agent/patching/policy/method_policy.rb +53 -64
  155. data/lib/contrast/agent/patching/policy/method_policy_extend.rb +113 -0
  156. data/lib/contrast/agent/patching/policy/module_policy.rb +27 -47
  157. data/lib/contrast/agent/patching/policy/patch.rb +147 -241
  158. data/lib/contrast/agent/patching/policy/patch_status.rb +21 -45
  159. data/lib/contrast/agent/patching/policy/patcher.rb +126 -161
  160. data/lib/contrast/agent/patching/policy/policy.rb +66 -57
  161. data/lib/contrast/agent/patching/policy/policy_node.rb +63 -32
  162. data/lib/contrast/agent/patching/policy/trigger_node.rb +32 -15
  163. data/lib/contrast/agent/protect/exploitable_collection.rb +38 -0
  164. data/lib/contrast/agent/protect/input_analyzer/input_analyzer.rb +170 -0
  165. data/lib/contrast/agent/protect/input_analyzer/worth_watching_analyzer.rb +116 -0
  166. data/lib/contrast/agent/protect/policy/applies_command_injection_rule.rb +65 -0
  167. data/lib/contrast/agent/protect/policy/applies_deserialization_rule.rb +97 -0
  168. data/lib/contrast/agent/protect/policy/applies_no_sqli_rule.rb +69 -0
  169. data/lib/contrast/agent/protect/policy/applies_path_traversal_rule.rb +138 -0
  170. data/lib/contrast/agent/protect/policy/applies_sqli_rule.rb +55 -0
  171. data/lib/contrast/agent/protect/policy/applies_xxe_rule.rb +125 -0
  172. data/lib/contrast/agent/protect/policy/policy.rb +10 -10
  173. data/lib/contrast/agent/protect/policy/rule_applicator.rb +102 -0
  174. data/lib/contrast/agent/protect/policy/trigger_node.rb +2 -2
  175. data/lib/contrast/agent/protect/rule/base.rb +205 -95
  176. data/lib/contrast/agent/protect/rule/base_service.rb +73 -14
  177. data/lib/contrast/agent/protect/rule/bot_blocker/bot_blocker_input_classification.rb +98 -0
  178. data/lib/contrast/agent/protect/rule/bot_blocker.rb +81 -0
  179. data/lib/contrast/agent/protect/rule/cmd_injection.rb +53 -123
  180. data/lib/contrast/agent/protect/rule/cmdi/cmdi_backdoors.rb +132 -0
  181. data/lib/contrast/agent/protect/rule/cmdi/cmdi_base_rule.rb +169 -0
  182. data/lib/contrast/agent/protect/rule/cmdi/cmdi_chained_command.rb +64 -0
  183. data/lib/contrast/agent/protect/rule/cmdi/cmdi_dangerous_path.rb +63 -0
  184. data/lib/contrast/agent/protect/rule/cmdi/cmdi_input_classification.rb +27 -0
  185. data/lib/contrast/agent/protect/rule/default_scanner.rb +69 -25
  186. data/lib/contrast/agent/protect/rule/deserialization.rb +32 -48
  187. data/lib/contrast/agent/protect/rule/http_method_tampering/http_method_tampering_input_classification.rb +96 -0
  188. data/lib/contrast/agent/protect/rule/http_method_tampering.rb +65 -62
  189. data/lib/contrast/agent/protect/rule/no_sqli/mongo_no_sql_scanner.rb +2 -3
  190. data/lib/contrast/agent/protect/rule/no_sqli/no_sqli_input_classification.rb +226 -0
  191. data/lib/contrast/agent/protect/rule/no_sqli.rb +47 -53
  192. data/lib/contrast/agent/protect/rule/path_traversal/path_traversal_input_classification.rb +61 -0
  193. data/lib/contrast/agent/protect/rule/path_traversal/path_traversal_semantic_security_bypass.rb +114 -0
  194. data/lib/contrast/agent/protect/rule/path_traversal.rb +57 -26
  195. data/lib/contrast/agent/protect/rule/sql_sample_builder.rb +155 -0
  196. data/lib/contrast/agent/protect/rule/sqli/default_sql_scanner.rb +1 -1
  197. data/lib/contrast/agent/protect/rule/sqli/mysql_sql_scanner.rb +1 -1
  198. data/lib/contrast/agent/protect/rule/sqli/postgres_sql_scanner.rb +2 -2
  199. data/lib/contrast/agent/protect/rule/sqli/sqli_base_rule.rb +37 -0
  200. data/lib/contrast/agent/protect/rule/sqli/sqli_input_classification.rb +28 -0
  201. data/lib/contrast/agent/protect/rule/sqli/sqli_semantic/sqli_dangerous_functions.rb +67 -0
  202. data/lib/contrast/agent/protect/rule/sqli/sqlite_sql_scanner.rb +1 -1
  203. data/lib/contrast/agent/protect/rule/sqli.rb +78 -62
  204. data/lib/contrast/agent/protect/rule/unsafe_file_upload/unsafe_file_upload_input_classification.rb +58 -0
  205. data/lib/contrast/agent/protect/rule/unsafe_file_upload.rb +19 -2
  206. data/lib/contrast/agent/protect/rule/xss/reflected_xss_input_classification.rb +58 -0
  207. data/lib/contrast/agent/protect/rule/xss.rb +20 -2
  208. data/lib/contrast/agent/protect/rule/xxe/entity_wrapper.rb +25 -21
  209. data/lib/contrast/agent/protect/rule/xxe.rb +69 -39
  210. data/lib/contrast/agent/protect/rule.rb +22 -25
  211. data/lib/contrast/agent/reporting/attack_result/attack_result.rb +71 -0
  212. data/lib/contrast/agent/reporting/attack_result/rasp_rule_sample.rb +86 -0
  213. data/lib/contrast/agent/reporting/attack_result/response_type.rb +29 -0
  214. data/lib/contrast/agent/reporting/attack_result/user_input.rb +98 -0
  215. data/lib/contrast/agent/reporting/details/bot_blocker_details.rb +29 -0
  216. data/lib/contrast/agent/reporting/details/cmd_injection_details.rb +30 -0
  217. data/lib/contrast/agent/reporting/details/details.rb +18 -0
  218. data/lib/contrast/agent/reporting/details/http_method_tempering_details.rb +27 -0
  219. data/lib/contrast/agent/reporting/details/ip_denylist_details.rb +35 -0
  220. data/lib/contrast/agent/reporting/details/no_sqli_details.rb +36 -0
  221. data/lib/contrast/agent/reporting/details/path_traversal_details.rb +24 -0
  222. data/lib/contrast/agent/reporting/details/path_traversal_semantic_analysis_details.rb +32 -0
  223. data/lib/contrast/agent/reporting/details/protect_rule_details.rb +17 -0
  224. data/lib/contrast/agent/reporting/details/sqli_dangerous_functions.rb +22 -0
  225. data/lib/contrast/agent/reporting/details/sqli_details.rb +36 -0
  226. data/lib/contrast/agent/reporting/details/untrusted_deserialization_details.rb +27 -0
  227. data/lib/contrast/agent/reporting/details/virtual_patch_details.rb +30 -0
  228. data/lib/contrast/agent/reporting/details/xss_details.rb +33 -0
  229. data/lib/contrast/agent/reporting/details/xss_match.rb +30 -0
  230. data/lib/contrast/agent/reporting/details/xxe_details.rb +36 -0
  231. data/lib/contrast/agent/reporting/details/xxe_match.rb +25 -0
  232. data/lib/contrast/agent/reporting/details/xxe_wrapper.rb +25 -0
  233. data/lib/contrast/agent/reporting/input_analysis/details/bot_blocker_details.rb +27 -0
  234. data/lib/contrast/agent/reporting/input_analysis/details/protect_rule_details.rb +15 -0
  235. data/lib/contrast/agent/reporting/input_analysis/input_analysis.rb +43 -0
  236. data/lib/contrast/agent/reporting/input_analysis/input_analysis_result.rb +129 -0
  237. data/lib/contrast/agent/reporting/input_analysis/input_type.rb +44 -0
  238. data/lib/contrast/agent/reporting/input_analysis/score_level.rb +21 -0
  239. data/lib/contrast/agent/reporting/masker/masker.rb +258 -0
  240. data/lib/contrast/agent/reporting/masker/masker_utils.rb +33 -0
  241. data/lib/contrast/agent/reporting/report.rb +31 -0
  242. data/lib/contrast/agent/reporting/reporter.rb +165 -0
  243. data/lib/contrast/agent/reporting/reporter_heartbeat.rb +47 -0
  244. data/lib/contrast/agent/reporting/reporting_events/agent_startup.rb +34 -0
  245. data/lib/contrast/agent/reporting/reporting_events/application_activity.rb +120 -0
  246. data/lib/contrast/agent/reporting/reporting_events/application_defend_activity.rb +85 -0
  247. data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_activity.rb +65 -0
  248. data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_sample.rb +102 -0
  249. data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_sample_activity.rb +68 -0
  250. data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_sample_stack.rb +22 -0
  251. data/lib/contrast/agent/reporting/reporting_events/application_defend_attacker_activity.rb +62 -0
  252. data/lib/contrast/agent/reporting/reporting_events/application_inventory.rb +42 -0
  253. data/lib/contrast/agent/reporting/reporting_events/application_inventory_activity.rb +57 -0
  254. data/lib/contrast/agent/reporting/reporting_events/application_reporting_event.rb +27 -0
  255. data/lib/contrast/agent/reporting/reporting_events/application_startup.rb +44 -0
  256. data/lib/contrast/agent/reporting/reporting_events/application_startup_instrumentation.rb +27 -0
  257. data/lib/contrast/agent/reporting/reporting_events/application_update.rb +56 -0
  258. data/lib/contrast/agent/reporting/reporting_events/architecture_component.rb +72 -0
  259. data/lib/contrast/agent/reporting/reporting_events/discovered_route.rb +126 -0
  260. data/lib/contrast/agent/reporting/reporting_events/finding.rb +210 -0
  261. data/lib/contrast/agent/reporting/reporting_events/finding_event.rb +449 -0
  262. data/lib/contrast/agent/reporting/reporting_events/finding_event_object.rb +104 -0
  263. data/lib/contrast/agent/reporting/reporting_events/finding_event_parent_object.rb +49 -0
  264. data/lib/contrast/agent/reporting/reporting_events/finding_event_property.rb +51 -0
  265. data/lib/contrast/agent/reporting/reporting_events/finding_event_signature.rb +106 -0
  266. data/lib/contrast/agent/reporting/reporting_events/finding_event_source.rb +74 -0
  267. data/lib/contrast/agent/reporting/reporting_events/finding_event_stack.rb +68 -0
  268. data/lib/contrast/agent/reporting/reporting_events/finding_event_taint_range.rb +71 -0
  269. data/lib/contrast/agent/reporting/reporting_events/finding_event_taint_range_tags.rb +105 -0
  270. data/lib/contrast/agent/reporting/reporting_events/finding_request.rb +134 -0
  271. data/lib/contrast/agent/reporting/reporting_events/library_discovery.rb +89 -0
  272. data/lib/contrast/agent/reporting/reporting_events/library_usage_observation.rb +48 -0
  273. data/lib/contrast/agent/reporting/reporting_events/observed_library_usage.rb +45 -0
  274. data/lib/contrast/agent/reporting/reporting_events/observed_route.rb +89 -0
  275. data/lib/contrast/agent/reporting/reporting_events/poll.rb +23 -0
  276. data/lib/contrast/agent/reporting/reporting_events/preflight.rb +41 -0
  277. data/lib/contrast/agent/reporting/reporting_events/preflight_message.rb +74 -0
  278. data/lib/contrast/agent/reporting/reporting_events/reporting_event.rb +66 -0
  279. data/lib/contrast/agent/reporting/reporting_events/route_coverage.rb +89 -0
  280. data/lib/contrast/agent/reporting/reporting_events/route_discovery.rb +63 -0
  281. data/lib/contrast/agent/reporting/reporting_events/route_discovery_observation.rb +53 -0
  282. data/lib/contrast/agent/reporting/reporting_events/server_reporting_event.rb +35 -0
  283. data/lib/contrast/agent/reporting/reporting_events/server_settings.rb +40 -0
  284. data/lib/contrast/agent/reporting/reporting_utilities/audit.rb +130 -0
  285. data/lib/contrast/agent/reporting/reporting_utilities/build_preflight.rb +35 -0
  286. data/lib/contrast/agent/reporting/reporting_utilities/endpoints.rb +176 -0
  287. data/lib/contrast/agent/reporting/reporting_utilities/headers.rb +54 -0
  288. data/lib/contrast/agent/reporting/reporting_utilities/reporter_client.rb +143 -0
  289. data/lib/contrast/agent/reporting/reporting_utilities/reporter_client_utils.rb +144 -0
  290. data/lib/contrast/agent/reporting/reporting_utilities/reporting_storage.rb +66 -0
  291. data/lib/contrast/agent/reporting/reporting_utilities/response.rb +98 -0
  292. data/lib/contrast/agent/reporting/reporting_utilities/response_extractor.rb +176 -0
  293. data/lib/contrast/agent/reporting/reporting_utilities/response_handler.rb +117 -0
  294. data/lib/contrast/agent/reporting/reporting_utilities/response_handler_mode.rb +63 -0
  295. data/lib/contrast/agent/reporting/reporting_utilities/response_handler_utils.rb +342 -0
  296. data/lib/contrast/agent/reporting/server_settings_worker.rb +44 -0
  297. data/lib/contrast/agent/reporting/settings/application_settings.rb +61 -0
  298. data/lib/contrast/agent/reporting/settings/assess.rb +45 -0
  299. data/lib/contrast/agent/reporting/settings/assess_server_feature.rb +114 -0
  300. data/lib/contrast/agent/reporting/settings/bot_blocker.rb +68 -0
  301. data/lib/contrast/agent/reporting/settings/code_exclusion.rb +32 -0
  302. data/lib/contrast/agent/reporting/settings/exclusion_base.rb +51 -0
  303. data/lib/contrast/agent/reporting/settings/exclusions.rb +106 -0
  304. data/lib/contrast/agent/reporting/settings/helpers.rb +63 -0
  305. data/lib/contrast/agent/reporting/settings/input_exclusion.rb +43 -0
  306. data/lib/contrast/agent/reporting/settings/ip_filter.rb +35 -0
  307. data/lib/contrast/agent/reporting/settings/keyword.rb +74 -0
  308. data/lib/contrast/agent/reporting/settings/log_enhancer.rb +65 -0
  309. data/lib/contrast/agent/reporting/settings/protect.rb +106 -0
  310. data/lib/contrast/agent/reporting/settings/protect_server_feature.rb +227 -0
  311. data/lib/contrast/agent/reporting/settings/reaction.rb +39 -0
  312. data/lib/contrast/agent/reporting/settings/rule_definition.rb +66 -0
  313. data/lib/contrast/agent/reporting/settings/sampling.rb +46 -0
  314. data/lib/contrast/agent/reporting/settings/sanitizer.rb +38 -0
  315. data/lib/contrast/agent/reporting/settings/security_logger.rb +77 -0
  316. data/lib/contrast/agent/reporting/settings/sensitive_data_masking.rb +118 -0
  317. data/lib/contrast/agent/reporting/settings/sensitive_data_masking_rule.rb +65 -0
  318. data/lib/contrast/agent/reporting/settings/server_features.rb +95 -0
  319. data/lib/contrast/agent/reporting/settings/syslog.rb +205 -0
  320. data/lib/contrast/agent/reporting/settings/url_exclusion.rb +42 -0
  321. data/lib/contrast/agent/reporting/settings/validator.rb +17 -0
  322. data/lib/contrast/agent/request.rb +107 -411
  323. data/lib/contrast/agent/request_context.rb +78 -162
  324. data/lib/contrast/agent/request_context_extend.rb +85 -0
  325. data/lib/contrast/agent/request_handler.rb +41 -0
  326. data/lib/contrast/agent/response.rb +37 -165
  327. data/lib/contrast/agent/rule_set.rb +52 -0
  328. data/lib/contrast/agent/scope.rb +142 -20
  329. data/lib/contrast/agent/static_analysis.rb +51 -0
  330. data/lib/contrast/agent/telemetry/base.rb +155 -0
  331. data/lib/contrast/agent/telemetry/events/event.rb +35 -0
  332. data/lib/contrast/agent/telemetry/events/exceptions/obfuscate.rb +119 -0
  333. data/lib/contrast/agent/telemetry/events/exceptions/telemetry_exception_base.rb +61 -0
  334. data/lib/contrast/agent/telemetry/events/exceptions/telemetry_exception_event.rb +46 -0
  335. data/lib/contrast/agent/telemetry/events/exceptions/telemetry_exception_message.rb +118 -0
  336. data/lib/contrast/agent/telemetry/events/exceptions/telemetry_exception_message_exception.rb +86 -0
  337. data/lib/contrast/agent/telemetry/events/exceptions/telemetry_exception_stack_frame.rb +67 -0
  338. data/lib/contrast/agent/telemetry/events/exceptions/telemetry_exceptions.rb +19 -0
  339. data/lib/contrast/agent/telemetry/events/metric_event.rb +28 -0
  340. data/lib/contrast/agent/telemetry/events/startup_metrics_event.rb +123 -0
  341. data/lib/contrast/agent/thread.rb +4 -6
  342. data/lib/contrast/agent/thread_watcher.rb +117 -0
  343. data/lib/contrast/agent/tracepoint_hook.rb +19 -13
  344. data/lib/contrast/agent/version.rb +2 -2
  345. data/lib/contrast/agent/worker_thread.rb +42 -0
  346. data/lib/contrast/agent.rb +83 -50
  347. data/lib/contrast/agent_lib/api/command_injection.rb +46 -0
  348. data/lib/contrast/agent_lib/api/init.rb +101 -0
  349. data/lib/contrast/agent_lib/api/input_tracing.rb +267 -0
  350. data/lib/contrast/agent_lib/api/method_tempering.rb +29 -0
  351. data/lib/contrast/agent_lib/api/panic.rb +87 -0
  352. data/lib/contrast/agent_lib/api/path_semantic_file_security_bypass.rb +40 -0
  353. data/lib/contrast/agent_lib/interface.rb +260 -0
  354. data/lib/contrast/agent_lib/interface_base.rb +118 -0
  355. data/lib/contrast/agent_lib/return_types/eval_result.rb +44 -0
  356. data/lib/contrast/agent_lib/test.rb +29 -0
  357. data/lib/contrast/api/communication/connection_status.rb +59 -0
  358. data/lib/contrast/components/agent.rb +108 -36
  359. data/lib/contrast/components/api.rb +159 -0
  360. data/lib/contrast/components/app_context.rb +124 -134
  361. data/lib/contrast/components/app_context_extend.rb +53 -0
  362. data/lib/contrast/components/assess.rb +187 -24
  363. data/lib/contrast/components/assess_rules.rb +54 -0
  364. data/lib/contrast/components/base.rb +103 -0
  365. data/lib/contrast/components/config/sources.rb +95 -0
  366. data/lib/contrast/components/config.rb +182 -60
  367. data/lib/contrast/components/heap_dump.rb +77 -12
  368. data/lib/contrast/components/inventory.rb +37 -10
  369. data/lib/contrast/components/logger.rb +46 -76
  370. data/lib/contrast/components/polling.rb +36 -0
  371. data/lib/contrast/components/protect.rb +142 -16
  372. data/lib/contrast/components/ruby_component.rb +96 -0
  373. data/lib/contrast/components/sampling.rb +156 -15
  374. data/lib/contrast/components/scope.rb +116 -85
  375. data/lib/contrast/components/security_logger.rb +36 -0
  376. data/lib/contrast/components/settings.rb +197 -90
  377. data/lib/contrast/config/api_proxy_configuration.rb +27 -0
  378. data/lib/contrast/config/base_configuration.rb +20 -94
  379. data/lib/contrast/config/certification_configuration.rb +47 -0
  380. data/lib/contrast/config/config.rb +46 -0
  381. data/lib/contrast/config/diagnostics.rb +114 -0
  382. data/lib/contrast/config/diagnostics_tools.rb +98 -0
  383. data/lib/contrast/config/effective_config.rb +65 -0
  384. data/lib/contrast/config/effective_config_value.rb +32 -0
  385. data/lib/contrast/config/env_variables.rb +18 -0
  386. data/lib/contrast/config/exception_configuration.rb +34 -12
  387. data/lib/contrast/config/protect_rule_configuration.rb +45 -24
  388. data/lib/contrast/config/protect_rules_configuration.rb +97 -22
  389. data/lib/contrast/config/request_audit_configuration.rb +57 -0
  390. data/lib/contrast/config/server_configuration.rb +67 -15
  391. data/lib/contrast/config.rb +6 -22
  392. data/lib/contrast/configuration.rb +231 -108
  393. data/lib/contrast/extension/assess/array.rb +75 -0
  394. data/lib/contrast/extension/assess/erb.rb +61 -0
  395. data/lib/contrast/extension/assess/eval_trigger.rb +47 -0
  396. data/lib/contrast/{core_extensions → extension}/assess/exec_trigger.rb +9 -21
  397. data/lib/contrast/extension/assess/fiber.rb +95 -0
  398. data/lib/contrast/extension/assess/hash.rb +33 -0
  399. data/lib/contrast/extension/assess/kernel.rb +124 -0
  400. data/lib/contrast/extension/assess/marshal.rb +80 -0
  401. data/lib/contrast/extension/assess/regexp.rb +71 -0
  402. data/lib/contrast/extension/assess/string.rb +84 -0
  403. data/lib/contrast/extension/assess.rb +47 -0
  404. data/lib/contrast/{core_extensions → extension}/delegator.rb +3 -1
  405. data/lib/contrast/extension/extension.rb +59 -0
  406. data/lib/contrast/extension/inventory.rb +21 -0
  407. data/lib/contrast/extension/module.rb +16 -0
  408. data/lib/contrast/extension/object.rb +19 -0
  409. data/lib/contrast/extension/protect/psych.rb +7 -0
  410. data/lib/contrast/{core_extensions → extension}/protect.rb +6 -6
  411. data/lib/contrast/extension/thread.rb +50 -0
  412. data/lib/contrast/framework/base_support.rb +78 -0
  413. data/lib/contrast/framework/grape/support.rb +176 -0
  414. data/lib/contrast/framework/manager.rb +158 -0
  415. data/lib/contrast/framework/manager_extend.rb +50 -0
  416. data/lib/contrast/framework/rack/patch/session_cookie.rb +107 -0
  417. data/lib/contrast/framework/rack/patch/support.rb +26 -0
  418. data/lib/contrast/framework/rack/support.rb +23 -0
  419. data/lib/contrast/framework/rails/patch/action_controller_live_buffer.rb +46 -0
  420. data/lib/contrast/framework/rails/patch/assess_configuration.rb +98 -0
  421. data/lib/contrast/framework/rails/patch/rails_application_configuration.rb +31 -0
  422. data/lib/contrast/framework/rails/patch/support.rb +46 -0
  423. data/lib/contrast/framework/rails/railtie.rb +33 -0
  424. data/lib/contrast/framework/rails/support.rb +187 -0
  425. data/lib/contrast/framework/sinatra/support.rb +165 -0
  426. data/lib/contrast/funchook/funchook.rb +45 -0
  427. data/lib/contrast/logger/aliased_logging.rb +101 -0
  428. data/lib/contrast/logger/application.rb +84 -0
  429. data/lib/contrast/logger/cef_log.rb +169 -0
  430. data/lib/contrast/logger/format.rb +61 -0
  431. data/lib/contrast/logger/log.rb +90 -0
  432. data/lib/contrast/logger/request.rb +25 -0
  433. data/lib/contrast/logger/time.rb +57 -0
  434. data/lib/contrast/security_exception.rb +2 -2
  435. data/lib/contrast/tasks/config.rb +144 -0
  436. data/lib/contrast/utils/assess/event_limit_utils.rb +134 -0
  437. data/lib/contrast/utils/assess/object_store.rb +36 -0
  438. data/lib/contrast/utils/assess/propagation_method_utils.rb +155 -0
  439. data/lib/contrast/utils/assess/property/tagged_utils.rb +165 -0
  440. data/lib/contrast/utils/assess/sampling_util.rb +11 -17
  441. data/lib/contrast/utils/assess/source_method_utils.rb +74 -0
  442. data/lib/contrast/utils/assess/split_utils.rb +23 -0
  443. data/lib/contrast/utils/assess/tracking_util.rb +95 -19
  444. data/lib/contrast/utils/assess/trigger_method_utils.rb +132 -0
  445. data/lib/contrast/utils/class_util.rb +125 -38
  446. data/lib/contrast/utils/duck_utils.rb +54 -43
  447. data/lib/contrast/utils/env_configuration_item.rb +4 -3
  448. data/lib/contrast/utils/findings.rb +66 -0
  449. data/lib/contrast/utils/hash_digest.rb +52 -100
  450. data/lib/contrast/utils/hash_digest_extend.rb +129 -0
  451. data/lib/contrast/utils/head_dump_utils_extend.rb +74 -0
  452. data/lib/contrast/utils/heap_dump_util.rb +44 -88
  453. data/lib/contrast/utils/input_classification_base.rb +155 -0
  454. data/lib/contrast/utils/invalid_configuration_util.rb +36 -50
  455. data/lib/contrast/utils/io_util.rb +47 -51
  456. data/lib/contrast/utils/job_servers_running.rb +47 -0
  457. data/lib/contrast/utils/log_utils.rb +254 -0
  458. data/lib/contrast/utils/lru_cache.rb +48 -0
  459. data/lib/contrast/utils/metrics_hash.rb +59 -0
  460. data/lib/contrast/utils/middleware_utils.rb +89 -0
  461. data/lib/contrast/utils/net_http_base.rb +167 -0
  462. data/lib/contrast/utils/object_share.rb +7 -48
  463. data/lib/contrast/utils/os.rb +14 -24
  464. data/lib/contrast/utils/patching/policy/patch_utils.rb +175 -0
  465. data/lib/contrast/utils/patching/policy/patcher_utils.rb +54 -0
  466. data/lib/contrast/utils/reporting/application_activity_batch_utils.rb +81 -0
  467. data/lib/contrast/utils/request_utils.rb +96 -0
  468. data/lib/contrast/utils/resource_loader.rb +2 -2
  469. data/lib/contrast/utils/response_utils.rb +79 -0
  470. data/lib/contrast/utils/routes_sent.rb +60 -0
  471. data/lib/contrast/utils/sha256_builder.rb +9 -21
  472. data/lib/contrast/utils/stack_trace_utils.rb +68 -184
  473. data/lib/contrast/utils/string_utils.rb +82 -52
  474. data/lib/contrast/utils/tag_util.rb +58 -44
  475. data/lib/contrast/utils/telemetry.rb +103 -0
  476. data/lib/contrast/utils/telemetry_client.rb +107 -0
  477. data/lib/contrast/utils/telemetry_hash.rb +65 -0
  478. data/lib/contrast/utils/telemetry_identifier.rb +153 -0
  479. data/lib/contrast/utils/thread_tracker.rb +27 -23
  480. data/lib/contrast/utils/timer.rb +20 -55
  481. data/lib/contrast-agent.rb +2 -2
  482. data/lib/contrast.rb +105 -43
  483. data/resources/assess/policy.json +523 -137
  484. data/resources/deadzone/policy.json +280 -10
  485. data/resources/inventory/policy.json +2 -2
  486. data/resources/protect/policy.json +30 -17
  487. data/ruby-agent.gemspec +114 -45
  488. data/sonar-project.properties +9 -0
  489. metadata +694 -287
  490. data/exe/contrast_service +0 -29
  491. data/ext/cs__assess_active_record_named/cs__active_record_named.c +0 -47
  492. data/ext/cs__assess_active_record_named/cs__active_record_named.h +0 -10
  493. data/ext/cs__assess_active_record_named/extconf.rb +0 -2
  494. data/ext/cs__assess_regexp_track/cs__assess_regexp_track.c +0 -63
  495. data/ext/cs__assess_regexp_track/cs__assess_regexp_track.h +0 -29
  496. data/ext/cs__assess_regexp_track/extconf.rb +0 -2
  497. data/ext/cs__assess_string_interpolation26/cs__assess_string_interpolation26.c +0 -31
  498. data/ext/cs__assess_string_interpolation26/cs__assess_string_interpolation26.h +0 -13
  499. data/ext/cs__assess_string_interpolation26/extconf.rb +0 -2
  500. data/ext/cs__protect_kernel/cs__protect_kernel.c +0 -37
  501. data/ext/cs__protect_kernel/cs__protect_kernel.h +0 -11
  502. data/ext/cs__protect_kernel/extconf.rb +0 -2
  503. data/funchook/Makefile +0 -29
  504. data/funchook/autom4te.cache/output.0 +0 -4976
  505. data/funchook/autom4te.cache/requests +0 -78
  506. data/funchook/autom4te.cache/traces.0 +0 -364
  507. data/funchook/config.log +0 -490
  508. data/funchook/config.status +0 -1016
  509. data/funchook/configure +0 -4976
  510. data/funchook/src/Makefile +0 -70
  511. data/funchook/src/config.h +0 -101
  512. data/funchook/src/config.h.in +0 -100
  513. data/funchook/src/decoder.o +0 -0
  514. data/funchook/src/distorm.o +0 -0
  515. data/funchook/src/funchook.o +0 -0
  516. data/funchook/src/funchook_io.o +0 -0
  517. data/funchook/src/funchook_syscall.o +0 -0
  518. data/funchook/src/funchook_unix.o +0 -0
  519. data/funchook/src/funchook_x86.o +0 -0
  520. data/funchook/src/instructions.o +0 -0
  521. data/funchook/src/insts.o +0 -0
  522. data/funchook/src/libfunchook.so +0 -0
  523. data/funchook/src/mnemonics.o +0 -0
  524. data/funchook/src/operands.o +0 -0
  525. data/funchook/src/os_func.o +0 -0
  526. data/funchook/src/os_func_unix.o +0 -0
  527. data/funchook/src/prefix.o +0 -0
  528. data/funchook/src/printf_base.o +0 -0
  529. data/funchook/src/textdefs.o +0 -0
  530. data/funchook/src/wstring.o +0 -0
  531. data/funchook/test/Makefile +0 -43
  532. data/funchook/test/funchook_test +0 -0
  533. data/funchook/test/libfunchook_test.so +0 -0
  534. data/funchook/test/test_main.o +0 -0
  535. data/funchook/test/x86_64_test.o +0 -0
  536. data/lib/contrast/agent/assess/adjusted_span.rb +0 -25
  537. data/lib/contrast/agent/assess/class_reverter.rb +0 -82
  538. data/lib/contrast/agent/assess/contrast_event.rb +0 -398
  539. data/lib/contrast/agent/assess/frozen_properties.rb +0 -41
  540. data/lib/contrast/agent/assess/insulator.rb +0 -53
  541. data/lib/contrast/agent/assess/policy/rewriter_patch.rb +0 -79
  542. data/lib/contrast/agent/assess/rule/base.rb +0 -72
  543. data/lib/contrast/agent/assess/rule/csrf/csrf_action.rb +0 -28
  544. data/lib/contrast/agent/assess/rule/csrf/csrf_applicator.rb +0 -69
  545. data/lib/contrast/agent/assess/rule/csrf/csrf_watcher.rb +0 -132
  546. data/lib/contrast/agent/assess/rule/csrf.rb +0 -66
  547. data/lib/contrast/agent/assess/rule/redos.rb +0 -68
  548. data/lib/contrast/agent/assess/rule/response_scanning_rule.rb +0 -47
  549. data/lib/contrast/agent/assess/rule/response_watcher.rb +0 -36
  550. data/lib/contrast/agent/assess/rule/watcher.rb +0 -36
  551. data/lib/contrast/agent/assess/rule.rb +0 -18
  552. data/lib/contrast/agent/class_reopener.rb +0 -195
  553. data/lib/contrast/agent/feature_state.rb +0 -379
  554. data/lib/contrast/agent/logger_manager.rb +0 -116
  555. data/lib/contrast/agent/patching/policy/policy_unpatcher.rb +0 -28
  556. data/lib/contrast/agent/protect/rule/csrf/csrf_evaluator.rb +0 -103
  557. data/lib/contrast/agent/protect/rule/csrf/csrf_token_injector.rb +0 -85
  558. data/lib/contrast/agent/protect/rule/csrf.rb +0 -118
  559. data/lib/contrast/agent/railtie.rb +0 -30
  560. data/lib/contrast/agent/reaction_processor.rb +0 -47
  561. data/lib/contrast/agent/require_state.rb +0 -61
  562. data/lib/contrast/agent/rewriter.rb +0 -244
  563. data/lib/contrast/agent/service_heartbeat.rb +0 -37
  564. data/lib/contrast/agent/settings_state.rb +0 -148
  565. data/lib/contrast/agent/socket_client.rb +0 -125
  566. data/lib/contrast/api/connection_status.rb +0 -49
  567. data/lib/contrast/api/dtm_pb.rb +0 -718
  568. data/lib/contrast/api/settings_pb.rb +0 -416
  569. data/lib/contrast/api/socket.rb +0 -43
  570. data/lib/contrast/api/speedracer.rb +0 -206
  571. data/lib/contrast/api/tcp_socket.rb +0 -31
  572. data/lib/contrast/api/unix_socket.rb +0 -25
  573. data/lib/contrast/api.rb +0 -17
  574. data/lib/contrast/common_agent_configuration.rb +0 -86
  575. data/lib/contrast/components/contrast_service.rb +0 -113
  576. data/lib/contrast/components/interface.rb +0 -178
  577. data/lib/contrast/config/agent_configuration.rb +0 -24
  578. data/lib/contrast/config/application_configuration.rb +0 -27
  579. data/lib/contrast/config/assess_configuration.rb +0 -22
  580. data/lib/contrast/config/assess_rules_configuration.rb +0 -18
  581. data/lib/contrast/config/default_value.rb +0 -16
  582. data/lib/contrast/config/heap_dump_configuration.rb +0 -23
  583. data/lib/contrast/config/inventory_configuration.rb +0 -20
  584. data/lib/contrast/config/logger_configuration.rb +0 -20
  585. data/lib/contrast/config/protect_configuration.rb +0 -20
  586. data/lib/contrast/config/root_configuration.rb +0 -26
  587. data/lib/contrast/config/ruby_configuration.rb +0 -39
  588. data/lib/contrast/config/sampling_configuration.rb +0 -22
  589. data/lib/contrast/config/service_configuration.rb +0 -22
  590. data/lib/contrast/core_extensions/assess/array.rb +0 -58
  591. data/lib/contrast/core_extensions/assess/assess_extension.rb +0 -145
  592. data/lib/contrast/core_extensions/assess/basic_object.rb +0 -15
  593. data/lib/contrast/core_extensions/assess/erb.rb +0 -42
  594. data/lib/contrast/core_extensions/assess/fiber.rb +0 -125
  595. data/lib/contrast/core_extensions/assess/hash.rb +0 -22
  596. data/lib/contrast/core_extensions/assess/kernel.rb +0 -95
  597. data/lib/contrast/core_extensions/assess/module.rb +0 -14
  598. data/lib/contrast/core_extensions/assess/regexp.rb +0 -206
  599. data/lib/contrast/core_extensions/assess/string.rb +0 -75
  600. data/lib/contrast/core_extensions/assess/tilt_template_trigger.rb +0 -73
  601. data/lib/contrast/core_extensions/assess.rb +0 -51
  602. data/lib/contrast/core_extensions/eval_trigger.rb +0 -52
  603. data/lib/contrast/core_extensions/inventory/datastores.rb +0 -37
  604. data/lib/contrast/core_extensions/inventory.rb +0 -22
  605. data/lib/contrast/core_extensions/module.rb +0 -42
  606. data/lib/contrast/core_extensions/object.rb +0 -27
  607. data/lib/contrast/core_extensions/protect/applies_command_injection_rule.rb +0 -70
  608. data/lib/contrast/core_extensions/protect/applies_deserialization_rule.rb +0 -58
  609. data/lib/contrast/core_extensions/protect/applies_no_sqli_rule.rb +0 -81
  610. data/lib/contrast/core_extensions/protect/applies_path_traversal_rule.rb +0 -119
  611. data/lib/contrast/core_extensions/protect/applies_sqli_rule.rb +0 -63
  612. data/lib/contrast/core_extensions/protect/applies_xxe_rule.rb +0 -141
  613. data/lib/contrast/core_extensions/protect/kernel.rb +0 -30
  614. data/lib/contrast/core_extensions/protect/psych.rb +0 -7
  615. data/lib/contrast/core_extensions/thread.rb +0 -31
  616. data/lib/contrast/internal_exception.rb +0 -8
  617. data/lib/contrast/rails_extensions/assess/action_controller_inheritance.rb +0 -48
  618. data/lib/contrast/rails_extensions/assess/active_record.rb +0 -32
  619. data/lib/contrast/rails_extensions/assess/active_record_named.rb +0 -61
  620. data/lib/contrast/rails_extensions/assess/configuration.rb +0 -26
  621. data/lib/contrast/rails_extensions/buffer.rb +0 -30
  622. data/lib/contrast/rails_extensions/rack.rb +0 -45
  623. data/lib/contrast/sinatra_extensions/assess/cookie.rb +0 -26
  624. data/lib/contrast/sinatra_extensions/inventory/sinatra_base.rb +0 -59
  625. data/lib/contrast/tasks/service.rb +0 -95
  626. data/lib/contrast/utils/boolean_util.rb +0 -33
  627. data/lib/contrast/utils/cache.rb +0 -69
  628. data/lib/contrast/utils/comment_range.rb +0 -19
  629. data/lib/contrast/utils/data_store_util.rb +0 -23
  630. data/lib/contrast/utils/environment_util.rb +0 -152
  631. data/lib/contrast/utils/freeze_util.rb +0 -36
  632. data/lib/contrast/utils/gemfile_reader.rb +0 -191
  633. data/lib/contrast/utils/inventory_util.rb +0 -126
  634. data/lib/contrast/utils/operating_environment.rb +0 -38
  635. data/lib/contrast/utils/path_util.rb +0 -151
  636. data/lib/contrast/utils/performs_logging.rb +0 -152
  637. data/lib/contrast/utils/preflight_util.rb +0 -13
  638. data/lib/contrast/utils/prevent_serialization.rb +0 -52
  639. data/lib/contrast/utils/rack_assess_session_cookie.rb +0 -104
  640. data/lib/contrast/utils/rails_assess_configuration.rb +0 -95
  641. data/lib/contrast/utils/random_util.rb +0 -22
  642. data/lib/contrast/utils/ruby_ast_rewriter.rb +0 -74
  643. data/lib/contrast/utils/scope_util.rb +0 -99
  644. data/lib/contrast/utils/service_response_util.rb +0 -116
  645. data/lib/contrast/utils/service_sender_util.rb +0 -98
  646. data/lib/contrast/utils/sinatra_helper.rb +0 -49
  647. data/resources/csrf/inject.js +0 -44
  648. data/resources/factory-bot-spec/spec_helper.rb +0 -30
  649. data/resources/rubocops/kernel/catch_cop.rb +0 -37
  650. data/resources/rubocops/kernel/require_cop.rb +0 -37
  651. data/resources/rubocops/kernel/require_relative_cop.rb +0 -33
  652. data/resources/rubocops/module/autoload_cop.rb +0 -37
  653. data/resources/rubocops/module/const_defined_cop.rb +0 -37
  654. data/resources/rubocops/module/const_get_cop.rb +0 -37
  655. data/resources/rubocops/module/const_set_cop.rb +0 -37
  656. data/resources/rubocops/module/constants_cop.rb +0 -37
  657. data/resources/rubocops/module/name_cop.rb +0 -37
  658. data/resources/rubocops/object/class_cop.rb +0 -37
  659. data/resources/rubocops/object/freeze_cop.rb +0 -37
  660. data/resources/rubocops/object/frozen_cop.rb +0 -37
  661. data/resources/rubocops/object/is_a_cop.rb +0 -37
  662. data/resources/rubocops/object/method_cop.rb +0 -37
  663. data/resources/rubocops/object/respond_to_cop.rb +0 -37
  664. data/resources/rubocops/object/singleton_class_cop.rb +0 -37
  665. data/resources/rubocops/regexp/spelling_cop.rb +0 -44
  666. data/resources/rubocops/thread/new_cop.rb +0 -39
  667. data/resources/ruby-spec/ancestors_spec.rb +0 -70
  668. data/resources/ruby-spec/modulo_spec.rb +0 -831
  669. data/resources/ruby-spec/parameters_spec.rb +0 -261
  670. data/resources/ruby-spec/ruby_spec_spec_helper.rb +0 -35
  671. data/service_executables/.gitkeep +0 -0
  672. data/service_executables/VERSION +0 -1
  673. data/service_executables/linux/contrast-service +0 -0
  674. data/service_executables/mac/contrast-service +0 -0
  675. data/shared_libraries/funchook.h +0 -123
  676. data/shared_libraries/libfunchook.so +0 -0
@@ -1,51 +1,66 @@
1
- # Copyright (c) 2020 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
1
+ # Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
2
2
  # frozen_string_literal: true
3
3
 
4
- cs__scoped_require 'contrast/utils/timer'
5
- cs__scoped_require 'contrast/agent/request'
6
- cs__scoped_require 'contrast/agent/response'
7
- cs__scoped_require 'contrast/utils/comment_range'
8
- cs__scoped_require 'contrast/utils/inventory_util'
9
- cs__scoped_require 'contrast/components/interface'
4
+ require 'contrast/utils/timer'
5
+ require 'contrast/agent/request'
6
+ require 'contrast/agent/response'
7
+ require 'contrast/agent/inventory/database_config'
8
+ require 'contrast/components/logger'
9
+ require 'contrast/components/scope'
10
+ require 'contrast/utils/request_utils'
11
+ require 'contrast/agent/request_context_extend'
12
+ require 'contrast/agent/reporting/reporting_events/observed_route'
13
+ require 'contrast/agent/reporting/input_analysis/input_analysis'
14
+ require 'contrast/agent/reporting/reporting_events/application_activity'
10
15
 
11
16
  module Contrast
12
17
  module Agent
13
- # This class acts to encapsulate information about the currently executed
14
- # request, making it available to the Agent for the duration of the request
15
- # in a standardized and normalized format which the Agent understands.
18
+ # This class acts to encapsulate information about the currently executed request, making it available to the Agent
19
+ # for the duration of the request in a standardized and normalized format which the Agent understands.
16
20
  class RequestContext
17
- include Contrast::Components::Interface
18
- access_component :logging, :analysis, :scope, :contrast_service
19
-
20
- EMPTY_INPUT_ANALYSIS_PB = Contrast::Api::Settings::InputAnalysis.new
21
-
22
- attr_reader :timer,
23
- :speedracer_input_analysis,
24
- :request,
25
- :response,
26
- :activity,
27
- :server_activity,
28
- :route,
29
- :observed_route
30
-
31
- def initialize rack_request, app_loaded = true
21
+ include Contrast::Components::Logger::InstanceMethods
22
+ include Contrast::Components::Scope::InstanceMethods
23
+ include Contrast::Utils::RequestUtils
24
+ include Contrast::Agent::RequestContextExtend
25
+
26
+ INPUT_ANALYSIS = Contrast::Agent::Reporting::InputAnalysis.new
27
+
28
+ # @return [Contrast::Agent::Reporting:ApplicationActivity] the application activity found in this request
29
+ attr_reader :activity
30
+ # @return [Hash] context used to log the request
31
+ attr_reader :logging_hash
32
+ # @return [Contrast::Agent::Reporting::ObservedRoute] the route, used for coverage, of this request
33
+ attr_reader :observed_route
34
+ # @return [Contrast::Agent::Request] our wrapper around the Rack::Request for this context
35
+ attr_reader :request
36
+ # @return [Contrast::Agent::Response] our wrapper around the Rack::Response or Array for this context,
37
+ # only available after the application has finished its processing
38
+ attr_reader :response
39
+ # @return [Contrast::Agent::Reporting::RouteDiscovery] the route, used for findings, of this request
40
+ attr_reader :discovered_route
41
+ # @return [Contrast::Agent::Reporting::InputAnalysis]
42
+ attr_reader :agent_input_analysis
43
+ # @return [Array<String>] the hash of findings already reported fro this request
44
+ attr_reader :reported_findings
45
+ # @return [Contrast::Utils::Timer] when the context was created
46
+ attr_reader :timer
47
+
48
+ attr_accessor :propagation_event_count, :source_event_count
49
+
50
+ def initialize rack_request, app_loaded: true
32
51
  with_contrast_scope do
33
- # all requests get a timer
52
+ # all requests get a timer and hash
34
53
  @timer = Contrast::Utils::Timer.new
54
+ @logging_hash = { request_id: __id__ }
35
55
 
36
56
  # instantiate helper for request and response
37
- @request = Contrast::Agent::Request.new(rack_request)
38
-
39
- @activity = Contrast::Api::Dtm::Activity.new
40
- @activity.http_request = request.dtm
41
-
42
- @server_activity = Contrast::Api::Dtm::ServerActivity.new
43
-
44
- @observed_route = Contrast::Api::Dtm::ObservedRoute.new
57
+ @request = Contrast::Agent::Request.new(rack_request) if rack_request
58
+ @activity = Contrast::Agent::Reporting::ApplicationActivity.new
45
59
 
46
60
  # build analyzer
47
61
  @do_not_track = false
48
- @speedracer_input_analysis = EMPTY_INPUT_ANALYSIS_PB
62
+ @agent_input_analysis = INPUT_ANALYSIS
63
+ agent_input_analysis.request = request
49
64
 
50
65
  # flag to indicate whether the app is fully loaded
51
66
  @app_loaded = !!app_loaded
@@ -53,13 +68,19 @@ module Contrast
53
68
  # generic holder for properties that can be set throughout this request
54
69
  @_properties = {}
55
70
 
56
- @sample = true
71
+ # count of propagation events
72
+ @propagation_event_count = 0
57
73
 
58
- @sample_request, @sample_response = Contrast::Utils::Assess::SamplingUtil.instance.sample?(@request) if ASSESS.enabled?
74
+ # count of source events
75
+ @source_event_count = 0
59
76
 
60
- @sample_response &&= ASSESS.scan_response?
77
+ if ::Contrast::ASSESS.enabled?
78
+ @sample_req, @sample_res = Contrast::Utils::Assess::SamplingUtil.instance.sample?(@request)
79
+ end
61
80
 
62
- append_route_coverage(Contrast::Utils::PathUtil.get_route(@request))
81
+ @reported_findings = []
82
+
83
+ handle_routes
63
84
  end
64
85
  end
65
86
 
@@ -67,105 +88,32 @@ module Contrast
67
88
  @app_loaded
68
89
  end
69
90
 
70
- def analyze?
71
- @sample_request || @sample_response
72
- end
73
-
74
91
  def analyze_request?
75
- @sample_request
92
+ analyze_request_assess? || analyze_req_res_protect?
76
93
  end
77
94
 
78
95
  def analyze_response?
79
- @sample_response
96
+ analyze_response_assess? || analyze_req_res_protect?
80
97
  end
81
98
 
82
- # Convert the discovered route for this request to appropriate forms and
83
- # disseminate it to those locations where it is necessary for our route
84
- # coverage and finding vulnerability discovery features to function.
85
- def append_route_coverage route
86
- return unless route
87
-
88
- # For our findings
89
- @route = route
90
-
91
- # For SR findings
92
- @activity.routes << route
93
-
94
- # For TS routes
95
- @observed_route.signature = route.route
96
- @observed_route.verb = route.verb
97
- @observed_route.session_id = Contrast::Agent::FeatureState.instance.current_session_id
98
-
99
- # TODO: SPEED-273: deprecate when SR handles this. ContrastUI API currently does not allow empty url, so we have to provide a default
100
- @observed_route.url = route.url.empty? ? Contrast::Utils::ObjectShare::SLASH : route.url
99
+ def analyze_req_res_protect?
100
+ ::Contrast::PROTECT.enabled?
101
101
  end
102
102
 
103
- # Collect the results for the given rule with the given action
104
- #
105
- # @param rule [String] the id of the rule to which the results apply
106
- # @param response_type [Symbol] the result of the response, matching a
107
- # value of Contrast::Api::Dtm::AttackResult::ResponseType
108
- # @return [Array<Contrast::Api::Dtm::AttackResult>]
109
- def results_for rule, response_type = nil
110
- if response_type.nil?
111
- activity.results.select { |r| r.rule_id == rule }
112
- else
113
- activity.results.select { |r| r.rule_id == rule && r.response == response_type }
114
- end
115
- end
103
+ def analyze_request_assess?
104
+ return false unless analyze_req_res_assess?
116
105
 
117
- def service_extract_request
118
- return false if @do_not_track
119
-
120
- service_response = CONTRAST_SERVICE.send_message(@activity.http_request)
121
- return false unless service_response
122
-
123
- handle_protect_state(service_response)
124
- ia = service_response.input_analysis
125
- if ia
126
- logger.debug(nil, "Analysis from Contrast Service: evaluations=#{ ia.results.length }")
127
- logger.debug(nil, "IA=#{ ia.inspect }")
128
- @speedracer_input_analysis = ia
129
- else
130
- logger.debug(nil, 'Analysis from Contrast Service was empty.')
131
- false
132
- end
133
- rescue Contrast::SecurityException
134
- raise
135
- rescue StandardError => e
136
- logger.warn(e, 'Unable to extract Contrast Service information from request')
137
- false
106
+ @sample_req
138
107
  end
139
108
 
140
- # NOTE: this method is only used as a backstop if Speedracer sends Input Evaluations
141
- # when the protect state indicates a security exception should be thrown. This method
142
- # ensures that the attack reports are generated. Normally these should be generated on
143
- # Speedracer for any attacks detected during prefilter.
144
- def handle_protect_state agent_settings
145
- return unless agent_settings
146
- return unless agent_settings.protect_state
147
-
148
- @uuid = agent_settings.protect_state.uuid
149
- @do_not_track = true unless agent_settings.protect_state.track_request
109
+ def analyze_response_assess?
110
+ return false unless analyze_req_res_assess?
150
111
 
151
- return unless agent_settings.protect_state.security_exception
152
-
153
- # If Contrast Service has NOT handled the input analysis, handle them here
154
- build_attack_results(agent_settings)
155
-
156
- msg = agent_settings.protect_state.security_message
157
- logger.warn(nil, 'Contrast Service said to block this request')
158
- raise Contrast::SecurityException.new(nil, (msg || 'Blocking suspicious behavior'))
112
+ @sample_res &&= ::Contrast::ASSESS.scan_response?
159
113
  end
160
114
 
161
- # append anything we've learned to the request seen message
162
- # this is the sum-total of all inventory information that has
163
- # been accumulated since the last request
164
- def extract_after rack_response
165
- @response = Contrast::Agent::Response.new(rack_response)
166
- activity.http_response = @response.dtm if @sample_response
167
- rescue StandardError => e
168
- logger.error(e, 'Unable to extract information after request')
115
+ def analyze_req_res_assess?
116
+ ::Contrast::ASSESS.enabled?
169
117
  end
170
118
 
171
119
  def add_property key, value
@@ -177,48 +125,16 @@ module Contrast
177
125
  end
178
126
 
179
127
  def reset_activity
180
- @activity = Contrast::Api::Dtm::Activity.new(http_request: request.dtm)
181
- @server_activity = Contrast::Api::Dtm::ServerActivity.new # it doesn't look like this is ever actually used?
182
- @observed_route = Contrast::Api::Dtm::ObservedRoute.new
128
+ @activity = Contrast::Agent::Reporting::ApplicationActivity.new
129
+ @observed_route = Contrast::Agent::Reporting::ObservedRoute.new
183
130
  end
184
131
 
185
132
  private
186
133
 
187
- # Generate attack results directly from any evaluations on the
188
- # agent settings object.
189
- def build_attack_results agent_settings
190
- return unless agent_settings&.input_analysis&.results&.any?
191
-
192
- attack_results_by_rule = {}
193
- agent_settings.input_analysis.results.each do |ia_result|
194
- rule_id = ia_result.rule_id
195
- rule = PROTECT.rule(rule_id)
196
- next unless rule
197
-
198
- logger.debug(nil, "Building attack result from Contrast Service input analysis: result=#{ ia_result.inspect }")
199
-
200
- attack_result = if rule.mode == :BLOCK
201
- # special case for rules (like reflected xss)
202
- # that used to have an infilter / block
203
- # mode but now are just block at perimeter
204
- rule.build_attack_with_match(
205
- self,
206
- ia_result,
207
- attack_results_by_rule[rule_id],
208
- ia_result.value)
209
- else
210
- rule.build_attack_without_match(
211
- self,
212
- ia_result,
213
- attack_results_by_rule[rule_id])
214
- end
215
- attack_results_by_rule[rule_id] = attack_result
216
- end
217
-
218
- attack_results_by_rule.each_pair do |_, attack_result|
219
- logger.debug(nil, "Blocking for #{ attack_result.rule_id }")
220
- activity.results << attack_result
221
- end
134
+ def handle_routes
135
+ @observed_route = Contrast::Agent::Reporting::ObservedRoute.new
136
+ reporting_route = Contrast::Agent.framework_manager.get_route_information(@request)
137
+ append_to_observed_route(reporting_route)
222
138
  end
223
139
  end
224
140
  end
@@ -0,0 +1,85 @@
1
+ # Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
2
+ # frozen_string_literal: true
3
+
4
+ require 'contrast/agent/assess/rule/response/auto_complete_rule'
5
+ require 'contrast/agent/assess/rule/response/cache_control_header_rule'
6
+ require 'contrast/agent/assess/rule/response/click_jacking_header_rule'
7
+ require 'contrast/agent/assess/rule/response/csp_header_insecure_rule'
8
+ require 'contrast/agent/assess/rule/response/csp_header_missing_rule'
9
+ require 'contrast/agent/assess/rule/response/hsts_header_rule'
10
+ require 'contrast/agent/assess/rule/response/parameters_pollution_rule'
11
+ require 'contrast/agent/assess/rule/response/x_content_type_header_rule'
12
+ require 'contrast/agent/assess/rule/response/x_xss_protection_header_rule'
13
+ require 'contrast/agent/protect/input_analyzer/input_analyzer'
14
+ require 'contrast/components/logger'
15
+ require 'contrast/utils/log_utils'
16
+ require 'contrast/utils/string_utils'
17
+
18
+ module Contrast
19
+ module Agent
20
+ # This class extends RequestContexts: this class acts to encapsulate information about the currently
21
+ # executed request, making it available to the Agent for the duration of the request in a standardized
22
+ # and normalized format which the Agent understands.
23
+ module RequestContextExtend
24
+ include Contrast::Utils::CEFLogUtils
25
+ include Contrast::Components::Logger::InstanceMethods
26
+ # Convert the discovered route for this request to appropriate forms and disseminate it to those locations
27
+ # where it is necessary for our route coverage and finding vulnerability discovery features to function.
28
+ #
29
+ # @param route [Contrast::Agent::Reporting::RouteCoverage]
30
+ def append_to_observed_route route
31
+ return unless route
32
+
33
+ @observed_route.signature = route.route
34
+ @observed_route.verb = route.verb
35
+ @observed_route.url = route.url if route.url
36
+ @request.observed_route = @observed_route
37
+
38
+ observation = Contrast::Agent::Reporting::RouteDiscoveryObservation.new(route.url, route.verb)
39
+ @discovered_route = Contrast::Agent::Reporting::RouteDiscovery.new(route.route, observation)
40
+ @request.discovered_route = @discovered_route
41
+ end
42
+
43
+ # If protect is enabled for this request, examine said request for any possible attack input. If those inputs
44
+ # provided match a rule which should block at the perimeter, that will be raised here.
45
+ #
46
+ # @raise [Contrast::SecurityException]
47
+ def protect_input_analysis
48
+ return false unless ::Contrast::AGENT.enabled?
49
+ return false unless ::Contrast::PROTECT.enabled?
50
+ return false if @do_not_track
51
+
52
+ if (ia = Contrast::Agent::Protect::InputAnalyzer.analyse(request))
53
+ @agent_input_analysis = ia
54
+ else
55
+ logger.trace('Analysis from Agent was empty.')
56
+ end
57
+ rescue Contrast::SecurityException => e
58
+ raise(e)
59
+ rescue StandardError => e
60
+ logger.warn('Unable to extract protect information from request', e)
61
+ end
62
+
63
+ # append anything we've learned to the request seen message this is the sum-total of all inventory information
64
+ # that has been accumulated since the last request
65
+ def extract_after rack_response
66
+ # We must ALWAYS save the response, even if we don't need it here for response sampling. It is used for other
67
+ # vulnerability detection, most notably XSS, and not capturing it may suppress valid findings.
68
+ @response = Contrast::Agent::Response.new(rack_response)
69
+ return unless @sample_res
70
+
71
+ Contrast::Agent::Assess::Rule::Response::AutoComplete.new.analyze(@response)
72
+ Contrast::Agent::Assess::Rule::Response::CacheControl.new.analyze(@response)
73
+ Contrast::Agent::Assess::Rule::Response::ClickJacking.new.analyze(@response)
74
+ Contrast::Agent::Assess::Rule::Response::CspHeaderMissing.new.analyze(@response)
75
+ Contrast::Agent::Assess::Rule::Response::CspHeaderInsecure.new.analyze(@response)
76
+ Contrast::Agent::Assess::Rule::Response::HSTSHeader.new.analyze(@response)
77
+ Contrast::Agent::Assess::Rule::Response::ParametersPollution.new.analyze(@response)
78
+ Contrast::Agent::Assess::Rule::Response::XContentType.new.analyze(@response)
79
+ Contrast::Agent::Assess::Rule::Response::XXssProtection.new.analyze(@response)
80
+ rescue StandardError => e
81
+ logger.error('Unable to extract information after request', e)
82
+ end
83
+ end
84
+ end
85
+ end
@@ -0,0 +1,41 @@
1
+ # Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
2
+ # frozen_string_literal: true
3
+
4
+ require 'contrast/components/logger'
5
+ require 'contrast/components/scope'
6
+ require 'contrast/agent/reporting/reporter'
7
+ require 'contrast/agent/reporting/masker/masker'
8
+
9
+ module Contrast
10
+ module Agent
11
+ # This class is instantiated when we receive a request and the agent is enabled to process that request. It holds
12
+ # the ruleset that we perform filtering operations on (currently prefilter and postfilter).
13
+ class RequestHandler
14
+ include Contrast::Components::Logger::InstanceMethods
15
+
16
+ attr_reader :ruleset, :context
17
+
18
+ # @param context [Contrast::Agent::RequestContext] the context of the request for which this handler applies
19
+ def initialize context
20
+ @context = context
21
+ @ruleset = ::Contrast::AGENT.ruleset
22
+ end
23
+
24
+ # reports events[Contrast::Agent::Reporting::ObservedRoute] to TS
25
+ # Other ReportingEvents are handled through batching in the middleware
26
+ #
27
+ def report_observed_route
28
+ return unless (reporter = Contrast::Agent.reporter)
29
+
30
+ reporter.send_event(context.observed_route) if Contrast::ROUTES_SENT.sendable?(context.observed_route)
31
+ end
32
+
33
+ # If the response is streaming, we should only perform filtering on our stream safe rules
34
+ def stream_safe_postfilter
35
+ stream_safe_ruleset = ruleset.select(&:stream_safe?)
36
+ postfilter_ruleset = Contrast::Agent::RuleSet.new(stream_safe_ruleset)
37
+ postfilter_ruleset.postfilter
38
+ end
39
+ end
40
+ end
41
+ end
@@ -1,14 +1,14 @@
1
- # Copyright (c) 2020 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
1
+ # Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
2
2
  # frozen_string_literal: true
3
3
 
4
- cs__scoped_require 'resolv'
5
- cs__scoped_require 'timeout'
4
+ require 'resolv'
5
+ require 'timeout'
6
6
 
7
- cs__scoped_require 'contrast/utils/object_share'
8
- cs__scoped_require 'contrast/utils/string_utils'
9
- cs__scoped_require 'contrast/utils/comment_range'
10
- cs__scoped_require 'contrast/utils/hash_digest'
11
- cs__scoped_require 'contrast/components/interface'
7
+ require 'contrast/utils/object_share'
8
+ require 'contrast/utils/string_utils'
9
+ require 'contrast/utils/hash_digest'
10
+ require 'contrast/components/logger'
11
+ require 'contrast/utils/response_utils'
12
12
 
13
13
  module Contrast
14
14
  module Agent
@@ -17,11 +17,13 @@ module Contrast
17
17
  # data in a format that the Agent expects, caching those transformations in
18
18
  # order to avoid repeatedly creating Strings & thrashing GC.
19
19
  class Response
20
- include Contrast::Components::Interface
21
- access_component :logging
20
+ include Contrast::Components::Logger::InstanceMethods
21
+ include Contrast::Utils::ResponseUtils
22
22
 
23
23
  extend Forwardable
24
24
 
25
+ # @return [Array, Rack::Response] The Rack Response passed by the application & middleware. It can be an Array
26
+ # in format [response_code, header_hash, response_body] or an instance of Rack::Response
25
27
  attr_reader :rack_response
26
28
 
27
29
  def initialize rack_response
@@ -29,6 +31,9 @@ module Contrast
29
31
  @is_array = !rack_response.is_a?(Rack::Response)
30
32
  end
31
33
 
34
+ # The document type of the response, based on its Content-Type. Can be one of :JSON, :NORMAL, :XML, or nothing.
35
+ #
36
+ # @return [Symbol<:XML, :JSON, :NORMAL>, nil]
32
37
  def document_type
33
38
  case content_type
34
39
  when /xml/i
@@ -40,175 +45,42 @@ module Contrast
40
45
  end
41
46
  end
42
47
 
43
- # B/c the response can change, we can't memoize this :(
44
- def dtm
45
- context_response = Contrast::Api::Dtm::HttpResponse.new
46
- context_response.response_code = response_code.to_i
47
- headers.each_pair do |key, value|
48
- k = Contrast::Utils::StringUtils.force_utf8(key)
49
- v = Contrast::Utils::StringUtils.force_utf8(value)
50
- context_response.response_headers[k] = v
51
- end
52
- context_response.parsed_response_headers = true
53
-
54
- context_response.response_body = Contrast::Utils::StringUtils.force_utf8(body)
55
- context_response.parsed_response_body = true
56
-
57
- doc_type = document_type
58
- context_response.document_type = doc_type if doc_type
59
-
60
- context_response
61
- end
62
-
48
+ # The response code of this response
49
+ #
50
+ # @return [Integer]
63
51
  def response_code
64
- return unless @rack_response
52
+ return unless rack_response
65
53
 
66
- @is_array ? @rack_response[0].to_i : @rack_response.status
54
+ @is_array ? rack_response[0].to_i : rack_response.status
67
55
  end
68
56
 
57
+ # The headers of this response
58
+ #
59
+ # @return [Hash, nil]
69
60
  def headers
70
- return unless @rack_response
61
+ return unless rack_response
71
62
 
72
- if @is_array
73
- @rack_response[1]
74
- else
75
- @rack_response.headers
76
- end
63
+ @is_array ? rack_response[1] : rack_response.headers
77
64
  end
78
65
 
79
- # Header keys upcased and any underscores replaced with dashes
80
- # We cannot memoize this, b/c response headers can change during the
81
- # request lifecycle.
82
- def normalized_headers
83
- hash = {}
84
- headers.each_pair do |header_name, header_value|
85
- hash[Contrast::Utils::StringUtils.normalized_key(header_name)] = header_value
86
- end
87
- hash
88
- end
89
-
90
- CONTENT_TYPE_HEADER = 'CONTENT-TYPE'.cs__freeze
66
+ # The Content-Type of this response, as set in the headers hash under the key Rack::CONTENT_TYPE
67
+ #
68
+ # @return [String, nil]
91
69
  def content_type
92
- return unless @rack_response
70
+ return unless rack_response
93
71
 
94
- if @is_array
95
- normalized_headers[CONTENT_TYPE_HEADER]
96
- else
97
- @rack_response.content_type
98
- end
72
+ @is_array ? headers[Rack::CONTENT_TYPE] : rack_response.content_type
99
73
  end
100
74
 
101
- def header key
102
- return unless @rack_response
103
-
104
- if @is_array
105
- normalized_headers[Contrast::Utils::StringUtils.normalized_key(key)]
106
- else
107
- @rack_response.get_header(key)
108
- end
109
- end
110
-
111
- def set_header key, value
112
- return unless @rack_response
113
-
114
- if @is_array
115
- Rack::Utils.set_cookie_header!(@rack_response[1], key, value)
116
- elsif @rack_response.is_a?(Rack::Response)
117
- @rack_response.set_header(key, value)
118
- end
119
- end
120
-
121
- # The response body can change during the request lifecycle
122
- # We should not extract it out as a variable here, or we'll miss those
123
- # changes. (headdesk)
75
+ # The response body can change during the request lifecycle, so we have to look it up every time we need it.
76
+ # We should not extract it out as a variable here, or we'll miss those changes.
77
+ #
78
+ # @return [String, nil]
124
79
  def body
125
- return unless @rack_response
80
+ return unless rack_response
126
81
 
127
- if @is_array
128
- extract_body(@rack_response[2])
129
- elsif Contrast::Utils::DuckUtils.quacks_to?(@rack_response, :body)
130
- extract_body(@rack_response.body)
131
- end
132
- end
133
-
134
- def update_body body_string
135
- return unless @rack_response
136
-
137
- successfully_updated_body = true
138
- if @is_array
139
- if @rack_response[2].is_a?(Rack::BodyProxy)
140
- successfully_updated_body = update_rack_body_proxy(body_string, true)
141
- else
142
- @rack_response[2] = [body_string]
143
- end
144
- elsif @rack_response.body.is_a?(Rack::BodyProxy)
145
- successfully_updated_body = update_rack_body_proxy(body_string)
146
- else
147
- @rack_response.body = body_string
148
- end
149
- update_content_length(body_string.bytesize) if successfully_updated_body
150
- end
151
-
152
- # Set the length header for this response. This value should be set ot the
153
- # bytesize, NOT THE LENGTH, of the response body. Otherwise, we may get
154
- # got by the Lint thing.
155
- CONTENT_LENGTH_HEADER = 'Content-Length'.cs__freeze
156
- def update_content_length length
157
- headers[CONTENT_LENGTH_HEADER] = length.to_s
158
- end
159
-
160
- private
161
-
162
- HTTP_PREFIX = /^[Hh][Tt][Tt][Pp][_-]/i.cs__freeze
163
-
164
- def update_rack_body_proxy body_string, is_array = false
165
- top_body_proxy = is_array ? @rack_response[2] : @rack_response
166
- parent_body_proxy = top_body_proxy
167
- until (next_body = parent_body_proxy.instance_variable_get(:@body)).cs__class != Rack::BodyProxy
168
- parent_body_proxy = next_body
169
- end
170
-
171
- if next_body.cs__class.to_s == 'ActionDispatch::Response::RackBody'
172
- modified_response = next_body.instance_variable_defined?(:@response) ? next_body.instance_variable_get(:@response) : nil
173
- if modified_response
174
- modified_response.body = body_string
175
- next_body.instance_variable_set(:@response, modified_response)
176
- end
177
- elsif next_body.is_a?(Array) && next_body[0].cs__class.to_s == 'ActionView::OutputBuffer'
178
- new_body = ActionView::OutputBuffer.new(body_string)
179
- next_body[0] = new_body
180
- else
181
- logger.warn("Detected unsupported Rack::BodyProxy internal response class #{ next_body.cs__class }")
182
- return false
183
- end
184
- true
185
- end
186
-
187
- def extract_body body
188
- return nil unless body
189
-
190
- if defined?(Rack::File) && body.is_a?(Rack::File)
191
- # not sure what to do in this situation, so don't do anything.
192
- nil
193
- elsif Contrast::Utils::DuckUtils.quacks_to?(body, :each)
194
- acc = []
195
- body.each { |tmp| acc << read_or_string(tmp) }
196
- acc.compact.join(Contrast::Utils::ObjectShare::NEW_LINE)
197
- else
198
- read_or_string(body)
199
- end
200
- end
201
-
202
- def read_or_string obj
203
- return nil unless obj
204
-
205
- if Contrast::Utils::DuckUtils.quacks_to?(obj, :read)
206
- tmp = obj.read
207
- obj.rewind
208
- tmp
209
- else
210
- obj.to_s
211
- end
82
+ body_content = @is_array ? rack_response[2] : rack_response.body
83
+ extract_body(body_content)
212
84
  end
213
85
  end
214
86
  end