contrast-agent 6.15.3 → 7.1.0

data/lib/contrast/agent/reporting/reporting_utilities/reporter_client.rb

@@ -5,14 +5,15 @@ require 'json'
 require 'net/http'
 require 'contrast/components/logger'
 require 'contrast/utils/net_http_base'
+require 'contrast/config/diagnostics/monitor'
 require 'contrast/agent/reporting/connection_status'
-require 'contrast/agent/reporting/reporting_utilities/response_handler'
-require 'contrast/agent/reporting/reporting_utilities/reporter_client_utils'
-require 'contrast/agent/reporting/reporting_utilities/endpoints'
 require 'contrast/agent/reporting/reporting_utilities/headers'
+require 'contrast/agent/reporting/reporting_utilities/endpoints'
 require 'contrast/agent/reporting/reporting_events/server_settings'
+require 'contrast/agent/reporting/reporting_utilities/response_handler'
 require 'contrast/agent/reporting/reporting_events/application_settings'
-require 'contrast/config/diagnostics'
+require 'contrast/agent/reporting/reporting_events/agent_effective_config'
+require 'contrast/agent/reporting/reporting_utilities/reporter_client_utils'
 
 module Contrast
   module Agent
@@ -57,6 +58,7 @@ module Contrast
         # @param connection [Net::HTTP] open connection
         def startup! connection
           return if status.startup_messages_sent?
+          return unless connection
 
           send_agent_startup(connection)
         end
@@ -76,7 +78,7 @@ module Contrast
           response = connection.request(request)
           audit&.audit_event(event, response) if ::Contrast::API.request_audit_enable
           process_settings_response(response, event)
-          record_configuration(response, event)
+          report_configuration(response, event)
           process_preflight_response(event, response, connection)
           response
         rescue StandardError => e
@@ -90,7 +92,7 @@ module Contrast
         #
         # @param response [Contrast::Agent::Reporting::Response, nil]
         # @param event [Contrast::Agent::Reporting::ReportingEvent]
-        def record_configuration response, event
+        def report_configuration response, event
           return unless response
 
           diagnostics.config.determine_config_status(response_handler.last_response_code || response.code)
@@ -99,6 +101,8 @@ module Contrast
 
           logger.info('[Reporter Diagnostics] last response code:', response_code: response_handler.last_response_code)
           diagnostics.write_to_file
+          config_event = Contrast::Agent::Reporting::AgentEffectiveConfig.new(diagnostics)
+          Contrast::Agent.reporter.send_event(config_event)
         end
 
         def status
@@ -110,7 +114,7 @@ module Contrast
         end
 
         def diagnostics
-          @_diagnostics ||= Contrast::Agent::DiagnosticsConfig::Diagnostics.new(Contrast::LOGGER.path)
+          @_diagnostics ||= Contrast::Config::Diagnostics::Monitor.new(Contrast::LOGGER.path)
         end
 
         def sleep?

data/lib/contrast/agent/reporting/reporting_utilities/reporter_client_utils.rb

@@ -53,19 +53,15 @@ module Contrast
         # @param request [Net::HTTPRequest]
         # @return [Net::HTTPRequest]
         def build_headers request
-          app_version = @headers.app_version
-          request['API-Key'] = @headers.api_key
-          request['Application-Language'] = @headers.app_language
-          request['Application-Name'] = @headers.app_name
-          request['Application-Path'] = @headers.app_path
-          request['Application-Version'] = app_version if app_version
+          build_application_headers(request)
+          build_encode_and_compress_headers(request)
           request['Authorization'] = @headers.authorization
           request['Server-Name'] = @headers.server_name
           request['Server-Path'] = @headers.server_path
           request['Server-Type'] = @headers.server_type
           request['X-Contrast-Agent'] = @headers.agent_version
           request['X-Contrast-Header-Encoding'] = @headers.encoding
-          build_encode_and_compress_headers(request)
+          request['Session-ID'] = @headers.session_id
           request
         end
 
@@ -155,6 +151,18 @@ module Contrast
           request['X-Contrast-Encoding'] = @headers.compression
           request['Content-Encoding'] = @headers.compression
         end
+
+        # Adds corresponding application headers to request.
+        #
+        # @param request [Net::HTTPRequest]
+        def build_application_headers request
+          app_version = @headers.app_version
+          request['API-Key'] = @headers.api_key
+          request['Application-Language'] = @headers.app_language
+          request['Application-Name'] = @headers.app_name
+          request['Application-Path'] = @headers.app_path
+          request['Application-Version'] = app_version if app_version
+        end
       end
     end
   end

data/lib/contrast/agent/reporting/reporting_utilities/response_handler_utils.rb

@@ -4,6 +4,7 @@
 require 'contrast/agent/reporting/reporting_utilities/ng_response_extractor'
 require 'contrast/agent/reporting/reporting_utilities/response_extractor'
 require 'contrast/agent/reactions/disable_reaction'
+require 'contrast/utils/json'
 
 module Contrast
   module Agent
@@ -32,7 +33,8 @@ module Contrast
         FORBIDDEN_NO_ACTION_MSG = 'Report access was forbidden because the supplied credentials failed ' \
                                   'to authenticate the Agent'
         UNPROCESSABLE_ENTITY_MSG = 'Reporter received Unprocessable Entity response. Disabling permanently.'
-        RETRY_AFTER_MSG = "There are too many requests of this type being sent by this Agent. #{ SUSPEND_MSG }"
+        RETRY_AFTER_MSG = 'There are too many requests of this type being sent by this Agent. ' \
+                          "#{ SUSPEND_MSG }".cs__freeze
 
         def last_response_code
           @_last_response_code ||= ''
@@ -256,7 +258,7 @@ module Contrast
           response_body = response&.body
           return unless response_body
 
-          response_data = JSON.parse(response_body, symbolize_names: true)
+          response_data = Contrast::Utils::Json.parse(response_body, deep_symbolize: true)
           return unless response_data.cs__is_a?(Hash)
 
           extract_response_last_modified(response, event)

data/lib/contrast/agent/reporting/reporting_workers/application_server_worker.rb

@@ -13,11 +13,14 @@ module Contrast
         RESEND_INTERVAL_MS = 30_000.cs__freeze
 
         def start_thread!
+          return unless attempt_to_start?
           return if running?
 
           @_thread = Contrast::Agent::Thread.new do
             logger.info('[ApplicationSettingsWorker] Starting thread.', sending_interval: application_server_ms)
             loop do
+              break unless attempt_to_start?
+
               logger.info('[ApplicationSettingsWorker] Fetching Settings', sending_interval: application_server_ms)
               Contrast::Agent.reporter&.send_event(application_settings_message)
               sleep(application_server_ms / 1000)

data/lib/contrast/agent/reporting/reporting_workers/reporter_heartbeat.rb

@@ -19,11 +19,14 @@ module Contrast
         REFRESH_INTERVAL_SEC = 60
 
         def start_thread!
+          return unless attempt_to_start?
           return if running?
 
           @_thread = Contrast::Agent::Thread.new do
             logger.info('[Heartbeat] Starting thread.')
             loop do
+              break unless attempt_to_start?
+
               polling_events.each do |event|
                 Contrast::Agent.reporter&.send_event(event)
               end

data/lib/contrast/agent/reporting/reporting_workers/server_settings_worker.rb

@@ -13,11 +13,14 @@ module Contrast
         RESEND_INTERVAL_MS = 60_000.cs__freeze
 
         def start_thread!
+          return unless attempt_to_start?
           return if running?
 
           @_thread = Contrast::Agent::Thread.new do
             logger.info('[ServerSettingsWorker] Starting thread.', sending_interval: server_settings_resend_ms)
             loop do
+              break unless attempt_to_start?
+
               logger.info('[ServerSettingsWorker] Fetching Settings', sending_interval: server_settings_resend_ms)
               Contrast::Agent.reporter&.send_event(settings_message)
               sleep(server_settings_resend_ms / 1000)

data/lib/contrast/agent/telemetry/base.rb

@@ -46,6 +46,39 @@ module Contrast
             @enabled
           end
 
+          # In case of connection error, do not create the background thread or queue,
+          # as if the opt-out env var was set.
+          #
+          # @return [Boolean]
+          def ip_opt_out?
+            @_ip_opt_out ||= begin
+              test_conn = Contrast::Agent::Telemetry::Client.new.initialize_connection(URL)
+
+              if test_conn.nil? || Contrast::Utils::NetHttpBase.last_error
+                # log if error:
+                if defined?(Contrast) && defined?(Contrast::CONFIG) && defined?(Contrast::CONFIG)
+                  Contrast::CONFIG.proto_logger.warn('[Telemetry] connection error disabling...',
+                                                     error: Contrast::Utils::NetHttpBase.last_error)
+
+                end
+                # Disable telemetry:
+                @enabled = false
+                true
+              else
+                # Close the connection
+                test_conn.finish if test_conn.started?
+                false
+              end
+            end
+          rescue StandardError
+            @enabled = false
+            true
+          end
+
+          def disable!
+            @enabled = false
+          end
+
           private
 
           def telemetry_enabled?
@@ -56,15 +89,7 @@ module Contrast
 
             # In case of connection error, do not create the background thread or queue,
             # as if the opt-out env var was set
-            @_client = Contrast::Agent::Telemetry::Client.new
-            ip_opt_out_telemetry = @_client.initialize_connection(URL)
-            if ip_opt_out_telemetry.nil?
-              # TODO: RUBY-2033 we cannot log the error above debug level here b/c it results in
-              #   an infinite loop w/ telemetry
-              logger.debug("[Telemetry] Connection was not established properly!!! \n
-                          Telemetry reporting will be disabled!")
-              return false
-            end
+            return false if ip_opt_out?
 
             true
           end
@@ -91,6 +116,7 @@ module Contrast
         end
 
         def start_thread!
+          return unless attempt_to_start?
           return if running?
 
           logger.debug('[Telemetry] Starting background telemetry thread.')
@@ -140,6 +166,7 @@ module Contrast
           Contrast::Agent::Thread.new do
             loop do
               next unless client && connection
+              break unless attempt_to_start?
 
               # Start pushing exceptions to queue for reporting.
               Contrast::TELEMETRY_EXCEPTIONS.each_value { |value| queue << value }
@@ -155,9 +182,7 @@ module Contrast
                     sleep(retry_sleep_time) unless retry_sleep_time.nil?
                   end
                 rescue StandardError => e
-                  # TODO: RUBY-2033 we cannot log the error above debug level here b/c it results in
-                  #   an infinite loop w/ telemetry
-                  logger.debug('[Telemetry] Could not send message to service from telemetry queue.', e)
+                  logger.error('[Telemetry] Could not send message to service from telemetry queue.', e)
                   stop!
                 end
               end

data/lib/contrast/agent/telemetry/client.rb

@@ -100,9 +100,7 @@ module Contrast
         def get_event_json event
           Array(event.to_controlled_hash).to_json
         rescue Exception => e # rubocop:disable Lint/RescueException
-          # TODO: RUBY-2033 we cannot log the error above debug level here b/c it results in
-          #   an infinite loop w/ telemetry
-          logger.debug('[Telemetry] Unable to convert TelemetryEvent to JSON string', e, hsh)
+          logger.error('[Telemetry] Unable to convert TelemetryEvent to JSON string', e, hsh)
           raise(e)
         end
       end

data/lib/contrast/agent/telemetry/telemetry.rb

@@ -92,13 +92,6 @@ module Contrast
         #
         # @return [Boolean]
         def telemetry_exceptions_enabled?
-          opts_out_telemetry = return_value(:telemetry_opt_outs).to_s
-          return false if opts_out_telemetry.casecmp?('true') || opts_out_telemetry == '1'
-          # Double check if telemetry is enabled, this includes a check for Agent enable setting in the
-          # config. In case of disabled Agent the queue won't be created and the Telemetry would not
-          # be enabled. This check is here to prevent a loop of error creations that could no be added
-          # to a queue ( because the client cannot be initialized if the Agent is disabled or settings are
-          # missing).
           return false unless Contrast::Agent::Telemetry::Base.enabled?
 
           true

data/lib/contrast/agent/thread/thread_watcher.rb

@@ -6,7 +6,7 @@ require 'contrast/agent/reporting/report'
 require 'contrast/agent/reporting/reporting_workers/reporting_workers'
 require 'contrast/agent/telemetry/base'
 require 'contrast/agent/protect/input_analyzer/worth_watching_analyzer'
-require 'contrast/config/diagnostics'
+require 'contrast/config/diagnostics/monitor'
 require 'contrast/utils/job_servers_running'
 
 module Contrast
@@ -114,7 +114,7 @@ module Contrast
       def check_before_start
         return if Contrast::CONFIG.send(:validate)
 
-        @_diagnostics = Contrast::Agent::DiagnosticsConfig::Diagnostics.new(Contrast::AGENT.logger.path ||
+        @_diagnostics = Contrast::Config::Diagnostics::Monitor.new(Contrast::AGENT.logger.path ||
                                                                             Contrast::Components::Config::CONTRAST_LOG)
         @_diagnostics.config.populate_fail_connection
         @_diagnostics.write_to_file_logic(false, reset: false)

data/lib/contrast/agent/version.rb

@@ -3,6 +3,6 @@
 
 module Contrast
   module Agent
-    VERSION = '6.15.3'
+    VERSION = '7.1.0'
   end
 end

data/lib/contrast/components/agent.rb

@@ -137,7 +137,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           super
           logger&.to_effective_config(effective_config)

data/lib/contrast/components/api.rb

@@ -18,7 +18,7 @@ module Contrast
         include Contrast::Config::BaseConfiguration
 
         CANON_NAME = 'api'
-        PROXY_NAME = "#{ CANON_NAME }.proxy"
+        PROXY_NAME = "#{ CANON_NAME }.proxy".cs__freeze
         CONFIG_VALUES = %w[api_key user_name service_key url].cs__freeze
 
         # @return [String]
@@ -127,7 +127,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           add_effective_config_values(effective_config, CONFIG_VALUES, CANON_NAME, CONTRAST)
           effective_proxy(effective_config)
@@ -137,7 +137,7 @@ module Contrast
 
         private
 
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def effective_proxy effective_config
           add_single_effective_value(effective_config, ENABLE, proxy_enable.to_s, PROXY_NAME, "#{ CONTRAST }.proxy")
           return unless proxy_url && proxy_enable

data/lib/contrast/components/app_context.rb

@@ -161,7 +161,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           super
           Contrast::CONFIG.server.to_effective_config(effective_config)

data/lib/contrast/components/assess.rb

@@ -218,7 +218,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           super
           sampling&.to_effective_config(effective_config)

data/lib/contrast/components/assess_rules.rb

@@ -16,7 +16,7 @@ module Contrast
 
         SPEC_KEY = :disabled_rules.cs__freeze
         CANON_NAME = 'assess.rules'
-        NAME_PREFIX = "#{ CONTRAST }.#{ CANON_NAME }"
+        NAME_PREFIX = "#{ CONTRAST }.#{ CANON_NAME }".cs__freeze
 
         # @return [Array, nil] list of disabled assess rules
         attr_accessor :disabled_rules
@@ -34,7 +34,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           add_single_effective_value(effective_config, SPEC_KEY.to_s, disabled_rules, canon_name, NAME_PREFIX)
         end

data/lib/contrast/components/base.rb

@@ -1,7 +1,7 @@
 # Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
 # frozen_string_literal: true
 
-require 'contrast/config/diagnostics_tools'
+require 'contrast/config/diagnostics/tools'
 require 'contrast/utils/object_share'
 
 module Contrast
@@ -9,7 +9,7 @@ module Contrast
     # All components should inherit from this,
     # whether Interfaces, InstanceMethods or ClassMethods.
     module ComponentBase
-      include Contrast::Agent::DiagnosticsConfig::DiagnosticsTools
+      include Contrast::Config::Diagnostics::Tools
 
       CONTRAST = 'contrast'
       ENABLE = 'enable'
@@ -84,7 +84,7 @@ module Contrast
       # Converts current configuration to effective config values class and appends them to
       # EffectiveConfig class.
       #
-      # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+      # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
       def to_effective_config effective_config
         add_effective_config_values(effective_config, config_values, canon_name, "#{ CONTRAST }.#{ canon_name }")
       end

data/lib/contrast/components/config/sources.rb

@@ -11,11 +11,14 @@ module Contrast
       # This component encapsulates storing the source for each entry in the config,
       # so that we can report on where the value was set from.
       class Sources
-        ENVIRONMENT = 'ENV'
-        CLI = 'CLI'
-        CONTRASTUI = 'ContrastUI'
-        DEFAULT = 'Default'
-        YAML = 'YAML'
+        ENVIRONMENT_VARIABLE = 'ENV'
+        COMMAND_LINE = 'CLI'
+        CONTRAST_UI = 'ContrastUI'
+        DEFAULT_VALUE = 'Default'
+        # Order matters for the Configurations files. This is read when Agent starts up and will always go
+        # through the YAML as priority.
+        # Do not change the order!
+        APP_CONFIGURATION_FILE = %w[YAML YML].cs__freeze
 
         # @return [Hash]
         attr_reader :data
@@ -30,15 +33,15 @@ module Contrast
         # @param path [String] the canonical name for the config entry (such as api.proxy.enable)
         # @return [String] the source for the entry
         def get path
-          data.dig(*parts_for(path)) || DEFAULT
+          data.dig(*parts_for(path)) || DEFAULT_VALUE
         rescue TypeError
-          DEFAULT
+          DEFAULT_VALUE
         end
 
         # Assigns the config source for a specified config path.
         #
         # @param path [String] the canonical name for the config entry (such as api.proxy.enable)
-        # @param [String] the source for the entry
+        # @param source[String] the source for the entry
         # @return [String] the source type for the entry
         def set path, source
           assign_value(data, parts_for(path), source)
@@ -64,7 +67,7 @@ module Contrast
         # @param current_level [Hash] all, or some of, the config source information
         # @param parts [Array] the parts for canonical name of the config entry
         # @param source [String] the source to be set for the specified entry
-        # @return [Array] the path split on periods, and converted to symbols
+        # @return [String] the path split on periods, and converted to symbols
         def assign_value current_level, parts, source
           parts[0...-1].each do |segment|
             current_level[segment] ||= {}

data/lib/contrast/components/config.rb

@@ -4,7 +4,7 @@
 require 'contrast/utils/env_configuration_item'
 require 'ougai'
 require 'contrast/configuration'
-require 'contrast/config/diagnostics'
+require 'contrast/config/diagnostics/monitor'
 
 module Contrast
   module Components
@@ -249,7 +249,7 @@ module Contrast
           return unless current_level.nil? == false && current_level.cs__respond_to?(dot_path_array[-1])
 
           current_level.send("#{ dot_path_array[-1] }=", value)
-          sources.set(dot_path_array.join('.'), Contrast::Components::Config::Sources::ENVIRONMENT)
+          sources.set(dot_path_array.join('.'), Contrast::Components::Config::Sources::ENVIRONMENT_VARIABLE)
         end
       end
     end

data/lib/contrast/components/protect.rb

@@ -130,7 +130,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           super
           protect_rules_to_effective_config(effective_config)
@@ -138,7 +138,7 @@ module Contrast
 
         private
 
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def protect_rules_to_effective_config effective_config
           return unless defend_rules
 

data/lib/contrast/components/sampling.rb

@@ -103,7 +103,7 @@ module Contrast
         include Contrast::Config::BaseConfiguration
 
         CANON_NAME = 'assess.sampling'
-        NAME_PREFIX = "#{ CONTRAST }.#{ CANON_NAME }"
+        NAME_PREFIX = "#{ CONTRAST }.#{ CANON_NAME }".cs__freeze
         CONFIG_VALUES = %w[enable baseline request_frequency response_frequency window_ms].cs__freeze
 
         # @return [Integer, nil]
@@ -136,7 +136,7 @@ module Contrast
         # Converts current configuration to effective config values class and appends them to
         # EffectiveConfig class.
         #
-        # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+        # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
         def to_effective_config effective_config
           confirm_sources
 
@@ -161,10 +161,11 @@ module Contrast
         # back to the default values.
         def confirm_sources
           if sampling_control[:enabled] == DEFAULT_SAMPLING_ENABLED
-            Contrast::CONFIG.sources.set('assess.sampling.enable', Contrast::Components::Config::Sources::DEFAULT)
+            Contrast::CONFIG.sources.set('assess.sampling.enable', Contrast::Components::Config::Sources::DEFAULT_VALUE)
           end
           if sampling_control[:window] == DEFAULT_SAMPLING_WINDOW_MS
-            Contrast::CONFIG.sources.set('assess.sampling.window_ms', Contrast::Components::Config::Sources::DEFAULT)
+            Contrast::CONFIG.sources.set('assess.sampling.window_ms',
+                                         Contrast::Components::Config::Sources::DEFAULT_VALUE)
           end
           {
               'baseline' => :baseline,
@@ -172,7 +173,8 @@ module Contrast
               'response_frequency' => :response_frequency
           }.each do |k, v|
             if sampling_control[v] == cs__class.cs__const_get("DEFAULT_SAMPLING_#{ v.upcase }")
-              Contrast::CONFIG.sources.set("assess.sampling.#{ k }", Contrast::Components::Config::Sources::DEFAULT)
+              Contrast::CONFIG.sources.set("assess.sampling.#{ k }",
+                                           Contrast::Components::Config::Sources::DEFAULT_VALUE)
             end
           end
         end

data/lib/contrast/components/settings.rb

@@ -283,7 +283,7 @@ module Contrast
           return unless level.cs__is_a?(Hash)
 
           level[parts[-1]] = value
-          Contrast::CONFIG.sources.set(parts.join('.'), Contrast::Components::Config::Sources::CONTRASTUI)
+          Contrast::CONFIG.sources.set(parts.join('.'), Contrast::Components::Config::Sources::CONTRAST_UI)
         end
       end
     end

data/lib/contrast/config/certification_configuration.rb

@@ -38,7 +38,7 @@ module Contrast
       # Converts current configuration to effective config values class and appends them to
       # EffectiveConfig class.
       #
-      # @param effective_config [Contrast::Agent::DiagnosticsConfig::EffectiveConfig]
+      # @param effective_config [Contrast::Config::Diagnostics::EffectiveConfig]
       def to_effective_config effective_config
         add_effective_config_values(effective_config, CONFIG_VALUES, CANON_NAME, CONTRAST)
       end

data/lib/contrast/config/configuration_files.rb

@@ -0,0 +1,47 @@
+# Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# frozen_string_literal: true
+
+require 'contrast/utils/duck_utils'
+require 'contrast/utils/object_share'
+require 'contrast/components/config/sources'
+require 'contrast/config/diagnostics/tools'
+
+module Contrast
+  module Config
+    # This class will hold all the references for the configuration files. It will safe read values used to
+    # identify the source of configuration in Configuration Diagnostics reported to TS.
+    class ConfigurationFiles
+      # @return [String] path of the main configuration file.
+      attr_accessor :main_file
+
+      # @return [Array<Contrast::Config::LocalSourceValue>]
+      def source_files
+        @_source_files ||= []
+      end
+
+      # @param path [String]
+      # @param values [Hash]
+      def add_source_file path, values
+        source_files << Contrast::Config::LocalSourceValue.new(path, values)
+        @main_file = path if source_files.length == 1
+      end
+    end
+
+    # This class will hold all the info about the read file.
+    class LocalSourceValue
+      YML_EXT = '.yml'
+      YAML_EXT = '.yaml'
+      # @return [String]
+      attr_reader :path
+      # @return [Hash]
+      attr_reader :values
+
+      # @param path [String]
+      # @param values [Hash]
+      def initialize path = '', values = {}
+        @path = path unless Contrast::Utils::DuckUtils.empty_duck?(path)
+        @values = values
+      end
+    end
+  end
+end

data/lib/contrast/config/diagnostics/command_line.rb

@@ -0,0 +1,24 @@
+# Copyright (c) 2023 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
+# frozen_string_literal: true
+
+require 'contrast/config/diagnostics/effective_config_value'
+require 'contrast/config/diagnostics/tools'
+require 'contrast/utils/object_share'
+
+module Contrast
+  module Config
+    module Diagnostics
+      # Reads All ENV variables.
+      module CommandLine
+        class << self
+          def command_line_settings
+            cli = Contrast::Config::Diagnostics::Tools.flatten_settings(Contrast::CONFIG.sources.
+              for(Contrast::Components::Config::Sources::COMMAND_LINE))
+
+            Contrast::Config::Diagnostics::Tools.to_config_values(cli, source: true)
+          end
+        end
+      end
+    end
+  end
+end