Table of Contents

1. Description
2. Setup - The basics of getting started with issue
3. Reference - An under-the-hood peek at what the module is doing and how
4. Limitations - OS compatibility, etc.
5. Development - Guide for contributing to the module

Description

This module manages /etc/issue and /ets/issue.net, and has several available file examples.

This is a SIMP module

This module is a component of the System Integrity Management Platform, a compliance-management framework built on Puppet.

If you find any issues, they may be submitted to our bug tracker.

This module is optimally designed for use within a larger SIMP ecosystem, but it can be used independently:

• When included within the SIMP ecosystem, security compliance settings will be managed from the Puppet server.
• If used independently, all SIMP-managed security subsystems are disabled by default and must be explicitly opted into by administrators. Please review the parameters in simp/simp_options for details.

Setup

Include the class to use it:

class { 'issue':
  profile => 'us_doc'
}

Reference

Available issue files are:

• default
• lite
• us_doc
• us_doc_lite
• us_dod
• us_noaa

They can be read in entirety in the files/issue directory.

For further documentation, see REFERENCE.md

Limitations

SIMP Puppet modules are generally intended for use on Red Hat Enterprise Linux and compatible distributions, such as CentOS. Please see the metadata.json file for the most up-to-date list of supported operating systems, Puppet versions, and module dependencies.

Development

Please read our Contribution Guide.

Reference

Table of Contents

Classes

• issue: Manage /etc/issue and /etc/issue.net

Classes

issue

Manage /etc/issue and /etc/issue.net

Parameters

The following parameters are available in the issue class:

• profile
• content
• source
• net_link
• net_content

profile

Data type: String

A pre-included banner that can be used out of the box.

Will be overridden by $content and/or $net_content

Valid values are defined by the simp_banners module but the local module has the following mappings for legacy support

• default => Standard, we watch everything
  • New Option => 'simp'
• lite => We only watch for bad things
  • New Option => 'simp_lite'
• us_doc => U.S. Department of Commerce
  • New Option => 'us/department_of_commerce'
• us_doc_lite => U.S. Department of Commerce lite
  • New Option => 'us/department_of_commerce_lite'
• us_dod => U.S. Department of Defense (STIG Compat)
  • New Option => 'us/department_of_defense'
• us_noaa => U.S. National Oceanic and Atmospehric Administration
  • New Option => 'us/national_oceanic_and_atmospheric_administration'

Default value: 'default'

content

Data type: Optional[String]

Defaults to a stock /etc/issue file in the module. Provide a custom string or file reference to customize. Follows the File resource content parameter syntax.

Default value: undef

source

Data type: Optional[Pattern[/^puppet:/, /^file:/, /^http:/]]

Provide a file resource pointer that can be used to set the source of the file to use for a banner. Cannot be set with $content. Follows the File resource source parameter syntax.

Default value: undef

net_link

Data type: Boolean

If set, links /etc/issue.net to /etc/issue

Default value: true

net_content

Data type: Optional[String]

If $net_link is false, this content will be written to the /etc/issue.net file on the system. Follows the File resource content parameter syntax.

Default value: undef

• Mon Oct 23 2023 Steven Pritchard steve@sicura.us - 0.7.0

• [puppetsync] Add EL9 support

• Wed Oct 11 2023 Steven Pritchard steve@sicura.us - 0.6.0

• [puppetsync] Updates for Puppet 8
  • These updates may include the following:
    • Update Gemfile
    • Add support for Puppet 8
    • Drop support for Puppet 6
    • Update module dependencies

• Wed Aug 23 2023 Steven Pritchard steve@sicura.us - 0.5.0

• Add AlmaLinux 8 support

• Mon Jun 12 2023 Chris Tessmer chris.tessmer@onyxpoint.com - 0.4.0

• Add RockyLinux 8 support

• Sat Jan 22 2022 Dan Barr drb45@arl.psu.edu - 0.3.1

• Upate DoD banner text

• Tue Jun 15 2021 Chris Tessmer chris.tessmer@onyxpoint.com - 0.3.0

• Removed support for Puppet 5
• Ensured support for Puppet 7 in requirements and stdlib

• Fri Dec 18 2020 Chris Tessmer chris.tessmer@onyxpoint.com - 0.2.1

• Removed EL6 support

• Mon Dec 16 2019 Trevor Vaughan tvaughan@onyxpoint.com - 0.2.0-0

• Add EL8 support

• Thu Aug 15 2019 Trevor Vaughan tvaughan@onyxpoint.com - 0.1.1-0

• Fix compliance engine data

• Tue Jul 23 2019 Chris Tessmer chris.tessmer@onyxpoint.com - 0.1.0-0

• Add REFERENCE.md for Puppet Forge

• Thu Jun 06 2019 Steven Pritchard steven.pritchard@onyxpoint.com - 0.1.0-0

• Add v2 compliance_markup data
• Add support for puppetlabs-stdlib 6

• Thu Mar 07 2019 Liz Nemsick lnemsick.simp@gmail.com - 0.0.4-0

• Update the upper bound of stdlib to < 6.0.0
• Update a URL in the README.md

• Tue Dec 11 2018 Adam Yohrling adam.yohrling@onyxpoint.com - 0.0.4-0

• Add source parameter to be able to specify a file for use directly within hiera data

• Wed Nov 07 2018 Liz Nemsick lnemsick.simp@gmail.com - 0.0.3-0

• Update static assets
• Update to onyxpoint OEL boxes in acceptance tests
• Update badges in README.md

• Mon Jun 25 2018 Trevor Vaughan tvaughan@onyxpoint.com - 0.0.3-0

• Removed the static banners from the module and tied the module to the simp/simp_banners module
• Add support for OEL and Puppet 5

• Thu Jul 06 2017 Liz Nemsick lnemsick.simp@gmail.com - 0.0.2-0

• Update puppet dependency and remove OBE pe dependency in metadata.json

• Thu Dec 15 2016 Nick Miller nick.miller@onyxpoint.com - 0.0.1

• First cut