Puppet Class: ir_agent

Defined in:
manifests/init.pp

Summary

Module for installing and managing Rapid7 Insight Agent.

Overview

Examples:

Deploy the agent with default options.


class { 'ir_agent':
  source => 'puppet:///modules/my_module/agent_installer_x64.sh',
  token  => 'us:01234567-89ab-cdef-0123-4567890abcde',
}

Parameters:

  • ensure (Enum['present', 'absent']) (defaults to: 'present') —

    If ‘present`, installs the agent. If `absent`, uninstalls the agent. The agent is self-updating, so there is no `latest` option provided.

  • source (Optional[String]) (defaults to: undef) —

    Source location for the agent installer script.

  • token (Optional[String]) (defaults to: undef) —

    Token needed to download the certificates needed to enable the agent.

  • auditd_compatibility_mode (Boolean) (defaults to: false) —

    Run the agent in auditd compatibility mode.

  • https_proxy (Optional[String]) (defaults to: undef) —

    Proxy host and port to use for communicating with Rapid7 cloud.



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
# File 'manifests/init.pp', line 26

class ir_agent (
  Enum['present', 'absent'] $ensure = 'present',
  Optional[String] $source = undef,
  Optional[String] $token = undef,
  Boolean $auditd_compatibility_mode = false,
  Optional[String] $https_proxy = undef,
) {
  $home = '/opt/rapid7'
  $agent_installer = "${home}/agent_installer_x64.sh"
  $audit_package = lookup('ir_agent::audit::package', String)
  $audit_rules = lookup('ir_agent::audit::rules', Stdlib::Unixpath)
  $audit_start_cmd = lookup('ir_agent::audit::start_cmd', String)
  $audispd_conf = lookup('ir_agent::audispd::conf', Stdlib::Unixpath)
  $audisp_plugins_dir = lookup('ir_agent::audisp::plugins_dir', Stdlib::Unixpath)

  if $ensure == 'present' {
    contain ir_agent::audit
    contain ir_agent::install
  } else {
    contain ir_agent::uninstall
  }

}