contrast-agent 3.9.1 → 6.15.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (705) hide show
  1. checksums.yaml +4 -4
  2. data/.dockerignore +0 -1
  3. data/.flayignore +1 -0
  4. data/.gitignore +8 -5
  5. data/.gitmodules +0 -3
  6. data/.rspec +0 -1
  7. data/.rspec_parallel +6 -0
  8. data/.simplecov +6 -2
  9. data/Gemfile +1 -1
  10. data/LICENSE.txt +1 -1
  11. data/Rakefile +5 -2
  12. data/ext/build_funchook.rb +16 -13
  13. data/ext/cs__assess_array/cs__assess_array.c +50 -6
  14. data/ext/cs__assess_array/cs__assess_array.h +5 -1
  15. data/ext/cs__assess_array/extconf.rb +3 -0
  16. data/ext/cs__assess_basic_object/cs__assess_basic_object.c +39 -17
  17. data/ext/cs__assess_basic_object/cs__assess_basic_object.h +2 -1
  18. data/ext/cs__assess_basic_object/extconf.rb +3 -0
  19. data/ext/cs__assess_fiber_track/cs__assess_fiber_track.c +9 -13
  20. data/ext/cs__assess_fiber_track/cs__assess_fiber_track.h +3 -4
  21. data/ext/cs__assess_fiber_track/extconf.rb +3 -0
  22. data/ext/cs__assess_hash/cs__assess_hash.c +46 -21
  23. data/ext/cs__assess_hash/cs__assess_hash.h +5 -6
  24. data/ext/cs__assess_hash/extconf.rb +3 -0
  25. data/ext/cs__assess_kernel/cs__assess_kernel.c +29 -15
  26. data/ext/cs__assess_kernel/cs__assess_kernel.h +3 -0
  27. data/ext/cs__assess_kernel/extconf.rb +3 -0
  28. data/ext/cs__assess_marshal_module/cs__assess_marshal_module.c +57 -23
  29. data/ext/cs__assess_marshal_module/cs__assess_marshal_module.h +6 -3
  30. data/ext/cs__assess_marshal_module/extconf.rb +3 -0
  31. data/ext/cs__assess_module/cs__assess_module.c +82 -22
  32. data/ext/cs__assess_module/cs__assess_module.h +10 -0
  33. data/ext/cs__assess_module/extconf.rb +3 -0
  34. data/ext/cs__assess_regexp/cs__assess_regexp.c +28 -9
  35. data/ext/cs__assess_regexp/cs__assess_regexp.h +3 -0
  36. data/ext/cs__assess_regexp/extconf.rb +3 -0
  37. data/ext/cs__assess_string/cs__assess_string.c +53 -21
  38. data/ext/cs__assess_string/cs__assess_string.h +7 -1
  39. data/ext/cs__assess_string/extconf.rb +3 -0
  40. data/ext/cs__assess_string_interpolation/cs__assess_string_interpolation.c +39 -0
  41. data/ext/cs__assess_string_interpolation/cs__assess_string_interpolation.h +13 -0
  42. data/ext/cs__assess_string_interpolation/extconf.rb +5 -0
  43. data/ext/cs__assess_test/cs__assess_test.h +9 -0
  44. data/ext/cs__assess_test/cs__assess_tests.c +22 -0
  45. data/ext/cs__assess_test/extconf.rb +5 -0
  46. data/ext/cs__assess_yield_track/cs__assess_yield_track.c +4 -8
  47. data/ext/cs__assess_yield_track/cs__assess_yield_track.h +1 -2
  48. data/ext/cs__assess_yield_track/extconf.rb +3 -0
  49. data/ext/cs__common/cs__common.c +240 -4
  50. data/ext/cs__common/cs__common.h +68 -1
  51. data/ext/cs__common/extconf.rb +3 -16
  52. data/ext/cs__contrast_patch/cs__contrast_patch.c +162 -83
  53. data/ext/cs__contrast_patch/cs__contrast_patch.h +11 -15
  54. data/ext/cs__contrast_patch/extconf.rb +3 -0
  55. data/ext/cs__os_information/cs__os_information.c +34 -0
  56. data/ext/cs__os_information/cs__os_information.h +7 -0
  57. data/ext/cs__os_information/extconf.rb +5 -0
  58. data/ext/cs__scope/cs__scope.c +980 -0
  59. data/ext/cs__scope/cs__scope.h +90 -0
  60. data/ext/cs__scope/extconf.rb +5 -0
  61. data/ext/cs__tests/cs__tests.c +12 -0
  62. data/ext/cs__tests/cs__tests.h +3 -0
  63. data/ext/cs__tests/extconf.rb +5 -0
  64. data/ext/extconf_common.rb +4 -34
  65. data/lib/contrast/agent/assess/assess.rb +23 -0
  66. data/lib/contrast/agent/assess/contrast_object.rb +54 -0
  67. data/lib/contrast/agent/assess/events/event_data.rb +30 -0
  68. data/lib/contrast/agent/assess/finalizers/freeze.rb +15 -0
  69. data/lib/contrast/agent/assess/finalizers/hash.rb +107 -0
  70. data/lib/contrast/agent/{module_data.rb → assess/module_data.rb} +5 -4
  71. data/lib/contrast/agent/assess/policy/dynamic_source_factory.rb +23 -48
  72. data/lib/contrast/agent/assess/policy/patcher.rb +13 -48
  73. data/lib/contrast/agent/assess/policy/policy.rb +20 -23
  74. data/lib/contrast/agent/assess/policy/policy_node.rb +97 -200
  75. data/lib/contrast/agent/assess/policy/policy_node_utils.rb +50 -0
  76. data/lib/contrast/agent/assess/policy/policy_scanner.rb +15 -12
  77. data/lib/contrast/agent/assess/policy/preshift.rb +49 -18
  78. data/lib/contrast/agent/assess/policy/propagation_method.rb +200 -194
  79. data/lib/contrast/agent/assess/policy/propagation_node.rb +49 -41
  80. data/lib/contrast/agent/assess/policy/propagator/append.rb +32 -15
  81. data/lib/contrast/agent/assess/policy/propagator/base.rb +5 -3
  82. data/lib/contrast/agent/assess/policy/propagator/buffer.rb +119 -0
  83. data/lib/contrast/agent/assess/policy/propagator/center.rb +12 -8
  84. data/lib/contrast/agent/assess/policy/propagator/custom.rb +7 -3
  85. data/lib/contrast/agent/assess/policy/propagator/database_write.rb +33 -25
  86. data/lib/contrast/agent/assess/policy/propagator/insert.rb +15 -11
  87. data/lib/contrast/agent/assess/policy/propagator/keep.rb +23 -6
  88. data/lib/contrast/agent/assess/policy/propagator/match_data.rb +118 -0
  89. data/lib/contrast/agent/assess/policy/propagator/next.rb +7 -6
  90. data/lib/contrast/agent/assess/policy/propagator/prepend.rb +13 -6
  91. data/lib/contrast/agent/assess/policy/propagator/rack_protection.rb +73 -0
  92. data/lib/contrast/agent/assess/policy/propagator/remove.rb +53 -41
  93. data/lib/contrast/agent/assess/policy/propagator/replace.rb +5 -3
  94. data/lib/contrast/agent/assess/policy/propagator/reverse.rb +7 -6
  95. data/lib/contrast/agent/assess/policy/propagator/select.rb +45 -36
  96. data/lib/contrast/agent/assess/policy/propagator/splat.rb +44 -21
  97. data/lib/contrast/agent/assess/policy/propagator/split.rb +133 -147
  98. data/lib/contrast/agent/assess/policy/propagator/substitution.rb +7 -132
  99. data/lib/contrast/agent/assess/policy/propagator/substitution_utils.rb +190 -0
  100. data/lib/contrast/agent/assess/policy/propagator/trim.rb +74 -52
  101. data/lib/contrast/agent/assess/policy/propagator.rb +21 -18
  102. data/lib/contrast/agent/assess/policy/source_method.rb +126 -188
  103. data/lib/contrast/agent/assess/policy/source_node.rb +3 -17
  104. data/lib/contrast/agent/assess/policy/source_validation/cross_site_validator.rb +9 -7
  105. data/lib/contrast/agent/assess/policy/source_validation/source_validation.rb +3 -5
  106. data/lib/contrast/agent/assess/policy/trigger/reflected_xss.rb +103 -0
  107. data/lib/contrast/agent/assess/policy/trigger/xpath.rb +57 -0
  108. data/lib/contrast/agent/assess/policy/trigger_method.rb +143 -206
  109. data/lib/contrast/agent/assess/policy/trigger_node.rb +144 -66
  110. data/lib/contrast/agent/assess/policy/trigger_validation/redos_validator.rb +98 -0
  111. data/lib/contrast/agent/assess/policy/trigger_validation/ssrf_validator.rb +8 -38
  112. data/lib/contrast/agent/assess/policy/trigger_validation/trigger_validation.rb +9 -7
  113. data/lib/contrast/agent/assess/policy/trigger_validation/xss_validator.rb +6 -15
  114. data/lib/contrast/agent/assess/properties.rb +15 -383
  115. data/lib/contrast/agent/assess/property/evented.rb +58 -0
  116. data/lib/contrast/agent/assess/property/tagged.rb +246 -0
  117. data/lib/contrast/agent/assess/property/updated.rb +131 -0
  118. data/lib/contrast/agent/assess/rule/provider/hardcoded_key.rb +58 -19
  119. data/lib/contrast/agent/assess/rule/provider/hardcoded_password.rb +22 -17
  120. data/lib/contrast/agent/assess/rule/provider/hardcoded_value_rule.rb +93 -81
  121. data/lib/contrast/agent/assess/rule/provider.rb +4 -4
  122. data/lib/contrast/agent/assess/rule/response/auto_complete_rule.rb +69 -0
  123. data/lib/contrast/agent/assess/rule/response/base_rule.rb +121 -0
  124. data/lib/contrast/agent/assess/rule/response/body_rule.rb +107 -0
  125. data/lib/contrast/agent/assess/rule/response/cache_control_header_rule.rb +195 -0
  126. data/lib/contrast/agent/assess/rule/response/click_jacking_header_rule.rb +26 -0
  127. data/lib/contrast/agent/assess/rule/response/csp_header_insecure_rule.rb +100 -0
  128. data/lib/contrast/agent/assess/rule/response/csp_header_missing_rule.rb +26 -0
  129. data/lib/contrast/agent/assess/rule/response/framework/rails_support.rb +34 -0
  130. data/lib/contrast/agent/assess/rule/response/header_rule.rb +70 -0
  131. data/lib/contrast/agent/assess/rule/response/hsts_header_rule.rb +36 -0
  132. data/lib/contrast/agent/assess/rule/response/parameters_pollution_rule.rb +61 -0
  133. data/lib/contrast/agent/assess/rule/response/x_content_type_header_rule.rb +26 -0
  134. data/lib/contrast/agent/assess/rule/response/x_xss_protection_header_rule.rb +34 -0
  135. data/lib/contrast/agent/assess/tag.rb +84 -41
  136. data/lib/contrast/agent/assess/tracker.rb +70 -0
  137. data/lib/contrast/agent/deadzone/policy/deadzone_node.rb +11 -6
  138. data/lib/contrast/agent/deadzone/policy/policy.rb +11 -7
  139. data/lib/contrast/agent/excluder/excluder.rb +306 -0
  140. data/lib/contrast/agent/excluder/exclusion_matcher.rb +112 -0
  141. data/lib/contrast/agent/hooks/at_exit_hook.rb +44 -0
  142. data/lib/contrast/agent/hooks/tracepoint_hook.rb +57 -0
  143. data/lib/contrast/agent/inventory/database_config.rb +175 -0
  144. data/lib/contrast/agent/inventory/dependencies.rb +52 -0
  145. data/lib/contrast/agent/inventory/dependency_analysis.rb +34 -0
  146. data/lib/contrast/agent/inventory/dependency_usage_analysis.rb +120 -0
  147. data/lib/contrast/agent/inventory/inventory.rb +14 -0
  148. data/lib/contrast/agent/inventory/policy/datastores.rb +51 -0
  149. data/lib/contrast/agent/inventory/policy/policy.rb +5 -5
  150. data/lib/contrast/agent/inventory/policy/trigger_node.rb +2 -2
  151. data/lib/contrast/agent/middleware/middleware.rb +214 -0
  152. data/lib/contrast/agent/middleware/static_analysis.rb +51 -0
  153. data/lib/contrast/agent/patching/policy/after_load_patch.rb +22 -11
  154. data/lib/contrast/agent/patching/policy/after_load_patcher.rb +103 -52
  155. data/lib/contrast/agent/patching/policy/method_policy.rb +38 -62
  156. data/lib/contrast/agent/patching/policy/method_policy_extend.rb +117 -0
  157. data/lib/contrast/agent/patching/policy/module_policy.rb +27 -47
  158. data/lib/contrast/agent/patching/policy/patch.rb +129 -254
  159. data/lib/contrast/agent/patching/policy/patch_status.rb +21 -43
  160. data/lib/contrast/agent/patching/policy/patcher.rb +125 -159
  161. data/lib/contrast/agent/patching/policy/policy.rb +63 -58
  162. data/lib/contrast/agent/patching/policy/policy_node.rb +55 -37
  163. data/lib/contrast/agent/patching/policy/trigger_node.rb +32 -16
  164. data/lib/contrast/agent/protect/exploitable_collection.rb +38 -0
  165. data/lib/contrast/agent/protect/input_analyzer/input_analyzer.rb +165 -0
  166. data/lib/contrast/agent/protect/input_analyzer/worth_watching_analyzer.rb +122 -0
  167. data/lib/contrast/agent/protect/policy/applies_command_injection_rule.rb +67 -0
  168. data/lib/contrast/agent/protect/policy/applies_deserialization_rule.rb +97 -0
  169. data/lib/contrast/agent/protect/policy/applies_no_sqli_rule.rb +72 -0
  170. data/lib/contrast/agent/protect/policy/applies_path_traversal_rule.rb +141 -0
  171. data/lib/contrast/agent/protect/policy/applies_sqli_rule.rb +58 -0
  172. data/lib/contrast/agent/protect/policy/applies_xxe_rule.rb +125 -0
  173. data/lib/contrast/agent/protect/policy/policy.rb +10 -10
  174. data/lib/contrast/agent/protect/policy/rule_applicator.rb +119 -0
  175. data/lib/contrast/agent/protect/policy/trigger_node.rb +2 -2
  176. data/lib/contrast/agent/protect/rule/base.rb +274 -173
  177. data/lib/contrast/agent/protect/rule/bot_blocker/bot_blocker.rb +89 -0
  178. data/lib/contrast/agent/protect/rule/bot_blocker/bot_blocker_input_classification.rb +98 -0
  179. data/lib/contrast/agent/protect/rule/cmdi/cmd_injection.rb +86 -0
  180. data/lib/contrast/agent/protect/rule/cmdi/cmdi_backdoors.rb +90 -0
  181. data/lib/contrast/agent/protect/rule/cmdi/cmdi_base_rule.rb +170 -0
  182. data/lib/contrast/agent/protect/rule/cmdi/cmdi_chained_command.rb +63 -0
  183. data/lib/contrast/agent/protect/rule/cmdi/cmdi_dangerous_path.rb +62 -0
  184. data/lib/contrast/agent/protect/rule/cmdi/cmdi_input_classification.rb +27 -0
  185. data/lib/contrast/agent/protect/rule/default_scanner.rb +69 -25
  186. data/lib/contrast/agent/protect/rule/{deserialization.rb → deserialization/deserialization.rb} +29 -24
  187. data/lib/contrast/agent/protect/rule/no_sqli/mongo_no_sql_scanner.rb +2 -3
  188. data/lib/contrast/agent/protect/rule/no_sqli/no_sqli.rb +105 -0
  189. data/lib/contrast/agent/protect/rule/no_sqli/no_sqli_input_classification.rb +226 -0
  190. data/lib/contrast/agent/protect/rule/{path_traversal.rb → path_traversal/path_traversal.rb} +48 -55
  191. data/lib/contrast/agent/protect/rule/path_traversal/path_traversal_input_classification.rb +61 -0
  192. data/lib/contrast/agent/protect/rule/path_traversal/path_traversal_semantic_security_bypass.rb +139 -0
  193. data/lib/contrast/agent/protect/rule/sqli/default_sql_scanner.rb +1 -1
  194. data/lib/contrast/agent/protect/rule/sqli/mysql_sql_scanner.rb +1 -1
  195. data/lib/contrast/agent/protect/rule/sqli/postgres_sql_scanner.rb +2 -3
  196. data/lib/contrast/agent/protect/rule/sqli/sql_sample_builder.rb +154 -0
  197. data/lib/contrast/agent/protect/rule/sqli/sqli.rb +101 -0
  198. data/lib/contrast/agent/protect/rule/sqli/sqli_base_rule.rb +37 -0
  199. data/lib/contrast/agent/protect/rule/sqli/sqli_input_classification.rb +27 -0
  200. data/lib/contrast/agent/protect/rule/sqli/sqli_semantic/sqli_dangerous_functions.rb +67 -0
  201. data/lib/contrast/agent/protect/rule/sqli/sqlite_sql_scanner.rb +1 -1
  202. data/lib/contrast/agent/protect/rule/unsafe_file_upload/unsafe_file_upload.rb +56 -0
  203. data/lib/contrast/agent/protect/rule/unsafe_file_upload/unsafe_file_upload_input_classification.rb +62 -0
  204. data/lib/contrast/agent/protect/rule/utils/builders.rb +111 -0
  205. data/lib/contrast/agent/protect/rule/utils/filters.rb +110 -0
  206. data/lib/contrast/agent/protect/rule/xss/reflected_xss_input_classification.rb +58 -0
  207. data/lib/contrast/agent/protect/rule/xss/xss.rb +50 -0
  208. data/lib/contrast/agent/protect/rule/xxe/entity_wrapper.rb +25 -21
  209. data/lib/contrast/agent/protect/rule/xxe/xxe.rb +149 -0
  210. data/lib/contrast/agent/protect/rule.rb +20 -27
  211. data/lib/contrast/agent/reactions/disable_reaction.rb +20 -0
  212. data/lib/contrast/agent/reporting/attack_result/attack_result.rb +71 -0
  213. data/lib/contrast/agent/reporting/attack_result/rasp_rule_sample.rb +86 -0
  214. data/lib/contrast/agent/reporting/attack_result/response_type.rb +29 -0
  215. data/lib/contrast/agent/reporting/attack_result/user_input.rb +97 -0
  216. data/lib/contrast/agent/reporting/connection_status.rb +45 -0
  217. data/lib/contrast/agent/reporting/details/bot_blocker_details.rb +29 -0
  218. data/lib/contrast/agent/reporting/details/cmd_injection_details.rb +30 -0
  219. data/lib/contrast/agent/reporting/details/details.rb +17 -0
  220. data/lib/contrast/agent/reporting/details/ip_denylist_details.rb +35 -0
  221. data/lib/contrast/agent/reporting/details/no_sqli_details.rb +36 -0
  222. data/lib/contrast/agent/reporting/details/path_traversal_details.rb +24 -0
  223. data/lib/contrast/agent/reporting/details/path_traversal_semantic_analysis_details.rb +32 -0
  224. data/lib/contrast/agent/reporting/details/protect_rule_details.rb +17 -0
  225. data/lib/contrast/agent/reporting/details/sqli_dangerous_functions.rb +22 -0
  226. data/lib/contrast/agent/reporting/details/sqli_details.rb +36 -0
  227. data/lib/contrast/agent/reporting/details/untrusted_deserialization_details.rb +27 -0
  228. data/lib/contrast/agent/reporting/details/virtual_patch_details.rb +30 -0
  229. data/lib/contrast/agent/reporting/details/xss_details.rb +33 -0
  230. data/lib/contrast/agent/reporting/details/xss_match.rb +30 -0
  231. data/lib/contrast/agent/reporting/details/xxe_details.rb +36 -0
  232. data/lib/contrast/agent/reporting/details/xxe_match.rb +25 -0
  233. data/lib/contrast/agent/reporting/details/xxe_wrapper.rb +25 -0
  234. data/lib/contrast/agent/reporting/input_analysis/details/bot_blocker_details.rb +27 -0
  235. data/lib/contrast/agent/reporting/input_analysis/details/protect_rule_details.rb +15 -0
  236. data/lib/contrast/agent/reporting/input_analysis/input_analysis.rb +55 -0
  237. data/lib/contrast/agent/reporting/input_analysis/input_analysis_result.rb +129 -0
  238. data/lib/contrast/agent/reporting/input_analysis/input_type.rb +44 -0
  239. data/lib/contrast/agent/reporting/input_analysis/score_level.rb +21 -0
  240. data/lib/contrast/agent/reporting/masker/masker.rb +258 -0
  241. data/lib/contrast/agent/reporting/masker/masker_utils.rb +33 -0
  242. data/lib/contrast/agent/reporting/report.rb +32 -0
  243. data/lib/contrast/agent/reporting/reporter.rb +163 -0
  244. data/lib/contrast/agent/reporting/reporting_events/agent_startup.rb +34 -0
  245. data/lib/contrast/agent/reporting/reporting_events/application_activity.rb +120 -0
  246. data/lib/contrast/agent/reporting/reporting_events/application_defend_activity.rb +101 -0
  247. data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_activity.rb +79 -0
  248. data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_sample.rb +101 -0
  249. data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_sample_activity.rb +74 -0
  250. data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_sample_stack.rb +22 -0
  251. data/lib/contrast/agent/reporting/reporting_events/application_defend_attacker_activity.rb +78 -0
  252. data/lib/contrast/agent/reporting/reporting_events/application_inventory.rb +43 -0
  253. data/lib/contrast/agent/reporting/reporting_events/application_inventory_activity.rb +57 -0
  254. data/lib/contrast/agent/reporting/reporting_events/application_reporting_event.rb +37 -0
  255. data/lib/contrast/agent/reporting/reporting_events/application_settings.rb +40 -0
  256. data/lib/contrast/agent/reporting/reporting_events/application_startup.rb +44 -0
  257. data/lib/contrast/agent/reporting/reporting_events/application_startup_instrumentation.rb +27 -0
  258. data/lib/contrast/agent/reporting/reporting_events/application_update.rb +55 -0
  259. data/lib/contrast/agent/reporting/reporting_events/architecture_component.rb +66 -0
  260. data/lib/contrast/agent/reporting/reporting_events/discovered_route.rb +122 -0
  261. data/lib/contrast/agent/reporting/reporting_events/finding.rb +201 -0
  262. data/lib/contrast/agent/reporting/reporting_events/finding_event.rb +442 -0
  263. data/lib/contrast/agent/reporting/reporting_events/finding_event_object.rb +96 -0
  264. data/lib/contrast/agent/reporting/reporting_events/finding_event_parent_object.rb +45 -0
  265. data/lib/contrast/agent/reporting/reporting_events/finding_event_property.rb +47 -0
  266. data/lib/contrast/agent/reporting/reporting_events/finding_event_signature.rb +99 -0
  267. data/lib/contrast/agent/reporting/reporting_events/finding_event_source.rb +63 -0
  268. data/lib/contrast/agent/reporting/reporting_events/finding_event_stack.rb +65 -0
  269. data/lib/contrast/agent/reporting/reporting_events/finding_event_taint_range.rb +67 -0
  270. data/lib/contrast/agent/reporting/reporting_events/finding_event_taint_range_tags.rb +105 -0
  271. data/lib/contrast/agent/reporting/reporting_events/finding_request.rb +126 -0
  272. data/lib/contrast/agent/reporting/reporting_events/library_discovery.rb +89 -0
  273. data/lib/contrast/agent/reporting/reporting_events/library_usage_observation.rb +48 -0
  274. data/lib/contrast/agent/reporting/reporting_events/observed_library_usage.rb +37 -0
  275. data/lib/contrast/agent/reporting/reporting_events/observed_route.rb +83 -0
  276. data/lib/contrast/agent/reporting/reporting_events/poll.rb +23 -0
  277. data/lib/contrast/agent/reporting/reporting_events/preflight.rb +52 -0
  278. data/lib/contrast/agent/reporting/reporting_events/preflight_message.rb +66 -0
  279. data/lib/contrast/agent/reporting/reporting_events/reportable_hash.rb +47 -0
  280. data/lib/contrast/agent/reporting/reporting_events/reporting_event.rb +35 -0
  281. data/lib/contrast/agent/reporting/reporting_events/route_coverage.rb +87 -0
  282. data/lib/contrast/agent/reporting/reporting_events/route_discovery.rb +59 -0
  283. data/lib/contrast/agent/reporting/reporting_events/route_discovery_observation.rb +49 -0
  284. data/lib/contrast/agent/reporting/reporting_events/server_reporting_event.rb +35 -0
  285. data/lib/contrast/agent/reporting/reporting_events/server_settings.rb +40 -0
  286. data/lib/contrast/agent/reporting/reporting_utilities/audit.rb +133 -0
  287. data/lib/contrast/agent/reporting/reporting_utilities/build_preflight.rb +38 -0
  288. data/lib/contrast/agent/reporting/reporting_utilities/endpoints.rb +176 -0
  289. data/lib/contrast/agent/reporting/reporting_utilities/headers.rb +57 -0
  290. data/lib/contrast/agent/reporting/reporting_utilities/ng_response_extractor.rb +137 -0
  291. data/lib/contrast/agent/reporting/reporting_utilities/reporter_client.rb +138 -0
  292. data/lib/contrast/agent/reporting/reporting_utilities/reporter_client_utils.rb +161 -0
  293. data/lib/contrast/agent/reporting/reporting_utilities/reporting_storage.rb +66 -0
  294. data/lib/contrast/agent/reporting/reporting_utilities/response.rb +98 -0
  295. data/lib/contrast/agent/reporting/reporting_utilities/response_extractor.rb +149 -0
  296. data/lib/contrast/agent/reporting/reporting_utilities/response_handler.rb +118 -0
  297. data/lib/contrast/agent/reporting/reporting_utilities/response_handler_mode.rb +63 -0
  298. data/lib/contrast/agent/reporting/reporting_utilities/response_handler_utils.rb +393 -0
  299. data/lib/contrast/agent/reporting/reporting_workers/application_server_worker.rb +46 -0
  300. data/lib/contrast/agent/reporting/reporting_workers/reporter_heartbeat.rb +51 -0
  301. data/lib/contrast/agent/reporting/reporting_workers/reporting_workers.rb +14 -0
  302. data/lib/contrast/agent/reporting/reporting_workers/server_settings_worker.rb +46 -0
  303. data/lib/contrast/agent/reporting/settings/application_settings.rb +61 -0
  304. data/lib/contrast/agent/reporting/settings/assess.rb +58 -0
  305. data/lib/contrast/agent/reporting/settings/assess_rule.rb +18 -0
  306. data/lib/contrast/agent/reporting/settings/assess_server_feature.rb +114 -0
  307. data/lib/contrast/agent/reporting/settings/bot_blocker.rb +68 -0
  308. data/lib/contrast/agent/reporting/settings/exclusion_base.rb +129 -0
  309. data/lib/contrast/agent/reporting/settings/exclusions.rb +86 -0
  310. data/lib/contrast/agent/reporting/settings/helpers.rb +101 -0
  311. data/lib/contrast/agent/reporting/settings/input_exclusion.rb +87 -0
  312. data/lib/contrast/agent/reporting/settings/ip_filter.rb +35 -0
  313. data/lib/contrast/agent/reporting/settings/keyword.rb +74 -0
  314. data/lib/contrast/agent/reporting/settings/log_enhancer.rb +65 -0
  315. data/lib/contrast/agent/reporting/settings/protect.rb +111 -0
  316. data/lib/contrast/agent/reporting/settings/protect_rule.rb +18 -0
  317. data/lib/contrast/agent/reporting/settings/protect_server_feature.rb +227 -0
  318. data/lib/contrast/agent/reporting/settings/reaction.rb +39 -0
  319. data/lib/contrast/agent/reporting/settings/rule_definition.rb +66 -0
  320. data/lib/contrast/agent/reporting/settings/sampling.rb +46 -0
  321. data/lib/contrast/agent/reporting/settings/sanitizer.rb +38 -0
  322. data/lib/contrast/agent/reporting/settings/security_logger.rb +77 -0
  323. data/lib/contrast/agent/reporting/settings/sensitive_data_masking.rb +118 -0
  324. data/lib/contrast/agent/reporting/settings/sensitive_data_masking_rule.rb +65 -0
  325. data/lib/contrast/agent/reporting/settings/server_features.rb +95 -0
  326. data/lib/contrast/agent/reporting/settings/syslog.rb +205 -0
  327. data/lib/contrast/agent/reporting/settings/url_exclusion.rb +18 -0
  328. data/lib/contrast/agent/reporting/settings/validator.rb +17 -0
  329. data/lib/contrast/agent/reporting/settings/virtual_patch.rb +56 -0
  330. data/lib/contrast/agent/reporting/settings/virtual_patch_condition.rb +47 -0
  331. data/lib/contrast/agent/request/request.rb +189 -0
  332. data/lib/contrast/agent/request/request_context.rb +143 -0
  333. data/lib/contrast/agent/request/request_context_extend.rb +105 -0
  334. data/lib/contrast/agent/request/request_handler.rb +41 -0
  335. data/lib/contrast/agent/response/response.rb +87 -0
  336. data/lib/contrast/agent/scope/scope.rb +158 -0
  337. data/lib/contrast/agent/telemetry/base.rb +171 -0
  338. data/lib/contrast/agent/telemetry/client.rb +111 -0
  339. data/lib/contrast/agent/telemetry/event.rb +35 -0
  340. data/lib/contrast/agent/telemetry/exception/base.rb +61 -0
  341. data/lib/contrast/agent/telemetry/exception/event.rb +46 -0
  342. data/lib/contrast/agent/telemetry/exception/message.rb +118 -0
  343. data/lib/contrast/agent/telemetry/exception/message_exception.rb +86 -0
  344. data/lib/contrast/agent/telemetry/exception/stack_frame.rb +67 -0
  345. data/lib/contrast/agent/telemetry/exception.rb +19 -0
  346. data/lib/contrast/agent/telemetry/hash.rb +71 -0
  347. data/lib/contrast/agent/telemetry/identifier.rb +153 -0
  348. data/lib/contrast/agent/telemetry/metric_event.rb +28 -0
  349. data/lib/contrast/agent/telemetry/startup_metrics_event.rb +123 -0
  350. data/lib/contrast/agent/telemetry/telemetry.rb +109 -0
  351. data/lib/contrast/agent/{thread.rb → thread/thread.rb} +4 -6
  352. data/lib/contrast/agent/thread/thread_watcher.rb +126 -0
  353. data/lib/contrast/agent/thread/worker_thread.rb +42 -0
  354. data/lib/contrast/agent/version.rb +2 -2
  355. data/lib/contrast/agent.rb +96 -57
  356. data/lib/contrast/agent_lib/api/command_injection.rb +46 -0
  357. data/lib/contrast/agent_lib/api/init.rb +95 -0
  358. data/lib/contrast/agent_lib/api/input_tracing.rb +265 -0
  359. data/lib/contrast/agent_lib/api/panic.rb +87 -0
  360. data/lib/contrast/agent_lib/api/path_semantic_file_security_bypass.rb +40 -0
  361. data/lib/contrast/agent_lib/interface.rb +245 -0
  362. data/lib/contrast/agent_lib/interface_base.rb +131 -0
  363. data/lib/contrast/agent_lib/return_types/eval_result.rb +44 -0
  364. data/lib/contrast/agent_lib/test.rb +29 -0
  365. data/lib/contrast/components/agent.rb +104 -48
  366. data/lib/contrast/components/api.rb +159 -0
  367. data/lib/contrast/components/app_context.rb +125 -98
  368. data/lib/contrast/components/app_context_extend.rb +53 -0
  369. data/lib/contrast/components/assess.rb +210 -24
  370. data/lib/contrast/components/assess_rules.rb +54 -0
  371. data/lib/contrast/components/base.rb +103 -0
  372. data/lib/contrast/components/config/sources.rb +95 -0
  373. data/lib/contrast/components/config.rb +182 -60
  374. data/lib/contrast/components/heap_dump.rb +77 -12
  375. data/lib/contrast/components/inventory.rb +37 -10
  376. data/lib/contrast/components/logger.rb +46 -76
  377. data/lib/contrast/components/polling.rb +39 -0
  378. data/lib/contrast/components/protect.rb +142 -16
  379. data/lib/contrast/components/ruby_component.rb +135 -0
  380. data/lib/contrast/components/rule_set.rb +52 -0
  381. data/lib/contrast/components/sampling.rb +156 -15
  382. data/lib/contrast/components/scope.rb +125 -116
  383. data/lib/contrast/components/security_logger.rb +36 -0
  384. data/lib/contrast/components/settings.rb +239 -88
  385. data/lib/contrast/config/api_proxy_configuration.rb +27 -0
  386. data/lib/contrast/config/base_configuration.rb +20 -94
  387. data/lib/contrast/config/certification_configuration.rb +47 -0
  388. data/lib/contrast/config/config.rb +48 -0
  389. data/lib/contrast/config/diagnostics.rb +123 -0
  390. data/lib/contrast/config/diagnostics_tools.rb +99 -0
  391. data/lib/contrast/config/effective_config.rb +131 -0
  392. data/lib/contrast/config/effective_config_value.rb +32 -0
  393. data/lib/contrast/config/env_variables.rb +18 -0
  394. data/lib/contrast/config/exception_configuration.rb +34 -12
  395. data/lib/contrast/config/protect_rule_configuration.rb +45 -24
  396. data/lib/contrast/config/protect_rules_configuration.rb +97 -22
  397. data/lib/contrast/config/request_audit_configuration.rb +57 -0
  398. data/lib/contrast/config/server_configuration.rb +67 -15
  399. data/lib/contrast/config/validate.rb +140 -0
  400. data/lib/contrast/config/yaml_file.rb +129 -0
  401. data/lib/contrast/config.rb +6 -22
  402. data/lib/contrast/configuration.rb +241 -109
  403. data/lib/contrast/extension/assess/array.rb +75 -0
  404. data/lib/contrast/extension/assess/erb.rb +61 -0
  405. data/lib/contrast/extension/assess/eval_trigger.rb +47 -0
  406. data/lib/contrast/{extensions/ruby_core → extension}/assess/exec_trigger.rb +9 -21
  407. data/lib/contrast/extension/assess/fiber.rb +95 -0
  408. data/lib/contrast/extension/assess/hash.rb +33 -0
  409. data/lib/contrast/extension/assess/kernel.rb +124 -0
  410. data/lib/contrast/extension/assess/marshal.rb +80 -0
  411. data/lib/contrast/extension/assess/regexp.rb +71 -0
  412. data/lib/contrast/extension/assess/string.rb +85 -0
  413. data/lib/contrast/extension/assess.rb +47 -0
  414. data/lib/contrast/{extensions/ruby_core → extension}/delegator.rb +3 -1
  415. data/lib/contrast/extension/extension.rb +59 -0
  416. data/lib/contrast/extension/inventory.rb +21 -0
  417. data/lib/contrast/{extensions/ruby_core → extension}/module.rb +2 -3
  418. data/lib/contrast/extension/object.rb +19 -0
  419. data/lib/contrast/extension/protect/psych.rb +7 -0
  420. data/lib/contrast/{extensions/ruby_core → extension}/protect.rb +6 -6
  421. data/lib/contrast/extension/thread.rb +50 -0
  422. data/lib/contrast/framework/base_support.rb +69 -54
  423. data/lib/contrast/framework/grape/support.rb +176 -0
  424. data/lib/contrast/framework/manager.rb +112 -60
  425. data/lib/contrast/framework/manager_extend.rb +50 -0
  426. data/lib/contrast/framework/rack/patch/session_cookie.rb +108 -0
  427. data/lib/contrast/framework/rack/patch/support.rb +26 -0
  428. data/lib/contrast/framework/rack/support.rb +23 -0
  429. data/lib/contrast/framework/rails/patch/action_controller_live_buffer.rb +46 -0
  430. data/lib/contrast/framework/rails/patch/assess_configuration.rb +98 -0
  431. data/lib/contrast/framework/rails/patch/rails_application_configuration.rb +31 -0
  432. data/lib/contrast/framework/rails/patch/support.rb +46 -0
  433. data/lib/contrast/framework/rails/railtie.rb +33 -0
  434. data/lib/contrast/framework/rails/support.rb +187 -0
  435. data/lib/contrast/framework/sinatra/patch/encrypted_session_cookie.rb +39 -0
  436. data/lib/contrast/framework/sinatra/support.rb +162 -0
  437. data/lib/contrast/funchook/funchook.rb +44 -0
  438. data/lib/contrast/logger/aliased_logging.rb +158 -0
  439. data/lib/contrast/logger/application.rb +84 -0
  440. data/lib/contrast/logger/cef_log.rb +169 -0
  441. data/lib/contrast/logger/format.rb +61 -0
  442. data/lib/contrast/logger/log.rb +90 -0
  443. data/lib/contrast/logger/request.rb +25 -0
  444. data/lib/contrast/logger/time.rb +57 -0
  445. data/lib/contrast/security_exception.rb +2 -2
  446. data/lib/contrast/tasks/config.rb +33 -0
  447. data/lib/contrast/utils/assess/event_limit_utils.rb +134 -0
  448. data/lib/contrast/utils/assess/object_store.rb +36 -0
  449. data/lib/contrast/utils/assess/propagation_method_utils.rb +155 -0
  450. data/lib/contrast/utils/assess/property/tagged_utils.rb +165 -0
  451. data/lib/contrast/utils/assess/sampling_util.rb +11 -17
  452. data/lib/contrast/utils/assess/source_method_utils.rb +74 -0
  453. data/lib/contrast/utils/assess/split_utils.rb +23 -0
  454. data/lib/contrast/utils/assess/tracking_util.rb +96 -18
  455. data/lib/contrast/utils/assess/trigger_method_utils.rb +132 -0
  456. data/lib/contrast/utils/class_util.rb +80 -48
  457. data/lib/contrast/utils/duck_utils.rb +18 -9
  458. data/lib/contrast/utils/env_configuration_item.rb +4 -3
  459. data/lib/contrast/utils/findings.rb +66 -0
  460. data/lib/contrast/utils/hash_digest.rb +52 -99
  461. data/lib/contrast/utils/hash_digest_extend.rb +129 -0
  462. data/lib/contrast/utils/head_dump_utils_extend.rb +74 -0
  463. data/lib/contrast/utils/heap_dump_util.rb +44 -88
  464. data/lib/contrast/utils/input_classification_base.rb +169 -0
  465. data/lib/contrast/utils/invalid_configuration_util.rb +31 -45
  466. data/lib/contrast/utils/io_util.rb +47 -51
  467. data/lib/contrast/utils/job_servers_running.rb +21 -11
  468. data/lib/contrast/utils/log_utils.rb +254 -0
  469. data/lib/contrast/utils/lru_cache.rb +48 -0
  470. data/lib/contrast/utils/metrics_hash.rb +59 -0
  471. data/lib/contrast/utils/middleware_utils.rb +97 -0
  472. data/lib/contrast/utils/net_http_base.rb +173 -0
  473. data/lib/contrast/utils/object_share.rb +8 -48
  474. data/lib/contrast/utils/os.rb +14 -24
  475. data/lib/contrast/utils/patching/policy/patch_utils.rb +175 -0
  476. data/lib/contrast/utils/patching/policy/patcher_utils.rb +54 -0
  477. data/lib/contrast/utils/reporting/application_activity_batch_utils.rb +89 -0
  478. data/lib/contrast/utils/request_utils.rb +96 -0
  479. data/lib/contrast/utils/resource_loader.rb +2 -2
  480. data/lib/contrast/utils/response_utils.rb +79 -0
  481. data/lib/contrast/utils/routes_sent.rb +63 -0
  482. data/lib/contrast/utils/sha256_builder.rb +9 -21
  483. data/lib/contrast/utils/silence_maker.rb +16 -0
  484. data/lib/contrast/utils/stack_trace_utils.rb +68 -184
  485. data/lib/contrast/utils/string_utils.rb +82 -52
  486. data/lib/contrast/utils/tag_util.rb +58 -44
  487. data/lib/contrast/utils/thread_tracker.rb +27 -23
  488. data/lib/contrast/utils/timer.rb +20 -55
  489. data/lib/contrast-agent.rb +2 -2
  490. data/lib/contrast.rb +106 -43
  491. data/resources/assess/policy.json +481 -120
  492. data/resources/deadzone/policy.json +280 -10
  493. data/resources/inventory/policy.json +2 -2
  494. data/resources/protect/policy.json +36 -17
  495. data/ruby-agent.gemspec +116 -46
  496. data/sonar-project.properties +9 -0
  497. metadata +694 -317
  498. data/exe/contrast_service +0 -29
  499. data/ext/cs__assess_active_record_named/cs__active_record_named.c +0 -47
  500. data/ext/cs__assess_active_record_named/cs__active_record_named.h +0 -10
  501. data/ext/cs__assess_active_record_named/extconf.rb +0 -2
  502. data/ext/cs__assess_regexp_track/cs__assess_regexp_track.c +0 -63
  503. data/ext/cs__assess_regexp_track/cs__assess_regexp_track.h +0 -29
  504. data/ext/cs__assess_regexp_track/extconf.rb +0 -2
  505. data/ext/cs__assess_string_interpolation26/cs__assess_string_interpolation26.c +0 -31
  506. data/ext/cs__assess_string_interpolation26/cs__assess_string_interpolation26.h +0 -13
  507. data/ext/cs__assess_string_interpolation26/extconf.rb +0 -2
  508. data/ext/cs__protect_kernel/cs__protect_kernel.c +0 -37
  509. data/ext/cs__protect_kernel/cs__protect_kernel.h +0 -11
  510. data/ext/cs__protect_kernel/extconf.rb +0 -2
  511. data/funchook/Makefile +0 -29
  512. data/funchook/autom4te.cache/output.0 +0 -4976
  513. data/funchook/autom4te.cache/requests +0 -78
  514. data/funchook/autom4te.cache/traces.0 +0 -364
  515. data/funchook/config.log +0 -490
  516. data/funchook/config.status +0 -1016
  517. data/funchook/configure +0 -4976
  518. data/funchook/src/Makefile +0 -70
  519. data/funchook/src/config.h +0 -101
  520. data/funchook/src/config.h.in +0 -100
  521. data/funchook/src/decoder.o +0 -0
  522. data/funchook/src/distorm.o +0 -0
  523. data/funchook/src/funchook.o +0 -0
  524. data/funchook/src/funchook_io.o +0 -0
  525. data/funchook/src/funchook_syscall.o +0 -0
  526. data/funchook/src/funchook_unix.o +0 -0
  527. data/funchook/src/funchook_x86.o +0 -0
  528. data/funchook/src/instructions.o +0 -0
  529. data/funchook/src/insts.o +0 -0
  530. data/funchook/src/libfunchook.so +0 -0
  531. data/funchook/src/mnemonics.o +0 -0
  532. data/funchook/src/operands.o +0 -0
  533. data/funchook/src/os_func.o +0 -0
  534. data/funchook/src/os_func_unix.o +0 -0
  535. data/funchook/src/prefix.o +0 -0
  536. data/funchook/src/printf_base.o +0 -0
  537. data/funchook/src/textdefs.o +0 -0
  538. data/funchook/src/wstring.o +0 -0
  539. data/funchook/test/Makefile +0 -43
  540. data/funchook/test/funchook_test +0 -0
  541. data/funchook/test/libfunchook_test.so +0 -0
  542. data/funchook/test/test_main.o +0 -0
  543. data/funchook/test/x86_64_test.o +0 -0
  544. data/lib/contrast/agent/assess/adjusted_span.rb +0 -25
  545. data/lib/contrast/agent/assess/contrast_event.rb +0 -399
  546. data/lib/contrast/agent/assess/frozen_properties.rb +0 -41
  547. data/lib/contrast/agent/assess/insulator.rb +0 -53
  548. data/lib/contrast/agent/assess/policy/rewriter_patch.rb +0 -80
  549. data/lib/contrast/agent/assess/rule/base.rb +0 -72
  550. data/lib/contrast/agent/assess/rule/csrf/csrf_action.rb +0 -28
  551. data/lib/contrast/agent/assess/rule/csrf/csrf_applicator.rb +0 -73
  552. data/lib/contrast/agent/assess/rule/csrf/csrf_watcher.rb +0 -132
  553. data/lib/contrast/agent/assess/rule/csrf.rb +0 -66
  554. data/lib/contrast/agent/assess/rule/redos.rb +0 -68
  555. data/lib/contrast/agent/assess/rule/response_scanning_rule.rb +0 -47
  556. data/lib/contrast/agent/assess/rule/response_watcher.rb +0 -36
  557. data/lib/contrast/agent/assess/rule/watcher.rb +0 -36
  558. data/lib/contrast/agent/assess/rule.rb +0 -18
  559. data/lib/contrast/agent/assess.rb +0 -44
  560. data/lib/contrast/agent/at_exit_hook.rb +0 -33
  561. data/lib/contrast/agent/class_reopener.rb +0 -238
  562. data/lib/contrast/agent/disable_reaction.rb +0 -24
  563. data/lib/contrast/agent/exclusion_matcher.rb +0 -190
  564. data/lib/contrast/agent/feature_state.rb +0 -379
  565. data/lib/contrast/agent/logger_manager.rb +0 -116
  566. data/lib/contrast/agent/middleware.rb +0 -350
  567. data/lib/contrast/agent/protect/rule/base_service.rb +0 -88
  568. data/lib/contrast/agent/protect/rule/cmd_injection.rb +0 -156
  569. data/lib/contrast/agent/protect/rule/csrf/csrf_evaluator.rb +0 -103
  570. data/lib/contrast/agent/protect/rule/csrf/csrf_token_injector.rb +0 -85
  571. data/lib/contrast/agent/protect/rule/csrf.rb +0 -118
  572. data/lib/contrast/agent/protect/rule/http_method_tampering.rb +0 -80
  573. data/lib/contrast/agent/protect/rule/no_sqli.rb +0 -101
  574. data/lib/contrast/agent/protect/rule/sqli.rb +0 -101
  575. data/lib/contrast/agent/protect/rule/unsafe_file_upload.rb +0 -20
  576. data/lib/contrast/agent/protect/rule/xss.rb +0 -24
  577. data/lib/contrast/agent/protect/rule/xxe.rb +0 -120
  578. data/lib/contrast/agent/railtie.rb +0 -36
  579. data/lib/contrast/agent/reaction_processor.rb +0 -47
  580. data/lib/contrast/agent/request.rb +0 -475
  581. data/lib/contrast/agent/request_context.rb +0 -225
  582. data/lib/contrast/agent/require_state.rb +0 -61
  583. data/lib/contrast/agent/response.rb +0 -215
  584. data/lib/contrast/agent/rewriter.rb +0 -245
  585. data/lib/contrast/agent/scope.rb +0 -125
  586. data/lib/contrast/agent/service_heartbeat.rb +0 -40
  587. data/lib/contrast/agent/settings_state.rb +0 -152
  588. data/lib/contrast/agent/socket_client.rb +0 -128
  589. data/lib/contrast/agent/tracepoint_hook.rb +0 -51
  590. data/lib/contrast/api/connection_status.rb +0 -49
  591. data/lib/contrast/api/dtm_pb.rb +0 -718
  592. data/lib/contrast/api/settings_pb.rb +0 -416
  593. data/lib/contrast/api/socket.rb +0 -43
  594. data/lib/contrast/api/speedracer.rb +0 -186
  595. data/lib/contrast/api/tcp_socket.rb +0 -31
  596. data/lib/contrast/api/unix_socket.rb +0 -25
  597. data/lib/contrast/api.rb +0 -18
  598. data/lib/contrast/common_agent_configuration.rb +0 -86
  599. data/lib/contrast/components/contrast_service.rb +0 -117
  600. data/lib/contrast/components/interface.rb +0 -178
  601. data/lib/contrast/config/agent_configuration.rb +0 -24
  602. data/lib/contrast/config/application_configuration.rb +0 -27
  603. data/lib/contrast/config/assess_configuration.rb +0 -22
  604. data/lib/contrast/config/assess_rules_configuration.rb +0 -18
  605. data/lib/contrast/config/default_value.rb +0 -16
  606. data/lib/contrast/config/heap_dump_configuration.rb +0 -23
  607. data/lib/contrast/config/inventory_configuration.rb +0 -20
  608. data/lib/contrast/config/logger_configuration.rb +0 -20
  609. data/lib/contrast/config/protect_configuration.rb +0 -20
  610. data/lib/contrast/config/root_configuration.rb +0 -26
  611. data/lib/contrast/config/ruby_configuration.rb +0 -44
  612. data/lib/contrast/config/sampling_configuration.rb +0 -22
  613. data/lib/contrast/config/service_configuration.rb +0 -22
  614. data/lib/contrast/delegators/application_update.rb +0 -32
  615. data/lib/contrast/delegators.rb +0 -9
  616. data/lib/contrast/extensions/framework/rack/cookie.rb +0 -24
  617. data/lib/contrast/extensions/framework/rack/request.rb +0 -24
  618. data/lib/contrast/extensions/framework/rack/response.rb +0 -23
  619. data/lib/contrast/extensions/framework/rails/action_controller_railties_helper_inherited.rb +0 -20
  620. data/lib/contrast/extensions/framework/rails/active_record.rb +0 -26
  621. data/lib/contrast/extensions/framework/rails/active_record_named.rb +0 -53
  622. data/lib/contrast/extensions/framework/rails/active_record_time_zone_inherited.rb +0 -21
  623. data/lib/contrast/extensions/framework/rails/buffer.rb +0 -28
  624. data/lib/contrast/extensions/framework/rails/configuration.rb +0 -27
  625. data/lib/contrast/extensions/framework/sinatra/base.rb +0 -59
  626. data/lib/contrast/extensions/ruby_core/assess/array.rb +0 -59
  627. data/lib/contrast/extensions/ruby_core/assess/assess_extension.rb +0 -143
  628. data/lib/contrast/extensions/ruby_core/assess/basic_object.rb +0 -15
  629. data/lib/contrast/extensions/ruby_core/assess/erb.rb +0 -42
  630. data/lib/contrast/extensions/ruby_core/assess/fiber.rb +0 -124
  631. data/lib/contrast/extensions/ruby_core/assess/hash.rb +0 -22
  632. data/lib/contrast/extensions/ruby_core/assess/kernel.rb +0 -95
  633. data/lib/contrast/extensions/ruby_core/assess/module.rb +0 -14
  634. data/lib/contrast/extensions/ruby_core/assess/regexp.rb +0 -206
  635. data/lib/contrast/extensions/ruby_core/assess/string.rb +0 -75
  636. data/lib/contrast/extensions/ruby_core/assess/tilt_template_trigger.rb +0 -73
  637. data/lib/contrast/extensions/ruby_core/assess/xpath_library_trigger.rb +0 -40
  638. data/lib/contrast/extensions/ruby_core/assess.rb +0 -52
  639. data/lib/contrast/extensions/ruby_core/eval_trigger.rb +0 -52
  640. data/lib/contrast/extensions/ruby_core/inventory/datastores.rb +0 -37
  641. data/lib/contrast/extensions/ruby_core/inventory.rb +0 -22
  642. data/lib/contrast/extensions/ruby_core/protect/applies_command_injection_rule.rb +0 -72
  643. data/lib/contrast/extensions/ruby_core/protect/applies_deserialization_rule.rb +0 -60
  644. data/lib/contrast/extensions/ruby_core/protect/applies_no_sqli_rule.rb +0 -83
  645. data/lib/contrast/extensions/ruby_core/protect/applies_path_traversal_rule.rb +0 -123
  646. data/lib/contrast/extensions/ruby_core/protect/applies_sqli_rule.rb +0 -65
  647. data/lib/contrast/extensions/ruby_core/protect/applies_xxe_rule.rb +0 -143
  648. data/lib/contrast/extensions/ruby_core/protect/kernel.rb +0 -30
  649. data/lib/contrast/extensions/ruby_core/protect/psych.rb +0 -7
  650. data/lib/contrast/extensions/ruby_core/thread.rb +0 -31
  651. data/lib/contrast/framework/platform_version.rb +0 -21
  652. data/lib/contrast/framework/rails_support.rb +0 -88
  653. data/lib/contrast/framework/sinatra_application_helper.rb +0 -49
  654. data/lib/contrast/framework/sinatra_support.rb +0 -94
  655. data/lib/contrast/framework/view_technologies_descriptor.rb +0 -20
  656. data/lib/contrast/internal_exception.rb +0 -8
  657. data/lib/contrast/tasks/service.rb +0 -95
  658. data/lib/contrast/utils/boolean_util.rb +0 -33
  659. data/lib/contrast/utils/cache.rb +0 -69
  660. data/lib/contrast/utils/comment_range.rb +0 -19
  661. data/lib/contrast/utils/data_store_util.rb +0 -23
  662. data/lib/contrast/utils/environment_util.rb +0 -82
  663. data/lib/contrast/utils/freeze_util.rb +0 -32
  664. data/lib/contrast/utils/gemfile_reader.rb +0 -191
  665. data/lib/contrast/utils/inventory_util.rb +0 -126
  666. data/lib/contrast/utils/performs_logging.rb +0 -152
  667. data/lib/contrast/utils/preflight_util.rb +0 -13
  668. data/lib/contrast/utils/prevent_serialization.rb +0 -52
  669. data/lib/contrast/utils/rack_assess_session_cookie.rb +0 -104
  670. data/lib/contrast/utils/rails_assess_configuration.rb +0 -95
  671. data/lib/contrast/utils/random_util.rb +0 -22
  672. data/lib/contrast/utils/ruby_ast_rewriter.rb +0 -74
  673. data/lib/contrast/utils/service_response_util.rb +0 -110
  674. data/lib/contrast/utils/service_sender_util.rb +0 -106
  675. data/lib/contrast/utils/sinatra_helper.rb +0 -55
  676. data/resources/csrf/inject.js +0 -44
  677. data/resources/factory-bot-spec/spec_helper.rb +0 -30
  678. data/resources/rubocops/kernel/catch_cop.rb +0 -37
  679. data/resources/rubocops/kernel/require_cop.rb +0 -37
  680. data/resources/rubocops/kernel/require_relative_cop.rb +0 -33
  681. data/resources/rubocops/module/autoload_cop.rb +0 -37
  682. data/resources/rubocops/module/const_defined_cop.rb +0 -37
  683. data/resources/rubocops/module/const_get_cop.rb +0 -37
  684. data/resources/rubocops/module/const_set_cop.rb +0 -37
  685. data/resources/rubocops/module/constants_cop.rb +0 -37
  686. data/resources/rubocops/module/name_cop.rb +0 -37
  687. data/resources/rubocops/object/class_cop.rb +0 -37
  688. data/resources/rubocops/object/freeze_cop.rb +0 -37
  689. data/resources/rubocops/object/frozen_cop.rb +0 -37
  690. data/resources/rubocops/object/is_a_cop.rb +0 -37
  691. data/resources/rubocops/object/method_cop.rb +0 -37
  692. data/resources/rubocops/object/respond_to_cop.rb +0 -37
  693. data/resources/rubocops/object/singleton_class_cop.rb +0 -37
  694. data/resources/rubocops/regexp/spelling_cop.rb +0 -44
  695. data/resources/rubocops/thread/new_cop.rb +0 -39
  696. data/resources/ruby-spec/ancestors_spec.rb +0 -70
  697. data/resources/ruby-spec/modulo_spec.rb +0 -831
  698. data/resources/ruby-spec/parameters_spec.rb +0 -261
  699. data/resources/ruby-spec/ruby_spec_spec_helper.rb +0 -35
  700. data/service_executables/.gitkeep +0 -0
  701. data/service_executables/VERSION +0 -1
  702. data/service_executables/linux/contrast-service +0 -0
  703. data/service_executables/mac/contrast-service +0 -0
  704. data/shared_libraries/funchook.h +0 -123
  705. data/shared_libraries/libfunchook.so +0 -0
@@ -0,0 +1,980 @@
1
+ /* Copyright (c) 2023 Contrast Security, Inc. See
2
+ * https://www.contrastsecurity.com/enduser-terms-0317a for more details. */
3
+
4
+ #include "cs__scope.h"
5
+ #include "../cs__common/cs__common.h"
6
+ #include <ruby.h>
7
+ #include <stdlib.h>
8
+
9
+ /*-----------------------------------------
10
+ | Calls to Contrast modules and classes
11
+ ------------------------------------------*/
12
+
13
+ VALUE contrast, agent, components;
14
+ VALUE scope_interface, scope_inst_methods;
15
+ VALUE scope_mod, scope_klass;
16
+
17
+ /*---------
18
+ | Arrays
19
+ ----------*/
20
+ static char truthy_arr[3][5] = {"true", "True", "TRUE"};
21
+
22
+ /*----------
23
+ | Helpers
24
+ -----------*/
25
+
26
+ /**
27
+ * @brief get scope for ec or create new
28
+ *
29
+ * @note [Ruby definition] EXECUTION_CONTEXT[Fiber.current] ||=
30
+ * Contrast::Agent::Scope.new
31
+ *
32
+ * @return VALUE [Contrast::Agent::Scope]
33
+ */
34
+ VALUE get_ec() {
35
+ VALUE ec, scope_inst, new_inst, keys, fiber;
36
+
37
+ ec = rb_const_get(scope_mod, rb_intern(rb_const_ec));
38
+ scope_inst = rb_hash_aref(ec, rb_fiber_current());
39
+ keys = rb_const_get(scope_mod, rb_intern(rb_const_ec_keys));
40
+ fiber = rb_fiber_current();
41
+
42
+ if (RB_TYPE_P(scope_inst, T_NIL)) {
43
+ new_inst = rb_new_c_scope();
44
+ rb_ary_push(keys, fiber);
45
+ rb_hash_aset(ec, fiber, new_inst);
46
+ return new_inst;
47
+ } else {
48
+ return scope_inst;
49
+ }
50
+ }
51
+
52
+ /**
53
+ * @brief create new Scope class instance
54
+ *
55
+ * @return VALUE [Contrast::Agent::Scope]
56
+ */
57
+ VALUE rb_new_c_scope() {
58
+ return rb_class_new_instance(0, 0, scope_klass);
59
+ }
60
+
61
+ /**
62
+ * @brief Increases scope value by 1.
63
+ *
64
+ * @param scope int
65
+ * @return int
66
+ */
67
+ int scope_increase(int scope) {
68
+ int inc = scope;
69
+ inc = inc + 1;
70
+
71
+ return INT2FIX(inc);
72
+ }
73
+
74
+ /**
75
+ * @brief Decreases scope value by 1.
76
+ *
77
+ * @param scope int
78
+ * @return int
79
+ */
80
+ int scope_decrease(int scope) {
81
+ int inc = scope;
82
+ inc = inc - 1;
83
+
84
+ return INT2FIX(inc);
85
+ }
86
+
87
+ /**
88
+ * @brief returns Qfalse or Qtrue if is in defined scope
89
+ *
90
+ * @param scope int
91
+ * @return VALUE
92
+ */
93
+ VALUE is_in_scope(int scope) {
94
+ if (scope > 0) {
95
+ return Qtrue;
96
+ } else if (scope <= 0) {
97
+ return Qfalse;
98
+ }
99
+ }
100
+
101
+ /**
102
+ * @error: raise NoMethodError, "Scope '#{ name.inspect }' is not registered as
103
+ * a scope."
104
+ */
105
+ void rb_raise_scope_no_method_err(const VALUE method_scope_sym) {
106
+ rb_raise(rb_eNoMethodError,
107
+ "Scope ':%" PRIsVALUE "' is not registered as a scope.",
108
+ rb_sym_to_s(method_scope_sym));
109
+ }
110
+
111
+ /*---------------------------------
112
+ | @class Contrast::Agent::Scope
113
+ ----------------------------------*/
114
+
115
+ /**
116
+ * @brief sets scope instance variables.
117
+ *
118
+ * @param self VALUE
119
+ * @param args VALUE
120
+ * @return VALUE self
121
+ *
122
+ * @note def initialize
123
+ * @contrast_scope = 0
124
+ * @deserialization_scope = 0
125
+ * @split_scope = 0
126
+ * end
127
+ */
128
+ VALUE contrast_scope_klass_init(VALUE self, VALUE args) {
129
+ rb_iv_set(self, rb_iv_cntr_scope, contrast_scope_application_update());
130
+ rb_iv_set(self, rb_iv_dslr_scope, INT2FIX(0));
131
+ rb_iv_set(self, rb_iv_split_scope, INT2FIX(0));
132
+
133
+ return self;
134
+ }
135
+
136
+ /**
137
+ * @brief This function will determine if the Application Scope flag is set.
138
+ * If the value set is not valid the Contrast Scope with start with 0.
139
+ * If the value is validated, then the Contrast Scope will be set to 1.
140
+ * If the value is nil the Contrast Scope will be set as default => 0.
141
+ *
142
+ * To be valid app scope must be one of the truthy_arr: ["true", "True", "TRUE",
143
+ * "1"]
144
+ */
145
+ VALUE contrast_scope_application_update() {
146
+ /**
147
+ * ENV variables are null-terminated strings.
148
+ *
149
+ * getenv() returns a pointer to a string within the environment list.
150
+ * The caller must take care not to modify this string,
151
+ * since that would change the environment of the process.
152
+ *
153
+ * [ Do not touch, do not free. We don't control it! ]
154
+ */
155
+ char *eVar = getenv(c_const_ctr_agent_app_scope);
156
+ VALUE app_scope = eVar;
157
+
158
+ /* check to see if the ENV variable is set */
159
+ if (RTEST(app_scope)) {
160
+ /* Application Scope is set*/
161
+ int i;
162
+ for (i = 0; i < sizeof(truthy_arr) / sizeof(truthy_arr[0]); i++) {
163
+ if (strcmp(eVar, truthy_arr[i]) == 0) {
164
+ return INT2FIX(1);
165
+ }
166
+ }
167
+ /* this covers all of the false values */
168
+ return INT2FIX(0);
169
+ } else {
170
+ /* Application Scope is not set ( NULL )*/
171
+ return INT2FIX(0);
172
+ }
173
+ }
174
+
175
+ /**
176
+ * @brief Check if we are in contrast scope.
177
+ * @note @method in_contrast_scope?
178
+ * @param self VALUE
179
+ * @param args VALUE
180
+ * @return VALUE [Boolean] check if we are in contrast scope
181
+ * if the scope is above 0 return true.
182
+ *
183
+ * @note def in_contrast_scope?
184
+ * @contrast_scope.positive?
185
+ * end
186
+ */
187
+ VALUE in_cntr_scope(VALUE self, VALUE args) {
188
+ return is_in_scope(FIX2INT(rb_iv_get(self, rb_iv_cntr_scope)));
189
+ }
190
+
191
+ /**
192
+ * @brief Enters contrast scope.
193
+ *
194
+ * @param self VALUE
195
+ * @param args VALUE
196
+ * @return VALUE [Integer] contrast scope increased.
197
+ *
198
+ * @note def enter_contrast_scope!
199
+ * @contrast_scope += 1
200
+ * end
201
+ */
202
+ VALUE enter_cntr_scope(VALUE self, VALUE args) {
203
+ int scope = FIX2INT(rb_iv_get(self, rb_iv_cntr_scope));
204
+ rb_iv_set(self, rb_iv_cntr_scope, scope_increase(scope));
205
+
206
+ return rb_iv_get(self, rb_iv_cntr_scope);
207
+ }
208
+
209
+ /**
210
+ * @brief Exits contrast scope.
211
+ *
212
+ * @param self VALUE
213
+ * @param args VALUE
214
+ * @return VALUE [Integer] contrast scope decreased.
215
+ *
216
+ * @note def exit_contrast_scope!
217
+ * @contrast_scope -= 1
218
+ * end
219
+ */
220
+ VALUE exit_cntr_scope(VALUE self, VALUE args) {
221
+ int scope = FIX2INT(rb_iv_get(self, rb_iv_cntr_scope));
222
+ rb_iv_set(self, rb_iv_cntr_scope, scope_decrease(scope));
223
+
224
+ return rb_iv_get(self, rb_iv_cntr_scope);
225
+ }
226
+
227
+ /**
228
+ * @brief Check if we are in deserialization scope.
229
+ *
230
+ * @param self VALUE
231
+ * @param args VALUE
232
+ * @return VALUE [Boolean] check if we are in deserialization scope
233
+ * if the scope is above 0 return true.
234
+ *
235
+ * @note def in_deserialization_scope?
236
+ * @deserialization_scope.positive?
237
+ * end
238
+ */
239
+ VALUE in_dslr_scope(VALUE self, VALUE args) {
240
+ return is_in_scope(FIX2INT(rb_iv_get(self, rb_iv_dslr_scope)));
241
+ }
242
+
243
+ /**
244
+ * @brief Enters deserialization scope.
245
+ *
246
+ * @param self VALUE
247
+ * @param args VALUE
248
+ * @return VALUE [Integer] deserialization scope increased.
249
+ *
250
+ * @note def enter_deserialization_scope!
251
+ * @deserialization_scope += 1
252
+ * end
253
+ */
254
+ VALUE enter_dsrl_scope(VALUE self, VALUE args) {
255
+ int scope = FIX2INT(rb_iv_get(self, rb_iv_dslr_scope));
256
+ rb_iv_set(self, rb_iv_dslr_scope, scope_increase(scope));
257
+
258
+ return rb_iv_get(self, rb_iv_dslr_scope);
259
+ }
260
+
261
+ /**
262
+ * @brief Exits deserialization scope.
263
+ *
264
+ * @param self VALUE
265
+ * @param args VALUE
266
+ * @return VALUE [Integer] deserialization scope decreased.
267
+ *
268
+ * @note def enter_deserialization_scope!
269
+ * @deserialization_scope += 1
270
+ * end
271
+
272
+ */
273
+ VALUE exit_dsrl_scope(VALUE self, VALUE args) {
274
+ int scope = FIX2INT(rb_iv_get(self, rb_iv_dslr_scope));
275
+ rb_iv_set(self, rb_iv_dslr_scope, scope_decrease(scope));
276
+
277
+ return rb_iv_get(self, rb_iv_dslr_scope);
278
+ }
279
+
280
+ /**
281
+ * @brief Check if we are in split scope.
282
+ *
283
+ * @param self VALUE
284
+ * @param args VALUE
285
+ * @return VALUE [Boolean] check if we are in split scope
286
+ * if the scope is above 0 return true.
287
+ *
288
+ * @note def in_split_scope?
289
+ * @split_scope.positive?
290
+ * end
291
+ */
292
+ VALUE in_split_scope(VALUE self, VALUE args) {
293
+ return is_in_scope(FIX2INT(rb_iv_get(self, rb_iv_split_scope)));
294
+ }
295
+
296
+ /**
297
+ * @brief Enters split scope.
298
+ *
299
+ * @param self VALUE
300
+ * @param args VALUE
301
+ * @return VALUE [Integer] split scope increased.
302
+ *
303
+ * @note def enter_split_scope!
304
+ * @split_scope += 1
305
+ * end
306
+ */
307
+ VALUE enter_split_scope(VALUE self, VALUE args) {
308
+ int scope = FIX2INT(rb_iv_get(self, rb_iv_split_scope));
309
+ rb_iv_set(self, rb_iv_split_scope, scope_increase(scope));
310
+
311
+ return rb_iv_get(self, rb_iv_split_scope);
312
+ }
313
+
314
+ /**
315
+ * @brief Exits split scope.
316
+ *
317
+ * @param self VALUE
318
+ * @param args VALUE
319
+ * @return VALUE [Integer] split scope decreased.
320
+ *
321
+ * @note def enter_split_scope!
322
+ * @split_scope -= 1
323
+ * end
324
+ */
325
+ VALUE exit_split_scope(VALUE self, VALUE args) {
326
+ int scope = FIX2INT(rb_iv_get(self, rb_iv_split_scope));
327
+ rb_iv_set(self, rb_iv_split_scope, scope_decrease(scope));
328
+
329
+ return rb_iv_get(self, rb_iv_split_scope);
330
+ }
331
+
332
+ /**
333
+ * @brief Returns split scope current depth.
334
+ *
335
+ * @param self VALUE
336
+ * @param args VALUE
337
+ * @return VALUE [Integer]
338
+ *
339
+ * @note def split_scope_depth
340
+ * @split_scope
341
+ * end
342
+ */
343
+ VALUE split_scope_depth(VALUE self, VALUE args) {
344
+ return rb_iv_get(self, rb_iv_split_scope);
345
+ }
346
+
347
+ /**
348
+ * Static methods to be used, the cases are defined by the usage from the above
349
+ * methods if more methods are added - please extend the case statements as they
350
+ * are no longed dynamic.
351
+ */
352
+
353
+ /**
354
+ * @brief Check if we are in specific scope.
355
+ *
356
+ * @param self VALUE
357
+ * @param method_scope_sym VALUE [Symbol] scope symbol representing scope to
358
+ * check.
359
+ * @return VALUE [Boolean] check if we are in passed scope.
360
+ * @error: NoMethodError
361
+ *
362
+ * @note def in_scope? name
363
+ * case name
364
+ * when :contrast
365
+ * in_contrast_scope?
366
+ * when :deserialization
367
+ * in_deserialization_scope?
368
+ * when :split
369
+ * in_split_scope?
370
+ * else
371
+ * raise NoMethodError, "Scope '#{ name.inspect }' is not registered
372
+ * as a scope." end end
373
+ */
374
+ VALUE scope_klass_in_scope(VALUE self, VALUE method_scope_sym) {
375
+ VALUE in_scope = Qnil;
376
+
377
+ if (method_scope_sym == rb_sym_contrast) {
378
+ /* in_contrast_scope? */
379
+ in_scope = in_cntr_scope(self, 0);
380
+ } else if (method_scope_sym == rb_sym_deserialization) {
381
+ /* in_deserialization_scope? */
382
+ in_scope = in_dslr_scope(self, 0);
383
+ } else if (method_scope_sym == rb_sym_split) {
384
+ /* in_split_scope? */
385
+ in_scope = in_split_scope(self, 0);
386
+ } else {
387
+ rb_raise_scope_no_method_err(method_scope_sym);
388
+ }
389
+
390
+ return in_scope;
391
+ }
392
+
393
+ /**
394
+ * @brief Enters specific scope.
395
+ *
396
+ * @param self VALUE
397
+ * @param method_scope_sym VALUE [Symbol] scope symbol representing scope to
398
+ * enter.
399
+ * @return VALUE [Boolean] entered scope value increased.
400
+ *
401
+ * @note def enter_scope! name
402
+ * case name
403
+ * when :contrast
404
+ * enter_contrast_scope!
405
+ * when :deserialization
406
+ * enter_deserialization_scope!
407
+ * when :split
408
+ * enter_split_scope!
409
+ * else
410
+ * raise NoMethodError, "Scope '#{ name.inspect }' is not registered as
411
+ * a scope." end end
412
+ */
413
+ VALUE scope_klass_enter_scope(VALUE self, VALUE method_scope_sym) {
414
+ VALUE enter_scope = Qnil;
415
+
416
+ if (method_scope_sym == rb_sym_contrast) {
417
+ enter_scope = enter_cntr_scope(self, 0);
418
+ } else if (method_scope_sym == rb_sym_deserialization) {
419
+ enter_scope = enter_dsrl_scope(self, 0);
420
+ } else if (method_scope_sym == rb_sym_split) {
421
+ enter_scope = enter_split_scope(self, 0);
422
+ } else {
423
+ rb_raise_scope_no_method_err(method_scope_sym);
424
+ }
425
+
426
+ return enter_scope;
427
+ }
428
+
429
+ /**
430
+ * @brief Exits specific scope.
431
+ *
432
+ * @param self VALUE
433
+ * @param method_scope_sym VALUE [Symbol] scope symbol representing scope to
434
+ * exit.
435
+ * @return VALUE [Boolean] entered scope value decreased.
436
+ *
437
+ * @note
438
+ * def exit_scope! name
439
+ * case name
440
+ * when :contrast
441
+ * exit_contrast_scope!
442
+ * when :deserialization
443
+ * exit_deserialization_scope!
444
+ * when :split
445
+ * exit_split_scope!
446
+ * else
447
+ * raise NoMethodError, "Scope '#{ name.inspect }' is not registered as a
448
+ * scope." end end
449
+ */
450
+ VALUE scope_klass_exit_scope(VALUE self, VALUE method_scope_sym) {
451
+ VALUE exit_scope = Qnil;
452
+
453
+ if (method_scope_sym == rb_sym_contrast) {
454
+ exit_scope = exit_cntr_scope(self, 0);
455
+ } else if (method_scope_sym == rb_sym_deserialization) {
456
+ exit_scope = exit_dsrl_scope(self, 0);
457
+ } else if (method_scope_sym == rb_sym_split) {
458
+ exit_scope = exit_split_scope(self, 0);
459
+ } else {
460
+ rb_raise_scope_no_method_err(method_scope_sym);
461
+ }
462
+
463
+ return exit_scope;
464
+ }
465
+
466
+ /*-----------------------------------------
467
+ | @class Contrast::Components::Interface
468
+ ------------------------------------------*/
469
+
470
+ /**
471
+ * @brief init set new scope for current fiber
472
+ *
473
+ * @param self VALUE
474
+ * @param args VALUE
475
+ * @return VALUE [Hash<Fiber => Scope>] ec
476
+ *
477
+ * @note EXECUTION_CONTEXT[Fiber.current] = Contrast::Agent::Scope.new
478
+ */
479
+ VALUE contrast_scope_interface_init(VALUE self, VALUE args) {
480
+ VALUE ec = rb_const_get(scope_mod, rb_intern(rb_const_ec));
481
+ rb_hash_aset(ec, rb_fiber_current(), rb_new_c_scope());
482
+
483
+ return ec;
484
+ }
485
+
486
+ /**
487
+ * @brief This returns the scope governing the current execution context. Use
488
+ * this sparingly, preferring the instance & class methods to access and query
489
+ * scope, rather than interacting with the scope object directly.
490
+ *
491
+ * Alternative to Monitor => mutex.synchronize
492
+ * rb_mutex_new(void)
493
+ * rb_mutex_synchronize (VALUE mutex, VALUE(*func)(VALUE arg), VALUE arg)
494
+ * Mutex.synchronize do ... end goes here:
495
+ *
496
+ * @param self VALUE
497
+ * @param args VALUE
498
+ * @return VALUE
499
+ *
500
+ * @note def scope_for_current_ec
501
+ * MONITOR.synchronize do
502
+ * return EXECUTION_CONTEXT[Fiber.current] ||=
503
+ * Contrast::Agent::Scope.new end end
504
+ */
505
+ VALUE contrast_scope_for_current_ec(VALUE self, VALUE args) {
506
+ /* synchronize */
507
+ VALUE mutex = rb_const_get(scope_mod, rb_intern(rb_const_mon));
508
+
509
+ return rb_mutex_synchronize(mutex, get_ec, 0);
510
+ }
511
+
512
+ /*--------------------------------------------------------
513
+ | @module Contrast::Components::Scope::InstanceMethods
514
+ ---------------------------------------------------------*/
515
+
516
+ /**
517
+ * @brief Iterates over the method policy's scopes and enters in each one.
518
+ *
519
+ * @param self VALUE
520
+ * @param scopes_to_enter VALUE [Array<Symbol>] Scopes form
521
+ * method_policy#scopes_to_enter for the scope current method policy
522
+ * @return VALUE [Array<Symbol>] scopes_to_enter
523
+ *
524
+ * @note def enter_method_scope! scopes_to_enter
525
+ * scopes_to_enter.each do |scope|
526
+ * enter_scope!(scope)
527
+ * end
528
+ * end
529
+ */
530
+ VALUE inst_methods_enter_method_scope(VALUE self, VALUE scopes_to_enter) {
531
+ VALUE scopes_ary, scope;
532
+
533
+ scopes_ary = rb_ary_dup(scopes_to_enter);
534
+ scope = rb_ary_pop(scopes_ary);
535
+
536
+ while (!RB_TYPE_P(scope, T_NIL)) {
537
+ inst_methods_enter_scope(self, scope);
538
+ scope = rb_ary_pop(scopes_ary);
539
+ }
540
+
541
+ return scopes_to_enter;
542
+ }
543
+
544
+ /**
545
+ * @brief Iterates over the method policy's scopes and exits each one.
546
+ *
547
+ * @param self VALUE
548
+ * @param scopes_to_exit VALUE [Array<Symbol>] Scopes form
549
+ * method_policy#scopes_to_exit for the scope current method policy
550
+ * @return VALUE [Array<Symbol>] scopes_to_exit
551
+ *
552
+ * @note def enter_method_scope! scopes_to_exit
553
+ * scopes_to_exit.each do |scope|
554
+ * enter_scope!(scope)
555
+ * end
556
+ * end
557
+ */
558
+ VALUE inst_methods_exit_method_scope(VALUE self, VALUE scopes_to_exit) {
559
+ VALUE scopes_ary, scope;
560
+
561
+ scopes_ary = rb_ary_dup(scopes_to_exit);
562
+ scope = rb_ary_pop(scopes_ary);
563
+
564
+ while (!RB_TYPE_P(scope, T_NIL)) {
565
+ inst_methods_exit_scope(self, scope);
566
+ scope = rb_ary_pop(scopes_ary);
567
+ }
568
+
569
+ return scopes_to_exit;
570
+ }
571
+
572
+ /**
573
+ * For the InstanceMethods we need to call all the scope methods from the
574
+ * current ec context All methods bellow are with same names as
575
+ * Contrast::Agent::Scope class with the difference that they act as forwarders:
576
+ * def in_contrast_scope?
577
+ * scope_for_current_ec.in_contrast_scope?
578
+ * end
579
+ */
580
+
581
+ /**
582
+ * @brief scope_for_current_ec.in_contrast_scope?
583
+ *
584
+ * @param self VALUE
585
+ * @param args VALUE
586
+ * @return VALUE
587
+ */
588
+ VALUE inst_methods_in_cntr_scope(VALUE self, VALUE args) {
589
+ return is_in_scope(FIX2INT(
590
+ rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_cntr_scope)));
591
+ }
592
+
593
+ /**
594
+ * @brief scope_for_current_ec.enter_contrast_scope!
595
+ *
596
+ * @param self VALUE
597
+ * @param args VALUE
598
+ * @return VALUE
599
+ */
600
+ VALUE inst_methods_enter_cntr_scope(VALUE self, VALUE args) {
601
+ int scope = FIX2INT(
602
+ rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_cntr_scope));
603
+ rb_iv_set(contrast_scope_for_current_ec(self, 0), rb_iv_cntr_scope,
604
+ scope_increase(scope));
605
+
606
+ return rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_cntr_scope);
607
+ }
608
+
609
+ /**
610
+ * @brief scope_for_current_ec.exit_contrast_scope!
611
+ *
612
+ * @param self VALUE
613
+ * @param args VALUE
614
+ * @return VALUE
615
+ */
616
+ VALUE inst_methods_exit_cntr_scope(VALUE self, VALUE args) {
617
+ int scope = FIX2INT(
618
+ rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_cntr_scope));
619
+ rb_iv_set(contrast_scope_for_current_ec(self, 0), rb_iv_cntr_scope,
620
+ scope_decrease(scope));
621
+
622
+ return rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_cntr_scope);
623
+ }
624
+
625
+ /**
626
+ * @brief scope_for_current_ec.in_split_scope?
627
+ *
628
+ * @param self VALUE
629
+ * @param args VALUE
630
+ * @return VALUE
631
+ */
632
+ VALUE inst_methods_in_split_scope(VALUE self, VALUE args) {
633
+ return is_in_scope(FIX2INT(
634
+ rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_split_scope)));
635
+ }
636
+
637
+ /**
638
+ * @brief scope_for_current_ec.enter_split_scope!
639
+ *
640
+ * @param self VALUE
641
+ * @param args VALUE
642
+ * @return VALUE
643
+ */
644
+ VALUE inst_methods_enter_split_scope(VALUE self, VALUE args) {
645
+ int scope = FIX2INT(
646
+ rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_split_scope));
647
+
648
+ return rb_iv_set(contrast_scope_for_current_ec(self, 0), rb_iv_split_scope,
649
+ scope_increase(scope));
650
+ }
651
+
652
+ /**
653
+ * @brief scope_for_current_ec.exit_split_scope!
654
+ *
655
+ * @param self VALUE
656
+ * @param args VALUE
657
+ * @return VALUE
658
+ */
659
+ VALUE inst_methods_exit_split_scope(VALUE self, VALUE args) {
660
+ int scope = FIX2INT(
661
+ rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_split_scope));
662
+ rb_iv_set(contrast_scope_for_current_ec(self, 0), rb_iv_split_scope,
663
+ scope_decrease(scope));
664
+
665
+ return rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_split_scope);
666
+ }
667
+
668
+ /**
669
+ * @brief Get Deserialization scope iv.
670
+ *
671
+ * @param self
672
+ * @param args
673
+ * @return VALUE
674
+ */
675
+ VALUE inst_methods_split_scope_depth(VALUE self, VALUE args) {
676
+ return rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_split_scope);
677
+ }
678
+
679
+ /**
680
+ * @brief scope_for_current_ec.in_deserialization_scope?
681
+ *
682
+ * @param self VALUE
683
+ * @param args VALUE
684
+ * @return VALUE
685
+ */
686
+ VALUE inst_methods_in_dsrl_scope(VALUE self, VALUE args) {
687
+ return is_in_scope(FIX2INT(
688
+ rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_dslr_scope)));
689
+ }
690
+
691
+ /**
692
+ * @brief scope_for_current_ec.enter_deserialization_scope!
693
+ *
694
+ * @param self VALUE
695
+ * @param args VALUE
696
+ * @return VALUE
697
+ */
698
+ VALUE inst_methods_enter_dsrl_scope(VALUE self, VALUE args) {
699
+ int scope = FIX2INT(
700
+ rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_dslr_scope));
701
+ rb_iv_set(contrast_scope_for_current_ec(self, 0), rb_iv_dslr_scope,
702
+ scope_increase(scope));
703
+
704
+ return rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_dslr_scope);
705
+ }
706
+
707
+ /**
708
+ * @brief scope_for_current_ec.exit_deserialization_scope!
709
+ *
710
+ * @param self VALUE
711
+ * @param args VALUE
712
+ * @return VALUE
713
+ */
714
+ VALUE inst_methods_exit_dsrl_scope(VALUE self, VALUE args) {
715
+ int scope = FIX2INT(
716
+ rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_dslr_scope));
717
+ rb_iv_set(contrast_scope_for_current_ec(self, 0), rb_iv_dslr_scope,
718
+ scope_decrease(scope));
719
+
720
+ return rb_iv_get(contrast_scope_for_current_ec(self, 0), rb_iv_dslr_scope);
721
+ }
722
+
723
+ /**
724
+ * @brief Check to see if we are in scope by parameter symbol passed. Raises
725
+ * error if symbol is not valid.
726
+ *
727
+ * @param self VALUE
728
+ * @param method_scope_sym VALUE [Symbol]
729
+ * @error: rb_raise_scope_no_method_err [NoMethodError]
730
+ * @return VALUE
731
+ */
732
+ VALUE inst_methods_in_scope(VALUE self, VALUE method_scope_sym) {
733
+ if (method_scope_sym == rb_sym_contrast) {
734
+ inst_methods_in_cntr_scope(self, 0);
735
+ } else if (method_scope_sym == rb_sym_deserialization) {
736
+ inst_methods_in_dsrl_scope(self, 0);
737
+ } else if (method_scope_sym == rb_sym_split) {
738
+ inst_methods_in_split_scope(self, 0);
739
+ } else {
740
+ rb_raise_scope_no_method_err(method_scope_sym);
741
+ }
742
+ }
743
+
744
+ /**
745
+ * @brief Enters scope by parameter symbol passed. Raises error if symbol is not
746
+ * valid.
747
+ *
748
+ * @param self VALUE
749
+ * @param method_scope_sym VALUE [Symbol]
750
+ * @error: rb_raise_scope_no_method_err [NoMethodError]
751
+ * @return VALUE
752
+ */
753
+ VALUE inst_methods_enter_scope(VALUE self, VALUE method_scope_sym) {
754
+ if (method_scope_sym == rb_sym_contrast) {
755
+ inst_methods_enter_cntr_scope(self, 0);
756
+ } else if (method_scope_sym == rb_sym_deserialization) {
757
+ inst_methods_enter_dsrl_scope(self, 0);
758
+ } else if (method_scope_sym == rb_sym_split) {
759
+ inst_methods_enter_split_scope(self, 0);
760
+ } else {
761
+ rb_raise_scope_no_method_err(method_scope_sym);
762
+ }
763
+ }
764
+
765
+ /**
766
+ * @brief Exits scope by parameter symbol passed. Raises error if symbol is not
767
+ * valid.
768
+ *
769
+ * @param self VALUE
770
+ * @param method_scope_sym VALUE [Symbol]
771
+ * @error: rb_raise_scope_no_method_err [NoMethodError]
772
+ * @return VALUE
773
+ */
774
+ VALUE inst_methods_exit_scope(VALUE self, VALUE method_scope_sym) {
775
+ if (method_scope_sym == rb_sym_contrast) {
776
+ inst_methods_exit_cntr_scope(self, 0);
777
+ } else if (method_scope_sym == rb_sym_deserialization) {
778
+ inst_methods_exit_dsrl_scope(self, 0);
779
+ } else if (method_scope_sym == rb_sym_split) {
780
+ inst_methods_exit_split_scope(self, 0);
781
+ } else {
782
+ rb_raise_scope_no_method_err(method_scope_sym);
783
+ }
784
+ }
785
+
786
+ /**
787
+ * @brief Sweeps and cleans any unused Execution Contexts.
788
+ * TODO: RUBY-534, #sweep_dead_ecs compensates for a lack of weak tables. when
789
+ * we can use WeakRef, we should investigate removing this call and instead use
790
+ * the WeakRef for the Execution Context's Keys or using our Finalizers Hash for
791
+ * Fibers
792
+ *
793
+ * @param self VALUE
794
+ * @param args VALUE
795
+ * @return VALUE
796
+ */
797
+ VALUE scope_mod_sweep_dead_ecs(VALUE self, VALUE args) {
798
+ VALUE mutex, ec, ec_keys, key, test;
799
+
800
+ mutex = rb_const_get(scope_mod, rb_intern(rb_const_mon));
801
+ ec = rb_const_get(scope_mod, rb_intern(rb_const_ec));
802
+ ec_keys = rb_const_get(scope_mod, rb_intern(rb_const_ec_keys));
803
+
804
+ /* Check if the key is dead (terminated fiber) and delete if true. */
805
+ int i = 0;
806
+ int size = rb_hash_size(ec_keys);
807
+
808
+ for (i = 0; i < size; ++i) {
809
+ key = rb_ary_entry(ec_keys, i);
810
+ test = key;
811
+ if (!RB_TYPE_P(key, T_NIL)) {
812
+ if (!rb_fiber_alive_p(key)) {
813
+ rb_hash_delete(ec, key);
814
+ }
815
+ }
816
+ }
817
+
818
+ return ec;
819
+ }
820
+
821
+ void Init_cs__scope() {
822
+ /* ivs */
823
+ rb_iv_cntr_scope = "@contrast_scope";
824
+ rb_iv_dslr_scope = "@deserialization_scope";
825
+ rb_iv_split_scope = "@split_scope";
826
+
827
+ /* constants */
828
+ rb_const_mon = "MONITOR";
829
+ rb_const_ec = "EXECUTION_CONTEXT";
830
+ rb_const_ec_keys = "EC_KEYS";
831
+ c_const_ctr_agent_app_scope = "CONTRAST__AGENT__RUBY__APPLICATION_SCOPE";
832
+
833
+ /* Symbols */
834
+ rb_sym_scope_mod = rb_intern("Scope");
835
+ rb_sym_contrast = ID2SYM(rb_intern("contrast"));
836
+ rb_sym_deserialization = ID2SYM(rb_intern("deserialization"));
837
+ rb_sym_split = ID2SYM(rb_intern("split"));
838
+
839
+ /* method names */
840
+ rb_method_name_init = "initialize";
841
+ rb_method_name_in_scope = "in_scope?";
842
+ rb_method_name_enter_scope = "enter_scope!";
843
+ rb_method_name_exit_scope = "exit_scope!";
844
+ rb_method_name_scope_for_current_ec = "scope_for_current_ec";
845
+ rb_method_name_in_cntr_scope = "in_contrast_scope?";
846
+ rb_method_name_enter_cntr_scope = "enter_contrast_scope!";
847
+ rb_method_name_exit_cntr_scope = "exit_contrast_scope!";
848
+ rb_method_name_in_dslr_scope = "in_deserialization_scope?";
849
+ rb_method_name_enter_dslr_scope = "enter_deserialization_scope!";
850
+ rb_method_name_exit_dslr_scope = "exit_deserialization_scope!";
851
+ rb_method_name_in_split_scope = "in_split_scope?";
852
+ rb_method_name_enter_split_scope = "enter_split_scope!";
853
+ rb_method_name_exit_split_scope = "exit_split_scope!";
854
+ rb_method_name_split_scope_depth = "split_scope_depth";
855
+
856
+ /* Define the new scope modules and objects */
857
+ contrast = rb_define_module("Contrast");
858
+ /* contrast::Agent */
859
+ agent = rb_define_module_under(contrast, "Agent");
860
+ /* components => Contrast::Components */
861
+ components = rb_define_module_under(contrast, "Components");
862
+ /* scope_mod => Contrast::Components::Scope */
863
+ scope_mod = rb_define_module_under(components, "Scope");
864
+ /* scope_interface => Contrast::Components::Scope::Interface */
865
+ scope_interface = rb_define_class_under(scope_mod, "Interface", rb_cObject);
866
+ /* scope_inst_methods => Contrast::Components::Scope::InstanceMethods */
867
+ scope_inst_methods = rb_define_module_under(scope_mod, "InstanceMethods");
868
+ /* scope_klass => Contrast::Agent::Scope */
869
+ scope_klass = rb_define_class_under(agent, "Scope", rb_cObject);
870
+
871
+ /**
872
+ * @class Contrast::Agent::Scope
873
+ */
874
+
875
+ /* Instance methods: */
876
+ rb_define_method(scope_klass, rb_method_name_init,
877
+ contrast_scope_klass_init, 0);
878
+ rb_define_method(scope_klass, rb_method_name_in_cntr_scope, in_cntr_scope,
879
+ 0);
880
+ rb_define_method(scope_klass, rb_method_name_enter_cntr_scope,
881
+ enter_cntr_scope, 0);
882
+ rb_define_method(scope_klass, rb_method_name_exit_cntr_scope,
883
+ exit_cntr_scope, 0);
884
+ rb_define_method(scope_klass, rb_method_name_in_dslr_scope, in_dslr_scope,
885
+ 0);
886
+ rb_define_method(scope_klass, rb_method_name_enter_dslr_scope,
887
+ enter_dsrl_scope, 0);
888
+ rb_define_method(scope_klass, rb_method_name_exit_dslr_scope,
889
+ exit_dsrl_scope, 0);
890
+ rb_define_method(scope_klass, rb_method_name_in_split_scope, in_split_scope,
891
+ 0);
892
+ rb_define_method(scope_klass, rb_method_name_enter_split_scope,
893
+ enter_split_scope, 0);
894
+ rb_define_method(scope_klass, rb_method_name_exit_split_scope,
895
+ exit_split_scope, 0);
896
+ rb_define_method(scope_klass, rb_method_name_split_scope_depth,
897
+ split_scope_depth, 0);
898
+ rb_define_method(scope_klass, rb_method_name_in_scope, scope_klass_in_scope,
899
+ 1);
900
+ rb_define_method(scope_klass, rb_method_name_enter_scope,
901
+ scope_klass_enter_scope, 1);
902
+ rb_define_method(scope_klass, rb_method_name_exit_scope,
903
+ scope_klass_exit_scope, 1);
904
+
905
+ /**
906
+ * @class Contrast::Components::Interface
907
+ */
908
+
909
+ /* Interface#initialize */
910
+ rb_define_method(scope_interface, rb_method_name_init,
911
+ contrast_scope_interface_init, 0);
912
+ /* Interface#scope_for_current_ec */
913
+ rb_define_method(scope_interface, rb_method_name_scope_for_current_ec,
914
+ contrast_scope_for_current_ec, 0);
915
+
916
+ /**
917
+ * @module Contrast::Components::Scope
918
+ */
919
+
920
+ /* Constants */
921
+
922
+ /* Contrast::Components::Scope::EC_KEYS */
923
+ rb_const_set(scope_mod, rb_intern(rb_const_ec_keys), rb_ary_new());
924
+ /* Contrast::Components::Scope::EXECUTION_CONTEXT => {} */
925
+ rb_define_const(scope_mod, rb_const_ec, rb_hash_new());
926
+ /* Contrast::Components::Scope::MONITOR => Mutex.new.freeze */
927
+ rb_define_const(scope_mod, rb_const_mon, rb_mutex_new());
928
+
929
+ /**
930
+ * @module Contrast::Components::Scope::InstanceMethods
931
+ */
932
+
933
+ /* InstanceMethods#scope_for_current_ec */
934
+ rb_define_method(scope_inst_methods, rb_method_name_scope_for_current_ec,
935
+ contrast_scope_for_current_ec, 0);
936
+ /* Forwarders */
937
+ rb_define_method(scope_inst_methods, rb_method_name_in_cntr_scope,
938
+ inst_methods_in_cntr_scope, 0);
939
+ rb_define_method(scope_inst_methods, rb_method_name_enter_cntr_scope,
940
+ inst_methods_enter_cntr_scope, 0);
941
+ rb_define_method(scope_inst_methods, rb_method_name_exit_cntr_scope,
942
+ inst_methods_exit_cntr_scope, 0);
943
+ rb_define_method(scope_inst_methods, rb_method_name_in_dslr_scope,
944
+ inst_methods_in_dsrl_scope, 0);
945
+ rb_define_method(scope_inst_methods, rb_method_name_enter_dslr_scope,
946
+ inst_methods_enter_dsrl_scope, 0);
947
+ rb_define_method(scope_inst_methods, rb_method_name_exit_dslr_scope,
948
+ inst_methods_exit_dsrl_scope, 0);
949
+ rb_define_method(scope_inst_methods, rb_method_name_in_split_scope,
950
+ inst_methods_in_split_scope, 0);
951
+ rb_define_method(scope_inst_methods, rb_method_name_enter_split_scope,
952
+ inst_methods_enter_split_scope, 0);
953
+ rb_define_method(scope_inst_methods, rb_method_name_exit_split_scope,
954
+ inst_methods_exit_split_scope, 0);
955
+ rb_define_method(scope_inst_methods, rb_method_name_split_scope_depth,
956
+ inst_methods_split_scope_depth, 0);
957
+ rb_define_method(scope_inst_methods, rb_method_name_in_scope,
958
+ inst_methods_in_scope, 1);
959
+ rb_define_method(scope_inst_methods, rb_method_name_enter_scope,
960
+ inst_methods_enter_scope, 1);
961
+ rb_define_method(scope_inst_methods, rb_method_name_exit_scope,
962
+ inst_methods_exit_scope, 1);
963
+
964
+ /**
965
+ * @module Contrast::Components::Scope
966
+ */
967
+ rb_define_singleton_method(scope_mod, "sweep_dead_ecs",
968
+ scope_mod_sweep_dead_ecs, 0);
969
+ /* Contrast::Components::Scope#cs__with_app_scope? */
970
+ rb_define_singleton_method(scope_mod, "cs__with_app_scope?",
971
+ contrast_scope_application_update, 0);
972
+
973
+ /**
974
+ * @module Contrast::Components::Scope::InstanceMethods
975
+ */
976
+ rb_define_method(scope_inst_methods, "contrast_enter_method_scopes!",
977
+ inst_methods_enter_method_scope, 1);
978
+ rb_define_method(scope_inst_methods, "contrast_exit_method_scopes!",
979
+ inst_methods_exit_method_scope, 1);
980
+ }