# encoding: utf-8 # Copyright 2015 Dominik Richter # author: Dominik Richter # author: Christoph Hartmann require 'logger' require 'thor' require 'json' require 'pp' require 'utils/json_log' require 'utils/latest_version' require 'inspec/base_cli' require 'inspec/plugin/v1' require 'inspec/plugin/v2' require 'inspec/runner_mock' require 'inspec/env_printer' require 'inspec/schema' class Inspec::InspecCLI < Inspec::BaseCLI class_option :log_level, aliases: :l, type: :string, desc: 'Set the log level: info (default), debug, warn, error' class_option :log_location, type: :string, desc: 'Location to send diagnostic log messages to. (default: STDOUT or Inspec::Log.error)' class_option :diagnose, type: :boolean, desc: 'Show diagnostics (versions, configurations)' class_option :color, type: :boolean, desc: 'Use colors in output.' class_option :interactive, type: :boolean, desc: 'Allow or disable user interaction' desc 'json PATH', 'read all tests in PATH and generate a JSON summary' option :output, aliases: :o, type: :string, desc: 'Save the created profile to a path' option :controls, type: :array, desc: 'A list of controls to include. Ignore all other tests.' profile_options def json(target) o = opts.dup diagnose(o) o['log_location'] = STDERR configure_logger(o) o[:backend] = Inspec::Backend.create(target: 'mock://') o[:check_mode] = true o[:vendor_cache] = Inspec::Cache.new(o[:vendor_cache]) profile = Inspec::Profile.for_target(target, o) info = profile.info # add in inspec version info[:generator] = { name: 'inspec', version: Inspec::VERSION, } dst = o[:output].to_s if dst.empty? puts JSON.dump(info) else if File.exist? dst puts "----> updating #{dst}" else puts "----> creating #{dst}" end fdst = File.expand_path(dst) File.write(fdst, JSON.dump(info)) end rescue StandardError => e pretty_handle_exception(e) end desc 'check PATH', 'verify all tests at the specified PATH' option :format, type: :string profile_options def check(path) # rubocop:disable Metrics/AbcSize o = opts.dup diagnose(o) o[:backend] = Inspec::Backend.create(target: 'mock://') o[:check_mode] = true o[:vendor_cache] = Inspec::Cache.new(o[:vendor_cache]) # run check profile = Inspec::Profile.for_target(path, o) result = profile.check if o['format'] == 'json' puts JSON.generate(result) else %w{location profile controls timestamp valid}.each do |item| puts format('%-12s %s', item.to_s.capitalize + ':', mark_text(result[:summary][item.to_sym])) end puts if result[:errors].empty? and result[:warnings].empty? puts 'No errors or warnings' else red = "\033[31m" yellow = "\033[33m" rst = "\033[0m" item_msg = lambda { |item| pos = [item[:file], item[:line], item[:column]].compact.join(':') pos.empty? ? item[:msg] : pos + ': ' + item[:msg] } result[:errors].each do |item| puts "#{red} ✖ #{item_msg.call(item)}#{rst}" end result[:warnings].each do |item| puts "#{yellow} ! #{item_msg.call(item)}#{rst}" end puts puts format('Summary: %s%d errors%s, %s%d warnings%s', red, result[:errors].length, rst, yellow, result[:warnings].length, rst) end end exit 1 unless result[:summary][:valid] rescue StandardError => e pretty_handle_exception(e) end desc 'vendor PATH', 'Download all dependencies and generate a lockfile in a `vendor` directory' option :overwrite, type: :boolean, default: false, desc: 'Overwrite existing vendored dependencies and lockfile.' def vendor(path = nil) o = opts.dup configure_logger(o) o[:logger] = Logger.new(STDOUT) o[:logger].level = get_log_level(o.log_level) vendor_deps(path, o) end desc 'archive PATH', 'archive a profile to tar.gz (default) or zip' profile_options option :output, aliases: :o, type: :string, desc: 'Save the archive to a path' option :zip, type: :boolean, default: false, desc: 'Generates a zip archive.' option :tar, type: :boolean, default: false, desc: 'Generates a tar.gz archive.' option :overwrite, type: :boolean, default: false, desc: 'Overwrite existing archive.' option :ignore_errors, type: :boolean, default: false, desc: 'Ignore profile warnings.' def archive(path) o = opts.dup diagnose(o) o[:logger] = Logger.new(STDOUT) o[:logger].level = get_log_level(o.log_level) o[:backend] = Inspec::Backend.create(target: 'mock://') # Force vendoring with overwrite when archiving vendor_options = o.dup vendor_options[:overwrite] = true vendor_deps(path, vendor_options) profile = Inspec::Profile.for_target(path, o) result = profile.check if result && !o[:ignore_errors] == false o[:logger].info 'Profile check failed. Please fix the profile before generating an archive.' return exit 1 end # generate archive exit 1 unless profile.archive(o) rescue StandardError => e pretty_handle_exception(e) end desc 'exec LOCATIONS', 'run all test files at the specified LOCATIONS.' # TODO: find a way for Thor not to butcher the formatting of this long_desc <<~EOT Loads the given profile(s) and fetches their dependencies if needed. Then connects to the target and executes any controls contained in the profiles. One or more reporters are used to generate output. ``` Exit codes: 0 Normal exit, all tests passed 1 Usage or general error 2 Error in plugin system 3 Fatal deprecation encountered 100 Normal exit, at least one test failed 101 Normal exit, at least one test skipped but none failed ``` Below are some examples of using `exec` with different test LOCATIONS: Automate: ``` inspec compliance login inspec exec compliance://username/linux-baseline ``` Supermarket: ``` inspec exec supermarket://username/linux-baseline ``` Local profile (executes all tests in `controls/`): ``` inspec exec /path/to/profile ``` Local single test (doesn't allow attributes or custom resources) ``` inspec exec /path/to/a_test.rb ``` Git via SSH ``` inspec exec git@github.com:dev-sec/linux-baseline.git ``` Git via HTTPS (.git suffix is required): ``` inspec exec https://github.com/dev-sec/linux-baseline.git ``` Private Git via HTTPS (.git suffix is required): ``` inspec exec https://API_TOKEN@github.com/dev-sec/linux-baseline.git ``` Private Git via HTTPS and cached credentials (.git suffix is required): ``` git config credential.helper cache git ls-remote https://github.com/dev-sec/linux-baseline.git inspec exec https://github.com/dev-sec/linux-baseline.git ``` Web hosted fileshare (also supports .zip): ``` inspec exec https://webserver/linux-baseline.tar.gz ``` Web hosted fileshare with basic authentication (supports .zip): ``` inspec exec https://username:password@webserver/linux-baseline.tar.gz ``` EOT exec_options def exec(*targets) o = opts(:exec).dup diagnose(o) configure_logger(o) runner = Inspec::Runner.new(o) targets.each { |target| runner.add_target(target) } exit runner.run rescue ArgumentError, RuntimeError, Train::UserError => e $stderr.puts e.message exit 1 rescue StandardError => e pretty_handle_exception(e) end desc 'detect', 'detect the target OS' target_options option :format, type: :string def detect o = opts(:detect).dup o[:command] = 'platform.params' (_, res) = run_command(o) if o['format'] == 'json' puts res.to_json else headline('Platform Details') puts Inspec::BaseCLI.detect(params: res, indent: 0, color: 36) end rescue ArgumentError, RuntimeError, Train::UserError => e $stderr.puts e.message exit 1 rescue StandardError => e pretty_handle_exception(e) end desc 'shell', 'open an interactive debugging shell' target_options option :command, aliases: :c, desc: 'A single command string to run instead of launching the shell' option :reporter, type: :array, banner: 'one two:/output/file/path', desc: 'Enable one or more output reporters: cli, documentation, html, progress, json, json-min, json-rspec, junit' option :depends, type: :array, default: [], desc: 'A space-delimited list of local folders containing profiles whose libraries and resources will be loaded into the new shell' option :distinct_exit, type: :boolean, default: true, desc: 'Exit with code 100 if any tests fail, and 101 if any are skipped but none failed (default). If disabled, exit 0 on skips and 1 for failures.' def shell_func o = opts(:shell).dup diagnose(o) o[:debug_shell] = true log_device = suppress_log_output?(o) ? nil : STDOUT o[:logger] = Logger.new(log_device) o[:logger].level = get_log_level(o.log_level) if o[:command].nil? runner = Inspec::Runner.new(o) return Inspec::Shell.new(runner).start end run_type, res = run_command(o) exit res unless run_type == :ruby_eval # No InSpec tests - just print evaluation output. res = (res.respond_to?(:to_json) ? res.to_json : JSON.dump(res)) if o['reporter']&.keys&.include?('json') puts res exit 0 rescue RuntimeError, Train::UserError => e $stderr.puts e.message rescue StandardError => e pretty_handle_exception(e) end desc 'env', 'Output shell-appropriate completion configuration' def env(shell = nil) p = Inspec::EnvPrinter.new(self.class, shell) p.print_and_exit! rescue StandardError => e pretty_handle_exception(e) end desc 'schema NAME', 'print the JSON schema', hide: true def schema(name) puts Inspec::Schema.json(name) rescue StandardError => e puts e puts "Valid schemas are #{Inspec::Schema.names.join(', ')}" end desc 'version', 'prints the version of this tool' option :format, type: :string def version if opts['format'] == 'json' v = { version: Inspec::VERSION } puts v.to_json else puts Inspec::VERSION # display outdated version latest = LatestInSpecVersion.new.latest if Gem::Version.new(Inspec::VERSION) < Gem::Version.new(latest) puts "\nYour version of InSpec is out of date! The latest version is #{latest}." end end end map %w{-v --version} => :version private def run_command(opts) runner = Inspec::Runner.new(opts) res = runner.eval_with_virtual_profile(opts[:command]) runner.load return :ruby_eval, res if runner.all_rules.empty? return :rspec_run, runner.run_tests # rubocop:disable Style/RedundantReturn end end begin # Handle help commands # This allows you to use any of the normal help commands after the normal args. help_commands = ['-h', '--help', 'help'] (help_commands & ARGV).each do |cmd| # move the help argument to one place behind the end for Thor to digest if ARGV.size > 1 match = ARGV.delete(cmd) ARGV.insert(-2, match) end end # Load v2 plugins v2_loader = Inspec::Plugin::V2::Loader.new v2_loader.load_all v2_loader.exit_on_load_error v2_loader.activate_mentioned_cli_plugins # Load v1 plugins on startup ctl = Inspec::PluginCtl.new ctl.list.each { |x| ctl.load(x) } # load v1 CLI plugins before the InSpec CLI has been started Inspec::Plugins::CLI.subcommands.each { |_subcommand, params| Inspec::InspecCLI.register( params[:klass], params[:subcommand_name], params[:usage], params[:description], params[:options], ) } rescue Inspec::Plugin::V2::Exception => v2ex Inspec::Log.error v2ex.message if ARGV.include?('--debug') Inspec::Log.error v2ex.class.name Inspec::Log.error v2ex.backtrace.join("\n") else Inspec::Log.error 'Run again with --debug for a stacktrace.' end exit 2 end