contrast-agent 4.13.1 → 5.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (399) hide show
  1. checksums.yaml +4 -4
  2. data/.simplecov +2 -2
  3. data/Gemfile +1 -1
  4. data/LICENSE.txt +1 -1
  5. data/Rakefile +1 -1
  6. data/exe/contrast_service +1 -1
  7. data/ext/build_funchook.rb +1 -1
  8. data/ext/cs__assess_array/cs__assess_array.c +1 -1
  9. data/ext/cs__assess_array/extconf.rb +1 -1
  10. data/ext/cs__assess_basic_object/cs__assess_basic_object.c +1 -1
  11. data/ext/cs__assess_basic_object/extconf.rb +1 -1
  12. data/ext/cs__assess_fiber_track/cs__assess_fiber_track.c +1 -1
  13. data/ext/cs__assess_fiber_track/extconf.rb +1 -1
  14. data/ext/cs__assess_hash/cs__assess_hash.c +1 -1
  15. data/ext/cs__assess_hash/extconf.rb +1 -1
  16. data/ext/cs__assess_kernel/cs__assess_kernel.c +1 -1
  17. data/ext/cs__assess_kernel/extconf.rb +1 -1
  18. data/ext/cs__assess_marshal_module/cs__assess_marshal_module.c +1 -1
  19. data/ext/cs__assess_marshal_module/extconf.rb +1 -1
  20. data/ext/cs__assess_module/cs__assess_module.c +42 -32
  21. data/ext/cs__assess_module/extconf.rb +1 -1
  22. data/ext/cs__assess_regexp/cs__assess_regexp.c +1 -1
  23. data/ext/cs__assess_regexp/extconf.rb +1 -1
  24. data/ext/cs__assess_string/cs__assess_string.c +1 -1
  25. data/ext/cs__assess_string/extconf.rb +1 -1
  26. data/ext/cs__assess_string_interpolation26/cs__assess_string_interpolation26.c +1 -1
  27. data/ext/cs__assess_string_interpolation26/extconf.rb +1 -1
  28. data/ext/cs__assess_yield_track/cs__assess_yield_track.c +1 -1
  29. data/ext/cs__assess_yield_track/extconf.rb +1 -1
  30. data/ext/cs__common/cs__common.c +1 -1
  31. data/ext/cs__common/extconf.rb +1 -1
  32. data/ext/cs__contrast_patch/cs__contrast_patch.c +1 -1
  33. data/ext/cs__contrast_patch/extconf.rb +1 -1
  34. data/ext/cs__os_information/cs__os_information.c +1 -1
  35. data/ext/cs__os_information/extconf.rb +1 -1
  36. data/ext/extconf_common.rb +1 -1
  37. data/lib/contrast/agent/assess/contrast_event.rb +7 -11
  38. data/lib/contrast/agent/assess/contrast_object.rb +1 -1
  39. data/lib/contrast/agent/assess/events/event_data.rb +30 -0
  40. data/lib/contrast/agent/assess/events/event_factory.rb +14 -6
  41. data/lib/contrast/agent/assess/events/source_event.rb +22 -3
  42. data/lib/contrast/agent/assess/finalizers/freeze.rb +1 -1
  43. data/lib/contrast/agent/assess/finalizers/hash.rb +1 -1
  44. data/lib/contrast/agent/assess/policy/dynamic_source_factory.rb +7 -7
  45. data/lib/contrast/agent/assess/policy/patcher.rb +1 -35
  46. data/lib/contrast/agent/assess/policy/policy.rb +1 -1
  47. data/lib/contrast/agent/assess/policy/policy_node.rb +7 -7
  48. data/lib/contrast/agent/assess/policy/policy_scanner.rb +6 -1
  49. data/lib/contrast/agent/assess/policy/preshift.rb +1 -1
  50. data/lib/contrast/agent/assess/policy/propagation_method.rb +55 -28
  51. data/lib/contrast/agent/assess/policy/propagation_node.rb +1 -1
  52. data/lib/contrast/agent/assess/policy/propagator/append.rb +1 -1
  53. data/lib/contrast/agent/assess/policy/propagator/base.rb +1 -1
  54. data/lib/contrast/agent/assess/policy/propagator/center.rb +2 -2
  55. data/lib/contrast/agent/assess/policy/propagator/custom.rb +1 -1
  56. data/lib/contrast/agent/assess/policy/propagator/database_write.rb +6 -2
  57. data/lib/contrast/agent/assess/policy/propagator/insert.rb +5 -2
  58. data/lib/contrast/agent/assess/policy/propagator/keep.rb +1 -1
  59. data/lib/contrast/agent/assess/policy/propagator/match_data.rb +11 -3
  60. data/lib/contrast/agent/assess/policy/propagator/next.rb +1 -1
  61. data/lib/contrast/agent/assess/policy/propagator/prepend.rb +1 -1
  62. data/lib/contrast/agent/assess/policy/propagator/rack_protection.rb +1 -1
  63. data/lib/contrast/agent/assess/policy/propagator/remove.rb +1 -1
  64. data/lib/contrast/agent/assess/policy/propagator/replace.rb +1 -1
  65. data/lib/contrast/agent/assess/policy/propagator/reverse.rb +1 -1
  66. data/lib/contrast/agent/assess/policy/propagator/select.rb +3 -2
  67. data/lib/contrast/agent/assess/policy/propagator/splat.rb +1 -1
  68. data/lib/contrast/agent/assess/policy/propagator/split.rb +27 -25
  69. data/lib/contrast/agent/assess/policy/propagator/substitution.rb +3 -157
  70. data/lib/contrast/agent/assess/policy/propagator/substitution_utils.rb +190 -0
  71. data/lib/contrast/agent/assess/policy/propagator/trim.rb +9 -4
  72. data/lib/contrast/agent/assess/policy/propagator.rb +1 -1
  73. data/lib/contrast/agent/assess/policy/source_method.rb +39 -26
  74. data/lib/contrast/agent/assess/policy/source_node.rb +1 -1
  75. data/lib/contrast/agent/assess/policy/source_validation/cross_site_validator.rb +1 -1
  76. data/lib/contrast/agent/assess/policy/source_validation/source_validation.rb +1 -1
  77. data/lib/contrast/agent/assess/policy/trigger/reflected_xss.rb +7 -2
  78. data/lib/contrast/agent/assess/policy/trigger/xpath.rb +1 -1
  79. data/lib/contrast/agent/assess/policy/trigger_method.rb +68 -18
  80. data/lib/contrast/agent/assess/policy/trigger_node.rb +15 -7
  81. data/lib/contrast/agent/assess/policy/trigger_validation/redos_validator.rb +1 -1
  82. data/lib/contrast/agent/assess/policy/trigger_validation/ssrf_validator.rb +1 -1
  83. data/lib/contrast/agent/assess/policy/trigger_validation/trigger_validation.rb +1 -1
  84. data/lib/contrast/agent/assess/policy/trigger_validation/xss_validator.rb +2 -2
  85. data/lib/contrast/agent/assess/properties.rb +1 -1
  86. data/lib/contrast/agent/assess/property/evented.rb +25 -12
  87. data/lib/contrast/agent/assess/property/tagged.rb +52 -58
  88. data/lib/contrast/agent/assess/property/updated.rb +1 -1
  89. data/lib/contrast/agent/assess/rule/provider/hardcoded_key.rb +1 -19
  90. data/lib/contrast/agent/assess/rule/provider/hardcoded_password.rb +1 -13
  91. data/lib/contrast/agent/assess/rule/provider/hardcoded_value_rule.rb +42 -60
  92. data/lib/contrast/agent/assess/rule/provider.rb +1 -1
  93. data/lib/contrast/agent/assess/rule/response/autocomplete_rule.rb +68 -0
  94. data/lib/contrast/agent/assess/rule/response/base_rule.rb +197 -0
  95. data/lib/contrast/agent/assess/rule/response/cachecontrol_rule.rb +184 -0
  96. data/lib/contrast/agent/assess/rule/response/clickjacking_rule.rb +66 -0
  97. data/lib/contrast/agent/assess/rule/response/csp_header_insecure_rule.rb +101 -0
  98. data/lib/contrast/agent/assess/rule/response/csp_header_missing_rule.rb +46 -0
  99. data/lib/contrast/agent/assess/rule/response/hsts_header_rule.rb +60 -0
  100. data/lib/contrast/agent/assess/rule/response/parameters_pollution_rule.rb +60 -0
  101. data/lib/contrast/agent/assess/rule/response/x_content_type_rule.rb +52 -0
  102. data/lib/contrast/agent/assess/rule/response/x_xss_protection_rule.rb +53 -0
  103. data/lib/contrast/agent/assess/tag.rb +1 -1
  104. data/lib/contrast/agent/assess/tracker.rb +1 -1
  105. data/lib/contrast/agent/assess.rb +1 -2
  106. data/lib/contrast/agent/at_exit_hook.rb +1 -1
  107. data/lib/contrast/agent/deadzone/policy/deadzone_node.rb +13 -8
  108. data/lib/contrast/agent/deadzone/policy/policy.rb +1 -1
  109. data/lib/contrast/agent/disable_reaction.rb +1 -1
  110. data/lib/contrast/agent/exclusion_matcher.rb +1 -1
  111. data/lib/contrast/agent/inventory/database_config.rb +115 -77
  112. data/lib/contrast/agent/inventory/dependencies.rb +1 -1
  113. data/lib/contrast/agent/inventory/dependency_analysis.rb +1 -1
  114. data/lib/contrast/agent/inventory/dependency_usage_analysis.rb +3 -3
  115. data/lib/contrast/agent/inventory/policy/datastores.rb +1 -1
  116. data/lib/contrast/agent/inventory/policy/policy.rb +1 -1
  117. data/lib/contrast/agent/inventory/policy/trigger_node.rb +1 -1
  118. data/lib/contrast/agent/inventory.rb +1 -1
  119. data/lib/contrast/agent/metric_telemetry_event.rb +3 -3
  120. data/lib/contrast/agent/middleware.rb +8 -77
  121. data/lib/contrast/agent/module_data.rb +1 -1
  122. data/lib/contrast/agent/patching/policy/after_load_patch.rb +1 -1
  123. data/lib/contrast/agent/patching/policy/after_load_patcher.rb +1 -1
  124. data/lib/contrast/agent/patching/policy/method_policy.rb +31 -104
  125. data/lib/contrast/agent/patching/policy/method_policy_extend.rb +113 -0
  126. data/lib/contrast/agent/patching/policy/module_policy.rb +1 -1
  127. data/lib/contrast/agent/patching/policy/patch.rb +1 -1
  128. data/lib/contrast/agent/patching/policy/patch_status.rb +2 -26
  129. data/lib/contrast/agent/patching/policy/patcher.rb +13 -13
  130. data/lib/contrast/agent/patching/policy/policy.rb +1 -1
  131. data/lib/contrast/agent/patching/policy/policy_node.rb +1 -1
  132. data/lib/contrast/agent/patching/policy/trigger_node.rb +1 -1
  133. data/lib/contrast/agent/protect/policy/applies_command_injection_rule.rb +1 -1
  134. data/lib/contrast/agent/protect/policy/applies_deserialization_rule.rb +1 -1
  135. data/lib/contrast/agent/protect/policy/applies_no_sqli_rule.rb +1 -1
  136. data/lib/contrast/agent/protect/policy/applies_path_traversal_rule.rb +1 -1
  137. data/lib/contrast/agent/protect/policy/applies_sqli_rule.rb +1 -1
  138. data/lib/contrast/agent/protect/policy/applies_xxe_rule.rb +1 -1
  139. data/lib/contrast/agent/protect/policy/policy.rb +1 -1
  140. data/lib/contrast/agent/protect/policy/rule_applicator.rb +1 -1
  141. data/lib/contrast/agent/protect/policy/trigger_node.rb +1 -1
  142. data/lib/contrast/agent/protect/rule/base.rb +1 -1
  143. data/lib/contrast/agent/protect/rule/base_service.rb +1 -1
  144. data/lib/contrast/agent/protect/rule/cmd_injection.rb +1 -1
  145. data/lib/contrast/agent/protect/rule/default_scanner.rb +1 -1
  146. data/lib/contrast/agent/protect/rule/deserialization.rb +1 -1
  147. data/lib/contrast/agent/protect/rule/http_method_tampering.rb +1 -1
  148. data/lib/contrast/agent/protect/rule/no_sqli/mongo_no_sql_scanner.rb +1 -1
  149. data/lib/contrast/agent/protect/rule/no_sqli.rb +1 -1
  150. data/lib/contrast/agent/protect/rule/path_traversal.rb +1 -1
  151. data/lib/contrast/agent/protect/rule/sql_sample_builder.rb +1 -1
  152. data/lib/contrast/agent/protect/rule/sqli/default_sql_scanner.rb +1 -1
  153. data/lib/contrast/agent/protect/rule/sqli/mysql_sql_scanner.rb +1 -1
  154. data/lib/contrast/agent/protect/rule/sqli/postgres_sql_scanner.rb +2 -2
  155. data/lib/contrast/agent/protect/rule/sqli/sqlite_sql_scanner.rb +1 -1
  156. data/lib/contrast/agent/protect/rule/sqli.rb +1 -1
  157. data/lib/contrast/agent/protect/rule/unsafe_file_upload.rb +1 -1
  158. data/lib/contrast/agent/protect/rule/xss.rb +1 -1
  159. data/lib/contrast/agent/protect/rule/xxe/entity_wrapper.rb +1 -1
  160. data/lib/contrast/agent/protect/rule/xxe.rb +1 -1
  161. data/lib/contrast/agent/protect/rule.rb +1 -1
  162. data/lib/contrast/agent/reaction_processor.rb +1 -1
  163. data/lib/contrast/agent/reporting/report.rb +27 -0
  164. data/lib/contrast/agent/reporting/reporter.rb +115 -0
  165. data/lib/contrast/agent/reporting/reporting_events/application_inventory.rb +49 -0
  166. data/lib/contrast/agent/reporting/reporting_events/application_update.rb +82 -0
  167. data/lib/contrast/agent/reporting/reporting_events/architecture_component.rb +80 -0
  168. data/lib/contrast/agent/reporting/reporting_events/discovered_route.rb +59 -0
  169. data/lib/contrast/agent/reporting/reporting_events/finding.rb +195 -0
  170. data/lib/contrast/agent/reporting/reporting_events/finding_event.rb +264 -0
  171. data/lib/contrast/agent/reporting/reporting_events/finding_event_source.rb +57 -0
  172. data/lib/contrast/agent/reporting/reporting_events/finding_object.rb +90 -0
  173. data/lib/contrast/agent/reporting/reporting_events/finding_request.rb +121 -0
  174. data/lib/contrast/agent/reporting/reporting_events/finding_signature.rb +105 -0
  175. data/lib/contrast/agent/reporting/reporting_events/finding_stack.rb +67 -0
  176. data/lib/contrast/agent/reporting/reporting_events/finding_taint_range.rb +58 -0
  177. data/lib/contrast/agent/reporting/reporting_events/library_discovery.rb +93 -0
  178. data/lib/contrast/agent/reporting/reporting_events/library_usage_observation.rb +50 -0
  179. data/lib/contrast/agent/reporting/reporting_events/observed_library_usage.rb +54 -0
  180. data/lib/contrast/agent/reporting/reporting_events/observed_route.rb +66 -0
  181. data/lib/contrast/agent/reporting/reporting_events/preflight.rb +39 -0
  182. data/lib/contrast/agent/reporting/reporting_events/preflight_message.rb +75 -0
  183. data/lib/contrast/agent/reporting/reporting_events/reporting_event.rb +47 -0
  184. data/lib/contrast/agent/reporting/reporting_events/route_coverage.rb +76 -0
  185. data/lib/contrast/agent/reporting/reporting_events/route_discovery.rb +66 -0
  186. data/lib/contrast/agent/reporting/reporting_events/route_discovery_observation.rb +65 -0
  187. data/lib/contrast/agent/reporting/reporting_events/server_activity.rb +52 -0
  188. data/lib/contrast/agent/reporting/reporting_events/trace_event_source.rb +30 -0
  189. data/lib/contrast/agent/reporting/reporting_utilities/audit.rb +137 -0
  190. data/lib/contrast/agent/reporting/reporting_utilities/dtm_message.rb +67 -0
  191. data/lib/contrast/agent/reporting/reporting_utilities/endpoints.rb +165 -0
  192. data/lib/contrast/agent/reporting/reporting_utilities/headers.rb +55 -0
  193. data/lib/contrast/agent/reporting/reporting_utilities/reporter_client.rb +86 -0
  194. data/lib/contrast/agent/reporting/reporting_utilities/reporter_client_utils.rb +154 -0
  195. data/lib/contrast/agent/reporting/reporting_utilities/reporting_storage.rb +66 -0
  196. data/lib/contrast/agent/reporting/reporting_utilities/response.rb +30 -0
  197. data/lib/contrast/agent/reporting/reporting_utilities/response_handler.rb +57 -0
  198. data/lib/contrast/agent/reporting/reporting_utilities/response_handler_utils.rb +196 -0
  199. data/lib/contrast/agent/reporting/settings/application_settings.rb +67 -0
  200. data/lib/contrast/agent/reporting/settings/assess.rb +45 -0
  201. data/lib/contrast/agent/reporting/settings/assess_server_feature.rb +136 -0
  202. data/lib/contrast/agent/reporting/settings/exclusions.rb +123 -0
  203. data/lib/contrast/agent/reporting/settings/protect.rb +89 -0
  204. data/lib/contrast/agent/reporting/settings/protect_server_feature.rb +243 -0
  205. data/lib/contrast/agent/reporting/settings/reaction.rb +30 -0
  206. data/lib/contrast/agent/reporting/settings/server_features.rb +78 -0
  207. data/lib/contrast/agent/request.rb +46 -84
  208. data/lib/contrast/agent/request_context.rb +20 -131
  209. data/lib/contrast/agent/request_context_extend.rb +176 -0
  210. data/lib/contrast/agent/request_handler.rb +41 -5
  211. data/lib/contrast/agent/response.rb +25 -88
  212. data/lib/contrast/agent/rule_set.rb +1 -1
  213. data/lib/contrast/agent/scope.rb +1 -1
  214. data/lib/contrast/agent/service_heartbeat.rb +1 -1
  215. data/lib/contrast/agent/startup_metrics_telemetry_event.rb +73 -23
  216. data/lib/contrast/agent/static_analysis.rb +14 -4
  217. data/lib/contrast/agent/telemetry.rb +16 -8
  218. data/lib/contrast/agent/telemetry_event.rb +9 -10
  219. data/lib/contrast/agent/thread.rb +1 -1
  220. data/lib/contrast/agent/thread_watcher.rb +32 -6
  221. data/lib/contrast/agent/tracepoint_hook.rb +1 -4
  222. data/lib/contrast/agent/version.rb +2 -2
  223. data/lib/contrast/agent/worker_thread.rb +1 -1
  224. data/lib/contrast/agent.rb +16 -1
  225. data/lib/contrast/api/communication/connection_status.rb +11 -8
  226. data/lib/contrast/api/communication/messaging_queue.rb +38 -4
  227. data/lib/contrast/api/communication/response_processor.rb +22 -11
  228. data/lib/contrast/api/communication/service_lifecycle.rb +14 -4
  229. data/lib/contrast/api/communication/socket.rb +7 -9
  230. data/lib/contrast/api/communication/socket_client.rb +33 -13
  231. data/lib/contrast/api/communication/speedracer.rb +38 -2
  232. data/lib/contrast/api/communication/tcp_socket.rb +5 -4
  233. data/lib/contrast/api/communication/unix_socket.rb +2 -1
  234. data/lib/contrast/api/communication.rb +1 -1
  235. data/lib/contrast/api/decorators/address.rb +1 -1
  236. data/lib/contrast/api/decorators/agent_startup.rb +1 -1
  237. data/lib/contrast/api/decorators/application_settings.rb +1 -1
  238. data/lib/contrast/api/decorators/application_startup.rb +1 -1
  239. data/lib/contrast/api/decorators/application_update.rb +1 -1
  240. data/lib/contrast/api/decorators/architecture_component.rb +36 -0
  241. data/lib/contrast/api/decorators/finding.rb +29 -0
  242. data/lib/contrast/api/decorators/http_request.rb +3 -2
  243. data/lib/contrast/api/decorators/input_analysis.rb +1 -1
  244. data/lib/contrast/api/decorators/instrumentation_mode.rb +1 -1
  245. data/lib/contrast/api/decorators/library.rb +1 -1
  246. data/lib/contrast/api/decorators/library_usage_update.rb +1 -1
  247. data/lib/contrast/api/decorators/message.rb +1 -1
  248. data/lib/contrast/api/decorators/rasp_rule_sample.rb +1 -1
  249. data/lib/contrast/api/decorators/route_coverage.rb +1 -1
  250. data/lib/contrast/api/decorators/server_features.rb +1 -1
  251. data/lib/contrast/api/decorators/trace_event.rb +1 -1
  252. data/lib/contrast/api/decorators/trace_event_object.rb +1 -1
  253. data/lib/contrast/api/decorators/trace_event_signature.rb +1 -1
  254. data/lib/contrast/api/decorators/trace_taint_range.rb +1 -1
  255. data/lib/contrast/api/decorators/trace_taint_range_tags.rb +1 -1
  256. data/lib/contrast/api/decorators/user_input.rb +1 -1
  257. data/lib/contrast/api/decorators.rb +2 -1
  258. data/lib/contrast/api.rb +1 -1
  259. data/lib/contrast/components/agent.rb +5 -24
  260. data/lib/contrast/components/api.rb +67 -2
  261. data/lib/contrast/components/app_context.rb +12 -66
  262. data/lib/contrast/components/app_context_extend.rb +78 -0
  263. data/lib/contrast/components/assess.rb +12 -8
  264. data/lib/contrast/components/base.rb +24 -1
  265. data/lib/contrast/components/config.rb +38 -23
  266. data/lib/contrast/components/contrast_service.rb +6 -1
  267. data/lib/contrast/components/heap_dump.rb +1 -1
  268. data/lib/contrast/components/inventory.rb +5 -1
  269. data/lib/contrast/components/logger.rb +1 -1
  270. data/lib/contrast/components/protect.rb +6 -2
  271. data/lib/contrast/components/sampling.rb +3 -3
  272. data/lib/contrast/components/scope.rb +1 -1
  273. data/lib/contrast/components/settings.rb +25 -12
  274. data/lib/contrast/config/agent_configuration.rb +2 -2
  275. data/lib/contrast/config/api_configuration.rb +9 -4
  276. data/lib/contrast/config/api_proxy_configuration.rb +14 -0
  277. data/lib/contrast/config/application_configuration.rb +3 -4
  278. data/lib/contrast/config/assess_configuration.rb +4 -4
  279. data/lib/contrast/config/assess_rules_configuration.rb +1 -1
  280. data/lib/contrast/config/base_configuration.rb +18 -29
  281. data/lib/contrast/config/certification_configuration.rb +15 -0
  282. data/lib/contrast/config/env_variables.rb +3 -10
  283. data/lib/contrast/config/exception_configuration.rb +1 -1
  284. data/lib/contrast/config/heap_dump_configuration.rb +7 -7
  285. data/lib/contrast/config/inventory_configuration.rb +2 -6
  286. data/lib/contrast/config/logger_configuration.rb +1 -1
  287. data/lib/contrast/config/protect_configuration.rb +1 -1
  288. data/lib/contrast/config/protect_rule_configuration.rb +2 -2
  289. data/lib/contrast/config/protect_rules_configuration.rb +1 -1
  290. data/lib/contrast/config/request_audit_configuration.rb +18 -0
  291. data/lib/contrast/config/root_configuration.rb +1 -1
  292. data/lib/contrast/config/ruby_configuration.rb +10 -7
  293. data/lib/contrast/config/sampling_configuration.rb +1 -1
  294. data/lib/contrast/config/server_configuration.rb +1 -1
  295. data/lib/contrast/config/service_configuration.rb +2 -3
  296. data/lib/contrast/config.rb +1 -2
  297. data/lib/contrast/configuration.rb +2 -3
  298. data/lib/contrast/extension/assess/array.rb +9 -9
  299. data/lib/contrast/extension/assess/erb.rb +32 -5
  300. data/lib/contrast/extension/assess/eval_trigger.rb +3 -1
  301. data/lib/contrast/extension/assess/exec_trigger.rb +2 -1
  302. data/lib/contrast/extension/assess/fiber.rb +6 -3
  303. data/lib/contrast/extension/assess/hash.rb +1 -1
  304. data/lib/contrast/extension/assess/kernel.rb +8 -3
  305. data/lib/contrast/extension/assess/marshal.rb +6 -2
  306. data/lib/contrast/extension/assess/regexp.rb +8 -2
  307. data/lib/contrast/extension/assess/string.rb +8 -2
  308. data/lib/contrast/extension/assess.rb +1 -1
  309. data/lib/contrast/extension/delegator.rb +1 -1
  310. data/lib/contrast/extension/extension.rb +2 -4
  311. data/lib/contrast/extension/inventory.rb +1 -1
  312. data/lib/contrast/extension/kernel.rb +1 -1
  313. data/lib/contrast/extension/module.rb +1 -1
  314. data/lib/contrast/extension/protect/psych.rb +1 -1
  315. data/lib/contrast/extension/protect.rb +1 -1
  316. data/lib/contrast/extension/thread.rb +32 -13
  317. data/lib/contrast/framework/base_support.rb +5 -1
  318. data/lib/contrast/framework/grape/support.rb +25 -1
  319. data/lib/contrast/framework/manager.rb +33 -36
  320. data/lib/contrast/framework/manager_extend.rb +50 -0
  321. data/lib/contrast/framework/platform_version.rb +1 -1
  322. data/lib/contrast/framework/rack/patch/session_cookie.rb +1 -1
  323. data/lib/contrast/framework/rack/patch/support.rb +1 -1
  324. data/lib/contrast/framework/rack/support.rb +1 -1
  325. data/lib/contrast/framework/rails/patch/action_controller_live_buffer.rb +1 -1
  326. data/lib/contrast/framework/rails/patch/assess_configuration.rb +1 -1
  327. data/lib/contrast/framework/rails/patch/rails_application_configuration.rb +1 -1
  328. data/lib/contrast/framework/rails/patch/support.rb +1 -1
  329. data/lib/contrast/framework/rails/railtie.rb +2 -2
  330. data/lib/contrast/framework/rails/support.rb +46 -2
  331. data/lib/contrast/framework/sinatra/support.rb +26 -3
  332. data/lib/contrast/funchook/funchook.rb +21 -18
  333. data/lib/contrast/logger/application.rb +1 -1
  334. data/lib/contrast/logger/format.rb +1 -1
  335. data/lib/contrast/logger/log.rb +9 -104
  336. data/lib/contrast/logger/request.rb +1 -1
  337. data/lib/contrast/logger/time.rb +1 -1
  338. data/lib/contrast/security_exception.rb +1 -1
  339. data/lib/contrast/tasks/config.rb +1 -1
  340. data/lib/contrast/tasks/service.rb +1 -1
  341. data/lib/contrast/utils/assess/propagation_method_utils.rb +1 -1
  342. data/lib/contrast/utils/assess/property/tagged_utils.rb +24 -1
  343. data/lib/contrast/utils/assess/sampling_util.rb +4 -4
  344. data/lib/contrast/utils/assess/source_method_utils.rb +1 -1
  345. data/lib/contrast/utils/assess/split_utils.rb +23 -0
  346. data/lib/contrast/utils/assess/tracking_util.rb +21 -16
  347. data/lib/contrast/utils/assess/trigger_method_utils.rb +4 -3
  348. data/lib/contrast/utils/class_util.rb +19 -15
  349. data/lib/contrast/utils/duck_utils.rb +1 -1
  350. data/lib/contrast/utils/env_configuration_item.rb +2 -2
  351. data/lib/contrast/utils/exclude_key.rb +1 -1
  352. data/lib/contrast/utils/findings.rb +65 -0
  353. data/lib/contrast/utils/hash_digest.rb +46 -79
  354. data/lib/contrast/utils/hash_digest_extend.rb +129 -0
  355. data/lib/contrast/utils/head_dump_utils_extend.rb +74 -0
  356. data/lib/contrast/utils/heap_dump_util.rb +3 -66
  357. data/lib/contrast/utils/invalid_configuration_util.rb +32 -2
  358. data/lib/contrast/utils/io_util.rb +2 -2
  359. data/lib/contrast/utils/job_servers_running.rb +1 -1
  360. data/lib/contrast/utils/log_utils.rb +108 -0
  361. data/lib/contrast/utils/lru_cache.rb +1 -1
  362. data/lib/contrast/utils/metrics_hash.rb +2 -2
  363. data/lib/contrast/utils/middleware_utils.rb +87 -0
  364. data/lib/contrast/utils/net_http_base.rb +165 -0
  365. data/lib/contrast/utils/object_share.rb +2 -6
  366. data/lib/contrast/utils/os.rb +9 -5
  367. data/lib/contrast/utils/patching/policy/patch_utils.rb +63 -99
  368. data/lib/contrast/utils/patching/policy/patcher_utils.rb +1 -1
  369. data/lib/contrast/utils/preflight_util.rb +1 -1
  370. data/lib/contrast/utils/request_utils.rb +96 -0
  371. data/lib/contrast/utils/resource_loader.rb +1 -1
  372. data/lib/contrast/utils/response_utils.rb +97 -0
  373. data/lib/contrast/utils/sha256_builder.rb +1 -1
  374. data/lib/contrast/utils/stack_trace_utils.rb +1 -1
  375. data/lib/contrast/utils/string_utils.rb +69 -67
  376. data/lib/contrast/utils/tag_util.rb +11 -10
  377. data/lib/contrast/utils/telemetry.rb +5 -3
  378. data/lib/contrast/utils/telemetry_client.rb +90 -0
  379. data/lib/contrast/utils/telemetry_identifier.rb +18 -25
  380. data/lib/contrast/utils/thread_tracker.rb +1 -1
  381. data/lib/contrast/utils/timer.rb +1 -1
  382. data/lib/contrast-agent.rb +1 -1
  383. data/lib/contrast.rb +1 -1
  384. data/resources/assess/policy.json +10 -0
  385. data/ruby-agent.gemspec +9 -10
  386. metadata +111 -50
  387. data/ext/cs__assess_active_record_named/cs__active_record_named.c +0 -46
  388. data/ext/cs__assess_active_record_named/cs__active_record_named.h +0 -11
  389. data/ext/cs__assess_active_record_named/extconf.rb +0 -5
  390. data/lib/contrast/agent/assess/policy/rewriter_patch.rb +0 -95
  391. data/lib/contrast/agent/class_reopener.rb +0 -258
  392. data/lib/contrast/agent/rewriter.rb +0 -259
  393. data/lib/contrast/config/default_value.rb +0 -17
  394. data/lib/contrast/framework/rails/rewrite/action_controller_railties_helper_inherited.rb +0 -37
  395. data/lib/contrast/framework/rails/rewrite/active_record_attribute_methods_read.rb +0 -41
  396. data/lib/contrast/framework/rails/rewrite/active_record_named.rb +0 -75
  397. data/lib/contrast/framework/rails/rewrite/active_record_time_zone_inherited.rb +0 -35
  398. data/lib/contrast/utils/requests_client.rb +0 -150
  399. data/lib/contrast/utils/ruby_ast_rewriter.rb +0 -82
@@ -1,12 +1,15 @@
1
- # Copyright (c) 2021 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
+ require 'contrast/agent/reporting/reporting_events/application_update'
5
+ require 'contrast/agent/reporting/reporting_events/application_inventory'
4
6
  require 'contrast/components/logger'
5
7
  require 'contrast/extension/module'
8
+ require 'contrast/framework/grape/support'
9
+ require 'contrast/framework/manager_extend'
6
10
  require 'contrast/framework/platform_version'
7
11
  require 'contrast/framework/rack/support'
8
12
  require 'contrast/framework/rails/support'
9
- require 'contrast/framework/grape/support'
10
13
  require 'contrast/framework/sinatra/support'
11
14
  require 'contrast/utils/class_util'
12
15
 
@@ -15,6 +18,7 @@ module Contrast
15
18
  # Allows access to framework specific information
16
19
  class Manager
17
20
  include Contrast::Components::Logger::InstanceMethods
21
+ include Contrast::Framework::ManagerExtend
18
22
 
19
23
  # Order here does matter as the first framework listed will be the first one we pull information from Rack will
20
24
  # be a special case that may involve updating some logic to handle only applying Rack if Rails/Sinatra do not
@@ -65,6 +69,10 @@ module Contrast
65
69
  Contrast::Framework::PlatformVersion.from_string(framework_version)
66
70
  end
67
71
 
72
+ def platform_version_string
73
+ first_framework_result :version, ''
74
+ end
75
+
68
76
  def server_type
69
77
  first_framework_result :server_type, 'rack'
70
78
  end
@@ -116,7 +124,18 @@ module Contrast
116
124
  # @param request [Contrast::Agent::Request] the current request.
117
125
  # @return [Contrast::Api::Dtm::RouteCoverage] the current route as a Dtm.
118
126
  def get_route_dtm request
119
- @_frameworks.lazy.map { |framework_support| framework_support.current_route(request) }.reject(&:nil?).first
127
+ @_frameworks.lazy.map { |framework_support| framework_support.current_route(request) }.
128
+ reject(&:nil?).first
129
+ end
130
+
131
+ # Iterate through current frameworks and return the current request's route. This will be the first non-nil
132
+ # result.
133
+ #
134
+ # @param request [Contrast::Agent::Request] the current request.
135
+ # @return [Contrast::Agent::Reporting::RouteCoverage] the current route as a Dtm.
136
+ def get_route_information request
137
+ @_frameworks.lazy.map { |framework_support| framework_support.current_route_coverage(request) }.
138
+ reject(&:nil?).first
120
139
  end
121
140
 
122
141
  # Sometimes the framework we want to instrument is loaded after our agent code. To catch that case, we'll detect
@@ -124,7 +143,6 @@ module Contrast
124
143
  # have support enabled, we'll enable it now. We'll also need to catch up on any other startup actions that we've
125
144
  # missed. Most likely, this is only necessary for those applications which have applications mounted on them.
126
145
  #
127
- # TODO: RUBY-1354
128
146
  # TODO: RUBY-1356
129
147
  #
130
148
  # @param mod [Module] the module or class that was just loaded
@@ -139,8 +157,18 @@ module Contrast
139
157
 
140
158
  @_frameworks << framework
141
159
  # Report the registered routes of that framework now that we know we need to find them
160
+ # TODO: RUBY-1438 -- remove and build ReportingEvent directly
142
161
  app_update_msg = Contrast::Api::Dtm::ApplicationUpdate.build
143
- Contrast::Agent.messaging_queue.send_event_eventually(app_update_msg)
162
+ if Contrast::Agent.reporter
163
+ report = Contrast::Agent::Reporting::DtmMessage.dtm_to_event(app_update_msg)
164
+ Contrast::Agent.reporter.send_event(report)
165
+
166
+ # This is being reported separately because we extract the data from the same message
167
+ inventory_report = Contrast::Agent::Reporting::ApplicationInventory.convert(app_update_msg)
168
+ Contrast::Agent.reporter.send_event(inventory_report)
169
+ else
170
+ Contrast::Agent.messaging_queue.send_event_eventually(app_update_msg)
171
+ end
144
172
  logger.info('Framework detected after initialization. Enabling support.',
145
173
  framework: framework.detection_class,
146
174
  frameworks: @_frameworks)
@@ -149,37 +177,6 @@ module Contrast
149
177
  rescue StandardError => e
150
178
  logger.warn('Unable to register a late framework', e, module: mod.cs__name)
151
179
  end
152
-
153
- private
154
-
155
- def enable_framework_support? klass
156
- Contrast::Utils::ClassUtil.truly_defined?(klass)
157
- end
158
-
159
- def routes_for_all_frameworks
160
- data_for_all_frameworks :collect_routes
161
- end
162
-
163
- # This returns an array of all data from each framework in a flat, no-nil values array
164
- #
165
- # @param method_name [Symbol] the method to call on each FrameworkSupport class
166
- # @return [Array]
167
- def data_for_all_frameworks method_name
168
- @_frameworks.flat_map { |framework| framework.send(method_name) }.compact
169
- end
170
-
171
- # This returns a single object from the first framework to successfully respond
172
- #
173
- # @param method_name [Symbol] the method to call on each FrameworkSupport class
174
- # @return [Object] - Determined by method to be invoked
175
- def first_framework_result method_name, default_value
176
- result = nil
177
- @_frameworks.each do |framework|
178
- result = framework.send(method_name)
179
- break if result
180
- end
181
- result || default_value
182
- end
183
180
  end
184
181
  end
185
182
  end
@@ -0,0 +1,50 @@
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/extension/module'
6
+ require 'contrast/framework/platform_version'
7
+ require 'contrast/framework/rack/support'
8
+ require 'contrast/framework/rails/support'
9
+ require 'contrast/framework/grape/support'
10
+ require 'contrast/framework/sinatra/support'
11
+ require 'contrast/utils/class_util'
12
+
13
+ module Contrast
14
+ module Framework
15
+ # Allows access to framework specific information
16
+ module ManagerExtend
17
+ private
18
+
19
+ def enable_framework_support? klass
20
+ Contrast::Utils::ClassUtil.truly_defined?(klass)
21
+ end
22
+
23
+ def routes_for_all_frameworks
24
+ data_for_all_frameworks :collect_routes
25
+ end
26
+
27
+ # This returns an array of all data from each framework in a flat, no-nil values array
28
+ #
29
+ # @param method_name [Symbol] the method to call on each FrameworkSupport class
30
+ # @return [Array]
31
+ def data_for_all_frameworks method_name
32
+ @_frameworks.flat_map { |framework| framework.send(method_name) }.
33
+ compact
34
+ end
35
+
36
+ # This returns a single object from the first framework to successfully respond
37
+ #
38
+ # @param method_name [Symbol] the method to call on each FrameworkSupport class
39
+ # @return [Object] - Determined by method to be invoked
40
+ def first_framework_result method_name, default_value
41
+ result = nil
42
+ @_frameworks.each do |framework|
43
+ result = framework.send(method_name)
44
+ break if result
45
+ end
46
+ result || default_value
47
+ end
48
+ end
49
+ end
50
+ end
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  module Contrast
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/components/logger'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/agent/patching/policy/after_load_patch'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/framework/base_support'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  module Contrast
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/utils/invalid_configuration_util'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/framework/rails/patch/assess_configuration'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/framework/rails/patch/rails_application_configuration'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/utils/job_servers_running'
@@ -14,7 +14,7 @@ module Contrast
14
14
  initializer 'Contrast Ruby Agent Initializer' do |app|
15
15
  log_rails = defined?(Rails) && defined?(Rails.logger)
16
16
 
17
- Rails.logger.debug("In railtie ::#{ app.middleware.inspect }") if log_rails
17
+ Rails.logger.debug { "In railtie ::#{ app.middleware.inspect }" } if log_rails
18
18
 
19
19
  if ::Contrast::APP_CONTEXT.instrument_middleware_stack?
20
20
  ::Contrast::AGENT.insert_middleware(app)
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/api/dtm.pb'
@@ -10,7 +10,7 @@ module Contrast
10
10
  module Framework
11
11
  module Rails
12
12
  # Used when Rails is present to define framework specific behavior
13
- class Support
13
+ class Support # rubocop:disable Metrics/ClassLength
14
14
  extend Contrast::Framework::BaseSupport
15
15
  extend Contrast::Framework::Rails::Patch::Support
16
16
  include Contrast::Components::Logger::InstanceMethods
@@ -78,6 +78,38 @@ module Contrast
78
78
  nil
79
79
  end
80
80
 
81
+ # Find the current route, based on the provided Request wrapper
82
+ #
83
+ # @param request[Contrast::Agent::Request]
84
+ # @return [Contrast::Agent::Reporting::RouteCoverage, nil] a Dtm describing the route
85
+ # matched to the request if a match was found.
86
+ def current_route_coverage request
87
+ return unless ::Rails.cs__respond_to?(:application)
88
+
89
+ # ActionDispatch::Journey::Path::Pattern::MatchData, Hash, ActionDispatch::Journey::Route, Array<String>
90
+ match, _params, route, path = get_full_route(request.rack_request)
91
+ unless route
92
+ logger.warn('Unable to determine the current route of this request')
93
+ return
94
+ end
95
+
96
+ original_url = request.rack_request.path_info
97
+ mounted_app = route&.app&.app
98
+ # Route is either the final rails route, or a router that points to a Sinatra controller.
99
+ if mounted_app && Contrast::Framework::Sinatra::Support.sinatra_controller?(mounted_app)
100
+ return mounted_new_sinatra_route(request, match, path, route, original_url)
101
+ end
102
+ if mounted_app && Contrast::Framework::Grape::Support.grape_controller?(mounted_app)
103
+ return mounted_new_grape_route(request, match, path, route, original_url)
104
+ end
105
+
106
+ new_route_coverage = Contrast::Agent::Reporting::RouteCoverage.new
107
+ new_route_coverage.attach_rails_data route, original_url
108
+ rescue StandardError => e
109
+ logger.warn('Unable to determine the current route of this request', e)
110
+ nil
111
+ end
112
+
81
113
  # Copy a request for modification.
82
114
  #
83
115
  # @param env [::ActionDispatch::Request] original env.
@@ -155,6 +187,12 @@ module Contrast
155
187
  Contrast::Framework::Sinatra::Support.current_route(new_req, route.app.app, original_url)
156
188
  end
157
189
 
190
+ # @return [Contrast::Agent::Reporting::RouteCoverage, nil]
191
+ def mounted_new_sinatra_route request, match, path, route, original_url
192
+ new_req = unmounted_route(request, match, path)
193
+ Contrast::Framework::Sinatra::Support.current_route_coverage(new_req, route.app.app, original_url)
194
+ end
195
+
158
196
  # @param request[Contrast::Agent::Request]
159
197
  # @param match [ActionDispatch::Journey::Path::Pattern::MatchData]
160
198
  # @param path [Array<String>] the path of this request, built out from each nested
@@ -167,6 +205,12 @@ module Contrast
167
205
  Contrast::Framework::Grape::Support.current_route(new_req, route.app.app, original_url)
168
206
  end
169
207
 
208
+ # @return [Contrast::Agent::Reporting::RouteCoverage, nil]
209
+ def mounted_new_grape_route request, match, path, route, original_url
210
+ new_req = unmounted_route(request, match, path)
211
+ Contrast::Framework::Grape::Support.current_route_coverage(new_req, route.app.app, original_url)
212
+ end
213
+
170
214
  # Create a request copied from current request, but with the base path removed from path_info, as that's
171
215
  # the mount.
172
216
  #
@@ -1,7 +1,8 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/framework/base_support'
5
+ require 'contrast/agent/reporting/report'
5
6
 
6
7
  module Contrast
7
8
  module Framework
@@ -82,6 +83,27 @@ module Contrast
82
83
  Contrast::Api::Dtm::RouteCoverage.from_sinatra_route(final_controller, method, route_pattern, full_route)
83
84
  end
84
85
 
86
+ # Given the current request - return a RouteCoverage object
87
+
88
+ # @param request [Contrast::Agent::Request] a contrast tracked request.
89
+ # @param controller [::Sinatra::Base] optionally use this controller instead of global ::Sinatra::Base.
90
+ # @return [Contrast::Agent::Reporting::RouteCoverage, nil] a Dtm describing the route
91
+ # matched to the request if a match was found.
92
+ def current_route_coverage request, controller = ::Sinatra::Base, full_route = nil
93
+ return unless sinatra_controller?(controller)
94
+
95
+ method = request.env[::Rack::REQUEST_METHOD] # GET, PUT, POST, etc...
96
+
97
+ # Find route match--checking superclasses if necessary.
98
+ final_controller, route_pattern = _route_recurse(controller, method, _cleaned_route(request))
99
+ return unless final_controller
100
+
101
+ full_route ||= request.env[::Rack::PATH_INFO]
102
+
103
+ new_route_coverage = Contrast::Agent::Reporting::RouteCoverage.new
104
+ new_route_coverage.attach_rack_based_data final_controller, method, route_pattern, full_route
105
+ end
106
+
85
107
  # Search object space for sinatra controllers--any class that subclasses ::Sinatra::Base.
86
108
  #
87
109
  # @return [Array<::Sinatra::Base>] sinatra controlelrs
@@ -100,13 +122,14 @@ module Contrast
100
122
  #
101
123
  # @param controller [Sinatra::Base, #routes] a Sinatra application.
102
124
  # @param method [::Rack::REQUEST_METHOD] GET, POST, PUT, etc...
103
- # @param method [String] the relative route passed from Rack.
125
+ # @param route [String] the relative route passed from Rack.
104
126
  # @return [Array[Sinatra::Base, Mustermann::Sinatra], nil] Either the controller that
105
127
  # will handle the route along with the route pattern or nil if no match.
106
128
  def _route_recurse controller, method, route
107
129
  return if controller.nil? || controller.cs__class == NilClass
108
130
 
109
- route_patterns = controller.routes.fetch(method) { [] }.map(&:first)
131
+ route_patterns = controller.routes.fetch(method) { [] }.
132
+ map(&:first)
110
133
  route_pattern = route_patterns&.find do |matcher|
111
134
  matcher.params(route) # ::Mustermann::Sinatra match.
112
135
  end
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/components/logger'
@@ -17,26 +17,29 @@ module Funchook
17
17
 
18
18
  AGENT_ROOT = File.join(__dir__, '..', '..', '..')
19
19
 
20
- def self.resolve_path!
21
- actual_path_segments = SEARCH_DIRS.product(ACCEPTABLE_FILES).find do |potential_funchook_path|
22
- load_path = absolute_path(potential_funchook_path)
23
- File.exist?(load_path)
20
+ class << self
21
+ def resolve_path!
22
+ actual_path_segments = SEARCH_DIRS.product(ACCEPTABLE_FILES).find do |potential_funchook_path|
23
+ load_path = absolute_path(potential_funchook_path)
24
+ File.exist?(load_path)
25
+ end
26
+
27
+ if actual_path_segments.nil?
28
+ logger.warn('Unable to find funchook')
29
+ else
30
+ @path = absolute_path(actual_path_segments)
31
+ logger.info('Funchook found', path: @path)
32
+ end
33
+ @path
24
34
  end
25
35
 
26
- if actual_path_segments.nil?
27
- logger.warn('Unable to find funchook')
28
- else
29
- @path = absolute_path(actual_path_segments)
30
- logger.info('Funchook found', path: @path)
36
+ def absolute_path path_array
37
+ File.absolute_path(File.join(AGENT_ROOT, *path_array))
31
38
  end
32
- @path
33
- end
34
-
35
- def self.absolute_path path_array
36
- File.absolute_path(File.join(AGENT_ROOT, *path_array))
37
- end
38
39
 
39
- def self.available?
40
- @_available ||= !!resolve_path!
40
+ def available?
41
+ @_available = !!resolve_path! if @_available.nil?
42
+ @_available
43
+ end
41
44
  end
42
45
  end
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/utils/exclude_key'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'ougai'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'logger'
@@ -11,6 +11,7 @@ require 'contrast/logger/format'
11
11
  require 'contrast/logger/request'
12
12
  require 'contrast/logger/time'
13
13
  require 'contrast/components/config'
14
+ require 'contrast/utils/log_utils'
14
15
 
15
16
  module Contrast
16
17
  # This module allows us to dynamically weave timing into our code, so that only when the time is actually needed do
@@ -26,9 +27,9 @@ module Contrast
26
27
  # Add a method to the list of methods to be trace timed if logger set to TRACE. Enables trace timing after if
27
28
  # logger set to TRACE.
28
29
  #
29
- # @params: clazz [Class] the class of the method to time.
30
- # @params: method [Symbol] the method to time.
31
- # @params: method [String] optional custom logging message.
30
+ # @param: clazz [Class] the class of the method to time.
31
+ # @param: method [Symbol] the method to time.
32
+ # @param: method [String] optional custom logging message.
32
33
  def add_method_to_trace_timing clazz, method, msg = nil
33
34
  methods_to_time.append(METHOD_INFO.new(clazz, method, msg, false))
34
35
  enable_trace_timing if logger.level == ::Ougai::Logging::TRACE
@@ -37,9 +38,9 @@ module Contrast
37
38
  # Add a method to the list of methods to be trace timed if logger set to TRACE. Enables trace timing after if
38
39
  # logger set to TRACE.
39
40
  #
40
- # @params: method_spec [METHOD_INFO] specs about the method to be timed.
41
- # @params: class_method [Boolean] whether this is or isn't a class/module method.
42
- def trace_time_class_method meth_spec, class_method
41
+ # @param: meth_spec [METHOD_INFO] specs about the method to be timed.
42
+ # @param: class_method [Boolean] whether this is or isn't a class/module method.
43
+ def trace_time_class_method meth_spec, class_method # rubocop:disable Metrics/AbcSize
43
44
  untimed_func_symbol = "untimed_#{ meth_spec.method_name }".to_sym
44
45
  send_to = class_method ? meth_spec.clazz.cs__singleton_class : meth_spec.clazz
45
46
  meth_spec.clazz.class_eval do
@@ -105,12 +106,7 @@ module Contrast
105
106
  class Log
106
107
  include Singleton
107
108
  include ::Contrast::TraceTiming
108
-
109
- DEFAULT_NAME = 'contrast.log'
110
- DEFAULT_LEVEL = ::Ougai::Logging::Severity::INFO
111
- VALID_LEVELS = ::Ougai::Logging::Severity::SEV_LABEL
112
- STDOUT_STR = 'STDOUT'
113
- STDERR_STR = 'STDERR'
109
+ include Contrast::Utils::LogUtils
114
110
 
115
111
  attr_reader :previous_path, :previous_level
116
112
 
@@ -167,97 +163,6 @@ module Contrast
167
163
  dir_name = File.dirname(File.absolute_path(path))
168
164
  File.writable?(dir_name)
169
165
  end
170
-
171
- private
172
-
173
- def build path: STDOUT_STR, level_const: DEFAULT_LEVEL
174
- logger = case path
175
- when STDOUT_STR, STDERR_STR
176
- ::Ougai::Logger.new(Object.cs__const_get(path))
177
- else
178
- ::Ougai::Logger.new(path)
179
- end
180
- add_contrast_loggers(logger)
181
- logger.progname = 'Contrast Agent'
182
- logger.level = level_const
183
- logger.formatter = Contrast::Logger::Format.new
184
- logger.formatter.datetime_format = '%Y-%m-%dT%H:%M:%S.%L%z'
185
- logger
186
- end
187
-
188
- def add_contrast_loggers logger
189
- logger.extend(Contrast::Logger::Application)
190
- logger.extend(Contrast::Logger::Request)
191
- logger.extend(Contrast::Logger::Time)
192
- end
193
-
194
- # Determine the valid path to which to log, given the precedence of config > settings > default.
195
- #
196
- # @param log_file [String, nil] the file to which to log as provided by the settings retrieved from the
197
- # TeamServer.
198
- # @return [String] the path to which to log or STDOUT / STDERR if one of those values provided.
199
- def find_valid_path log_file
200
- config = ::Contrast::CONFIG.root.agent.logger
201
- config_path = config&.path&.length.to_i.positive? ? config.path : nil
202
- valid_path(config_path || log_file)
203
- end
204
-
205
- def valid_path path
206
- path = path.nil? ? Contrast::Utils::ObjectShare::EMPTY_STRING : path
207
- return path if path == STDOUT_STR
208
- return path if path == STDERR_STR
209
-
210
- path = DEFAULT_NAME if path.empty?
211
- if write_permission?(path)
212
- path
213
- elsif write_permission?(DEFAULT_NAME)
214
- # Log once when the path is invalid. We'll change to this path, so no
215
- # need to log again.
216
- if previous_path != DEFAULT_NAME
217
- puts "[!] Unable to write to '#{ path }'. Writing to default log '#{ DEFAULT_NAME }' instead."
218
- end
219
- DEFAULT_NAME
220
- else
221
- # Log once when the path is invalid. We'll change to this path, so no
222
- # need to log again.
223
- puts "[!] Unable to write to '#{ path }'. Writing to standard out instead." if previous_path != STDOUT_STR
224
- STDOUT_STR
225
- end
226
- end
227
-
228
- # Determine the valid level to which to log, given the precedence of config > settings > default.
229
- #
230
- # @param log_level [String, nil] the level at which to log as provided by the settings retrieved from the
231
- # TeamServer.
232
- # @return [::Ougai::Logging::Severity] the level at which to log
233
- def find_valid_level log_level
234
- config = ::Contrast::CONFIG.root.agent.logger
235
- config_level = config&.level&.length&.positive? ? config.level : nil
236
-
237
- valid_level(config_level || log_level)
238
- end
239
-
240
- def valid_level level
241
- level ||= DEFAULT_LEVEL
242
- level = level.upcase
243
- if VALID_LEVELS.include?(level)
244
- Object.cs__const_get("::Ougai::Logging::Severity::#{ level }")
245
- else
246
- DEFAULT_LEVEL
247
- end
248
- rescue StandardError
249
- DEFAULT_LEVEL
250
- end
251
-
252
- # Log that the Agent log has changed and include some default information at the start of the log.
253
- def log_update
254
- logger.debug('Initialized new contrast agent logger')
255
- logger.debug_with_time('middleware: log environment') do
256
- logger.application_environment
257
- logger.application_configuration
258
- logger.application_libraries
259
- end
260
- end
261
166
  end
262
167
  end
263
168
  end
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/utils/timer'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  module Contrast
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  module Contrast
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'yaml'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  require 'contrast/utils/os'
@@ -1,4 +1,4 @@
1
- # Copyright (c) 2021 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
4
  module Contrast