contrast-agent 4.13.0 → 5.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (390) hide show
  1. checksums.yaml +4 -4
  2. data/.simplecov +2 -1
  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 +1 -1
  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 +7 -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 +130 -0
  94. data/lib/contrast/agent/assess/rule/response/base_rule.rb +117 -0
  95. data/lib/contrast/agent/assess/tag.rb +1 -1
  96. data/lib/contrast/agent/assess/tracker.rb +1 -1
  97. data/lib/contrast/agent/assess.rb +1 -2
  98. data/lib/contrast/agent/at_exit_hook.rb +1 -1
  99. data/lib/contrast/agent/deadzone/policy/deadzone_node.rb +13 -8
  100. data/lib/contrast/agent/deadzone/policy/policy.rb +1 -1
  101. data/lib/contrast/agent/disable_reaction.rb +1 -1
  102. data/lib/contrast/agent/exclusion_matcher.rb +1 -1
  103. data/lib/contrast/agent/inventory/database_config.rb +115 -77
  104. data/lib/contrast/agent/inventory/dependencies.rb +1 -1
  105. data/lib/contrast/agent/inventory/dependency_analysis.rb +1 -1
  106. data/lib/contrast/agent/inventory/dependency_usage_analysis.rb +3 -3
  107. data/lib/contrast/agent/inventory/policy/datastores.rb +1 -1
  108. data/lib/contrast/agent/inventory/policy/policy.rb +1 -1
  109. data/lib/contrast/agent/inventory/policy/trigger_node.rb +1 -1
  110. data/lib/contrast/agent/inventory.rb +1 -1
  111. data/lib/contrast/agent/metric_telemetry_event.rb +3 -3
  112. data/lib/contrast/agent/middleware.rb +8 -77
  113. data/lib/contrast/agent/module_data.rb +1 -1
  114. data/lib/contrast/agent/patching/policy/after_load_patch.rb +1 -1
  115. data/lib/contrast/agent/patching/policy/after_load_patcher.rb +1 -1
  116. data/lib/contrast/agent/patching/policy/method_policy.rb +31 -104
  117. data/lib/contrast/agent/patching/policy/method_policy_extend.rb +113 -0
  118. data/lib/contrast/agent/patching/policy/module_policy.rb +1 -1
  119. data/lib/contrast/agent/patching/policy/patch.rb +1 -1
  120. data/lib/contrast/agent/patching/policy/patch_status.rb +2 -26
  121. data/lib/contrast/agent/patching/policy/patcher.rb +13 -13
  122. data/lib/contrast/agent/patching/policy/policy.rb +1 -1
  123. data/lib/contrast/agent/patching/policy/policy_node.rb +1 -1
  124. data/lib/contrast/agent/patching/policy/trigger_node.rb +1 -1
  125. data/lib/contrast/agent/protect/policy/applies_command_injection_rule.rb +1 -1
  126. data/lib/contrast/agent/protect/policy/applies_deserialization_rule.rb +1 -1
  127. data/lib/contrast/agent/protect/policy/applies_no_sqli_rule.rb +1 -1
  128. data/lib/contrast/agent/protect/policy/applies_path_traversal_rule.rb +1 -1
  129. data/lib/contrast/agent/protect/policy/applies_sqli_rule.rb +1 -1
  130. data/lib/contrast/agent/protect/policy/applies_xxe_rule.rb +1 -1
  131. data/lib/contrast/agent/protect/policy/policy.rb +1 -1
  132. data/lib/contrast/agent/protect/policy/rule_applicator.rb +1 -1
  133. data/lib/contrast/agent/protect/policy/trigger_node.rb +1 -1
  134. data/lib/contrast/agent/protect/rule/base.rb +1 -1
  135. data/lib/contrast/agent/protect/rule/base_service.rb +1 -1
  136. data/lib/contrast/agent/protect/rule/cmd_injection.rb +1 -1
  137. data/lib/contrast/agent/protect/rule/default_scanner.rb +1 -1
  138. data/lib/contrast/agent/protect/rule/deserialization.rb +1 -1
  139. data/lib/contrast/agent/protect/rule/http_method_tampering.rb +1 -1
  140. data/lib/contrast/agent/protect/rule/no_sqli/mongo_no_sql_scanner.rb +1 -1
  141. data/lib/contrast/agent/protect/rule/no_sqli.rb +1 -1
  142. data/lib/contrast/agent/protect/rule/path_traversal.rb +1 -1
  143. data/lib/contrast/agent/protect/rule/sql_sample_builder.rb +1 -1
  144. data/lib/contrast/agent/protect/rule/sqli/default_sql_scanner.rb +1 -1
  145. data/lib/contrast/agent/protect/rule/sqli/mysql_sql_scanner.rb +1 -1
  146. data/lib/contrast/agent/protect/rule/sqli/postgres_sql_scanner.rb +2 -2
  147. data/lib/contrast/agent/protect/rule/sqli/sqlite_sql_scanner.rb +1 -1
  148. data/lib/contrast/agent/protect/rule/sqli.rb +1 -1
  149. data/lib/contrast/agent/protect/rule/unsafe_file_upload.rb +1 -1
  150. data/lib/contrast/agent/protect/rule/xss.rb +1 -1
  151. data/lib/contrast/agent/protect/rule/xxe/entity_wrapper.rb +1 -1
  152. data/lib/contrast/agent/protect/rule/xxe.rb +1 -1
  153. data/lib/contrast/agent/protect/rule.rb +1 -1
  154. data/lib/contrast/agent/reaction_processor.rb +1 -1
  155. data/lib/contrast/agent/reporting/report.rb +27 -0
  156. data/lib/contrast/agent/reporting/reporter.rb +115 -0
  157. data/lib/contrast/agent/reporting/reporting_events/application_inventory.rb +49 -0
  158. data/lib/contrast/agent/reporting/reporting_events/application_update.rb +82 -0
  159. data/lib/contrast/agent/reporting/reporting_events/architecture_component.rb +80 -0
  160. data/lib/contrast/agent/reporting/reporting_events/discovered_route.rb +59 -0
  161. data/lib/contrast/agent/reporting/reporting_events/finding.rb +185 -0
  162. data/lib/contrast/agent/reporting/reporting_events/finding_event.rb +264 -0
  163. data/lib/contrast/agent/reporting/reporting_events/finding_event_source.rb +57 -0
  164. data/lib/contrast/agent/reporting/reporting_events/finding_object.rb +90 -0
  165. data/lib/contrast/agent/reporting/reporting_events/finding_request.rb +121 -0
  166. data/lib/contrast/agent/reporting/reporting_events/finding_signature.rb +105 -0
  167. data/lib/contrast/agent/reporting/reporting_events/finding_stack.rb +67 -0
  168. data/lib/contrast/agent/reporting/reporting_events/finding_taint_range.rb +58 -0
  169. data/lib/contrast/agent/reporting/reporting_events/library_discovery.rb +93 -0
  170. data/lib/contrast/agent/reporting/reporting_events/library_usage_observation.rb +50 -0
  171. data/lib/contrast/agent/reporting/reporting_events/observed_library_usage.rb +54 -0
  172. data/lib/contrast/agent/reporting/reporting_events/observed_route.rb +66 -0
  173. data/lib/contrast/agent/reporting/reporting_events/preflight.rb +39 -0
  174. data/lib/contrast/agent/reporting/reporting_events/preflight_message.rb +75 -0
  175. data/lib/contrast/agent/reporting/reporting_events/reporting_event.rb +47 -0
  176. data/lib/contrast/agent/reporting/reporting_events/route_coverage.rb +76 -0
  177. data/lib/contrast/agent/reporting/reporting_events/route_discovery.rb +66 -0
  178. data/lib/contrast/agent/reporting/reporting_events/route_discovery_observation.rb +65 -0
  179. data/lib/contrast/agent/reporting/reporting_events/server_activity.rb +52 -0
  180. data/lib/contrast/agent/reporting/reporting_events/trace_event_source.rb +30 -0
  181. data/lib/contrast/agent/reporting/reporting_utilities/audit.rb +137 -0
  182. data/lib/contrast/agent/reporting/reporting_utilities/dtm_message.rb +67 -0
  183. data/lib/contrast/agent/reporting/reporting_utilities/endpoints.rb +165 -0
  184. data/lib/contrast/agent/reporting/reporting_utilities/headers.rb +55 -0
  185. data/lib/contrast/agent/reporting/reporting_utilities/reporter_client.rb +86 -0
  186. data/lib/contrast/agent/reporting/reporting_utilities/reporter_client_utils.rb +154 -0
  187. data/lib/contrast/agent/reporting/reporting_utilities/reporting_storage.rb +66 -0
  188. data/lib/contrast/agent/reporting/reporting_utilities/response.rb +30 -0
  189. data/lib/contrast/agent/reporting/reporting_utilities/response_handler.rb +57 -0
  190. data/lib/contrast/agent/reporting/reporting_utilities/response_handler_utils.rb +196 -0
  191. data/lib/contrast/agent/reporting/settings/application_settings.rb +67 -0
  192. data/lib/contrast/agent/reporting/settings/assess.rb +45 -0
  193. data/lib/contrast/agent/reporting/settings/assess_server_feature.rb +136 -0
  194. data/lib/contrast/agent/reporting/settings/exclusions.rb +123 -0
  195. data/lib/contrast/agent/reporting/settings/protect.rb +89 -0
  196. data/lib/contrast/agent/reporting/settings/protect_server_feature.rb +243 -0
  197. data/lib/contrast/agent/reporting/settings/reaction.rb +30 -0
  198. data/lib/contrast/agent/reporting/settings/server_features.rb +78 -0
  199. data/lib/contrast/agent/request.rb +46 -84
  200. data/lib/contrast/agent/request_context.rb +20 -131
  201. data/lib/contrast/agent/request_context_extend.rb +163 -0
  202. data/lib/contrast/agent/request_handler.rb +41 -5
  203. data/lib/contrast/agent/response.rb +25 -88
  204. data/lib/contrast/agent/rule_set.rb +1 -1
  205. data/lib/contrast/agent/scope.rb +1 -1
  206. data/lib/contrast/agent/service_heartbeat.rb +1 -1
  207. data/lib/contrast/agent/startup_metrics_telemetry_event.rb +73 -23
  208. data/lib/contrast/agent/static_analysis.rb +14 -4
  209. data/lib/contrast/agent/telemetry.rb +16 -8
  210. data/lib/contrast/agent/telemetry_event.rb +9 -10
  211. data/lib/contrast/agent/thread.rb +1 -1
  212. data/lib/contrast/agent/thread_watcher.rb +32 -6
  213. data/lib/contrast/agent/tracepoint_hook.rb +1 -4
  214. data/lib/contrast/agent/version.rb +2 -2
  215. data/lib/contrast/agent/worker_thread.rb +1 -1
  216. data/lib/contrast/agent.rb +16 -1
  217. data/lib/contrast/api/communication/connection_status.rb +11 -8
  218. data/lib/contrast/api/communication/messaging_queue.rb +38 -4
  219. data/lib/contrast/api/communication/response_processor.rb +22 -11
  220. data/lib/contrast/api/communication/service_lifecycle.rb +14 -4
  221. data/lib/contrast/api/communication/socket.rb +7 -9
  222. data/lib/contrast/api/communication/socket_client.rb +33 -13
  223. data/lib/contrast/api/communication/speedracer.rb +38 -2
  224. data/lib/contrast/api/communication/tcp_socket.rb +5 -4
  225. data/lib/contrast/api/communication/unix_socket.rb +2 -1
  226. data/lib/contrast/api/communication.rb +1 -1
  227. data/lib/contrast/api/decorators/address.rb +1 -1
  228. data/lib/contrast/api/decorators/agent_startup.rb +1 -1
  229. data/lib/contrast/api/decorators/application_settings.rb +1 -1
  230. data/lib/contrast/api/decorators/application_startup.rb +1 -1
  231. data/lib/contrast/api/decorators/application_update.rb +1 -1
  232. data/lib/contrast/api/decorators/architecture_component.rb +36 -0
  233. data/lib/contrast/api/decorators/finding.rb +29 -0
  234. data/lib/contrast/api/decorators/http_request.rb +3 -2
  235. data/lib/contrast/api/decorators/input_analysis.rb +1 -1
  236. data/lib/contrast/api/decorators/instrumentation_mode.rb +1 -1
  237. data/lib/contrast/api/decorators/library.rb +1 -1
  238. data/lib/contrast/api/decorators/library_usage_update.rb +1 -1
  239. data/lib/contrast/api/decorators/message.rb +1 -1
  240. data/lib/contrast/api/decorators/rasp_rule_sample.rb +1 -1
  241. data/lib/contrast/api/decorators/route_coverage.rb +1 -1
  242. data/lib/contrast/api/decorators/server_features.rb +1 -1
  243. data/lib/contrast/api/decorators/trace_event.rb +1 -1
  244. data/lib/contrast/api/decorators/trace_event_object.rb +1 -1
  245. data/lib/contrast/api/decorators/trace_event_signature.rb +1 -1
  246. data/lib/contrast/api/decorators/trace_taint_range.rb +1 -1
  247. data/lib/contrast/api/decorators/trace_taint_range_tags.rb +1 -1
  248. data/lib/contrast/api/decorators/user_input.rb +1 -1
  249. data/lib/contrast/api/decorators.rb +2 -1
  250. data/lib/contrast/api.rb +1 -1
  251. data/lib/contrast/components/agent.rb +5 -24
  252. data/lib/contrast/components/api.rb +67 -2
  253. data/lib/contrast/components/app_context.rb +12 -66
  254. data/lib/contrast/components/app_context_extend.rb +78 -0
  255. data/lib/contrast/components/assess.rb +12 -8
  256. data/lib/contrast/components/base.rb +24 -1
  257. data/lib/contrast/components/config.rb +38 -23
  258. data/lib/contrast/components/contrast_service.rb +6 -1
  259. data/lib/contrast/components/heap_dump.rb +1 -1
  260. data/lib/contrast/components/inventory.rb +5 -1
  261. data/lib/contrast/components/logger.rb +1 -1
  262. data/lib/contrast/components/protect.rb +6 -2
  263. data/lib/contrast/components/sampling.rb +3 -3
  264. data/lib/contrast/components/scope.rb +1 -1
  265. data/lib/contrast/components/settings.rb +25 -12
  266. data/lib/contrast/config/agent_configuration.rb +2 -2
  267. data/lib/contrast/config/api_configuration.rb +9 -4
  268. data/lib/contrast/config/api_proxy_configuration.rb +14 -0
  269. data/lib/contrast/config/application_configuration.rb +3 -4
  270. data/lib/contrast/config/assess_configuration.rb +4 -4
  271. data/lib/contrast/config/assess_rules_configuration.rb +1 -1
  272. data/lib/contrast/config/base_configuration.rb +18 -29
  273. data/lib/contrast/config/certification_configuration.rb +15 -0
  274. data/lib/contrast/config/env_variables.rb +3 -10
  275. data/lib/contrast/config/exception_configuration.rb +1 -1
  276. data/lib/contrast/config/heap_dump_configuration.rb +7 -7
  277. data/lib/contrast/config/inventory_configuration.rb +2 -6
  278. data/lib/contrast/config/logger_configuration.rb +1 -1
  279. data/lib/contrast/config/protect_configuration.rb +1 -1
  280. data/lib/contrast/config/protect_rule_configuration.rb +2 -2
  281. data/lib/contrast/config/protect_rules_configuration.rb +1 -1
  282. data/lib/contrast/config/request_audit_configuration.rb +18 -0
  283. data/lib/contrast/config/root_configuration.rb +1 -1
  284. data/lib/contrast/config/ruby_configuration.rb +10 -7
  285. data/lib/contrast/config/sampling_configuration.rb +1 -1
  286. data/lib/contrast/config/server_configuration.rb +1 -1
  287. data/lib/contrast/config/service_configuration.rb +2 -3
  288. data/lib/contrast/config.rb +1 -2
  289. data/lib/contrast/configuration.rb +2 -3
  290. data/lib/contrast/extension/assess/array.rb +9 -9
  291. data/lib/contrast/extension/assess/erb.rb +15 -5
  292. data/lib/contrast/extension/assess/eval_trigger.rb +3 -1
  293. data/lib/contrast/extension/assess/exec_trigger.rb +2 -1
  294. data/lib/contrast/extension/assess/fiber.rb +6 -3
  295. data/lib/contrast/extension/assess/hash.rb +1 -1
  296. data/lib/contrast/extension/assess/kernel.rb +8 -3
  297. data/lib/contrast/extension/assess/marshal.rb +6 -2
  298. data/lib/contrast/extension/assess/regexp.rb +8 -2
  299. data/lib/contrast/extension/assess/string.rb +8 -2
  300. data/lib/contrast/extension/assess.rb +1 -1
  301. data/lib/contrast/extension/delegator.rb +1 -1
  302. data/lib/contrast/extension/extension.rb +2 -4
  303. data/lib/contrast/extension/inventory.rb +1 -1
  304. data/lib/contrast/extension/kernel.rb +1 -1
  305. data/lib/contrast/extension/module.rb +1 -1
  306. data/lib/contrast/extension/protect/psych.rb +1 -1
  307. data/lib/contrast/extension/protect.rb +1 -1
  308. data/lib/contrast/extension/thread.rb +32 -13
  309. data/lib/contrast/framework/base_support.rb +5 -1
  310. data/lib/contrast/framework/grape/support.rb +25 -1
  311. data/lib/contrast/framework/manager.rb +33 -36
  312. data/lib/contrast/framework/manager_extend.rb +50 -0
  313. data/lib/contrast/framework/platform_version.rb +1 -1
  314. data/lib/contrast/framework/rack/patch/session_cookie.rb +1 -1
  315. data/lib/contrast/framework/rack/patch/support.rb +1 -1
  316. data/lib/contrast/framework/rack/support.rb +1 -1
  317. data/lib/contrast/framework/rails/patch/action_controller_live_buffer.rb +1 -1
  318. data/lib/contrast/framework/rails/patch/assess_configuration.rb +1 -1
  319. data/lib/contrast/framework/rails/patch/rails_application_configuration.rb +1 -1
  320. data/lib/contrast/framework/rails/patch/support.rb +1 -1
  321. data/lib/contrast/framework/rails/railtie.rb +2 -2
  322. data/lib/contrast/framework/rails/support.rb +46 -2
  323. data/lib/contrast/framework/sinatra/support.rb +26 -3
  324. data/lib/contrast/funchook/funchook.rb +21 -18
  325. data/lib/contrast/logger/application.rb +1 -1
  326. data/lib/contrast/logger/format.rb +1 -1
  327. data/lib/contrast/logger/log.rb +9 -104
  328. data/lib/contrast/logger/request.rb +1 -1
  329. data/lib/contrast/logger/time.rb +1 -1
  330. data/lib/contrast/security_exception.rb +1 -1
  331. data/lib/contrast/tasks/config.rb +1 -1
  332. data/lib/contrast/tasks/service.rb +1 -1
  333. data/lib/contrast/utils/assess/propagation_method_utils.rb +1 -1
  334. data/lib/contrast/utils/assess/property/tagged_utils.rb +24 -1
  335. data/lib/contrast/utils/assess/sampling_util.rb +4 -4
  336. data/lib/contrast/utils/assess/source_method_utils.rb +1 -1
  337. data/lib/contrast/utils/assess/split_utils.rb +23 -0
  338. data/lib/contrast/utils/assess/tracking_util.rb +21 -16
  339. data/lib/contrast/utils/assess/trigger_method_utils.rb +4 -3
  340. data/lib/contrast/utils/class_util.rb +19 -15
  341. data/lib/contrast/utils/duck_utils.rb +1 -1
  342. data/lib/contrast/utils/env_configuration_item.rb +2 -2
  343. data/lib/contrast/utils/exclude_key.rb +1 -1
  344. data/lib/contrast/utils/findings.rb +65 -0
  345. data/lib/contrast/utils/hash_digest.rb +46 -79
  346. data/lib/contrast/utils/hash_digest_extend.rb +129 -0
  347. data/lib/contrast/utils/head_dump_utils_extend.rb +74 -0
  348. data/lib/contrast/utils/heap_dump_util.rb +3 -66
  349. data/lib/contrast/utils/invalid_configuration_util.rb +32 -2
  350. data/lib/contrast/utils/io_util.rb +2 -2
  351. data/lib/contrast/utils/job_servers_running.rb +1 -1
  352. data/lib/contrast/utils/log_utils.rb +108 -0
  353. data/lib/contrast/utils/lru_cache.rb +1 -1
  354. data/lib/contrast/utils/metrics_hash.rb +2 -2
  355. data/lib/contrast/utils/middleware_utils.rb +87 -0
  356. data/lib/contrast/utils/net_http_base.rb +165 -0
  357. data/lib/contrast/utils/object_share.rb +2 -6
  358. data/lib/contrast/utils/os.rb +9 -5
  359. data/lib/contrast/utils/patching/policy/patch_utils.rb +63 -99
  360. data/lib/contrast/utils/patching/policy/patcher_utils.rb +1 -1
  361. data/lib/contrast/utils/preflight_util.rb +1 -1
  362. data/lib/contrast/utils/request_utils.rb +96 -0
  363. data/lib/contrast/utils/resource_loader.rb +1 -1
  364. data/lib/contrast/utils/response_utils.rb +97 -0
  365. data/lib/contrast/utils/sha256_builder.rb +1 -1
  366. data/lib/contrast/utils/stack_trace_utils.rb +1 -1
  367. data/lib/contrast/utils/string_utils.rb +69 -67
  368. data/lib/contrast/utils/tag_util.rb +11 -10
  369. data/lib/contrast/utils/telemetry.rb +11 -10
  370. data/lib/contrast/utils/telemetry_client.rb +90 -0
  371. data/lib/contrast/utils/telemetry_identifier.rb +18 -25
  372. data/lib/contrast/utils/thread_tracker.rb +1 -1
  373. data/lib/contrast/utils/timer.rb +1 -1
  374. data/lib/contrast-agent.rb +1 -1
  375. data/lib/contrast.rb +1 -1
  376. data/ruby-agent.gemspec +9 -10
  377. metadata +102 -49
  378. data/ext/cs__assess_active_record_named/cs__active_record_named.c +0 -46
  379. data/ext/cs__assess_active_record_named/cs__active_record_named.h +0 -11
  380. data/ext/cs__assess_active_record_named/extconf.rb +0 -5
  381. data/lib/contrast/agent/assess/policy/rewriter_patch.rb +0 -95
  382. data/lib/contrast/agent/class_reopener.rb +0 -258
  383. data/lib/contrast/agent/rewriter.rb +0 -259
  384. data/lib/contrast/config/default_value.rb +0 -17
  385. data/lib/contrast/framework/rails/rewrite/action_controller_railties_helper_inherited.rb +0 -37
  386. data/lib/contrast/framework/rails/rewrite/active_record_attribute_methods_read.rb +0 -41
  387. data/lib/contrast/framework/rails/rewrite/active_record_named.rb +0 -75
  388. data/lib/contrast/framework/rails/rewrite/active_record_time_zone_inherited.rb +0 -35
  389. data/lib/contrast/utils/requests_client.rb +0 -150
  390. data/lib/contrast/utils/ruby_ast_rewriter.rb +0 -82
@@ -0,0 +1,121 @@
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
+ module Contrast
5
+ module Agent
6
+ module Reporting
7
+ # This is the new Finding class which will include all the needed information for the new reporting system to
8
+ # relay this information in the Finding/Trace messages. These findings are used by TeamServer to construct the
9
+ # vulnerability information for the assess feature. They represent those parts of the application, either through
10
+ # configuration, method invocation, or dataflow, which are determined to be insecure.
11
+ #
12
+ # @attr_accessor events [Array<Contrast::Agent::Assess::ContrastEvent>] if a dataflow based finding, the
13
+ # representation of those method calls which constitute a dangerous code path.
14
+ # @attr_accessor properties [Hash<String,String>] a set of values that TeamServer can use to provide more context
15
+ # to the user when rendering the finding. For some findings, a specific set of keys and values are required.
16
+ # @attr_accessor request [Contrast::Agent::Request, nil] the request, if any, in which this finding occurred
17
+ # @attr_accessor hash_code [String] the unique identifier of this finding.
18
+ # @attr_reader rule_id [String] the name of the rule violated; must match those in TeamServer.
19
+ class FindingRequest
20
+ attr_reader :body, :headers, :method, :parameters, :port, :protocol, :query_string, :uri, :version
21
+
22
+ class << self
23
+ # @param request [Contrast::Api::Dtm::HttpRequest,Contrast::Agent::Request]
24
+ # @return [Contrast::Agent::Reporting::FindingRequest]
25
+ def convert request
26
+ report = new
27
+ if request.cs__is_a?(Contrast::Agent::Request)
28
+ report.attach_data(request)
29
+ else
30
+ report.attach_dtm_data(request)
31
+ end
32
+ report
33
+ end
34
+ end
35
+
36
+ # Parse the data from a Contrast::Agent::Request to attach what is required for reporting to TeamServer to this
37
+ # Contrast::Agent::Reporting::FindingRequest
38
+ #
39
+ # @param request [Contrast::Agent::Request]
40
+ def attach_data request
41
+ @body = request.body
42
+ @headers = {}
43
+ request.headers.each_pair do |key, value|
44
+ next unless key && value
45
+
46
+ # We need to change from the uppercase _ format to capitalized - format.
47
+ header = key.split('_')
48
+ header.each(&:capitalize!)
49
+ header = header.join('-')
50
+ headers[header] = value.split
51
+ end
52
+ @method = request.request_method
53
+ @parameters = {}
54
+ request.parameters.each_pair do |key, value|
55
+ @parameters[key] = value
56
+ end
57
+ @port = request.port || 0
58
+ @protocol = request.scheme
59
+ @query_string = request.query_string
60
+ @uri = request.normalized_uri
61
+ @version = request.version
62
+ end
63
+
64
+ # Parse the data from a Contrast::Api::Dtm::HttpRequest to attach what is required for reporting to TeamServer
65
+ # to this Contrast::Agent::Reporting::FindingRequest
66
+ #
67
+ # @param request_dtm [Contrast::Api::Dtm::HttpRequest]
68
+ def attach_dtm_data request_dtm
69
+ @body = request_dtm.request_body_binary
70
+ @headers = {}
71
+ request_dtm.request_headers.each_pair do |key, value|
72
+ next unless key && value
73
+
74
+ # We need to change from the uppercase _ format to capitalized - format.
75
+ header = key.split('_')
76
+ header.each(&:capitalize!)
77
+ header = header.join('-')
78
+ headers[header] = value.split
79
+ end
80
+ @method = request_dtm.method # rubocop:disable Security/Object/Method
81
+ @parameters = {}
82
+ request_dtm.normalized_request_params.each_value do |pair|
83
+ @parameters[pair.key] = pair.values
84
+ end
85
+ @port = nil
86
+ @protocol = request_dtm.protocol
87
+ @query_string = request_dtm.query_string
88
+ @uri = request_dtm.uri
89
+ @version = request_dtm.version
90
+ end
91
+
92
+ # Convert the instance variables on the class, and other information, into the identifiers required for
93
+ # TeamServer to process the JSON form of this message.
94
+ #
95
+ # @return [Hash]
96
+ # @raise [ArgumentError]
97
+ def to_controlled_hash
98
+ validate
99
+ {
100
+ body: body,
101
+ headers: headers,
102
+ method: method, # rubocop:disable Security/Object/Method
103
+ parameters: parameters,
104
+ port: port || 0,
105
+ protocol: protocol,
106
+ queryString: query_string,
107
+ uri: uri,
108
+ version: version
109
+ }
110
+ end
111
+
112
+ def validate
113
+ unless cs__method && !cs__method.empty?
114
+ raise(ArgumentError, "#{ self } did not have a proper method. Unable to continue.")
115
+ end
116
+ raise(ArgumentError, "#{ self } did not have a proper uri. Unable to continue.") unless uri && !uri.empty?
117
+ end
118
+ end
119
+ end
120
+ end
121
+ end
@@ -0,0 +1,105 @@
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/utils/object_share'
5
+
6
+ module Contrast
7
+ module Agent
8
+ module Reporting
9
+ # This is the new FindingSignature class which will include all the needed information for the new reporting
10
+ # system to relay this information in the Finding/Trace messages. These FindingObjects are used by TeamServer to
11
+ # construct the vulnerability information for the assess feature. They represent the signature of the method that
12
+ # was invoked in this event.
13
+ #
14
+ # @attr_reader arg_types [String] the types of the arguments in this event; may be different for each invocation
15
+ # of the method.
16
+ # @attr_reader class_name [String] the name of the class of this object or the name itself if of Module type.
17
+ # @attr_reader constructor [Boolean] if the method is a constructor or not.
18
+ # @attr_reader expression_type [String] unused.
19
+ # @attr_reader flags [Integer] the Java flags.
20
+ # @attr_reader method_name [String] the name of the method.
21
+ # @attr_reader operator [String] unused.
22
+ # @attr_reader return_type [String] the type of the return in this event; may be different for each invocation of
23
+ # the method.
24
+ # @attr_reader signature [String] the id of the Object this represents.
25
+ # @attr_reader void_method [Boolean] if the method is void or not; may be different for each invocation of the
26
+ # method.
27
+ class FindingSignature
28
+ attr_reader :arg_types, :class_name, :constructor, :expression_type, :flags, :method_name, :operator,
29
+ :return_type, :signature, :void_method
30
+
31
+ class << self
32
+ # @param event [Contrast::Agent::Assess::ContrastEvent] the event to build a signature for
33
+ # @return [Contrast::Agent::Reporting::FindingSignature]
34
+ def convert event
35
+ report = new
36
+ report.attach_data(event)
37
+ report
38
+ end
39
+ end
40
+
41
+ # Parse the data from a Contrast::Agent::Assess::ContrastEvent to attach what is required for reporting to
42
+ # TeamServer to this Contrast::Agent::Reporting::FindingSignature
43
+ #
44
+ # @param event [Contrast::Agent::Assess::ContrastEvent]
45
+ def attach_data event
46
+ node = event.policy_node
47
+ @arg_types = []
48
+ event.args&.each do |arg|
49
+ arg_types << type_name(arg)
50
+ end
51
+ @class_name = node.class_name
52
+ @constructor = node.method_name == :new || node.method_name == :initialize
53
+ # 8 is STATIC in Java... we have to placate them for now it has been requested that flags be removed since it
54
+ # isn't used
55
+ @flags = 8 unless policy_node.instance_method?
56
+ @method_name = node.method_name
57
+ @return_type = type_name(event.ret)
58
+ # if there's a ret, then this method isn't nil. not 100% full proof since you can return nil, but this is the
59
+ # best we've got currently.
60
+ @void_method = event.ret.nil? ||
61
+ event.ret.object.nil? ||
62
+ event.ret.object == Contrast::Utils::ObjectShare::NIL_STRING
63
+ end
64
+
65
+ # Convert the instance variables on the class, and other information, into the identifiers required for
66
+ # TeamServer to process the JSON form of this message.
67
+ #
68
+ # @return [Hash]
69
+ # @raise [ArgumentError]
70
+ def to_controlled_hash
71
+ validate
72
+ {
73
+ argTypes: arg_types,
74
+ className: class_name,
75
+ constructor: constructor,
76
+ # expressionType: expression_type, # This is unused by the Ruby agent
77
+ flags: flags.to_i,
78
+ methodName: method_name,
79
+ # operator: operator, # This is unused by the Ruby agent
80
+ returnType: return_type,
81
+ # signature: signature, # This is unused by the Ruby agent
82
+ voidMethod: void_method
83
+ }
84
+ end
85
+
86
+ def validate
87
+ raise(ArgumentError, "#{ self } did not have a proper argTypes. Unable to continue.") unless arg_types
88
+ raise(ArgumentError, "#{ self } did not have a proper constructor. Unable to continue.") if constructor.nil?
89
+ end
90
+
91
+ private
92
+
93
+ # While Ruby signatures do not require neither a return type and can return anything depending on inputs, code
94
+ # paths, etc, nor constant parameter types, TeamServer was designed with strongly typed languages (Java) in
95
+ # mind, so we need types in our signatures.
96
+ #
97
+ # @param contrast_object [Contrast::Agent::Assess::ContrastObject, nil] the object to find the type of
98
+ # @return [String] the name of the module of the ret_obj, or `nil`
99
+ def type_name contrast_object
100
+ contrast_object ? contrast_object.object_type : Contrast::Utils::ObjectShare::NIL_STRING
101
+ end
102
+ end
103
+ end
104
+ end
105
+ end
@@ -0,0 +1,67 @@
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
+ module Contrast
5
+ module Agent
6
+ module Reporting
7
+ # This is the new FindingStack class which will include all the needed information for the new reporting system
8
+ # to relay this information in the Finding/Trace messages. These FindingStack are used by TeamServer to construct
9
+ # the vulnerability information for the assess feature. They represent the callstack at the time that each
10
+ # FindingEvent was generated.
11
+ #
12
+ # @attr_reader eval [String] unused
13
+ # @attr_reader file [String] the stack frame to show in TeamServer; the value of an entry in #caller
14
+ # @attr_reader line_number [String] unused
15
+ # @attr_reader method [String] unused
16
+ # @attr_reader signature [String] unused
17
+ # @attr_reader type [String] unused
18
+ class FindingStack
19
+ attr_reader :eval, :file, :line_number, :method, :signature, :type
20
+
21
+ AGENT_CLASS_MARKER = '/lib/contrast/'
22
+
23
+ class << self
24
+ # @param stack [Array<String>]
25
+ # @return [Contrast::Agent::Reporting::FindingStack,nil]
26
+ def convert stack
27
+ return unless stack
28
+ return if stack.include?(AGENT_CLASS_MARKER)
29
+
30
+ report = new
31
+ report.attach_data(stack)
32
+ report
33
+ end
34
+ end
35
+
36
+ # Parse the data from a Contrast::Agent::Assess::Tag to attach what is required for reporting to TeamServer to
37
+ # this Contrast::Agent::Reporting::FindingTaintRange
38
+ #
39
+ # @param stack [Array<String>]
40
+ def attach_data stack
41
+ @file = stack
42
+ end
43
+
44
+ # Convert the instance variables on the class, and other information, into the identifiers required for
45
+ # TeamServer to process the JSON form of this message.
46
+ #
47
+ # @return [Hash]
48
+ # @raise [ArgumentError]
49
+ def to_controlled_hash
50
+ validate
51
+ {
52
+ # eval: eval,
53
+ file: file # ,
54
+ # line_number: line_number, # This is unused by the Ruby agent
55
+ # method: method, # This is unused by the Ruby agent
56
+ # signature: signature, # This is unused by the Ruby agent
57
+ # type: type # This is unused by the Ruby agent
58
+ }
59
+ end
60
+
61
+ def validate
62
+ raise(ArgumentError, "#{ self } did not have a proper hash. Unable to continue.") unless file && !file.empty?
63
+ end
64
+ end
65
+ end
66
+ end
67
+ end
@@ -0,0 +1,58 @@
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
+ module Contrast
5
+ module Agent
6
+ module Reporting
7
+ # This is the new FindingObject class which will include all the needed information for the new reporting system
8
+ # to relay this information in the Finding/Trace messages. These FindingTaintRanges are used by TeamServer to
9
+ # construct the vulnerability information for the assess feature. They represent those parts of the objects that
10
+ # are tracked because of a security relevant operation acting on them.
11
+ #
12
+ # @attr_reader range [String] the range (inclusive:exclusive), that this tag covers.
13
+ # @attr_reader tag [String] the type of action this tag represents.
14
+ class FindingTaintRange
15
+ attr_reader :range, :tag
16
+
17
+ class << self
18
+ # @param tag [Contrast::Agent::Assess::Tag] the tag to convert
19
+ # @return [Contrast::Agent::Reporting::FindingTaintRange]
20
+ def convert tag
21
+ report = new
22
+ report.attach_data(tag)
23
+ report
24
+ end
25
+ end
26
+
27
+ # Parse the data from a Contrast::Agent::Assess::Tag to attach what is required for reporting to TeamServer to
28
+ # this Contrast::Agent::Reporting::FindingTaintRange
29
+ #
30
+ # @param tag [Contrast::Agent::Assess::Tag] the tag to convert
31
+ def attach_data tag
32
+ @range = "#{ tag.start_idx }:#{ tag.end_idx }"
33
+ @tag = tag.label
34
+ end
35
+
36
+ # Convert the instance variables on the class, and other information, into the identifiers required for
37
+ # TeamServer to process the JSON form of this message.
38
+ #
39
+ # @return [Hash]
40
+ # @raise [ArgumentError]
41
+ def to_controlled_hash
42
+ validate
43
+ {
44
+ range: range,
45
+ tag: tag
46
+ }
47
+ end
48
+
49
+ def validate
50
+ raise(ArgumentError, "#{ self } did not have a proper hash. Unable to continue.") unless hash && !hash.empty?
51
+ return unless value && !value.empty?
52
+
53
+ raise(ArgumentError, "#{ self } did not have a proper value. Unable to continue.")
54
+ end
55
+ end
56
+ end
57
+ end
58
+ end
@@ -0,0 +1,93 @@
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/api/dtm.pb'
5
+
6
+ module Contrast
7
+ module Agent
8
+ module Reporting
9
+ # This is the new Library Discovery class which will include all the needed information for the new
10
+ # reporting system to relay this information in the Application Update messages. These libraries are used by
11
+ # TeamServer to construct the dependency information for the SCA feature. They represent those gems that are
12
+ # included in the GemSpec, not necessarily those that have had files in them required.
13
+ #
14
+ # @attr_reader class_count [Integer] the number of files in the Gem which contain code.
15
+ # @attr_reader external_date [Integer] the time, in ms, when the Gem was published. Required for reporting.
16
+ # @attr_reader file [String] the name of the Gem. Required for reporting.
17
+ # @attr_reader hash [String] the Sha256 of the Gem, matching its hash in RubyGems. Required for reporting.
18
+ # @attr_reader internal_date [Integer] the time, in ms, when the Gem was published. Required for reporting.
19
+ # @attr_reader manifest [String] the YAML form of the Gem's specification.
20
+ # @attr_reader tags [String] Inventory tags set by the user via configuration.
21
+ # @attr_reader url [String] The homepage of the Gem.
22
+ # @attr_reader version [String] The version of the Gem.
23
+ class LibraryDiscovery
24
+ # required attributes
25
+ attr_reader :external_date, :file, :hash, :internal_date
26
+ # optional attributes
27
+ attr_reader :class_count, :manifest, :tags, :url, :version
28
+
29
+ class << self
30
+ # Convert a DTM for SpeedRacer to an Event for TeamServer.
31
+ #
32
+ # @param library_dtm [Contrast::Api::Dtm::Library]
33
+ # @return [Contrast::Agent::Reporting::LibraryDiscovery]
34
+ def convert library_dtm
35
+ report = new
36
+ report.attach_data(library_dtm)
37
+ report
38
+ end
39
+ end
40
+
41
+ # Attach the data from the protobuf models to this reporter so that it can be sent to TeamServer directly
42
+ #
43
+ # @param library_dtm [Contrast::Api::Dtm::Library]
44
+ def attach_data library_dtm
45
+ @class_count = library_dtm.class_count
46
+ @external_date = library_dtm.external_ms
47
+ @file = library_dtm.file_path
48
+ @hash = library_dtm.hash_code
49
+ @internal_date = library_dtm.internal_ms
50
+ @manifest = library_dtm.manifest
51
+ @tags = Contrast::INVENTORY.tags
52
+ @url = library_dtm.url
53
+ @version = library_dtm.version
54
+ end
55
+
56
+ # Convert the instance variables on the class, and other information, into the identifiers required for
57
+ # TeamServer to process the JSON form of this message.
58
+ #
59
+ # @return [Hash]
60
+ # @raise [ArgumentError]
61
+ def to_controlled_hash
62
+ validate
63
+ msg = {
64
+ classCount: class_count,
65
+ externalDate: external_date,
66
+ file: file,
67
+ hash: hash,
68
+ internalDate: internal_date,
69
+ manifest: manifest,
70
+ url: url,
71
+ version: version
72
+ }
73
+ msg[:tags] = tags if tags
74
+ msg
75
+ end
76
+
77
+ # Ensure the required fields are present.
78
+ #
79
+ # @raise [ArgumentError]
80
+ def validate
81
+ unless external_date
82
+ raise(ArgumentError, "#{ self } did not have a proper external date. Unable to continue.")
83
+ end
84
+ unless internal_date
85
+ raise(ArgumentError, "#{ self } did not have a proper internal date. Unable to continue.")
86
+ end
87
+ raise(ArgumentError, "#{ self } did not have a proper file. Unable to continue.") unless file
88
+ raise(ArgumentError, "#{ self } did not have a proper hash. Unable to continue.") unless hash
89
+ end
90
+ end
91
+ end
92
+ end
93
+ 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
+ module Contrast
5
+ module Agent
6
+ module Reporting
7
+ #
8
+ # @attr_accessor id - [String] - Hash of library as identified by the agent
9
+ # @attr_accessor names Array[String] - List of file paths that have been loaded out of or executed by the library
10
+ #
11
+ class LibraryUsageObservation
12
+ attr_accessor :id, :names
13
+
14
+ class << self
15
+ # Convert a DTM for SpeedRacer to an Event for TeamServer.
16
+ #
17
+ # @param usage_dtm [Contrast::Api::Dtm::LibraryUsageUpdate]
18
+ # @return [Contrast::Agent::Reporting::LibraryUsageObservation]
19
+ def convert usage_dtm
20
+ observation = new
21
+ observation.attach_data(usage_dtm)
22
+ observation
23
+ end
24
+ end
25
+
26
+ def initialize
27
+ @names = []
28
+ end
29
+
30
+ def attach_data usage_dtm
31
+ @id = usage_dtm.hash_code
32
+ @names = usage_dtm.class_names.keys
33
+ end
34
+
35
+ def to_controlled_hash
36
+ validate
37
+ {
38
+ id: @id,
39
+ names: @names
40
+ }
41
+ end
42
+
43
+ def validate
44
+ raise(ArgumentError, "#{ self } did not have a proper id. Unable to continue.") unless id
45
+ raise(ArgumentError, "#{ self } did not have a proper names. Unable to continue.") if names.empty?
46
+ end
47
+ end
48
+ end
49
+ end
50
+ end
@@ -0,0 +1,54 @@
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/reporting/reporting_events/reporting_event'
5
+ require 'contrast/agent/reporting/reporting_events/library_usage_observation'
6
+
7
+ module Contrast
8
+ module Agent
9
+ module Reporting
10
+ # List of libraries that have been observed to have something loaded or executed.
11
+ #
12
+ # @attr_reader observations - Array[Contrast::Agent::Reporting::LibraryUsageObservation]
13
+ # - Hash of LibraryUsageObservations
14
+ class ObservedLibraryUsage < Contrast::Agent::Reporting::ReportingEvent
15
+ attr_reader :observations
16
+
17
+ class << self
18
+ # Convert a Hash of LibraryUsageUpdate DTMs for SpeedRacer to an Event for TeamServer.
19
+ #
20
+ # @param usages_dtm_hash Hash[Contrast::Api::Dtm::LibraryUsageUpdate]
21
+ # @return [Contrast::Agent::Reporting::ObservedLibraryUsage]
22
+ def convert usages_dtm_hash
23
+ report = new
24
+ report.attach_data(usages_dtm_hash)
25
+ report
26
+ end
27
+ end
28
+
29
+ def initialize
30
+ @event_endpoint = Contrast::Agent::Reporting::Endpoints.library_usage
31
+ @observations = []
32
+ super
33
+ end
34
+
35
+ def to_controlled_hash
36
+ validate
37
+ { observations: @observations.map(&:to_controlled_hash) }
38
+ end
39
+
40
+ def attach_data usages_dtm_hash
41
+ usages_dtm_hash.each do |_key, value|
42
+ next unless value.class_names.any?
43
+
44
+ @observations << Contrast::Agent::Reporting::LibraryUsageObservation.convert(value)
45
+ end
46
+ end
47
+
48
+ def validate
49
+ raise(ArgumentError, "#{ self } did not have observations. Unable to continue.") if observations.empty?
50
+ end
51
+ end
52
+ end
53
+ end
54
+ end
@@ -0,0 +1,66 @@
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 'json'
5
+ require 'contrast/components/logger'
6
+ require 'contrast/agent/reporting/reporting_events/reporting_event'
7
+ require 'contrast/utils/object_share'
8
+
9
+ module Contrast
10
+ module Agent
11
+ module Reporting
12
+ # This is the new Route Observation class which will include all the needed information for the new reporting
13
+ # system to relay this information in the Route Observation messages. These observations are used by TeamServer
14
+ # to construct the route coverage information for the assess feature. They represent those methods which map to
15
+ # externally accessible endpoints within the application, as registered to the application framework. This also
16
+ # includes the literal URL and HTTP Verb used to invoke them, as they must have been called at this point to be
17
+ # recorded.
18
+ #
19
+ # @attr_accessor signature [String] the method signature used to uniquely identify the coverage report.
20
+ # @attr_accessor url [String] the normalized URL used to access the method in the route.
21
+ # @attr_accessor verb [String] the HTTP Verb used to access the method in the route.
22
+ # @attr_accessor agent_session_id_value [Integer] the session of this process, as determined from TeamServer on
23
+ # application create.
24
+ # @attr_accessor sources [Array<Contrast::Agent::Reporting::TraceEventSource>] the sources of user input accessed
25
+ # during this request. Used for remediation determinations in TeamServer.
26
+ class ObservedRoute < Contrast::Agent::Reporting::ReportingEvent
27
+ attr_accessor :sources, :agent_session_id_value, :signature, :verb, :url
28
+
29
+ def initialize
30
+ @event_endpoint = Contrast::Agent::Reporting::Endpoints.observed_route
31
+ @sources = []
32
+ @signature = Contrast::Utils::ObjectShare::EMPTY_STRING
33
+ @verb = Contrast::Utils::ObjectShare::EMPTY_STRING
34
+ @url = Contrast::Utils::ObjectShare::EMPTY_STRING
35
+ super()
36
+ end
37
+
38
+ # Convert the instance variables on the class, and other information, into the identifiers required for
39
+ # TeamServer to process the JSON form of this message.
40
+ #
41
+ # @return [Hash]
42
+ # @raise [ArgumentError]
43
+ def to_controlled_hash
44
+ validate
45
+ rc_hash = {
46
+ session_id: @agent_session_id_value,
47
+ sources: @sources,
48
+ signature: @signature,
49
+ verb: @verb,
50
+ url: @url
51
+ }
52
+ rc_hash.delete(:verb) unless @verb
53
+ rc_hash
54
+ end
55
+
56
+ def validate
57
+ raise(ArgumentError, "#{ self } did not have a proper sources. Unable to continue.") if @sources.nil?
58
+ raise(ArgumentError, "#{ self } did not have a proper signature. Unable to continue.") unless signature
59
+ raise(ArgumentError, "#{ self } did not have a proper url. Unable to continue.") unless url
60
+
61
+ nil
62
+ end
63
+ end
64
+ end
65
+ end
66
+ end
@@ -0,0 +1,39 @@
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/reporting/reporting_events/reporting_event'
5
+
6
+ module Contrast
7
+ module Agent
8
+ module Reporting
9
+ # This is the new Preflight class which will include all the needed information for the new reporting system
10
+ # to report a Preflight message to TeamServer. This message represents the identifying information of a
11
+ # collection of Findings/Traces, which TeamServer will use to determine if it requires the full information of
12
+ # any of the Findings/Traces to be reported.
13
+ #
14
+ # For our purposes, we'll only ever send one message per request; however, we must use an array to conform to the
15
+ # specification.
16
+ #
17
+ # @attr_reader messages [Array<Contrast::Agent::Reporting::PreflightMessage>]
18
+ class Preflight < Contrast::Agent::Reporting::ReportingEvent
19
+ attr_reader :messages
20
+
21
+ def initialize
22
+ @event_method = :PUT
23
+ @event_endpoint = "#{ Contrast::API.api_url }/api/ng/preflight/"
24
+ @messages = []
25
+ super
26
+ end
27
+
28
+ # Convert the instance variables on the class, and other information, into the identifiers required for
29
+ # TeamServer to process the JSON form of this message.
30
+ #
31
+ # @return [Hash]
32
+ # @raise [ArgumentError]
33
+ def to_controlled_hash
34
+ { messages: @messages }
35
+ end
36
+ end
37
+ end
38
+ end
39
+ end