/puppet-selinux_types

Helpful Puppet types for interacting with SELinux

Primary LanguageRubyMIT LicenseMIT

DEAD REPOSITORY NOTICE

I haven't used Puppet in a few years, so I'm not maintaining this anymore. If you'd like to take over this project, drop me a PR directing this repo's readers to your fork.

Usage

These types only require that /usr/sbin/semanage be installed.

Types

selinux_fcontext

Creates, deletes, and modifies the SELinux file context rules database. Note that it will not automatically initiate a filesystem relabel after it completes, but you can of course have your selinux_fcontext resources refresh an exec to handle that if you want that behavior.

Example:

selinux_fcontext { '/usr/lib(64)?/nagios/plugins/check_disk':
  ensure   => 'present',
  selrange => 's0.c1023',
  seltype  => 'nagios_unconfined_plugin_exec_t',
  seluser  => 'root',
}

selinux_port

Creates, deletes, and modifies the SELinux network port type definitions. It accepts proto tcp/udp and port (range) between 1-65535.

Example:

selinux_port { 'tcp/8080-8085':
  seltype => 'http_port_t',
}

selinux_port { 'udp/53':
  seltype => 'dns_port_t',
}

Purge all network port type definitions that are not managed by puppet:

resource { 'selinux_port':
  purge => true,
}

selinux_permissive_domain

Create or deletes the SELinux processes type enforcement mode.

Example:

Change apache to a permissive domain

selinux_permissive_domain { 'httpd_t':
  ensure => 'present',
}

Remove apache from permissive domains

selinux_permissive_domain { 'httpd_t':
  ensure => 'absent',
}

Purge all permissive domains that are not managed by puppet: Note: Rather not useful right now, as you can not currently remove permissive domains if they are the built-in into policy.

resource { 'selinux_permissive_domain':
  purge => true,
}