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.
- checksums.yaml +4 -4
- data/.dockerignore +0 -1
- data/.flayignore +1 -0
- data/.gitignore +8 -5
- data/.gitmodules +0 -3
- data/.rspec +0 -1
- data/.rspec_parallel +6 -0
- data/.simplecov +6 -2
- data/Gemfile +1 -1
- data/LICENSE.txt +1 -1
- data/Rakefile +5 -2
- data/ext/build_funchook.rb +16 -13
- data/ext/cs__assess_array/cs__assess_array.c +50 -6
- data/ext/cs__assess_array/cs__assess_array.h +5 -1
- data/ext/cs__assess_array/extconf.rb +3 -0
- data/ext/cs__assess_basic_object/cs__assess_basic_object.c +39 -17
- data/ext/cs__assess_basic_object/cs__assess_basic_object.h +2 -1
- data/ext/cs__assess_basic_object/extconf.rb +3 -0
- data/ext/cs__assess_fiber_track/cs__assess_fiber_track.c +9 -13
- data/ext/cs__assess_fiber_track/cs__assess_fiber_track.h +3 -4
- data/ext/cs__assess_fiber_track/extconf.rb +3 -0
- data/ext/cs__assess_hash/cs__assess_hash.c +46 -21
- data/ext/cs__assess_hash/cs__assess_hash.h +5 -6
- data/ext/cs__assess_hash/extconf.rb +3 -0
- data/ext/cs__assess_kernel/cs__assess_kernel.c +29 -15
- data/ext/cs__assess_kernel/cs__assess_kernel.h +3 -0
- data/ext/cs__assess_kernel/extconf.rb +3 -0
- data/ext/cs__assess_marshal_module/cs__assess_marshal_module.c +57 -23
- data/ext/cs__assess_marshal_module/cs__assess_marshal_module.h +6 -3
- data/ext/cs__assess_marshal_module/extconf.rb +3 -0
- data/ext/cs__assess_module/cs__assess_module.c +82 -22
- data/ext/cs__assess_module/cs__assess_module.h +10 -0
- data/ext/cs__assess_module/extconf.rb +3 -0
- data/ext/cs__assess_regexp/cs__assess_regexp.c +28 -9
- data/ext/cs__assess_regexp/cs__assess_regexp.h +3 -0
- data/ext/cs__assess_regexp/extconf.rb +3 -0
- data/ext/cs__assess_string/cs__assess_string.c +53 -21
- data/ext/cs__assess_string/cs__assess_string.h +7 -1
- data/ext/cs__assess_string/extconf.rb +3 -0
- data/ext/cs__assess_string_interpolation/cs__assess_string_interpolation.c +39 -0
- data/ext/cs__assess_string_interpolation/cs__assess_string_interpolation.h +13 -0
- data/ext/cs__assess_string_interpolation/extconf.rb +5 -0
- data/ext/cs__assess_test/cs__assess_test.h +9 -0
- data/ext/cs__assess_test/cs__assess_tests.c +22 -0
- data/ext/cs__assess_test/extconf.rb +5 -0
- data/ext/cs__assess_yield_track/cs__assess_yield_track.c +4 -8
- data/ext/cs__assess_yield_track/cs__assess_yield_track.h +1 -2
- data/ext/cs__assess_yield_track/extconf.rb +3 -0
- data/ext/cs__common/cs__common.c +240 -4
- data/ext/cs__common/cs__common.h +68 -1
- data/ext/cs__common/extconf.rb +3 -16
- data/ext/cs__contrast_patch/cs__contrast_patch.c +162 -83
- data/ext/cs__contrast_patch/cs__contrast_patch.h +11 -15
- data/ext/cs__contrast_patch/extconf.rb +3 -0
- data/ext/cs__os_information/cs__os_information.c +34 -0
- data/ext/cs__os_information/cs__os_information.h +7 -0
- data/ext/cs__os_information/extconf.rb +5 -0
- data/ext/cs__scope/cs__scope.c +980 -0
- data/ext/cs__scope/cs__scope.h +90 -0
- data/ext/cs__scope/extconf.rb +5 -0
- data/ext/cs__tests/cs__tests.c +12 -0
- data/ext/cs__tests/cs__tests.h +3 -0
- data/ext/cs__tests/extconf.rb +5 -0
- data/ext/extconf_common.rb +4 -34
- data/lib/contrast/agent/assess/assess.rb +23 -0
- data/lib/contrast/agent/assess/contrast_object.rb +54 -0
- data/lib/contrast/agent/assess/events/event_data.rb +30 -0
- data/lib/contrast/agent/assess/finalizers/freeze.rb +15 -0
- data/lib/contrast/agent/assess/finalizers/hash.rb +107 -0
- data/lib/contrast/agent/{module_data.rb → assess/module_data.rb} +5 -4
- data/lib/contrast/agent/assess/policy/dynamic_source_factory.rb +23 -48
- data/lib/contrast/agent/assess/policy/patcher.rb +13 -48
- data/lib/contrast/agent/assess/policy/policy.rb +20 -23
- data/lib/contrast/agent/assess/policy/policy_node.rb +97 -200
- data/lib/contrast/agent/assess/policy/policy_node_utils.rb +50 -0
- data/lib/contrast/agent/assess/policy/policy_scanner.rb +15 -12
- data/lib/contrast/agent/assess/policy/preshift.rb +49 -18
- data/lib/contrast/agent/assess/policy/propagation_method.rb +200 -194
- data/lib/contrast/agent/assess/policy/propagation_node.rb +49 -41
- data/lib/contrast/agent/assess/policy/propagator/append.rb +32 -15
- data/lib/contrast/agent/assess/policy/propagator/base.rb +5 -3
- data/lib/contrast/agent/assess/policy/propagator/buffer.rb +119 -0
- data/lib/contrast/agent/assess/policy/propagator/center.rb +12 -8
- data/lib/contrast/agent/assess/policy/propagator/custom.rb +7 -3
- data/lib/contrast/agent/assess/policy/propagator/database_write.rb +33 -25
- data/lib/contrast/agent/assess/policy/propagator/insert.rb +15 -11
- data/lib/contrast/agent/assess/policy/propagator/keep.rb +23 -6
- data/lib/contrast/agent/assess/policy/propagator/match_data.rb +118 -0
- data/lib/contrast/agent/assess/policy/propagator/next.rb +7 -6
- data/lib/contrast/agent/assess/policy/propagator/prepend.rb +13 -6
- data/lib/contrast/agent/assess/policy/propagator/rack_protection.rb +73 -0
- data/lib/contrast/agent/assess/policy/propagator/remove.rb +53 -41
- data/lib/contrast/agent/assess/policy/propagator/replace.rb +5 -3
- data/lib/contrast/agent/assess/policy/propagator/reverse.rb +7 -6
- data/lib/contrast/agent/assess/policy/propagator/select.rb +45 -36
- data/lib/contrast/agent/assess/policy/propagator/splat.rb +44 -21
- data/lib/contrast/agent/assess/policy/propagator/split.rb +133 -147
- data/lib/contrast/agent/assess/policy/propagator/substitution.rb +7 -132
- data/lib/contrast/agent/assess/policy/propagator/substitution_utils.rb +190 -0
- data/lib/contrast/agent/assess/policy/propagator/trim.rb +74 -52
- data/lib/contrast/agent/assess/policy/propagator.rb +21 -18
- data/lib/contrast/agent/assess/policy/source_method.rb +126 -188
- data/lib/contrast/agent/assess/policy/source_node.rb +3 -17
- data/lib/contrast/agent/assess/policy/source_validation/cross_site_validator.rb +9 -7
- data/lib/contrast/agent/assess/policy/source_validation/source_validation.rb +3 -5
- data/lib/contrast/agent/assess/policy/trigger/reflected_xss.rb +103 -0
- data/lib/contrast/agent/assess/policy/trigger/xpath.rb +57 -0
- data/lib/contrast/agent/assess/policy/trigger_method.rb +143 -206
- data/lib/contrast/agent/assess/policy/trigger_node.rb +144 -66
- data/lib/contrast/agent/assess/policy/trigger_validation/redos_validator.rb +98 -0
- data/lib/contrast/agent/assess/policy/trigger_validation/ssrf_validator.rb +8 -38
- data/lib/contrast/agent/assess/policy/trigger_validation/trigger_validation.rb +9 -7
- data/lib/contrast/agent/assess/policy/trigger_validation/xss_validator.rb +6 -15
- data/lib/contrast/agent/assess/properties.rb +15 -383
- data/lib/contrast/agent/assess/property/evented.rb +58 -0
- data/lib/contrast/agent/assess/property/tagged.rb +246 -0
- data/lib/contrast/agent/assess/property/updated.rb +131 -0
- data/lib/contrast/agent/assess/rule/provider/hardcoded_key.rb +58 -19
- data/lib/contrast/agent/assess/rule/provider/hardcoded_password.rb +22 -17
- data/lib/contrast/agent/assess/rule/provider/hardcoded_value_rule.rb +93 -81
- data/lib/contrast/agent/assess/rule/provider.rb +4 -4
- data/lib/contrast/agent/assess/rule/response/auto_complete_rule.rb +69 -0
- data/lib/contrast/agent/assess/rule/response/base_rule.rb +121 -0
- data/lib/contrast/agent/assess/rule/response/body_rule.rb +107 -0
- data/lib/contrast/agent/assess/rule/response/cache_control_header_rule.rb +195 -0
- data/lib/contrast/agent/assess/rule/response/click_jacking_header_rule.rb +26 -0
- data/lib/contrast/agent/assess/rule/response/csp_header_insecure_rule.rb +100 -0
- data/lib/contrast/agent/assess/rule/response/csp_header_missing_rule.rb +26 -0
- data/lib/contrast/agent/assess/rule/response/framework/rails_support.rb +34 -0
- data/lib/contrast/agent/assess/rule/response/header_rule.rb +70 -0
- data/lib/contrast/agent/assess/rule/response/hsts_header_rule.rb +36 -0
- data/lib/contrast/agent/assess/rule/response/parameters_pollution_rule.rb +61 -0
- data/lib/contrast/agent/assess/rule/response/x_content_type_header_rule.rb +26 -0
- data/lib/contrast/agent/assess/rule/response/x_xss_protection_header_rule.rb +34 -0
- data/lib/contrast/agent/assess/tag.rb +84 -41
- data/lib/contrast/agent/assess/tracker.rb +70 -0
- data/lib/contrast/agent/deadzone/policy/deadzone_node.rb +11 -6
- data/lib/contrast/agent/deadzone/policy/policy.rb +11 -7
- data/lib/contrast/agent/excluder/excluder.rb +306 -0
- data/lib/contrast/agent/excluder/exclusion_matcher.rb +112 -0
- data/lib/contrast/agent/hooks/at_exit_hook.rb +44 -0
- data/lib/contrast/agent/hooks/tracepoint_hook.rb +57 -0
- data/lib/contrast/agent/inventory/database_config.rb +175 -0
- data/lib/contrast/agent/inventory/dependencies.rb +52 -0
- data/lib/contrast/agent/inventory/dependency_analysis.rb +34 -0
- data/lib/contrast/agent/inventory/dependency_usage_analysis.rb +120 -0
- data/lib/contrast/agent/inventory/inventory.rb +14 -0
- data/lib/contrast/agent/inventory/policy/datastores.rb +51 -0
- data/lib/contrast/agent/inventory/policy/policy.rb +5 -5
- data/lib/contrast/agent/inventory/policy/trigger_node.rb +2 -2
- data/lib/contrast/agent/middleware/middleware.rb +214 -0
- data/lib/contrast/agent/middleware/static_analysis.rb +51 -0
- data/lib/contrast/agent/patching/policy/after_load_patch.rb +22 -11
- data/lib/contrast/agent/patching/policy/after_load_patcher.rb +103 -52
- data/lib/contrast/agent/patching/policy/method_policy.rb +38 -62
- data/lib/contrast/agent/patching/policy/method_policy_extend.rb +117 -0
- data/lib/contrast/agent/patching/policy/module_policy.rb +27 -47
- data/lib/contrast/agent/patching/policy/patch.rb +129 -254
- data/lib/contrast/agent/patching/policy/patch_status.rb +21 -43
- data/lib/contrast/agent/patching/policy/patcher.rb +125 -159
- data/lib/contrast/agent/patching/policy/policy.rb +63 -58
- data/lib/contrast/agent/patching/policy/policy_node.rb +55 -37
- data/lib/contrast/agent/patching/policy/trigger_node.rb +32 -16
- data/lib/contrast/agent/protect/exploitable_collection.rb +38 -0
- data/lib/contrast/agent/protect/input_analyzer/input_analyzer.rb +165 -0
- data/lib/contrast/agent/protect/input_analyzer/worth_watching_analyzer.rb +122 -0
- data/lib/contrast/agent/protect/policy/applies_command_injection_rule.rb +67 -0
- data/lib/contrast/agent/protect/policy/applies_deserialization_rule.rb +97 -0
- data/lib/contrast/agent/protect/policy/applies_no_sqli_rule.rb +72 -0
- data/lib/contrast/agent/protect/policy/applies_path_traversal_rule.rb +141 -0
- data/lib/contrast/agent/protect/policy/applies_sqli_rule.rb +58 -0
- data/lib/contrast/agent/protect/policy/applies_xxe_rule.rb +125 -0
- data/lib/contrast/agent/protect/policy/policy.rb +10 -10
- data/lib/contrast/agent/protect/policy/rule_applicator.rb +119 -0
- data/lib/contrast/agent/protect/policy/trigger_node.rb +2 -2
- data/lib/contrast/agent/protect/rule/base.rb +274 -173
- data/lib/contrast/agent/protect/rule/bot_blocker/bot_blocker.rb +89 -0
- data/lib/contrast/agent/protect/rule/bot_blocker/bot_blocker_input_classification.rb +98 -0
- data/lib/contrast/agent/protect/rule/cmdi/cmd_injection.rb +86 -0
- data/lib/contrast/agent/protect/rule/cmdi/cmdi_backdoors.rb +90 -0
- data/lib/contrast/agent/protect/rule/cmdi/cmdi_base_rule.rb +170 -0
- data/lib/contrast/agent/protect/rule/cmdi/cmdi_chained_command.rb +63 -0
- data/lib/contrast/agent/protect/rule/cmdi/cmdi_dangerous_path.rb +62 -0
- data/lib/contrast/agent/protect/rule/cmdi/cmdi_input_classification.rb +27 -0
- data/lib/contrast/agent/protect/rule/default_scanner.rb +69 -25
- data/lib/contrast/agent/protect/rule/{deserialization.rb → deserialization/deserialization.rb} +29 -24
- data/lib/contrast/agent/protect/rule/no_sqli/mongo_no_sql_scanner.rb +2 -3
- data/lib/contrast/agent/protect/rule/no_sqli/no_sqli.rb +105 -0
- data/lib/contrast/agent/protect/rule/no_sqli/no_sqli_input_classification.rb +226 -0
- data/lib/contrast/agent/protect/rule/{path_traversal.rb → path_traversal/path_traversal.rb} +48 -55
- data/lib/contrast/agent/protect/rule/path_traversal/path_traversal_input_classification.rb +61 -0
- data/lib/contrast/agent/protect/rule/path_traversal/path_traversal_semantic_security_bypass.rb +139 -0
- data/lib/contrast/agent/protect/rule/sqli/default_sql_scanner.rb +1 -1
- data/lib/contrast/agent/protect/rule/sqli/mysql_sql_scanner.rb +1 -1
- data/lib/contrast/agent/protect/rule/sqli/postgres_sql_scanner.rb +2 -3
- data/lib/contrast/agent/protect/rule/sqli/sql_sample_builder.rb +154 -0
- data/lib/contrast/agent/protect/rule/sqli/sqli.rb +101 -0
- data/lib/contrast/agent/protect/rule/sqli/sqli_base_rule.rb +37 -0
- data/lib/contrast/agent/protect/rule/sqli/sqli_input_classification.rb +27 -0
- data/lib/contrast/agent/protect/rule/sqli/sqli_semantic/sqli_dangerous_functions.rb +67 -0
- data/lib/contrast/agent/protect/rule/sqli/sqlite_sql_scanner.rb +1 -1
- data/lib/contrast/agent/protect/rule/unsafe_file_upload/unsafe_file_upload.rb +56 -0
- data/lib/contrast/agent/protect/rule/unsafe_file_upload/unsafe_file_upload_input_classification.rb +62 -0
- data/lib/contrast/agent/protect/rule/utils/builders.rb +111 -0
- data/lib/contrast/agent/protect/rule/utils/filters.rb +110 -0
- data/lib/contrast/agent/protect/rule/xss/reflected_xss_input_classification.rb +58 -0
- data/lib/contrast/agent/protect/rule/xss/xss.rb +50 -0
- data/lib/contrast/agent/protect/rule/xxe/entity_wrapper.rb +25 -21
- data/lib/contrast/agent/protect/rule/xxe/xxe.rb +149 -0
- data/lib/contrast/agent/protect/rule.rb +20 -27
- data/lib/contrast/agent/reactions/disable_reaction.rb +20 -0
- data/lib/contrast/agent/reporting/attack_result/attack_result.rb +71 -0
- data/lib/contrast/agent/reporting/attack_result/rasp_rule_sample.rb +86 -0
- data/lib/contrast/agent/reporting/attack_result/response_type.rb +29 -0
- data/lib/contrast/agent/reporting/attack_result/user_input.rb +97 -0
- data/lib/contrast/agent/reporting/connection_status.rb +45 -0
- data/lib/contrast/agent/reporting/details/bot_blocker_details.rb +29 -0
- data/lib/contrast/agent/reporting/details/cmd_injection_details.rb +30 -0
- data/lib/contrast/agent/reporting/details/details.rb +17 -0
- data/lib/contrast/agent/reporting/details/ip_denylist_details.rb +35 -0
- data/lib/contrast/agent/reporting/details/no_sqli_details.rb +36 -0
- data/lib/contrast/agent/reporting/details/path_traversal_details.rb +24 -0
- data/lib/contrast/agent/reporting/details/path_traversal_semantic_analysis_details.rb +32 -0
- data/lib/contrast/agent/reporting/details/protect_rule_details.rb +17 -0
- data/lib/contrast/agent/reporting/details/sqli_dangerous_functions.rb +22 -0
- data/lib/contrast/agent/reporting/details/sqli_details.rb +36 -0
- data/lib/contrast/agent/reporting/details/untrusted_deserialization_details.rb +27 -0
- data/lib/contrast/agent/reporting/details/virtual_patch_details.rb +30 -0
- data/lib/contrast/agent/reporting/details/xss_details.rb +33 -0
- data/lib/contrast/agent/reporting/details/xss_match.rb +30 -0
- data/lib/contrast/agent/reporting/details/xxe_details.rb +36 -0
- data/lib/contrast/agent/reporting/details/xxe_match.rb +25 -0
- data/lib/contrast/agent/reporting/details/xxe_wrapper.rb +25 -0
- data/lib/contrast/agent/reporting/input_analysis/details/bot_blocker_details.rb +27 -0
- data/lib/contrast/agent/reporting/input_analysis/details/protect_rule_details.rb +15 -0
- data/lib/contrast/agent/reporting/input_analysis/input_analysis.rb +55 -0
- data/lib/contrast/agent/reporting/input_analysis/input_analysis_result.rb +129 -0
- data/lib/contrast/agent/reporting/input_analysis/input_type.rb +44 -0
- data/lib/contrast/agent/reporting/input_analysis/score_level.rb +21 -0
- data/lib/contrast/agent/reporting/masker/masker.rb +258 -0
- data/lib/contrast/agent/reporting/masker/masker_utils.rb +33 -0
- data/lib/contrast/agent/reporting/report.rb +32 -0
- data/lib/contrast/agent/reporting/reporter.rb +163 -0
- data/lib/contrast/agent/reporting/reporting_events/agent_startup.rb +34 -0
- data/lib/contrast/agent/reporting/reporting_events/application_activity.rb +120 -0
- data/lib/contrast/agent/reporting/reporting_events/application_defend_activity.rb +101 -0
- data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_activity.rb +79 -0
- data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_sample.rb +101 -0
- data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_sample_activity.rb +74 -0
- data/lib/contrast/agent/reporting/reporting_events/application_defend_attack_sample_stack.rb +22 -0
- data/lib/contrast/agent/reporting/reporting_events/application_defend_attacker_activity.rb +78 -0
- data/lib/contrast/agent/reporting/reporting_events/application_inventory.rb +43 -0
- data/lib/contrast/agent/reporting/reporting_events/application_inventory_activity.rb +57 -0
- data/lib/contrast/agent/reporting/reporting_events/application_reporting_event.rb +37 -0
- data/lib/contrast/agent/reporting/reporting_events/application_settings.rb +40 -0
- data/lib/contrast/agent/reporting/reporting_events/application_startup.rb +44 -0
- data/lib/contrast/agent/reporting/reporting_events/application_startup_instrumentation.rb +27 -0
- data/lib/contrast/agent/reporting/reporting_events/application_update.rb +55 -0
- data/lib/contrast/agent/reporting/reporting_events/architecture_component.rb +66 -0
- data/lib/contrast/agent/reporting/reporting_events/discovered_route.rb +122 -0
- data/lib/contrast/agent/reporting/reporting_events/finding.rb +201 -0
- data/lib/contrast/agent/reporting/reporting_events/finding_event.rb +442 -0
- data/lib/contrast/agent/reporting/reporting_events/finding_event_object.rb +96 -0
- data/lib/contrast/agent/reporting/reporting_events/finding_event_parent_object.rb +45 -0
- data/lib/contrast/agent/reporting/reporting_events/finding_event_property.rb +47 -0
- data/lib/contrast/agent/reporting/reporting_events/finding_event_signature.rb +99 -0
- data/lib/contrast/agent/reporting/reporting_events/finding_event_source.rb +63 -0
- data/lib/contrast/agent/reporting/reporting_events/finding_event_stack.rb +65 -0
- data/lib/contrast/agent/reporting/reporting_events/finding_event_taint_range.rb +67 -0
- data/lib/contrast/agent/reporting/reporting_events/finding_event_taint_range_tags.rb +105 -0
- data/lib/contrast/agent/reporting/reporting_events/finding_request.rb +126 -0
- data/lib/contrast/agent/reporting/reporting_events/library_discovery.rb +89 -0
- data/lib/contrast/agent/reporting/reporting_events/library_usage_observation.rb +48 -0
- data/lib/contrast/agent/reporting/reporting_events/observed_library_usage.rb +37 -0
- data/lib/contrast/agent/reporting/reporting_events/observed_route.rb +83 -0
- data/lib/contrast/agent/reporting/reporting_events/poll.rb +23 -0
- data/lib/contrast/agent/reporting/reporting_events/preflight.rb +52 -0
- data/lib/contrast/agent/reporting/reporting_events/preflight_message.rb +66 -0
- data/lib/contrast/agent/reporting/reporting_events/reportable_hash.rb +47 -0
- data/lib/contrast/agent/reporting/reporting_events/reporting_event.rb +35 -0
- data/lib/contrast/agent/reporting/reporting_events/route_coverage.rb +87 -0
- data/lib/contrast/agent/reporting/reporting_events/route_discovery.rb +59 -0
- data/lib/contrast/agent/reporting/reporting_events/route_discovery_observation.rb +49 -0
- data/lib/contrast/agent/reporting/reporting_events/server_reporting_event.rb +35 -0
- data/lib/contrast/agent/reporting/reporting_events/server_settings.rb +40 -0
- data/lib/contrast/agent/reporting/reporting_utilities/audit.rb +133 -0
- data/lib/contrast/agent/reporting/reporting_utilities/build_preflight.rb +38 -0
- data/lib/contrast/agent/reporting/reporting_utilities/endpoints.rb +176 -0
- data/lib/contrast/agent/reporting/reporting_utilities/headers.rb +57 -0
- data/lib/contrast/agent/reporting/reporting_utilities/ng_response_extractor.rb +137 -0
- data/lib/contrast/agent/reporting/reporting_utilities/reporter_client.rb +138 -0
- data/lib/contrast/agent/reporting/reporting_utilities/reporter_client_utils.rb +161 -0
- data/lib/contrast/agent/reporting/reporting_utilities/reporting_storage.rb +66 -0
- data/lib/contrast/agent/reporting/reporting_utilities/response.rb +98 -0
- data/lib/contrast/agent/reporting/reporting_utilities/response_extractor.rb +149 -0
- data/lib/contrast/agent/reporting/reporting_utilities/response_handler.rb +118 -0
- data/lib/contrast/agent/reporting/reporting_utilities/response_handler_mode.rb +63 -0
- data/lib/contrast/agent/reporting/reporting_utilities/response_handler_utils.rb +393 -0
- data/lib/contrast/agent/reporting/reporting_workers/application_server_worker.rb +46 -0
- data/lib/contrast/agent/reporting/reporting_workers/reporter_heartbeat.rb +51 -0
- data/lib/contrast/agent/reporting/reporting_workers/reporting_workers.rb +14 -0
- data/lib/contrast/agent/reporting/reporting_workers/server_settings_worker.rb +46 -0
- data/lib/contrast/agent/reporting/settings/application_settings.rb +61 -0
- data/lib/contrast/agent/reporting/settings/assess.rb +58 -0
- data/lib/contrast/agent/reporting/settings/assess_rule.rb +18 -0
- data/lib/contrast/agent/reporting/settings/assess_server_feature.rb +114 -0
- data/lib/contrast/agent/reporting/settings/bot_blocker.rb +68 -0
- data/lib/contrast/agent/reporting/settings/exclusion_base.rb +129 -0
- data/lib/contrast/agent/reporting/settings/exclusions.rb +86 -0
- data/lib/contrast/agent/reporting/settings/helpers.rb +101 -0
- data/lib/contrast/agent/reporting/settings/input_exclusion.rb +87 -0
- data/lib/contrast/agent/reporting/settings/ip_filter.rb +35 -0
- data/lib/contrast/agent/reporting/settings/keyword.rb +74 -0
- data/lib/contrast/agent/reporting/settings/log_enhancer.rb +65 -0
- data/lib/contrast/agent/reporting/settings/protect.rb +111 -0
- data/lib/contrast/agent/reporting/settings/protect_rule.rb +18 -0
- data/lib/contrast/agent/reporting/settings/protect_server_feature.rb +227 -0
- data/lib/contrast/agent/reporting/settings/reaction.rb +39 -0
- data/lib/contrast/agent/reporting/settings/rule_definition.rb +66 -0
- data/lib/contrast/agent/reporting/settings/sampling.rb +46 -0
- data/lib/contrast/agent/reporting/settings/sanitizer.rb +38 -0
- data/lib/contrast/agent/reporting/settings/security_logger.rb +77 -0
- data/lib/contrast/agent/reporting/settings/sensitive_data_masking.rb +118 -0
- data/lib/contrast/agent/reporting/settings/sensitive_data_masking_rule.rb +65 -0
- data/lib/contrast/agent/reporting/settings/server_features.rb +95 -0
- data/lib/contrast/agent/reporting/settings/syslog.rb +205 -0
- data/lib/contrast/agent/reporting/settings/url_exclusion.rb +18 -0
- data/lib/contrast/agent/reporting/settings/validator.rb +17 -0
- data/lib/contrast/agent/reporting/settings/virtual_patch.rb +56 -0
- data/lib/contrast/agent/reporting/settings/virtual_patch_condition.rb +47 -0
- data/lib/contrast/agent/request/request.rb +189 -0
- data/lib/contrast/agent/request/request_context.rb +143 -0
- data/lib/contrast/agent/request/request_context_extend.rb +105 -0
- data/lib/contrast/agent/request/request_handler.rb +41 -0
- data/lib/contrast/agent/response/response.rb +87 -0
- data/lib/contrast/agent/scope/scope.rb +158 -0
- data/lib/contrast/agent/telemetry/base.rb +171 -0
- data/lib/contrast/agent/telemetry/client.rb +111 -0
- data/lib/contrast/agent/telemetry/event.rb +35 -0
- data/lib/contrast/agent/telemetry/exception/base.rb +61 -0
- data/lib/contrast/agent/telemetry/exception/event.rb +46 -0
- data/lib/contrast/agent/telemetry/exception/message.rb +118 -0
- data/lib/contrast/agent/telemetry/exception/message_exception.rb +86 -0
- data/lib/contrast/agent/telemetry/exception/stack_frame.rb +67 -0
- data/lib/contrast/agent/telemetry/exception.rb +19 -0
- data/lib/contrast/agent/telemetry/hash.rb +71 -0
- data/lib/contrast/agent/telemetry/identifier.rb +153 -0
- data/lib/contrast/agent/telemetry/metric_event.rb +28 -0
- data/lib/contrast/agent/telemetry/startup_metrics_event.rb +123 -0
- data/lib/contrast/agent/telemetry/telemetry.rb +109 -0
- data/lib/contrast/agent/{thread.rb → thread/thread.rb} +4 -6
- data/lib/contrast/agent/thread/thread_watcher.rb +126 -0
- data/lib/contrast/agent/thread/worker_thread.rb +42 -0
- data/lib/contrast/agent/version.rb +2 -2
- data/lib/contrast/agent.rb +96 -57
- data/lib/contrast/agent_lib/api/command_injection.rb +46 -0
- data/lib/contrast/agent_lib/api/init.rb +95 -0
- data/lib/contrast/agent_lib/api/input_tracing.rb +265 -0
- data/lib/contrast/agent_lib/api/panic.rb +87 -0
- data/lib/contrast/agent_lib/api/path_semantic_file_security_bypass.rb +40 -0
- data/lib/contrast/agent_lib/interface.rb +245 -0
- data/lib/contrast/agent_lib/interface_base.rb +131 -0
- data/lib/contrast/agent_lib/return_types/eval_result.rb +44 -0
- data/lib/contrast/agent_lib/test.rb +29 -0
- data/lib/contrast/components/agent.rb +104 -48
- data/lib/contrast/components/api.rb +159 -0
- data/lib/contrast/components/app_context.rb +125 -98
- data/lib/contrast/components/app_context_extend.rb +53 -0
- data/lib/contrast/components/assess.rb +210 -24
- data/lib/contrast/components/assess_rules.rb +54 -0
- data/lib/contrast/components/base.rb +103 -0
- data/lib/contrast/components/config/sources.rb +95 -0
- data/lib/contrast/components/config.rb +182 -60
- data/lib/contrast/components/heap_dump.rb +77 -12
- data/lib/contrast/components/inventory.rb +37 -10
- data/lib/contrast/components/logger.rb +46 -76
- data/lib/contrast/components/polling.rb +39 -0
- data/lib/contrast/components/protect.rb +142 -16
- data/lib/contrast/components/ruby_component.rb +135 -0
- data/lib/contrast/components/rule_set.rb +52 -0
- data/lib/contrast/components/sampling.rb +156 -15
- data/lib/contrast/components/scope.rb +125 -116
- data/lib/contrast/components/security_logger.rb +36 -0
- data/lib/contrast/components/settings.rb +239 -88
- data/lib/contrast/config/api_proxy_configuration.rb +27 -0
- data/lib/contrast/config/base_configuration.rb +20 -94
- data/lib/contrast/config/certification_configuration.rb +47 -0
- data/lib/contrast/config/config.rb +48 -0
- data/lib/contrast/config/diagnostics.rb +123 -0
- data/lib/contrast/config/diagnostics_tools.rb +99 -0
- data/lib/contrast/config/effective_config.rb +131 -0
- data/lib/contrast/config/effective_config_value.rb +32 -0
- data/lib/contrast/config/env_variables.rb +18 -0
- data/lib/contrast/config/exception_configuration.rb +34 -12
- data/lib/contrast/config/protect_rule_configuration.rb +45 -24
- data/lib/contrast/config/protect_rules_configuration.rb +97 -22
- data/lib/contrast/config/request_audit_configuration.rb +57 -0
- data/lib/contrast/config/server_configuration.rb +67 -15
- data/lib/contrast/config/validate.rb +140 -0
- data/lib/contrast/config/yaml_file.rb +129 -0
- data/lib/contrast/config.rb +6 -22
- data/lib/contrast/configuration.rb +241 -109
- data/lib/contrast/extension/assess/array.rb +75 -0
- data/lib/contrast/extension/assess/erb.rb +61 -0
- data/lib/contrast/extension/assess/eval_trigger.rb +47 -0
- data/lib/contrast/{extensions/ruby_core → extension}/assess/exec_trigger.rb +9 -21
- data/lib/contrast/extension/assess/fiber.rb +95 -0
- data/lib/contrast/extension/assess/hash.rb +33 -0
- data/lib/contrast/extension/assess/kernel.rb +124 -0
- data/lib/contrast/extension/assess/marshal.rb +80 -0
- data/lib/contrast/extension/assess/regexp.rb +71 -0
- data/lib/contrast/extension/assess/string.rb +85 -0
- data/lib/contrast/extension/assess.rb +47 -0
- data/lib/contrast/{extensions/ruby_core → extension}/delegator.rb +3 -1
- data/lib/contrast/extension/extension.rb +59 -0
- data/lib/contrast/extension/inventory.rb +21 -0
- data/lib/contrast/{extensions/ruby_core → extension}/module.rb +2 -3
- data/lib/contrast/extension/object.rb +19 -0
- data/lib/contrast/extension/protect/psych.rb +7 -0
- data/lib/contrast/{extensions/ruby_core → extension}/protect.rb +6 -6
- data/lib/contrast/extension/thread.rb +50 -0
- data/lib/contrast/framework/base_support.rb +69 -54
- data/lib/contrast/framework/grape/support.rb +176 -0
- data/lib/contrast/framework/manager.rb +112 -60
- data/lib/contrast/framework/manager_extend.rb +50 -0
- data/lib/contrast/framework/rack/patch/session_cookie.rb +108 -0
- data/lib/contrast/framework/rack/patch/support.rb +26 -0
- data/lib/contrast/framework/rack/support.rb +23 -0
- data/lib/contrast/framework/rails/patch/action_controller_live_buffer.rb +46 -0
- data/lib/contrast/framework/rails/patch/assess_configuration.rb +98 -0
- data/lib/contrast/framework/rails/patch/rails_application_configuration.rb +31 -0
- data/lib/contrast/framework/rails/patch/support.rb +46 -0
- data/lib/contrast/framework/rails/railtie.rb +33 -0
- data/lib/contrast/framework/rails/support.rb +187 -0
- data/lib/contrast/framework/sinatra/patch/encrypted_session_cookie.rb +39 -0
- data/lib/contrast/framework/sinatra/support.rb +162 -0
- data/lib/contrast/funchook/funchook.rb +44 -0
- data/lib/contrast/logger/aliased_logging.rb +158 -0
- data/lib/contrast/logger/application.rb +84 -0
- data/lib/contrast/logger/cef_log.rb +169 -0
- data/lib/contrast/logger/format.rb +61 -0
- data/lib/contrast/logger/log.rb +90 -0
- data/lib/contrast/logger/request.rb +25 -0
- data/lib/contrast/logger/time.rb +57 -0
- data/lib/contrast/security_exception.rb +2 -2
- data/lib/contrast/tasks/config.rb +33 -0
- data/lib/contrast/utils/assess/event_limit_utils.rb +134 -0
- data/lib/contrast/utils/assess/object_store.rb +36 -0
- data/lib/contrast/utils/assess/propagation_method_utils.rb +155 -0
- data/lib/contrast/utils/assess/property/tagged_utils.rb +165 -0
- data/lib/contrast/utils/assess/sampling_util.rb +11 -17
- data/lib/contrast/utils/assess/source_method_utils.rb +74 -0
- data/lib/contrast/utils/assess/split_utils.rb +23 -0
- data/lib/contrast/utils/assess/tracking_util.rb +96 -18
- data/lib/contrast/utils/assess/trigger_method_utils.rb +132 -0
- data/lib/contrast/utils/class_util.rb +80 -48
- data/lib/contrast/utils/duck_utils.rb +18 -9
- data/lib/contrast/utils/env_configuration_item.rb +4 -3
- data/lib/contrast/utils/findings.rb +66 -0
- data/lib/contrast/utils/hash_digest.rb +52 -99
- data/lib/contrast/utils/hash_digest_extend.rb +129 -0
- data/lib/contrast/utils/head_dump_utils_extend.rb +74 -0
- data/lib/contrast/utils/heap_dump_util.rb +44 -88
- data/lib/contrast/utils/input_classification_base.rb +169 -0
- data/lib/contrast/utils/invalid_configuration_util.rb +31 -45
- data/lib/contrast/utils/io_util.rb +47 -51
- data/lib/contrast/utils/job_servers_running.rb +21 -11
- data/lib/contrast/utils/log_utils.rb +254 -0
- data/lib/contrast/utils/lru_cache.rb +48 -0
- data/lib/contrast/utils/metrics_hash.rb +59 -0
- data/lib/contrast/utils/middleware_utils.rb +97 -0
- data/lib/contrast/utils/net_http_base.rb +173 -0
- data/lib/contrast/utils/object_share.rb +8 -48
- data/lib/contrast/utils/os.rb +14 -24
- data/lib/contrast/utils/patching/policy/patch_utils.rb +175 -0
- data/lib/contrast/utils/patching/policy/patcher_utils.rb +54 -0
- data/lib/contrast/utils/reporting/application_activity_batch_utils.rb +89 -0
- data/lib/contrast/utils/request_utils.rb +96 -0
- data/lib/contrast/utils/resource_loader.rb +2 -2
- data/lib/contrast/utils/response_utils.rb +79 -0
- data/lib/contrast/utils/routes_sent.rb +63 -0
- data/lib/contrast/utils/sha256_builder.rb +9 -21
- data/lib/contrast/utils/silence_maker.rb +16 -0
- data/lib/contrast/utils/stack_trace_utils.rb +68 -184
- data/lib/contrast/utils/string_utils.rb +82 -52
- data/lib/contrast/utils/tag_util.rb +58 -44
- data/lib/contrast/utils/thread_tracker.rb +27 -23
- data/lib/contrast/utils/timer.rb +20 -55
- data/lib/contrast-agent.rb +2 -2
- data/lib/contrast.rb +106 -43
- data/resources/assess/policy.json +481 -120
- data/resources/deadzone/policy.json +280 -10
- data/resources/inventory/policy.json +2 -2
- data/resources/protect/policy.json +36 -17
- data/ruby-agent.gemspec +116 -46
- data/sonar-project.properties +9 -0
- metadata +694 -317
- data/exe/contrast_service +0 -29
- data/ext/cs__assess_active_record_named/cs__active_record_named.c +0 -47
- data/ext/cs__assess_active_record_named/cs__active_record_named.h +0 -10
- data/ext/cs__assess_active_record_named/extconf.rb +0 -2
- data/ext/cs__assess_regexp_track/cs__assess_regexp_track.c +0 -63
- data/ext/cs__assess_regexp_track/cs__assess_regexp_track.h +0 -29
- data/ext/cs__assess_regexp_track/extconf.rb +0 -2
- data/ext/cs__assess_string_interpolation26/cs__assess_string_interpolation26.c +0 -31
- data/ext/cs__assess_string_interpolation26/cs__assess_string_interpolation26.h +0 -13
- data/ext/cs__assess_string_interpolation26/extconf.rb +0 -2
- data/ext/cs__protect_kernel/cs__protect_kernel.c +0 -37
- data/ext/cs__protect_kernel/cs__protect_kernel.h +0 -11
- data/ext/cs__protect_kernel/extconf.rb +0 -2
- data/funchook/Makefile +0 -29
- data/funchook/autom4te.cache/output.0 +0 -4976
- data/funchook/autom4te.cache/requests +0 -78
- data/funchook/autom4te.cache/traces.0 +0 -364
- data/funchook/config.log +0 -490
- data/funchook/config.status +0 -1016
- data/funchook/configure +0 -4976
- data/funchook/src/Makefile +0 -70
- data/funchook/src/config.h +0 -101
- data/funchook/src/config.h.in +0 -100
- data/funchook/src/decoder.o +0 -0
- data/funchook/src/distorm.o +0 -0
- data/funchook/src/funchook.o +0 -0
- data/funchook/src/funchook_io.o +0 -0
- data/funchook/src/funchook_syscall.o +0 -0
- data/funchook/src/funchook_unix.o +0 -0
- data/funchook/src/funchook_x86.o +0 -0
- data/funchook/src/instructions.o +0 -0
- data/funchook/src/insts.o +0 -0
- data/funchook/src/libfunchook.so +0 -0
- data/funchook/src/mnemonics.o +0 -0
- data/funchook/src/operands.o +0 -0
- data/funchook/src/os_func.o +0 -0
- data/funchook/src/os_func_unix.o +0 -0
- data/funchook/src/prefix.o +0 -0
- data/funchook/src/printf_base.o +0 -0
- data/funchook/src/textdefs.o +0 -0
- data/funchook/src/wstring.o +0 -0
- data/funchook/test/Makefile +0 -43
- data/funchook/test/funchook_test +0 -0
- data/funchook/test/libfunchook_test.so +0 -0
- data/funchook/test/test_main.o +0 -0
- data/funchook/test/x86_64_test.o +0 -0
- data/lib/contrast/agent/assess/adjusted_span.rb +0 -25
- data/lib/contrast/agent/assess/contrast_event.rb +0 -399
- data/lib/contrast/agent/assess/frozen_properties.rb +0 -41
- data/lib/contrast/agent/assess/insulator.rb +0 -53
- data/lib/contrast/agent/assess/policy/rewriter_patch.rb +0 -80
- data/lib/contrast/agent/assess/rule/base.rb +0 -72
- data/lib/contrast/agent/assess/rule/csrf/csrf_action.rb +0 -28
- data/lib/contrast/agent/assess/rule/csrf/csrf_applicator.rb +0 -73
- data/lib/contrast/agent/assess/rule/csrf/csrf_watcher.rb +0 -132
- data/lib/contrast/agent/assess/rule/csrf.rb +0 -66
- data/lib/contrast/agent/assess/rule/redos.rb +0 -68
- data/lib/contrast/agent/assess/rule/response_scanning_rule.rb +0 -47
- data/lib/contrast/agent/assess/rule/response_watcher.rb +0 -36
- data/lib/contrast/agent/assess/rule/watcher.rb +0 -36
- data/lib/contrast/agent/assess/rule.rb +0 -18
- data/lib/contrast/agent/assess.rb +0 -44
- data/lib/contrast/agent/at_exit_hook.rb +0 -33
- data/lib/contrast/agent/class_reopener.rb +0 -238
- data/lib/contrast/agent/disable_reaction.rb +0 -24
- data/lib/contrast/agent/exclusion_matcher.rb +0 -190
- data/lib/contrast/agent/feature_state.rb +0 -379
- data/lib/contrast/agent/logger_manager.rb +0 -116
- data/lib/contrast/agent/middleware.rb +0 -350
- data/lib/contrast/agent/protect/rule/base_service.rb +0 -88
- data/lib/contrast/agent/protect/rule/cmd_injection.rb +0 -156
- data/lib/contrast/agent/protect/rule/csrf/csrf_evaluator.rb +0 -103
- data/lib/contrast/agent/protect/rule/csrf/csrf_token_injector.rb +0 -85
- data/lib/contrast/agent/protect/rule/csrf.rb +0 -118
- data/lib/contrast/agent/protect/rule/http_method_tampering.rb +0 -80
- data/lib/contrast/agent/protect/rule/no_sqli.rb +0 -101
- data/lib/contrast/agent/protect/rule/sqli.rb +0 -101
- data/lib/contrast/agent/protect/rule/unsafe_file_upload.rb +0 -20
- data/lib/contrast/agent/protect/rule/xss.rb +0 -24
- data/lib/contrast/agent/protect/rule/xxe.rb +0 -120
- data/lib/contrast/agent/railtie.rb +0 -36
- data/lib/contrast/agent/reaction_processor.rb +0 -47
- data/lib/contrast/agent/request.rb +0 -475
- data/lib/contrast/agent/request_context.rb +0 -225
- data/lib/contrast/agent/require_state.rb +0 -61
- data/lib/contrast/agent/response.rb +0 -215
- data/lib/contrast/agent/rewriter.rb +0 -245
- data/lib/contrast/agent/scope.rb +0 -125
- data/lib/contrast/agent/service_heartbeat.rb +0 -40
- data/lib/contrast/agent/settings_state.rb +0 -152
- data/lib/contrast/agent/socket_client.rb +0 -128
- data/lib/contrast/agent/tracepoint_hook.rb +0 -51
- data/lib/contrast/api/connection_status.rb +0 -49
- data/lib/contrast/api/dtm_pb.rb +0 -718
- data/lib/contrast/api/settings_pb.rb +0 -416
- data/lib/contrast/api/socket.rb +0 -43
- data/lib/contrast/api/speedracer.rb +0 -186
- data/lib/contrast/api/tcp_socket.rb +0 -31
- data/lib/contrast/api/unix_socket.rb +0 -25
- data/lib/contrast/api.rb +0 -18
- data/lib/contrast/common_agent_configuration.rb +0 -86
- data/lib/contrast/components/contrast_service.rb +0 -117
- data/lib/contrast/components/interface.rb +0 -178
- data/lib/contrast/config/agent_configuration.rb +0 -24
- data/lib/contrast/config/application_configuration.rb +0 -27
- data/lib/contrast/config/assess_configuration.rb +0 -22
- data/lib/contrast/config/assess_rules_configuration.rb +0 -18
- data/lib/contrast/config/default_value.rb +0 -16
- data/lib/contrast/config/heap_dump_configuration.rb +0 -23
- data/lib/contrast/config/inventory_configuration.rb +0 -20
- data/lib/contrast/config/logger_configuration.rb +0 -20
- data/lib/contrast/config/protect_configuration.rb +0 -20
- data/lib/contrast/config/root_configuration.rb +0 -26
- data/lib/contrast/config/ruby_configuration.rb +0 -44
- data/lib/contrast/config/sampling_configuration.rb +0 -22
- data/lib/contrast/config/service_configuration.rb +0 -22
- data/lib/contrast/delegators/application_update.rb +0 -32
- data/lib/contrast/delegators.rb +0 -9
- data/lib/contrast/extensions/framework/rack/cookie.rb +0 -24
- data/lib/contrast/extensions/framework/rack/request.rb +0 -24
- data/lib/contrast/extensions/framework/rack/response.rb +0 -23
- data/lib/contrast/extensions/framework/rails/action_controller_railties_helper_inherited.rb +0 -20
- data/lib/contrast/extensions/framework/rails/active_record.rb +0 -26
- data/lib/contrast/extensions/framework/rails/active_record_named.rb +0 -53
- data/lib/contrast/extensions/framework/rails/active_record_time_zone_inherited.rb +0 -21
- data/lib/contrast/extensions/framework/rails/buffer.rb +0 -28
- data/lib/contrast/extensions/framework/rails/configuration.rb +0 -27
- data/lib/contrast/extensions/framework/sinatra/base.rb +0 -59
- data/lib/contrast/extensions/ruby_core/assess/array.rb +0 -59
- data/lib/contrast/extensions/ruby_core/assess/assess_extension.rb +0 -143
- data/lib/contrast/extensions/ruby_core/assess/basic_object.rb +0 -15
- data/lib/contrast/extensions/ruby_core/assess/erb.rb +0 -42
- data/lib/contrast/extensions/ruby_core/assess/fiber.rb +0 -124
- data/lib/contrast/extensions/ruby_core/assess/hash.rb +0 -22
- data/lib/contrast/extensions/ruby_core/assess/kernel.rb +0 -95
- data/lib/contrast/extensions/ruby_core/assess/module.rb +0 -14
- data/lib/contrast/extensions/ruby_core/assess/regexp.rb +0 -206
- data/lib/contrast/extensions/ruby_core/assess/string.rb +0 -75
- data/lib/contrast/extensions/ruby_core/assess/tilt_template_trigger.rb +0 -73
- data/lib/contrast/extensions/ruby_core/assess/xpath_library_trigger.rb +0 -40
- data/lib/contrast/extensions/ruby_core/assess.rb +0 -52
- data/lib/contrast/extensions/ruby_core/eval_trigger.rb +0 -52
- data/lib/contrast/extensions/ruby_core/inventory/datastores.rb +0 -37
- data/lib/contrast/extensions/ruby_core/inventory.rb +0 -22
- data/lib/contrast/extensions/ruby_core/protect/applies_command_injection_rule.rb +0 -72
- data/lib/contrast/extensions/ruby_core/protect/applies_deserialization_rule.rb +0 -60
- data/lib/contrast/extensions/ruby_core/protect/applies_no_sqli_rule.rb +0 -83
- data/lib/contrast/extensions/ruby_core/protect/applies_path_traversal_rule.rb +0 -123
- data/lib/contrast/extensions/ruby_core/protect/applies_sqli_rule.rb +0 -65
- data/lib/contrast/extensions/ruby_core/protect/applies_xxe_rule.rb +0 -143
- data/lib/contrast/extensions/ruby_core/protect/kernel.rb +0 -30
- data/lib/contrast/extensions/ruby_core/protect/psych.rb +0 -7
- data/lib/contrast/extensions/ruby_core/thread.rb +0 -31
- data/lib/contrast/framework/platform_version.rb +0 -21
- data/lib/contrast/framework/rails_support.rb +0 -88
- data/lib/contrast/framework/sinatra_application_helper.rb +0 -49
- data/lib/contrast/framework/sinatra_support.rb +0 -94
- data/lib/contrast/framework/view_technologies_descriptor.rb +0 -20
- data/lib/contrast/internal_exception.rb +0 -8
- data/lib/contrast/tasks/service.rb +0 -95
- data/lib/contrast/utils/boolean_util.rb +0 -33
- data/lib/contrast/utils/cache.rb +0 -69
- data/lib/contrast/utils/comment_range.rb +0 -19
- data/lib/contrast/utils/data_store_util.rb +0 -23
- data/lib/contrast/utils/environment_util.rb +0 -82
- data/lib/contrast/utils/freeze_util.rb +0 -32
- data/lib/contrast/utils/gemfile_reader.rb +0 -191
- data/lib/contrast/utils/inventory_util.rb +0 -126
- data/lib/contrast/utils/performs_logging.rb +0 -152
- data/lib/contrast/utils/preflight_util.rb +0 -13
- data/lib/contrast/utils/prevent_serialization.rb +0 -52
- data/lib/contrast/utils/rack_assess_session_cookie.rb +0 -104
- data/lib/contrast/utils/rails_assess_configuration.rb +0 -95
- data/lib/contrast/utils/random_util.rb +0 -22
- data/lib/contrast/utils/ruby_ast_rewriter.rb +0 -74
- data/lib/contrast/utils/service_response_util.rb +0 -110
- data/lib/contrast/utils/service_sender_util.rb +0 -106
- data/lib/contrast/utils/sinatra_helper.rb +0 -55
- data/resources/csrf/inject.js +0 -44
- data/resources/factory-bot-spec/spec_helper.rb +0 -30
- data/resources/rubocops/kernel/catch_cop.rb +0 -37
- data/resources/rubocops/kernel/require_cop.rb +0 -37
- data/resources/rubocops/kernel/require_relative_cop.rb +0 -33
- data/resources/rubocops/module/autoload_cop.rb +0 -37
- data/resources/rubocops/module/const_defined_cop.rb +0 -37
- data/resources/rubocops/module/const_get_cop.rb +0 -37
- data/resources/rubocops/module/const_set_cop.rb +0 -37
- data/resources/rubocops/module/constants_cop.rb +0 -37
- data/resources/rubocops/module/name_cop.rb +0 -37
- data/resources/rubocops/object/class_cop.rb +0 -37
- data/resources/rubocops/object/freeze_cop.rb +0 -37
- data/resources/rubocops/object/frozen_cop.rb +0 -37
- data/resources/rubocops/object/is_a_cop.rb +0 -37
- data/resources/rubocops/object/method_cop.rb +0 -37
- data/resources/rubocops/object/respond_to_cop.rb +0 -37
- data/resources/rubocops/object/singleton_class_cop.rb +0 -37
- data/resources/rubocops/regexp/spelling_cop.rb +0 -44
- data/resources/rubocops/thread/new_cop.rb +0 -39
- data/resources/ruby-spec/ancestors_spec.rb +0 -70
- data/resources/ruby-spec/modulo_spec.rb +0 -831
- data/resources/ruby-spec/parameters_spec.rb +0 -261
- data/resources/ruby-spec/ruby_spec_spec_helper.rb +0 -35
- data/service_executables/.gitkeep +0 -0
- data/service_executables/VERSION +0 -1
- data/service_executables/linux/contrast-service +0 -0
- data/service_executables/mac/contrast-service +0 -0
- data/shared_libraries/funchook.h +0 -123
- data/shared_libraries/libfunchook.so +0 -0
@@ -0,0 +1,112 @@
|
|
1
|
+
# Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
|
2
|
+
# frozen_string_literal: true
|
3
|
+
|
4
|
+
require 'contrast/components/logger'
|
5
|
+
require 'contrast/agent/reporting/settings/exclusion_base'
|
6
|
+
require 'contrast/agent/reporting/settings/input_exclusion'
|
7
|
+
require 'contrast/agent/reporting/settings/url_exclusion'
|
8
|
+
|
9
|
+
module Contrast
|
10
|
+
module Agent
|
11
|
+
# Exclusions are ways for the User to tell the Agent to ignore sections of
|
12
|
+
# the Application. If a request or an event matches one of these, the
|
13
|
+
# functions of the Agent are suppressed for that request or event.
|
14
|
+
class ExclusionMatcher
|
15
|
+
include Contrast::Components::Logger::InstanceMethods
|
16
|
+
extend Forwardable
|
17
|
+
|
18
|
+
attr_reader :protect, :assess, :exclusion_type, :wildcard_url, :wildcard_input
|
19
|
+
|
20
|
+
def_delegators :@exclusion, :protect_rules, :assess_rules, :type, :name, :input_name, :urls, :match_strategy
|
21
|
+
|
22
|
+
MATCH_ALL = 'ALL'.cs__freeze
|
23
|
+
|
24
|
+
# Create a matcher around an exclusion sent from TeamServer.
|
25
|
+
#
|
26
|
+
# @param excl [Contrast::Agent::Reporting::Settings::ExclusionBase]
|
27
|
+
# @return [Contrast::Agent::ExclusionMatcher]
|
28
|
+
def initialize excl
|
29
|
+
@exclusion = excl
|
30
|
+
@protect = @exclusion.protect
|
31
|
+
@assess = @exclusion.assess
|
32
|
+
|
33
|
+
case excl
|
34
|
+
when Contrast::Agent::Reporting::Settings::InputExclusion
|
35
|
+
handle_wildcard_input
|
36
|
+
@exclusion_type = :INPUT
|
37
|
+
when Contrast::Agent::Reporting::Settings::UrlExclusion
|
38
|
+
handle_wildcard_url
|
39
|
+
@exclusion_type = :URL
|
40
|
+
end
|
41
|
+
end
|
42
|
+
|
43
|
+
# According to the docs for exclusions, user input applies to all inputs if
|
44
|
+
# the name supplied is an '*' or '.*'. The name matcher does NOT support
|
45
|
+
# regexp beyond this.
|
46
|
+
# https://docs.contrastsecurity.com/admin-policymgmt.html#exclude
|
47
|
+
def handle_wildcard_input
|
48
|
+
return unless @exclusion.name # rubocop:disable Security/Module/Name
|
49
|
+
|
50
|
+
@wildcard_input = @exclusion.name == '.*' || @exclusion.name == Contrast::Utils::ObjectShare::ASTERISK # rubocop:disable Security/Module/Name
|
51
|
+
end
|
52
|
+
|
53
|
+
# According to the docs for exclusions, urls apply to all urls if the url
|
54
|
+
# supplied is '/.*' or if the URL mode is all. Otherwise, the URL supplied is
|
55
|
+
# to be treated as a regular expression that must match the entire URL
|
56
|
+
# against which it is tested.
|
57
|
+
# https://docs.contrastsecurity.com/admin-policymgmt.html#exclude
|
58
|
+
def handle_wildcard_url
|
59
|
+
@wildcard_url = match_all?
|
60
|
+
return if @wildcard_url
|
61
|
+
return unless @exclusion.urls&.any?
|
62
|
+
|
63
|
+
@wildcard_url ||= @exclusion.urls.any?('/.*')
|
64
|
+
return if @wildcard_url
|
65
|
+
|
66
|
+
@urls = []
|
67
|
+
@exclusion.urls.each do |url|
|
68
|
+
url_pattern = build_regexp(url, start_anchor: true, end_anchor: true)
|
69
|
+
@urls << url_pattern if url_pattern
|
70
|
+
end
|
71
|
+
end
|
72
|
+
|
73
|
+
def build_regexp pattern, start_anchor: false, end_anchor: false
|
74
|
+
pattern = Contrast::Utils::ObjectShare::CARROT + pattern if start_anchor
|
75
|
+
pattern += Contrast::Utils::ObjectShare::DOLLAR_SIGN if end_anchor
|
76
|
+
Regexp.compile(pattern)
|
77
|
+
rescue RegexpError => e
|
78
|
+
logger.error('Unable to generate a pattern for exclusion matching.', e, pattern: pattern)
|
79
|
+
end
|
80
|
+
|
81
|
+
def protect?
|
82
|
+
@protect
|
83
|
+
end
|
84
|
+
|
85
|
+
def assess?
|
86
|
+
@assess
|
87
|
+
end
|
88
|
+
|
89
|
+
def match_all?
|
90
|
+
(@exclusion.urls.nil? || @exclusion.urls.empty?) && @exclusion.match_strategy == MATCH_ALL
|
91
|
+
end
|
92
|
+
|
93
|
+
# Determine if the given rule is excluded by this exclusion.
|
94
|
+
# In this case, the `protect_rules` being empty means apply to all rules,
|
95
|
+
# not no rules
|
96
|
+
#
|
97
|
+
# @param rule - the id of the rule which we're checking for exclusion
|
98
|
+
def protection_rule? rule
|
99
|
+
protect? && (@exclusion.protect_rules.empty? || @exclusion.protect_rules.include?(rule))
|
100
|
+
end
|
101
|
+
|
102
|
+
# Determine if the given rule is excluded by this exclusion.
|
103
|
+
# In this case, the `assessment_rules` being empty means apply to all rules,
|
104
|
+
# not no rules
|
105
|
+
#
|
106
|
+
# @param rule - the id of the rule which we're checking for exclusion
|
107
|
+
def assess_rule? rule
|
108
|
+
assess? && (@exclusion.assess_rules.empty? || @exclusion.assess_rules.include?(rule))
|
109
|
+
end
|
110
|
+
end
|
111
|
+
end
|
112
|
+
end
|
@@ -0,0 +1,44 @@
|
|
1
|
+
# Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
|
2
|
+
# frozen_string_literal: true
|
3
|
+
|
4
|
+
require 'contrast/components/logger'
|
5
|
+
|
6
|
+
module Contrast
|
7
|
+
module Agent
|
8
|
+
# This module adds an at_exit hook for us to send messages that may be lost at process exit
|
9
|
+
module AtExitHook
|
10
|
+
extend Contrast::Components::Logger::InstanceMethods
|
11
|
+
|
12
|
+
def self.exit_hook
|
13
|
+
@_exit_hook ||= begin
|
14
|
+
at_exit do
|
15
|
+
on_exit
|
16
|
+
end
|
17
|
+
true
|
18
|
+
end
|
19
|
+
end
|
20
|
+
|
21
|
+
# Actions to take when a process exits. Typically called from our
|
22
|
+
# exit_hook, but exposed here for other process terminations, like those
|
23
|
+
# in Kernel#exec
|
24
|
+
def self.on_exit
|
25
|
+
logger.debug('at_exit invoked, host application terminating',
|
26
|
+
p_id: @pid,
|
27
|
+
pp_id: @ppid,
|
28
|
+
process_pid: Process.pid,
|
29
|
+
process_pp_id: Process.ppid)
|
30
|
+
|
31
|
+
context = Contrast::Agent::REQUEST_TRACKER.current
|
32
|
+
return unless context
|
33
|
+
|
34
|
+
[
|
35
|
+
Contrast::Agent::Inventory::DependencyUsageAnalysis.instance.generate_library_usage,
|
36
|
+
context.observed_route
|
37
|
+
].compact.each do |event|
|
38
|
+
Contrast::Agent.reporter&.send_event_immediately(event)
|
39
|
+
end
|
40
|
+
Contrast::Agent.reporter&.send_event_immediately(context.activity)
|
41
|
+
end
|
42
|
+
end
|
43
|
+
end
|
44
|
+
end
|
@@ -0,0 +1,57 @@
|
|
1
|
+
# Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
|
2
|
+
# frozen_string_literal: true
|
3
|
+
|
4
|
+
require 'contrast/components/logger'
|
5
|
+
require 'contrast/components/scope'
|
6
|
+
|
7
|
+
module Contrast
|
8
|
+
module Agent
|
9
|
+
# This module is used to apply instrumentation to classes as they are required
|
10
|
+
module TracePointHook
|
11
|
+
extend Contrast::Components::Logger::InstanceMethods
|
12
|
+
extend Contrast::Components::Scope::InstanceMethods
|
13
|
+
|
14
|
+
class << self
|
15
|
+
def enable!
|
16
|
+
@require_hook ||= TracePoint.new(:end) do |tracepoint_event|
|
17
|
+
process(tracepoint_event)
|
18
|
+
end
|
19
|
+
|
20
|
+
@require_hook.enable
|
21
|
+
logger.debug('Enabled :end event tracing')
|
22
|
+
end
|
23
|
+
|
24
|
+
def disable
|
25
|
+
instance_variable_defined?(:@require_hook) && @require_hook.disable
|
26
|
+
end
|
27
|
+
|
28
|
+
private
|
29
|
+
|
30
|
+
# Use the TracePoint from the :end event, meaning the completion of a definition of a Class or Module (or
|
31
|
+
# really the completion of that piece of a definition, as determined by an `end` statement since there could be
|
32
|
+
# definitions across multiple files) to carry out actions required on definition. This typically involves
|
33
|
+
# patching and usage analysis
|
34
|
+
#
|
35
|
+
# @param tracepoint_event [TracePoint] the TracePoint from the :end
|
36
|
+
def process tracepoint_event
|
37
|
+
with_contrast_scope do
|
38
|
+
# the Module or Class that was loaded during this event
|
39
|
+
loaded_module = tracepoint_event.self
|
40
|
+
# the file being loaded that contained this definition
|
41
|
+
path = tracepoint_event.path
|
42
|
+
return if path&.include?('contrast')
|
43
|
+
|
44
|
+
logger.trace('Received TracePoint end event', module: loaded_module, path: path)
|
45
|
+
|
46
|
+
Contrast::Agent.framework_manager.register_late_framework(loaded_module)
|
47
|
+
Contrast::Agent::Inventory::DependencyUsageAnalysis.instance.associate_file(path) if path
|
48
|
+
Contrast::Agent::Patching::Policy::Patcher.patch_specific_module(loaded_module)
|
49
|
+
Contrast::Agent::Assess::Policy::PolicyScanner.scan(tracepoint_event)
|
50
|
+
rescue StandardError => e
|
51
|
+
logger.error('Unable to complete TracePoint analysis', e, module: loaded_module, path: path)
|
52
|
+
end
|
53
|
+
end
|
54
|
+
end
|
55
|
+
end
|
56
|
+
end
|
57
|
+
end
|
@@ -0,0 +1,175 @@
|
|
1
|
+
# Copyright (c) 2023 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/architecture_component'
|
5
|
+
require 'contrast/components/logger'
|
6
|
+
require 'contrast/utils/object_share'
|
7
|
+
require 'contrast/utils/timer'
|
8
|
+
|
9
|
+
module Contrast
|
10
|
+
module Agent
|
11
|
+
module Inventory
|
12
|
+
# Methods used for parsing database connection configurations
|
13
|
+
# for getting inventory information from the application
|
14
|
+
module DatabaseConfig
|
15
|
+
extend Contrast::Components::Logger::InstanceMethods
|
16
|
+
|
17
|
+
# TeamServer only accepts certain values for FlowMap Services.
|
18
|
+
# DO NOT CHANGE THIS
|
19
|
+
ADAPTER = 'adapter'
|
20
|
+
HOST = 'host'
|
21
|
+
PORT = 'port'
|
22
|
+
DATABASE = 'database'
|
23
|
+
DEFAULT = 'default'
|
24
|
+
LOCALHOST = 'localhost'
|
25
|
+
|
26
|
+
class << self
|
27
|
+
# Append the available database connection information to the message being sent to TeamServer.
|
28
|
+
#
|
29
|
+
# @param activity_or_update [Contrast::Agent::Reporting::ApplicationUpdate]
|
30
|
+
# @param hash_or_str [Hash, String] the database connection information
|
31
|
+
def append_db_config activity_or_update, hash_or_str = active_record_config
|
32
|
+
arr = build_from_db_config(hash_or_str)
|
33
|
+
return unless arr&.any?
|
34
|
+
|
35
|
+
arr.each do |component|
|
36
|
+
next unless component
|
37
|
+
|
38
|
+
if activity_or_update.cs__is_a?(Contrast::Agent::Reporting::ApplicationUpdate)
|
39
|
+
activity_or_update.components << component
|
40
|
+
else
|
41
|
+
activity_or_update.attach_inventory(component)
|
42
|
+
end
|
43
|
+
end
|
44
|
+
rescue StandardError => e
|
45
|
+
logger.warn('Unable to append db config', e)
|
46
|
+
nil
|
47
|
+
end
|
48
|
+
|
49
|
+
private
|
50
|
+
|
51
|
+
# We capture the active record configuration used by this application, as reported by
|
52
|
+
# ActiveRecord::Base.connection_db_config, so that we can record it once and report it as needed.
|
53
|
+
#
|
54
|
+
# @return [Hash]
|
55
|
+
def active_record_config
|
56
|
+
return @_active_record_config if instance_variable_defined?(:@_active_record_config)
|
57
|
+
return unless defined?(ActiveRecord) && defined?(ActiveRecord::Base)
|
58
|
+
|
59
|
+
@_active_record_config = if ActiveRecord::Base.cs__respond_to?(:connection_db_config)
|
60
|
+
ActiveRecord::Base.connection_db_config
|
61
|
+
else
|
62
|
+
# TODO: RUBY-99999 - Remove when Rails 6.0 is not supported
|
63
|
+
ActiveRecord::Base.connection_config
|
64
|
+
end
|
65
|
+
rescue StandardError => e
|
66
|
+
logger.error('Unable to detect db config connection', e)
|
67
|
+
nil
|
68
|
+
end
|
69
|
+
|
70
|
+
# The classes we instrument in order to determine which, if any, database(s) an application connects to take
|
71
|
+
# either a Hash or a String as a parameter. We install this one patch into all of those methods, letting our
|
72
|
+
# code here, rather than at the patch level, make the determination of which path to call. We'll make that
|
73
|
+
# decision and then parse the given configuration to create a
|
74
|
+
# Contrast::Agent::Reporting::ArchitectureComponent for reporting.
|
75
|
+
#
|
76
|
+
# @param hash_or_str [Hash, String]
|
77
|
+
# @return [Array<Contrast::Agent::Reporting::ArchitectureComponent>, nil]
|
78
|
+
def build_from_db_config hash_or_str
|
79
|
+
return unless hash_or_str
|
80
|
+
|
81
|
+
# we need to handle types of HashConfig, which != Hash
|
82
|
+
# for example ActiveRecord::DatabaseConfigurations::HashConfig is type of active_record config
|
83
|
+
# but the method is not handling it properly
|
84
|
+
# so we need to handle it here and extract the hash
|
85
|
+
hash_or_str = hash_or_str.configuration_hash if hash_or_str.cs__respond_to?(:configuration_hash)
|
86
|
+
if hash_or_str.is_a?(Hash)
|
87
|
+
build_from_db_hash(hash_or_str)
|
88
|
+
else
|
89
|
+
build_from_db_string(hash_or_str.to_s)
|
90
|
+
end
|
91
|
+
end
|
92
|
+
|
93
|
+
# Convert the Hash used to create a database connection into a
|
94
|
+
# Contrast::Agent::Reporting::ArchitectureComponent understandable by TeamServer.
|
95
|
+
#
|
96
|
+
# @param hash [Hash] the information used to open a database connection
|
97
|
+
# @return [Array<Contrast::Agent::Reporting::ArchitectureComponent>]
|
98
|
+
def build_from_db_hash hash
|
99
|
+
ac = Contrast::Agent::Reporting::ArchitectureComponent.build_database
|
100
|
+
ac.vendor = hash[:adapter] || hash[ADAPTER] || Contrast::Utils::ObjectShare::EMPTY_STRING
|
101
|
+
ac.remote_host = host_from_hash(hash)
|
102
|
+
ac.remote_port = port_from_hash(hash)
|
103
|
+
ac.url = hash[:database] || hash[DATABASE] || DEFAULT
|
104
|
+
[ac]
|
105
|
+
end
|
106
|
+
|
107
|
+
# Retrieve the host from the given connection Hash
|
108
|
+
#
|
109
|
+
# @param hash [Hash]
|
110
|
+
# @return [String]
|
111
|
+
def host_from_hash hash
|
112
|
+
hash[:host] || hash[HOST] || Contrast::Utils::ObjectShare::EMPTY_STRING
|
113
|
+
end
|
114
|
+
|
115
|
+
# Retrieve the port from the given connection Hash
|
116
|
+
#
|
117
|
+
# @param hash [Hash]
|
118
|
+
# @return [integer]
|
119
|
+
def port_from_hash hash
|
120
|
+
p = hash[:port] || hash[PORT] || Contrast::Utils::ObjectShare::EMPTY_STRING
|
121
|
+
p.to_i
|
122
|
+
end
|
123
|
+
|
124
|
+
# Examples:
|
125
|
+
# mongodb://[user:pass@]host1[:port1][,host2[:port2],[,hostN[:portN]]][/[database][?options]]
|
126
|
+
# postgresql://scott:tiger@localhost/mydatabase # pragma: allowlist secret
|
127
|
+
# mysql+mysqlconnector://scott:tiger@localhost/foo # pragma: allowlist secret
|
128
|
+
#
|
129
|
+
# @param str [String] the DB connection string
|
130
|
+
# @return [Array<Contrast::Agent::Reporting::ArchitectureComponent>, nil]
|
131
|
+
def build_from_db_string str
|
132
|
+
adapter, hosts, database = split_connection_str(str)
|
133
|
+
return unless adapter && hosts && database
|
134
|
+
|
135
|
+
acs = []
|
136
|
+
hosts.split(Contrast::Utils::ObjectShare::COMMA).map do |s|
|
137
|
+
host, port = s.split(Contrast::Utils::ObjectShare::COLON)
|
138
|
+
|
139
|
+
ac = Contrast::Agent::Reporting::ArchitectureComponent.build_database
|
140
|
+
ac.vendor = Contrast::Utils::StringUtils.force_utf8(adapter)
|
141
|
+
ac.remote_host = Contrast::Utils::StringUtils.force_utf8(host)
|
142
|
+
ac.remote_port = port.to_i
|
143
|
+
ac.url = Contrast::Utils::StringUtils.force_utf8(database)
|
144
|
+
acs << ac
|
145
|
+
end
|
146
|
+
acs
|
147
|
+
end
|
148
|
+
|
149
|
+
# Parse the given string used to connect to a database into its composite components, allowing for the
|
150
|
+
# generation of a Contrast::Agent::Reporting::ArchitectureComponent
|
151
|
+
#
|
152
|
+
# @param str [String] the DB connection string
|
153
|
+
# @return [Array<String>, nil] the adapter, hosts, and database
|
154
|
+
def split_connection_str str
|
155
|
+
adapter, str = str.split(Contrast::Utils::ObjectShare::COLON_SLASH_SLASH)
|
156
|
+
return unless str
|
157
|
+
|
158
|
+
_auth, str = str.split(Contrast::Utils::ObjectShare::AT)
|
159
|
+
return unless str
|
160
|
+
|
161
|
+
# Not currently used
|
162
|
+
# user, pass = auth.split(Contrast::Utils::ObjectShare::COLON)
|
163
|
+
hosts, db_and_options = str.split(Contrast::Utils::ObjectShare::SLASH)
|
164
|
+
return unless db_and_options
|
165
|
+
|
166
|
+
hosts << LOCALHOST if hosts.empty?
|
167
|
+
database, _options = db_and_options.split(Contrast::Utils::ObjectShare::QUESTION_MARK)
|
168
|
+
|
169
|
+
[adapter, hosts, database]
|
170
|
+
end
|
171
|
+
end
|
172
|
+
end
|
173
|
+
end
|
174
|
+
end
|
175
|
+
end
|
@@ -0,0 +1,52 @@
|
|
1
|
+
# Copyright (c) 2023 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 Inventory
|
7
|
+
# this module is included in classes that need access to the applications dependencies
|
8
|
+
module Dependencies
|
9
|
+
CONTRAST_AGENT = 'contrast-agent'
|
10
|
+
|
11
|
+
# the #clone is necessary here, as a require in another thread could
|
12
|
+
# potentially result in adding a key to the loaded_specs hash during
|
13
|
+
# iteration. (as in RUBY-330)
|
14
|
+
# this takes care of filtering out contrast-only dependencies
|
15
|
+
def loaded_specs
|
16
|
+
specs = Gem.loaded_specs.clone
|
17
|
+
specs.delete_if { |name, _v| contrast?(name) }
|
18
|
+
end
|
19
|
+
|
20
|
+
private
|
21
|
+
|
22
|
+
def contrast_gems
|
23
|
+
@_contrast_gems ||= find_contrast_gems
|
24
|
+
end
|
25
|
+
|
26
|
+
def contrast? name
|
27
|
+
contrast_gems.include?(name)
|
28
|
+
end
|
29
|
+
|
30
|
+
# Go through all dependents, given as a pair from the DependencyList: `dependency`
|
31
|
+
# is the dependency itself, filled with all its specs. `dependents` is the array of reverse
|
32
|
+
# dependencies for the aforementioned dependency. If the dependency is also in contrast_dep_set,
|
33
|
+
# then contrast depends on it. If its array of dependents is 1, then contrast is the
|
34
|
+
# only dependency in that list. Since only contrast depends on it, we should ignore it.
|
35
|
+
def find_contrast_gems
|
36
|
+
# rubocop:disable Security/Module/Name -- here name is part of Ruby Gems.
|
37
|
+
ignore = Set.new([CONTRAST_AGENT])
|
38
|
+
contrast_specs = Gem::DependencyList.from_specs.specs.find do |dependency|
|
39
|
+
dependency.name == CONTRAST_AGENT
|
40
|
+
end
|
41
|
+
contrast_dep_set = contrast_specs.dependencies.map(&:name).to_set
|
42
|
+
|
43
|
+
Gem::DependencyList.from_specs.spec_predecessors.each_pair do |dependency, dependents|
|
44
|
+
ignore.add(dependency.name) if contrast_dep_set.include?(dependency.name) && dependents.length == 1
|
45
|
+
end
|
46
|
+
ignore
|
47
|
+
# rubocop:enable Security/Module/Name
|
48
|
+
end
|
49
|
+
end
|
50
|
+
end
|
51
|
+
end
|
52
|
+
end
|
@@ -0,0 +1,34 @@
|
|
1
|
+
# Copyright (c) 2023 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/library_discovery'
|
5
|
+
require 'contrast/agent/inventory/dependencies'
|
6
|
+
require 'contrast/utils/object_share'
|
7
|
+
|
8
|
+
module Contrast
|
9
|
+
module Agent
|
10
|
+
module Inventory
|
11
|
+
# Used to collect dependencies of the application for reporting
|
12
|
+
class DependencyAnalysis
|
13
|
+
include Singleton
|
14
|
+
include Contrast::Agent::Inventory::Dependencies
|
15
|
+
|
16
|
+
# Report the dependencies of this application
|
17
|
+
#
|
18
|
+
# @return [Array<Contrast::Agent::Reporting::LibraryDiscovery>] direct report form of
|
19
|
+
# Gem::Specification that have been loaded for this application.
|
20
|
+
def library_pb_list
|
21
|
+
return Contrast::Utils::ObjectShare::EMPTY_ARRAY unless ::Contrast::INVENTORY.enable
|
22
|
+
return Contrast::Utils::ObjectShare::EMPTY_ARRAY unless ::Contrast::INVENTORY.analyze_libraries
|
23
|
+
|
24
|
+
loaded_specs.each_with_object([]) do |(_name, spec), reported_lib_list|
|
25
|
+
next unless spec
|
26
|
+
next unless (digest = Contrast::Utils::Sha256Builder.instance.build_from_spec(spec))
|
27
|
+
|
28
|
+
reported_lib_list << Contrast::Agent::Reporting::LibraryDiscovery.new(digest, spec)
|
29
|
+
end
|
30
|
+
end
|
31
|
+
end
|
32
|
+
end
|
33
|
+
end
|
34
|
+
end
|
@@ -0,0 +1,120 @@
|
|
1
|
+
# Copyright (c) 2023 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/library_usage_observation'
|
5
|
+
require 'contrast/agent/inventory/dependencies'
|
6
|
+
require 'contrast/components/logger'
|
7
|
+
require 'contrast/utils/object_share'
|
8
|
+
require 'set'
|
9
|
+
|
10
|
+
module Contrast
|
11
|
+
module Agent
|
12
|
+
module Inventory
|
13
|
+
# Used to analyze class usage for reporting
|
14
|
+
class DependencyUsageAnalysis
|
15
|
+
include Singleton
|
16
|
+
include Contrast::Components::Logger::InstanceMethods
|
17
|
+
include Contrast::Agent::Inventory::Dependencies
|
18
|
+
|
19
|
+
def initialize
|
20
|
+
return unless enabled?
|
21
|
+
|
22
|
+
@lock = Mutex.new
|
23
|
+
@lock.synchronize { @gemdigest_cache = Hash.new { |hash, key| hash[key] = Set.new } }
|
24
|
+
end
|
25
|
+
|
26
|
+
# This method is invoked once, along with the rest of our catchup code to report libraries and their associated
|
27
|
+
# files that have already been loaded pre-contrast.
|
28
|
+
def catchup
|
29
|
+
return unless enabled?
|
30
|
+
|
31
|
+
loaded_specs.each do |_name, spec|
|
32
|
+
# Get a digest of the Gem file itself.
|
33
|
+
next unless (digest = Contrast::Utils::Sha256Builder.instance.build_from_spec(spec))
|
34
|
+
|
35
|
+
loaded_files_from_gem = $LOADED_FEATURES.select { |f| f.start_with?(spec.full_gem_path) }
|
36
|
+
|
37
|
+
new_files = loaded_files_from_gem.each_with_object(Set.new) do |file_path, set|
|
38
|
+
set << adjust_path_for_reporting(file_path, spec)
|
39
|
+
logger.trace('Recording loaded file for inventory analysis', line: file_path)
|
40
|
+
end
|
41
|
+
|
42
|
+
# Even if new_files is empty, still need to add digest key for library discovery.
|
43
|
+
@lock.synchronize { @gemdigest_cache[digest].merge(new_files) }
|
44
|
+
end
|
45
|
+
end
|
46
|
+
|
47
|
+
# This method is invoked once per TracePoint :end - to map a specific file being required to the gem to which
|
48
|
+
# it belongs.
|
49
|
+
#
|
50
|
+
# @param path [String] the result of TracePoint#path from the :end event in which the Module was defined.
|
51
|
+
def associate_file path
|
52
|
+
return unless enabled?
|
53
|
+
|
54
|
+
spec_lookup_path = adjust_path_for_spec_lookup(path)
|
55
|
+
spec = Gem::Specification.find_by_path(spec_lookup_path)
|
56
|
+
unless spec
|
57
|
+
logger.debug('Unable to resolve gem spec for path', path: path)
|
58
|
+
return
|
59
|
+
end
|
60
|
+
|
61
|
+
digest = Contrast::Utils::Sha256Builder.instance.build_from_spec(spec)
|
62
|
+
unless digest
|
63
|
+
logger.debug('Unable to resolve digest for gem spec', spec: spec.to_s) if logger.debug?
|
64
|
+
return
|
65
|
+
end
|
66
|
+
report_path = adjust_path_for_reporting(path, spec)
|
67
|
+
@lock.synchronize { @gemdigest_cache[digest] << report_path }
|
68
|
+
rescue StandardError => e
|
69
|
+
logger.error('Unable to inventory file path', e, path: path)
|
70
|
+
end
|
71
|
+
|
72
|
+
# Populate the library_usages field of the Activity message using the data stored in the @gemdigest_cache. If
|
73
|
+
# no libraries had files loaded, or inventory analysis is disabled, return nil instead.
|
74
|
+
#
|
75
|
+
# @return [Contrast::Agent::Reporting::ObservedLibraryUsage, nil]
|
76
|
+
def generate_library_usage
|
77
|
+
return unless enabled?
|
78
|
+
return unless @gemdigest_cache.any?
|
79
|
+
|
80
|
+
# Disconnect gemdigest_cache and replace it with an empty one; synch so new libs cannot be added between the
|
81
|
+
# assignment and the replace
|
82
|
+
gem_spec_digest_to_files = @lock.synchronize do
|
83
|
+
hold = @gemdigest_cache
|
84
|
+
@gemdigest_cache = Hash.new { |hash, key| hash[key] = Set.new }
|
85
|
+
hold
|
86
|
+
end
|
87
|
+
|
88
|
+
observed_library_usage = Contrast::Agent::Reporting::ObservedLibraryUsage.new
|
89
|
+
gem_spec_digest_to_files.each_pair do |digest, files|
|
90
|
+
next unless files.any?
|
91
|
+
|
92
|
+
usage = Contrast::Agent::Reporting::LibraryUsageObservation.new(digest, files)
|
93
|
+
observed_library_usage.observations << usage
|
94
|
+
end
|
95
|
+
observed_library_usage.observations.any? ? observed_library_usage : nil
|
96
|
+
rescue StandardError => e
|
97
|
+
logger.error('Unable to generate library usage.', e)
|
98
|
+
end
|
99
|
+
|
100
|
+
private
|
101
|
+
|
102
|
+
def adjust_path_for_spec_lookup path
|
103
|
+
idx = path.index('/lib/')
|
104
|
+
path = path[(idx + 4)..] if idx
|
105
|
+
path
|
106
|
+
end
|
107
|
+
|
108
|
+
def adjust_path_for_reporting path, gem_spec
|
109
|
+
path.delete_prefix(gem_spec.full_gem_path)
|
110
|
+
end
|
111
|
+
|
112
|
+
# We only use this if inventory and library analysis are enabled
|
113
|
+
def enabled?
|
114
|
+
@_enabled = ::Contrast::INVENTORY.enable && ::Contrast::INVENTORY.analyze_libraries if @_enabled.nil?
|
115
|
+
@_enabled
|
116
|
+
end
|
117
|
+
end
|
118
|
+
end
|
119
|
+
end
|
120
|
+
end
|
@@ -0,0 +1,14 @@
|
|
1
|
+
# Copyright (c) 2023 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
|
+
# Namespace used for inventory behavior
|
7
|
+
module Inventory
|
8
|
+
end
|
9
|
+
end
|
10
|
+
end
|
11
|
+
|
12
|
+
require 'contrast/agent/inventory/dependencies'
|
13
|
+
require 'contrast/agent/inventory/dependency_usage_analysis'
|
14
|
+
require 'contrast/agent/inventory/dependency_analysis'
|
@@ -0,0 +1,51 @@
|
|
1
|
+
# Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
|
2
|
+
# frozen_string_literal: true
|
3
|
+
|
4
|
+
require 'contrast/components/logger'
|
5
|
+
require 'contrast/agent/inventory/database_config'
|
6
|
+
|
7
|
+
module Contrast
|
8
|
+
module Agent
|
9
|
+
module Inventory
|
10
|
+
module Policy
|
11
|
+
# This Module is how we apply the Data Store detection required for the
|
12
|
+
# FlowMap feature. It is called from our patches of the targeted methods
|
13
|
+
# in which database operations occur. It is responsible for deciding if
|
14
|
+
# the given invocation is worth reporting or not.
|
15
|
+
module DataStores
|
16
|
+
extend Contrast::Components::Logger::InstanceMethods
|
17
|
+
class << self
|
18
|
+
# The key used in policy.json to indicate the database type to
|
19
|
+
# report.
|
20
|
+
DATA_STORE_MARKER = 'data_store'
|
21
|
+
|
22
|
+
def report_data_store _method, _exception, properties, object, _args
|
23
|
+
return unless ::Contrast::INVENTORY.enable
|
24
|
+
|
25
|
+
marker = properties[DATA_STORE_MARKER]
|
26
|
+
return unless marker
|
27
|
+
|
28
|
+
file_report(marker)
|
29
|
+
rescue StandardError => e
|
30
|
+
logger.error('Error reporting database call', e, object: object)
|
31
|
+
end
|
32
|
+
|
33
|
+
private
|
34
|
+
|
35
|
+
def file_report data_store
|
36
|
+
return unless data_store
|
37
|
+
|
38
|
+
context = Contrast::Agent::REQUEST_TRACKER.current
|
39
|
+
return unless context&.activity
|
40
|
+
|
41
|
+
context.activity.query_count += 1
|
42
|
+
return unless context.activity.query_count == 1
|
43
|
+
|
44
|
+
Contrast::Agent::Inventory::DatabaseConfig.append_db_config(context.activity)
|
45
|
+
end
|
46
|
+
end
|
47
|
+
end
|
48
|
+
end
|
49
|
+
end
|
50
|
+
end
|
51
|
+
end
|