theforeman/foreman · error · Foreman::Exception

SSL CA file not found, check the 'Server CA file' and 'SSL C

Error message

SSL CA file not found, check the 'Server CA file' and 'SSL CA file' in Settings > Authentication

What it means

Error "SSL CA file not found, check the 'Server CA file' and 'SSL CA file' in Settings > Authentication" thrown in theforeman/foreman.

Source

Thrown at app/services/foreman/renderer/scope/macros/base.rb:393

          def foreman_server_ca_cert(server_ca_file_enabled: true, ssl_ca_file_enabled: true)
            setting_values = []
            setting_values << Setting[:server_ca_file] if server_ca_file_enabled
            setting_values << Setting[:ssl_ca_file] if ssl_ca_file_enabled

            raise UndefinedSetting.new(setting: '"Server CA file" or "SSL CA file"') if setting_values.reject(&:empty?).empty?

            files_content = setting_values.uniq.compact.map do |setting_value|
              File.read(setting_value)
            rescue StandardError => e
              Foreman::Logging.logger('templates').warn("Failed to read CA file: #{e}")

              nil
            end

            result = files_content.compact.join("\n")

            msg = N_("SSL CA file not found, check the 'Server CA file' and 'SSL CA file' in Settings > Authentication")
            raise Foreman::Exception.new(msg) unless result.present?

            result
          end

          apipie_method :rand, 'Returns random floating point numbers between 0 and 1' do
            desc 'When the attribute is smaller or equal to 1, the function return float. Otherwise it returns integer. '
            optional :args, ::Float, desc: 'Can take a parameter as max value for random number. For negative and float numbers produce interesting outputs'
            returns ::Float
            example 'rand #=> 0.5
                     rand #=> 0.8
                     rand(100) #=> 23
                     rand(100) #=> 72'
          end

          apipie :method, "Return the concatenated array with correct line break" do
            desc 'This method returns concatenated array with correct line break with the respect of output format.
                  For HTML output, it joins array members with <br> tag otherwise it uses a \n character.
                  It works as new line at CSV but at YAML and JSON it is used for separating of lines

View on GitHub (pinned to 6b05625475)

When it happens

Trigger: Thrown at app/services/foreman/renderer/scope/macros/base.rb:393 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

• SSL/TLS and certificate errors — how TLS handshakes and certificate validation fail.
• Authentication and authorization failures — expired tokens, bad credentials, and missing scopes.

AI-assisted analysis of theforeman/foreman@6b05625475 (2026-08-23). Data as JSON: /api/errors/d041ceebefed77d2. Report an issue: GitHub.