/puppet-rkhunter

Manage rkhunter installation and configuration with Puppet

Primary LanguagePuppetApache License 2.0Apache-2.0

puppet-rkhunter

Build Status Puppet Forge Puppet Forge - downloads Puppet Forge - endorsement Puppet Forge - scores

Manage rkhunter installation and configuration with Puppet.

Features

  • Manage ALL config entries (some of them dont make sense in server environments)
  • Manage your whitelists
  • The check cronjob is called staggered (predefined timewindow)
  • The db update cronjob is configured separately

Supported OS

  • Debian (tested on Debian 7.5, 8.1, 10)
  • Redhat/CentOS (tested on CentOS 6, 7 and 8)
  • FreeBSD (NOT tested yet)

Used Modules

Other than some data types from puppetlabs/stdlib, no other external modules are used.

Configuration

See templates/etc/rkhunter.conf.erb for detailed explanation of the rkhunter config options. Important: full possible configuration is visible in params.pp. Do not uncomment them in params.pp.

Minimal configuration

  include rkhunter
  include rkhunter::cron

A bit bigger configuration

class { 'rkhunter':
  allow_ssh_root_user         => 'yes',
  shared_lib_whitelist        => [ '/lib/snoopy.so' ],
  allow_syslog_remote_logging => "1",
  scriptwhitelist             => [
    '/bin/egrep',
    '/bin/fgrep',
    '/bin/which',
    '/usr/bin/groups',
    '/usr/bin/ldd',
    '/usr/bin/lwp-request',
    '/usr/sbin/adduser',
  ],
}
include rkhunter::cron

List of optional configuration paramaeters

NOTE: there may be more. I do not update this list every time. Have a look into params.pp

  rotate_mirrors
  update_mirrors
  mirrors_mode
  mail_on_warning
  tmpdir
  dbdir
  scriptdir
  logfile
  append_log
  copy_log_on_error
  use_syslog
  color_set2
  auto_x_detect
  whitelisted_is_white
  allow_ssh_root_user
  allow_ssh_prot_v1
  enable_tests
  disable_tests
  immutable_set
  allow_syslog_remote_logging
  suspscan_temp
  suspscan_maxsize
  suspscan_thresh
  use_locking
  lock_timeout
  show_lockmsgs
  disable_unhide
  installdir
  ssh_config_dir
  hash_func
  hash_fld_idx
  package_manager
  pkgmgr_no_verfy
  ignore_prelink_dep_err
  use_sunsum
  existwhitelist
  attrwhitelist
  writewhitelist
  scan_mode_dev
  phlanx2_dirtest
  inetd_conf_path
  inetd_allowed_svc
  xinetd_conf_path
  xinetd_allowed_svc
  startup_paths
  passwd_file
  user_fileprop_files_dirs
  rtkt_file_whitelist
  rtkt_dir_whitelist
  scriptwhitelist
  immutewhitelist
  allowhiddendir
  allowhiddenfile
  allowprocdelfile
  allowproclisten
  allowpromiscif
  allowdevfile
  allowipcproc
  uid0_accounts
  pwdless_accounts
  syslog_config_file
  app_whitelist
  suspscan_dirs
  port_whitelist
  shared_lib_whitelist

License

This project is licensed under the Apache-2 license

Copyright and origin

This repository was forked from https://github.com/mmz-srf/puppet-rkhunter and is now maintained by the Vox Pupuli community.