inspec/lib/resources/shadow.rb

# encoding: utf-8
# copyright: 2016, Chef Software Inc.

require 'utils/filter'
require 'utils/file_reader'

# The file format consists of
# - user
# - password
# - last_change
# - min_days before password change
# - max_days until password change
# - warn_days before warning about expiry
# - inactive_days before deactivating the account
# - expiry_date when this account will expire

module Inspec::Resources
  class Shadow < Inspec.resource(1)
    name 'shadow'
    supports platform: 'unix'
    desc 'Use the shadow InSpec resource to test the contents of /etc/shadow, '\
         'which contains information for users that may log into '\
         'the system and/or as users that own running processes.'
    example "
      describe shadow do
        its('user') { should_not include 'forbidden_user' }
      end

      describe shadow.user('bin') do
        its('password') { should cmp 'x' }
        its('count') { should eq 1 }
      end
    "

    include FileReader

    attr_reader :params

    def initialize(path = '/etc/shadow', opts = {})
      @opts = opts
      @path = path || '/etc/shadow'
      @filters = @opts[:filters] || ''
    end

    filtertable = FilterTable.create
    filtertable
      .add_accessor(:where)
      .add_accessor(:entries)
      .add(:user, field: 'user')
      .add(:password, field: 'password')
      .add(:last_change, field: 'last_change')
      .add(:min_days, field: 'min_days')
      .add(:max_days, field: 'max_days')
      .add(:warn_days, field: 'warn_days')
      .add(:inactive_days, field: 'inactive_days')
      .add(:expiry_date, field: 'expiry_date')
      .add(:reserved, field: 'reserved')

    filtertable.add(:content) { |t, _|
      t.entries.map do |e|
        [e.user, e.password, e.last_change, e.min_days, e.max_days, e.warn_days, e.inactive_days, e.expiry_date].compact.join(':')
      end.join("\n")
    }

    filtertable.add(:count) { |i, _|
      i.entries.length
    }

    filtertable.connect(self, :set_params)

    def filter(query = {})
      return self if query.nil? || query.empty?
      res = set_params
      filters = ''
      query.each do |attr, condition|
        condition = condition.to_s if condition.is_a? Integer
        filters += " #{attr} = #{condition.inspect}"
        res = res.find_all do |line|
          case line[attr.to_s]
          when condition
            true
          else
            false
          end
        end
      end
      content = res.map { |x| x.values.join(':') }.join("\n")
      Shadow.new(@path, content: content, filters: @filters + filters)
    end

    def users(query = nil)
      warn '[DEPRECATION] The shadow `users` property is deprecated and will be removed' \
       ' in InSpec 3.0.  Please use `user` instead.'
      query.nil? ? user : user(query)
    end

    def passwords(query = nil)
      warn '[DEPRECATION] The shadow `passwords` property is deprecated and will be removed' \
       ' in InSpec 3.0.  Please use `password` instead.'
      query.nil? ? password : password(query)
    end

    def last_changes(query = nil)
      warn '[DEPRECATION] The shadow `last_changes` property is deprecated and will be removed' \
       ' in InSpec 3.0.  Please use `last_change` instead.'
      query.nil? ? last_change : last_change(query)
    end

    def expiry_dates(query = nil)
      warn '[DEPRECATION] The shadow `expiry_dates` property is deprecated and will be removed' \
       ' in InSpec 3.0.  Please use `expiry_date` instead.'
      query.nil? ? expiry_date : expiry_date(query)
    end

    def lines
      warn '[DEPRECATION] The shadow `lines` property is deprecated and will be removed' \
        ' in InSpec 3.0.'
      shadow_content.to_s.split("\n")
    end

    def to_s
      f = @filters.empty? ? '' : ' with'+@filters
      "#{@path}#{f}"
    end

    private

    def shadow_content
      @opts[:content] || read_file_content(@path, allow_empty: true)
    end

    def set_params
      @params ||= Array(shadow_content.to_s.split("\n")).map { |l| parse_shadow_line(l) }
    end

    def map_data(id)
      set_params.collect { |x| x[id] }
    end

    # Parse a line of /etc/shadow
    #
    # @param [String] line a line of /etc/shadow
    # @return [Hash] Map of entries in this line
    def parse_shadow_line(line)
      x = line.split(':')
      {
        'user'          => x.at(0),
        'password'      => x.at(1),
        'last_change'   => x.at(2),
        'min_days'      => x.at(3),
        'max_days'      => x.at(4),
        'warn_days'     => x.at(5),
        'inactive_days' => x.at(6),
        'expiry_date'   => x.at(7),
        'reserved'      => x.at(8),
      }
    end
  end
end