contrast-agent 4.14.0 → 5.2.0

data/lib/contrast/components/config.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/env_configuration_item'
@@ -80,27 +80,42 @@ module Contrast
         API_KEY = "Invalid configuration. Missing a required connection value 'api_key' is not set."
         API_SERVICE_KEY = "Invalid configuration. Missing a required connection value 'service_tag' is not set."
         API_USERNAME = "Invalid configuration. Missing a required connection value 'user_name' is not set."
+        # The config has information about how to construct the logger. If the config is invalid, and you want to know
+        # about it, then you have a circular dependency if you try to log it, so we use basic proto_logger to do this
+        # job.
         def validate
-          # The config has information about how to construct the logger.
-          # If the config is invalid, and you want to know about it, then
-          # you have a circular dependency if you try to log it,
-          # so we use basic proto_logger to do this job.
-          if !session_id.empty? && !session_metadata.empty?
+          return false unless valid_session_metadata?
+
+          valid_api?
+        end
+
+        # The use can set either the application's session id or session metadata or neither, but never both.
+        #
+        # @return [boolean]
+        def valid_session_metadata?
+          if !session_id&.empty? && !session_metadata&.empty?
             proto_logger.error(SESSION_VARIABLES)
             return false
           end
-          if bypass
-            msg = []
-            msg << API_URL unless api_url
-            msg << API_KEY unless api_key
-            msg << API_SERVICE_KEY unless api_service_key
-            msg << API_USERNAME unless api_username
-            msg.any? { |m| proto_logger.error(m) }
-            return false unless msg.empty?
-          end
           true
         end
 
+        # If the agent is to use the bypass to communicate with TeamServer directly, than it must have the
+        # configuration values required for that connection.
+        #
+        # @return [boolean]
+        def valid_api?
+          return true unless bypass
+
+          msg = []
+          msg << API_URL unless api_url
+          msg << API_KEY unless api_key
+          msg << API_SERVICE_KEY unless api_service_key
+          msg << API_USERNAME unless api_username
+          msg.any? { |m| proto_logger.error(m) }
+          msg.empty?
+        end
+
         def env_overrides
           # For env variables resembling CONTRAST__WHATEVER__NESTED_VALUE
           # override raw.whatever.nested_value

data/lib/contrast/components/contrast_service.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 'monitor'

data/lib/contrast/components/heap_dump.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/components/base'

data/lib/contrast/components/inventory.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
@@ -21,6 +21,10 @@ module Contrast
           @_analyze_libraries = !false?(::Contrast::CONFIG.root.inventory.analyze_libraries) if @_analyze_libraries.nil?
           @_analyze_libraries
         end
+
+        def tags
+          ::Contrast::CONFIG.root.inventory&.tags
+        end
       end
     end
   end

data/lib/contrast/components/logger.rb

@@ -1,7 +1,8 @@
-# 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/logger/log'
+require 'contrast/logger/cef_log'
 require 'contrast/components/base'
 
 module Contrast
@@ -12,6 +13,10 @@ module Contrast
           Contrast::Logger::Log.instance.logger
         end
 
+        def cef_logger
+          @_cef_logger ||= Contrast::Logger::CEFLog.instance.tap(&:build_logger)
+        end
+
         def add_trace_perf_logging_for sym, custom_message = nil
           logger.add_trace_perf_logging(self, sym, custom_message)
         end

data/lib/contrast/components/protect.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/components/base'
@@ -28,7 +28,8 @@ module Contrast
         end
 
         def rule_mode rule_id
-          ::Contrast::CONFIG.root.protect.rules[rule_id]&.applicable_mode ||
+          str = rule_id.tr('-', '_')
+          ::Contrast::CONFIG.root.protect.rules[str]&.applicable_mode ||
               ::Contrast::SETTINGS.application_state.modes_by_id[rule_id] ||
               Contrast::Api::Settings::ProtectionRule::Mode::NO_ACTION
         end
@@ -47,19 +48,24 @@ module Contrast
 
         def report_custom_code_sysfile_access?
           if @_report_custom_code_sysfile_access.nil?
-            ctrl = rule_config[Contrast::Agent::Protect::Rule::PathTraversal::NAME]
+            name_changed = Contrast::Agent::Protect::Rule::PathTraversal::NAME.tr('-', '_')
+            ctrl = rule_config[name_changed]
             @_report_custom_code_sysfile_access = true?(ctrl.detect_custom_code_accessing_system_files)
           end
           @_report_custom_code_sysfile_access
         end
 
         def forcibly_disabled?
-          @_forcibly_disabled ||= false?(::Contrast::CONFIG.root.protect.enable)
+          return @_forcibly_disabled unless @_forcibly_disabled.nil?
+
+          @_forcibly_disabled = false?(::Contrast::CONFIG.root.protect.enable)
         end
 
         private
 
         def forcibly_enabled?
+          return @_forcibly_enabled unless @_forcibly_enabled.nil?
+
           @_forcibly_enabled ||= true?(::Contrast::CONFIG.root.protect.enable)
         end
       end

data/lib/contrast/components/sampling.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/components/base'

data/lib/contrast/components/scope.rb

@@ -1,9 +1,9 @@
-# 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 'fiber'
-require 'monitor'
 require 'contrast/agent/scope'
+require 'cs__scope/cs__scope'
 
 # This is the Scope component.
 #
@@ -12,85 +12,99 @@ require 'contrast/agent/scope'
 # execution context for which we need to special case?".
 module Contrast
   module Components
-    module Scope # :nodoc:
-      MONITOR = Monitor.new
-      EXECUTION_CONTEXT = {} # rubocop:disable Style/MutableConstant
-
-      class Interface # :nodoc:
-        def initialize
-          # This is probably redundant with #scope_for_current_ec's nil check.
-          EXECUTION_CONTEXT[Fiber.current] = Contrast::Agent::Scope.new
-        end
-
-        # This returns the scope governing the current execution context. Use this sparingly, preferring the instance
-        # & class methods to access and query scope, rather than interacting with the scope object directly.
-        def scope_for_current_ec
-          MONITOR.synchronize do
-            return EXECUTION_CONTEXT[Fiber.current] ||= Contrast::Agent::Scope.new
-          end
-        end
-      end
-
-      module InstanceMethods # :nodoc:
-        # For each instance method on a scope, define a forwarder to the scope on the current execution context's scope.
-        def scope_for_current_ec
-          MONITOR.synchronize do
-            return EXECUTION_CONTEXT[Fiber.current] ||= Contrast::Agent::Scope.new
-          end
-        end
-
-        def enter_contrast_scope!
-          scope_for_current_ec.enter_contrast_scope!
-        end
-
-        def enter_deserialization_scope!
-          scope_for_current_ec.enter_deserialization_scope!
-        end
-
-        def enter_split_scope!
-          scope_for_current_ec.enter_split_scope!
-        end
-
-        def enter_scope! name
-          scope_for_current_ec.enter_scope! name
-        end
-
-        def exit_contrast_scope!
-          scope_for_current_ec.exit_contrast_scope!
-        end
-
-        def exit_deserialization_scope!
-          scope_for_current_ec.exit_deserialization_scope!
-        end
-
-        def exit_split_scope!
-          scope_for_current_ec.exit_split_scope!
-        end
-
-        def exit_scope! name
-          scope_for_current_ec.exit_scope! name
-        end
-
-        def in_contrast_scope?
-          scope_for_current_ec.in_contrast_scope?
-        end
-
-        def in_deserialization_scope?
-          scope_for_current_ec.in_deserialization_scope?
-        end
-
-        def in_split_scope?
-          scope_for_current_ec.in_split_scope?
-        end
-
-        def split_scope_depth
-          scope_for_current_ec.split_scope_depth
-        end
-
-        def in_scope? name
-          scope_for_current_ec.in_scope? name
-        end
-
+    # Constants defined in C:
+    #
+    # MONITOR = Mutex.new This was replaced from Monitor to Mutex.
+    # EXECUTION_CONTEXT = {} Hash containing all of the current ecs as keys pointing to their scope instances.
+    # EC_KEYS = [] set while we get the current ec, and used for sweeping the dead fibers in C.
+    #
+    # Methods defined in C:
+    #
+    # class Interface
+    #   initializes the scope for the current fiber context.
+    #   def initialize end;
+    #
+    #     This returns the scope governing the current execution context. Use this sparingly, preferring the instance
+    #    & class methods to access and query scope, rather than interacting with the scope object directly.
+    #   def scope_for_current_ec end;
+    # end
+    #
+    # module Scope
+    #   Singleton method for cleaning the dead fibers and unused scope instances, scope GC.
+    #   def self.sweep_dead_ecs end;
+    # end
+    module Scope
+      # Methods defined in C:
+      #
+      # For each instance method on a scope, define a forwarder to the scope on the
+      # current execution context's scope.
+      # def scope_for_current_ec end;
+      #
+      # all the methods bellow are used as forwarders to be executed in the current ec.
+      # exp: in_contrast_scope? => scope_for_current_ec.enter_contrast_scope!
+      #
+      # Check if we are in contrast scope.
+      # def in_contrast_scope? end;
+      # @return [Boolean] check if we are in contrast scope
+      #                   if the scope is above 0 return true.
+      #
+      # check if we are in deserialization scope.
+      # def in_deserialization_scope? end;
+      # @return [Boolean] check if we are in contrast scope
+      #                   if the scope is above 0 return true.
+      #
+      # check if we are in split scope.
+      # def in_split_scope? end;
+      # @return [Boolean] check if we are in contrast scope
+      #                   if the scope is above 0 return true.
+      #
+      # enter contrast scope.
+      # def enter_contrast_scope! end;
+      # @return @contrast_scope [Integer] contrast scope increased.
+      #
+      # enter deserialization scope.
+      # def enter_deserialization_scope! end;
+      # @return @deserialization_scope [Integer] deserialization scope increased.
+      #
+      # enter split scope.
+      # def enter_split_scope! end;
+      # @return @split_scope [Integer] split scope increased.
+      #
+      # check split scope depth.
+      # def split_scope_depth end;
+      # @return @split_scope [Integer] split scope depth.
+      #
+      # exit contrast scope.
+      # def exit_contrast_scope! end;
+      # @return @contrast_scope [Integer] contrast scope decreased.
+      #
+      # exit deserialization scope.
+      # def exit_deserialization_scope! end;
+      # @return @deserialization_scope [Integer] deserialization scope decreased.
+      #
+      # exit split scope.
+      # def exit_split_scope! end;
+      # @return @split_scope [Integer] split scope decreased.
+      #
+      # Static methods to be used, the cases are defined by the usage from the above methods
+      #
+      # check if are in specific scope.
+      # def in_scope? name end;
+      # @param name [Symbol] scope symbol representing scope to check.
+      # @return [Boolean] check if we are in passed scope.
+      #
+      # enter specific scope.
+      # def enter_scope! name end;
+      # @param name [Symbol] scope symbol representing scope to enter.
+      # @return scope [Integer] entered scope value increased.
+      #
+      # exit specific scope.
+      # def exit_cope! name end;
+      # @param name [Symbol] scope symbol representing scope to exit.
+      # @return scope [Integer] entered scope value decreased.
+      module InstanceMethods
+        # Forwarder to execute block in contrast scope under current
+        # method execution context. On completion exits scope.
         def with_contrast_scope
           scope_for_current_ec.enter_contrast_scope!
           yield
@@ -98,6 +112,8 @@ module Contrast
           scope_for_current_ec.exit_contrast_scope!
         end
 
+        # Forwarder to execute block in deserialization scope under current
+        # method execution context. On completion exits scope.
         def with_deserialization_scope
           scope_for_current_ec.enter_deserialization_scope!
           yield
@@ -105,6 +121,8 @@ module Contrast
           scope_for_current_ec.exit_deserialization_scope!
         end
 
+        # Forwarder to execute block in split scope under current
+        # method execution context. On completion exits scope.
         def with_split_scope
           scope_for_current_ec.enter_split_scope!
           yield
@@ -113,17 +131,6 @@ module Contrast
         end
       end
 
-      def self.sweep_dead_ecs
-        # TODO: RUBY-534, #sweep_dead_ecs compensates for a lack of weak tables. when we can use WeakRef, we should
-        #   investigate removing this call and instead use the WeakRef for the Execution Context's Keys or using our
-        #   Finalizers Hash for Fibers
-        MONITOR.synchronize do
-          EXECUTION_CONTEXT.delete_if do |ec, _scope|
-            !ec.alive?
-          end
-        end
-      end
-
       ClassMethods = InstanceMethods
     end
   end

data/lib/contrast/components/settings.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/api/settings.pb'
@@ -36,19 +36,32 @@ module Contrast
           @application_state.exclusion_matchers.select(&:code?)
         end
 
-        # @param server_features [Contrast::Api::Settings::ServerFeatures]
-        def update_from_server_features server_features
-          @protect_state.enabled = server_features.protect_enabled?
-          @assess_state.enabled = server_features.assess_enabled?
-          @assess_state.sampling_settings = server_features.assess.sampling
+        # @param features [Contrast::Api::Settings::ServerFeatures, Contrast::Agent::Reporting::Response]
+        def update_from_server_features features
+          if features&.class == Contrast::Agent::Reporting::Response
+            @protect_state.enabled = features.server_features.protect.enabled?
+            @assess_state.enabled = features.server_features.assess.enabled?
+            @assess_state.sampling_settings = features.server_features.assess.sampling
+          else
+            @protect_state.enabled = features.protect_enabled?
+            @assess_state.enabled = features.assess_enabled?
+            @assess_state.sampling_settings = features.assess.sampling
+          end
         end
 
-        # @param application_settings [Contrast::Api::Settings::ApplicationSettings]
-        def update_from_application_settings application_settings
-          new_vals = application_settings.application_state_translation
-          @application_state.modes_by_id = new_vals[:modes_by_id]
-          @application_state.exclusion_matchers = new_vals[:exclusion_matchers]
-          @assess_state.disabled_assess_rules = new_vals[:disabled_assess_rules]
+        # @param features [Contrast::Api::Settings::ApplicationSettings, Contrast::Agent::Reporting::Response]
+        def update_from_application_settings features
+          if features&.class == Contrast::Agent::Reporting::Response
+            @application_state.modes_by_id = features.application_settings.protect.protection_rules_to_settings_hash
+            # TODO: RUBY-1438 this needs to be translated
+            # @application_state.exclusion_matchers = new_vals[:exclusion_matchers]
+            @assess_state.disabled_assess_rules = features.application_settings.assess.disabled_rules
+          else
+            new_vals = features.application_state_translation
+            @application_state.modes_by_id = new_vals[:modes_by_id]
+            @application_state.exclusion_matchers = new_vals[:exclusion_matchers]
+            @assess_state.disabled_assess_rules = new_vals[:disabled_assess_rules]
+          end
         end
 
         # Wipe state to zero.

data/lib/contrast/config/agent_configuration.rb

@@ -1,23 +1,69 @@
-# 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/config/service_configuration'
+require 'contrast/config/logger_configuration'
+require 'contrast/config/ruby_configuration'
+require 'contrast/config/heap_dump_configuration'
+require 'contrast/config/api_configuration'
+
 module Contrast
   module Config
     # Common Configuration settings. Those in this section pertain to the
     # core functionality of the Agent.
     class AgentConfiguration < BaseConfiguration
-      KEYS = {
-          enable: EMPTY_VALUE,
-          start_bundled_service: true,
-          omit_body: EMPTY_VALUE,
-          service: Contrast::Config::ServiceConfiguration,
-          logger: Contrast::Config::LoggerConfiguration,
-          ruby: Contrast::Config::RubyConfiguration,
-          heap_dump: Contrast::Config::HeapDumpConfiguration
-      }.cs__freeze
-
-      def initialize hsh
-        super(hsh, KEYS)
+      attr_accessor :enable, :omit_body, :start_bundled_service, :api
+      attr_writer :ruby, :service, :logger, :heap_dump
+
+      def initialize hsh = {}
+        @enable = traverse_config(hsh, :enable)
+        @start_bundled_service = traverse_config(hsh, :start_bundled_service)
+        @omit_body = traverse_config(hsh, :omit_body)
+        @service = Contrast::Config::ServiceConfiguration.new(traverse_config(hsh, :service))
+        @logger = Contrast::Config::LoggerConfiguration.new(traverse_config(hsh, :logger))
+        @ruby = Contrast::Config::RubyConfiguration.new(traverse_config(hsh, :ruby))
+        @heap_dump = Contrast::Config::HeapDumpConfiguration.new(traverse_config(hsh, :heap_dump))
+        @configuration_map = {}
+        build_configuration_map
+      end
+
+      def service
+        @service ||= Contrast::Config::ServiceConfiguration.new({})
+      end
+
+      def logger
+        @logger ||= Contrast::Config::LoggerConfiguration.new({})
+      end
+
+      def ruby
+        @ruby ||= Contrast::Config::RubyConfiguration.new({})
+      end
+
+      def heap_dump
+        @heap_dump ||= Contrast::Config::HeapDumpConfiguration.new({})
+      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/api_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/config/api_proxy_configuration'
@@ -9,18 +9,106 @@ module Contrast
   module Config
     # Api keys configuration
     class ApiConfiguration < BaseConfiguration
-      URL = 'https://app.contrastsecurity.com/contrast'
-      KEYS = {
-          api_key: EMPTY_VALUE,
-          url: URL,
-          user_name: EMPTY_VALUE,
-          service_key: EMPTY_VALUE,
-          proxy: Contrast::Config::ApiProxyConfiguration,
-          request_audit: Contrast::Config::RequestAuditConfiguration,
-          certificate: Contrast::Config::CertificationConfiguration
-      }.cs__freeze
-      def initialize hsh
-        super(hsh, KEYS)
+      # @return [String]
+      attr_reader :api_key
+      # @return [String]
+      attr_reader :user_name
+      # @return [String]
+      attr_reader :service_key
+
+      DEFAULT_URL = 'https://app.contrastsecurity.com/Contrast'
+
+      def initialize hsh = {}
+        @api_key = traverse_config(hsh, :api_key)
+        @url = traverse_config(hsh, :url)
+        @user_name = traverse_config(hsh, :user_name)
+        @service_key = traverse_config(hsh, :service_key)
+        @proxy = Contrast::Config::ApiProxyConfiguration.new(traverse_config(hsh, :proxy))
+        @request_audit = Contrast::Config::RequestAuditConfiguration.new(traverse_config(hsh, :request_audit))
+        @certificate = Contrast::Config::CertificationConfiguration.new(traverse_config(hsh, :certificate))
+        @configuration_map = {}
+        build_configuration_map
+      end
+
+      def url
+        @url.nil? ? DEFAULT_URL : @url
+      end
+
+      # @return [Contrast::Config::ApiProxyConfiguration]
+      def proxy
+        @proxy ||= Contrast::Config::ApiProxyConfiguration.new
+      end
+
+      # @return [Contrast::Config::RequestAuditConfiguration]
+      def request_audit
+        @request_audit ||= Contrast::Config::RequestAuditConfiguration.new
+      end
+
+      # @return [Contrast::Config::CertificationConfiguration]
+      def certificate
+        @certificate ||= Contrast::Config::CertificationConfiguration.new
+      end
+
+      def api_key= value
+        self['api_key'] = value
+      end
+
+      def url= value
+        self['url'] = value
+      end
+
+      def user_name= value
+        self['user_name'] = value
+      end
+
+      def service_key= value
+        self['service_key'] = value
+      end
+
+      def proxy= value
+        self['proxy'] = value
+      end
+
+      def request_audit= value
+        self['request_audit'] = value
+      end
+
+      def certificate= value
+        self['certificate'] = 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