contrast-agent 4.14.0 → 5.2.0

data/lib/contrast/config/api_proxy_configuration.rb

@@ -1,13 +1,65 @@
-# Copyright (c) 2021 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
 # frozen_string_literal: true
 
 module Contrast
   module Config
     # Api Proxy keys configuration
     class ApiProxyConfiguration < BaseConfiguration
-      KEYS = { enable: false, url: EMPTY_VALUE }.cs__freeze
-      def initialize hsh
-        super(hsh, KEYS)
+      # @return [String] proxy url
+      attr_reader :url
+
+      def initialize hsh = {}
+        @enable = traverse_config(hsh, :enable)
+        @url = traverse_config(hsh, :url)
+        @configuration_map = {}
+        build_configuration_map
+      end
+
+      # @return [Boolean, false]
+      def enable
+        @enable.nil? ? false : @enable
+      end
+
+      def enable= value
+        self['enable'] = value
+      end
+
+      def url= value
+        self['url'] = value
+      end
+
+      # TODO: RUBY-1493 MOVE TO BASE CONFIG
+
+      def []= key, value
+        instance_variable_set("@#{ key }".to_sym, value)
+        @configuration_map[key] = value
+      end
+
+      def [] key
+        send(key.to_sym)
+      end
+
+      # Traverse the given entity to build out the configuration graph.
+      #
+      # The values will be either a hash, indicating internal nodes to
+      # traverse, or a value to set or the EMPTY_VALUE symbol, indicating a
+      # leaf node.
+      #
+      # The spec_key are the Contrast defined keys based on the instance variables of
+      # a given configuration.
+      def traverse_config values, spec_key
+        internal_nodes = values.cs__respond_to?(:has_key?)
+        val = internal_nodes ? value_from_key_config(spec_key, values) : nil
+        val == EMPTY_VALUE ? nil : val
+      end
+
+      def build_configuration_map
+        instance_variables.each do |key|
+          str_key = key.to_s.tr('@', '')
+          next if str_key == 'configuration_map'
+
+          @configuration_map[str_key] = send(str_key.to_sym)
+        end
       end
     end
   end

data/lib/contrast/config/application_configuration.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
 # frozen_string_literal: true
 
 require 'contrast/utils/object_share'
@@ -8,21 +8,120 @@ module Contrast
     # Common Configuration settings. Those in this section pertain to the
     # application identification functionality of the Agent.
     class ApplicationConfiguration < BaseConfiguration
-      KEYS = {
-          name: EMPTY_VALUE,
-          version: EMPTY_VALUE,
-          language: EMPTY_VALUE,
-          path: EMPTY_VALUE,
-          group: EMPTY_VALUE,
-          tags: EMPTY_VALUE,
-          code: EMPTY_VALUE,
-          metadata: EMPTY_VALUE,
-          session_id: Contrast::Utils::ObjectShare::EMPTY_STRING,
-          session_metadata: Contrast::Utils::ObjectShare::EMPTY_STRING
-      }.cs__freeze
-
-      def initialize hsh
-        super(hsh, KEYS)
+      # @return [String]
+      attr_reader :name
+      # @return [String]
+      attr_reader :version
+      # @return [String]
+      attr_reader :language
+      # @return [String]
+      attr_reader :path
+      # @return [String]
+      attr_reader :group
+      # @return [String]
+      attr_reader :tags
+      # @return [String]
+      attr_reader :code
+      # @return [String]
+      attr_reader :metadata
+
+      def initialize hsh = {}
+        @name = traverse_config(hsh, :name)
+        @version = traverse_config(hsh, :version)
+        @language = traverse_config(hsh, :language)
+        @path = traverse_config(hsh, :path)
+        @group = traverse_config(hsh, :group)
+        @tags = traverse_config(hsh, :tags)
+        @code = traverse_config(hsh, :code)
+        @metadata = traverse_config(hsh, :metadata)
+        @session_id = traverse_config(hsh, :session_id)
+        @session_metadata = traverse_config(hsh, :session_metadata)
+        @configuration_map = {}
+        build_configuration_map
+      end
+
+      # @return [String, Contrast::Utils::ObjectShare::EMPTY_STRING]
+      def session_id
+        @session_id ||= Contrast::Utils::ObjectShare::EMPTY_STRING
+      end
+
+      # @return [String, Contrast::Utils::ObjectShare::EMPTY_STRING]
+      def session_metadata
+        @session_metadata ||= Contrast::Utils::ObjectShare::EMPTY_STRING
+      end
+
+      def name= value
+        self['name'] = value
+      end
+
+      def version= value
+        self['version'] = value
+      end
+
+      def language= value
+        self['language'] = value
+      end
+
+      def path= value
+        self['path'] = value
+      end
+
+      def group= value
+        self['group'] = value
+      end
+
+      def tags= value
+        self['tags'] = value
+      end
+
+      def code= value
+        self['code'] = value
+      end
+
+      def metadata= value
+        self['metadata'] = value
+      end
+
+      def session_id= value
+        self['session_id'] = value
+      end
+
+      def session_metadata= value
+        self['session_metadata'] = value
+      end
+
+      # TODO: RUBY-1493 MOVE TO BASE CONFIG
+
+      def []= key, value
+        instance_variable_set("@#{ key }".to_sym, value)
+        @configuration_map[key] = value
+      end
+
+      def [] key
+        send(key.to_sym)
+      end
+
+      # Traverse the given entity to build out the configuration graph.
+      #
+      # The values will be either a hash, indicating internal nodes to
+      # traverse, or a value to set or the EMPTY_VALUE symbol, indicating a
+      # leaf node.
+      #
+      # The spec_key are the Contrast defined keys based on the instance variables of
+      # a given configuration.
+      def traverse_config values, spec_key
+        internal_nodes = values.cs__respond_to?(:has_key?)
+        val = internal_nodes ? value_from_key_config(spec_key, values) : nil
+        val == EMPTY_VALUE ? nil : val
+      end
+
+      def build_configuration_map
+        instance_variables.each do |key|
+          str_key = key.to_s.tr('@', '')
+          next if str_key == 'configuration_map'
+
+          @configuration_map[str_key] = send(str_key.to_sym)
+        end
       end
     end
   end

data/lib/contrast/config/assess_configuration.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
 # frozen_string_literal: true
 
 module Contrast
@@ -6,18 +6,112 @@ module Contrast
     # Common Configuration settings. Those in this section pertain to the
     # assess functionality of the Agent.
     class AssessConfiguration < BaseConfiguration
-      KEYS = {
-          tags: EMPTY_VALUE,
-          enable: EMPTY_VALUE,
-          enable_scan_response: true,
-          enable_dynamic_sources: true,
-          sampling: Contrast::Config::SamplingConfiguration,
-          rules: Contrast::Config::AssessRulesConfiguration,
-          stacktraces: 'ALL'
-      }.cs__freeze
-
-      def initialize hsh
-        super(hsh, KEYS)
+      # @return [String, nil]
+      attr_reader :tags
+
+      DEFAULT_STACKTRACES = 'ALL'
+
+      def initialize hsh = {}
+        @enable = traverse_config(hsh, :enable)
+        @tags = traverse_config(hsh, :tags)
+        @enable_scan_response = traverse_config(hsh, :enable_scan_response)
+        @enable_dynamic_sources = traverse_config(hsh, :enable_dynamic_sources)
+        @sampling = Contrast::Config::SamplingConfiguration.new(traverse_config(hsh, :sampling))
+        @rules = Contrast::Config::AssessRulesConfiguration.new(traverse_config(hsh, :rules))
+        @stacktraces = traverse_config(hsh, :stacktraces)
+        @configuration_map = {}
+        build_configuration_map
+      end
+
+      # @return [Boolean, true]
+      def enable
+        @enable.nil? ? true : @enable
+      end
+
+      # @return [Boolean, true]
+      def enable_scan_response
+        @enable_scan_response.nil? ? true : @enable_scan_response
+      end
+
+      # @return [Boolean, true]
+      def enable_dynamic_sources
+        @enable_dynamic_sources.nil? ? true : @enable_dynamic_sources
+      end
+
+      # @return [Contrast::Config::SamplingConfiguration]
+      def sampling
+        @sampling ||= Contrast::Config::SamplingConfiguration.new
+      end
+
+      # @return [Contrast::Config::AssessRulesConfiguration]
+      def rules
+        @rules ||= Contrast::Config::AssessRulesConfiguration.new
+      end
+
+      # @return [String] stacktrace level
+      def stacktraces
+        @stacktraces ||= DEFAULT_STACKTRACES
+      end
+
+      def enable= value
+        self['enable'] = value
+      end
+
+      def tags= value
+        self['tags'] = value
+      end
+
+      def enable_scan_response= value
+        self['enable_scan_response'] = value
+      end
+
+      def enable_dynamic_sources= value
+        self['enable_dynamic_sources'] = value
+      end
+
+      def sampling= value
+        self['sampling'] = value
+      end
+
+      def rules= value
+        self['rules'] = value
+      end
+
+      def stacktraces= value
+        self['stacktraces'] = value
+      end
+      # TODO: RUBY-1493 MOVE TO BASE CONFIG
+
+      def []= key, value
+        instance_variable_set("@#{ key }".to_sym, value)
+        @configuration_map[key] = value
+      end
+
+      def [] key
+        send(key.to_sym)
+      end
+
+      # Traverse the given entity to build out the configuration graph.
+      #
+      # The values will be either a hash, indicating internal nodes to
+      # traverse, or a value to set or the EMPTY_VALUE symbol, indicating a
+      # leaf node.
+      #
+      # The spec_key are the Contrast defined keys based on the instance variables of
+      # a given configuration.
+      def traverse_config values, spec_key
+        internal_nodes = values.cs__respond_to?(:has_key?)
+        val = internal_nodes ? value_from_key_config(spec_key, values) : nil
+        val == EMPTY_VALUE ? nil : val
+      end
+
+      def build_configuration_map
+        instance_variables.each do |key|
+          str_key = key.to_s.tr('@', '')
+          next if str_key == 'configuration_map'
+
+          @configuration_map[str_key] = send(str_key.to_sym)
+        end
       end
     end
   end

data/lib/contrast/config/assess_rules_configuration.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
 # frozen_string_literal: true
 
 module Contrast
@@ -6,10 +6,51 @@ module Contrast
     # Common Configuration settings. Those in this section pertain to the
     # disabled assess rule functionality of the Agent.
     class AssessRulesConfiguration < BaseConfiguration
-      KEYS = { disabled_rules: EMPTY_VALUE }.cs__freeze
+      # @return [Array, nil] list of disabled assess rules
+      attr_reader :disabled_rules
 
-      def initialize hsh
-        super(hsh, KEYS)
+      def initialize hsh = {}
+        @disabled_rules = traverse_config(hsh, :disabled_rules)
+        @configuration_map = {}
+        build_configuration_map
+      end
+
+      def disabled_rules= value
+        self['disabled_rules'] = value
+      end
+
+      # TODO: RUBY-1493 MOVE TO BASE CONFIG
+
+      def []= key, value
+        instance_variable_set("@#{ key }".to_sym, value)
+        @configuration_map[key] = value
+      end
+
+      def [] key
+        send(key.to_sym)
+      end
+
+      # Traverse the given entity to build out the configuration graph.
+      #
+      # The values will be either a hash, indicating internal nodes to
+      # traverse, or a value to set or the EMPTY_VALUE symbol, indicating a
+      # leaf node.
+      #
+      # The spec_key are the Contrast defined keys based on the instance variables of
+      # a given configuration.
+      def traverse_config values, spec_key
+        internal_nodes = values.cs__respond_to?(:has_key?)
+        val = internal_nodes ? value_from_key_config(spec_key, values) : nil
+        val == EMPTY_VALUE ? nil : val
+      end
+
+      def build_configuration_map
+        instance_variables.each do |key|
+          str_key = key.to_s.tr('@', '')
+          next if str_key == 'configuration_map'
+
+          @configuration_map[str_key] = send(str_key.to_sym)
+        end
       end
     end
   end

data/lib/contrast/config/base_configuration.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
 # frozen_string_literal: true
 
 require 'forwardable'
@@ -30,6 +30,7 @@ module Contrast
       def assign_value_to_path_array dot_path_array, value
         current_level = self
         dot_path_array[0...-1].each do |segment|
+          segment = segment.tr('-', '_')
           current_level = current_level.send(segment) if current_level.cs__respond_to?(segment)
         end
         last_entry = dot_path_array[-1]

data/lib/contrast/config/certification_configuration.rb

@@ -1,14 +1,85 @@
-# Copyright (c) 2021 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
 # frozen_string_literal: true
 
 module Contrast
   module Config
     # Certificate Configuration
     class CertificationConfiguration < BaseConfiguration
-      KEYS = { enable: false, ca_file: EMPTY_VALUE, cert_file: EMPTY_VALUE, key_file: EMPTY_VALUE }.cs__freeze
+      # @return [String] path to CA Cert file
+      attr_reader :ca_file
+      # @return [String] path to Certification file
+      attr_reader :cert_file
+      # @return [String] path to Certification Key file
+      attr_reader :key_file
 
-      def initialize hsh
-        super(hsh, KEYS)
+      def initialize hsh = {}
+        @enable = traverse_config(hsh, :enable)
+        @ca_file = traverse_config(hsh, :ca_file)
+        @cert_file = traverse_config(hsh, :cert_file)
+        @key_file = traverse_config(hsh, :key_file)
+        @configuration_map = {}
+        build_configuration_map
+      end
+
+      # GETTERS
+
+      # @return [Boolean]
+      def enable
+        return false if @enable.nil?
+
+        @enable
+      end
+
+      # SETTERS
+
+      def enable= value
+        self['enable'] = value
+      end
+
+      def ca_file= value
+        self['ca_file'] = value
+      end
+
+      def cert_file= value
+        self['cert_file'] = value
+      end
+
+      def key_file= value
+        self['key_file'] = value
+      end
+
+      # TODO: RUBY-1493 MOVE TO BASE CONFIG
+
+      def []= key, value
+        instance_variable_set("@#{ key }".to_sym, value)
+        @configuration_map[key] = value
+      end
+
+      def [] key
+        send(key.to_sym)
+      end
+
+      # Traverse the given entity to build out the configuration graph.
+      #
+      # The values will be either a hash, indicating internal nodes to
+      # traverse, or a value to set or the EMPTY_VALUE symbol, indicating a
+      # leaf node.
+      #
+      # The spec_key are the Contrast defined keys based on the instance variables of
+      # a given configuration.
+      def traverse_config values, spec_key
+        internal_nodes = values.cs__respond_to?(:has_key?)
+        val = internal_nodes ? value_from_key_config(spec_key, values) : nil
+        val == EMPTY_VALUE ? nil : val
+      end
+
+      def build_configuration_map
+        instance_variables.each do |key|
+          str_key = key.to_s.tr('@', '')
+          next if str_key == 'configuration_map'
+
+          @configuration_map[str_key] = send(str_key.to_sym)
+        end
       end
     end
   end

data/lib/contrast/config/env_variables.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
 # frozen_string_literal: true
 
 module Contrast

data/lib/contrast/config/exception_configuration.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2021 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# Copyright (c) 2022 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
 # frozen_string_literal: true
 
 module Contrast
@@ -7,10 +7,68 @@ module Contrast
     # exception handling in Ruby, allowing for the override of Response Code
     # and Message when Security Exceptions are raised.
     class ExceptionConfiguration < BaseConfiguration
-      KEYS = { capture: EMPTY_VALUE, override_status: EMPTY_VALUE, override_message: EMPTY_VALUE }.cs__freeze
+      # @return [Integer] the HTTP status code override
+      attr_reader :override_status
+      # @return [String] the message text override
+      attr_reader :override_message
 
-      def initialize hsh
-        super(hsh, KEYS)
+      def initialize hsh = {}
+        @capture = traverse_config(hsh, :capture)
+        @override_status = traverse_config(hsh, :override_status)
+        @override_message = traverse_config(hsh, :override_message)
+        @configuration_map = {}
+        build_configuration_map
+      end
+
+      # @return [Boolean] default: false
+      def capture
+        @capture.nil? ? false : @capture
+      end
+
+      def capture= value
+        self['capture'] = value
+      end
+
+      def override_status= value
+        self['override_status'] = value
+      end
+
+      def override_message= value
+        self['override_message'] = value
+      end
+
+      # TODO: RUBY-1493 MOVE TO BASE CONFIG
+
+      def []= key, value
+        instance_variable_set("@#{ key }".to_sym, value)
+        @configuration_map[key] = value
+      end
+
+      def [] key
+        send(key.to_sym)
+      end
+
+      # Traverse the given entity to build out the configuration graph.
+      #
+      # The values will be either a hash, indicating internal nodes to
+      # traverse, or a value to set or the EMPTY_VALUE symbol, indicating a
+      # leaf node.
+      #
+      # The spec_key are the Contrast defined keys based on the instance variables of
+      # a given configuration.
+      def traverse_config values, spec_key
+        internal_nodes = values.cs__respond_to?(:has_key?)
+        val = internal_nodes ? value_from_key_config(spec_key, values) : nil
+        val == EMPTY_VALUE ? nil : val
+      end
+
+      def build_configuration_map
+        instance_variables.each do |key|
+          str_key = key.to_s.tr('@', '')
+          next if str_key == 'configuration_map'
+
+          @configuration_map[str_key] = send(str_key.to_sym)
+        end
       end
     end
   end