diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.geppetto-rc.json b/modules/services/unix/http/apache_kali_compatible/apache/.geppetto-rc.json similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.geppetto-rc.json rename to modules/services/unix/http/apache_kali_compatible/apache/.geppetto-rc.json diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.github/workflows/auto_release.yml b/modules/services/unix/http/apache_kali_compatible/apache/.github/workflows/auto_release.yml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.github/workflows/auto_release.yml rename to modules/services/unix/http/apache_kali_compatible/apache/.github/workflows/auto_release.yml diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.github/workflows/nightly.yml b/modules/services/unix/http/apache_kali_compatible/apache/.github/workflows/nightly.yml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.github/workflows/nightly.yml rename to modules/services/unix/http/apache_kali_compatible/apache/.github/workflows/nightly.yml diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.github/workflows/pr_test.yml b/modules/services/unix/http/apache_kali_compatible/apache/.github/workflows/pr_test.yml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.github/workflows/pr_test.yml rename to modules/services/unix/http/apache_kali_compatible/apache/.github/workflows/pr_test.yml diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.github/workflows/release.yml b/modules/services/unix/http/apache_kali_compatible/apache/.github/workflows/release.yml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.github/workflows/release.yml rename to modules/services/unix/http/apache_kali_compatible/apache/.github/workflows/release.yml diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.github/workflows/spec.yml b/modules/services/unix/http/apache_kali_compatible/apache/.github/workflows/spec.yml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.github/workflows/spec.yml rename to modules/services/unix/http/apache_kali_compatible/apache/.github/workflows/spec.yml diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.github_changelog_generator b/modules/services/unix/http/apache_kali_compatible/apache/.github_changelog_generator similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.github_changelog_generator rename to modules/services/unix/http/apache_kali_compatible/apache/.github_changelog_generator diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.gitpod.Dockerfile b/modules/services/unix/http/apache_kali_compatible/apache/.gitpod.Dockerfile similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.gitpod.Dockerfile rename to modules/services/unix/http/apache_kali_compatible/apache/.gitpod.Dockerfile diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.gitpod.yml b/modules/services/unix/http/apache_kali_compatible/apache/.gitpod.yml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.gitpod.yml rename to modules/services/unix/http/apache_kali_compatible/apache/.gitpod.yml diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.nodeset.yml b/modules/services/unix/http/apache_kali_compatible/apache/.nodeset.yml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.nodeset.yml rename to modules/services/unix/http/apache_kali_compatible/apache/.nodeset.yml diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/.rubocop_todo.yml b/modules/services/unix/http/apache_kali_compatible/apache/.rubocop_todo.yml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/.rubocop_todo.yml rename to modules/services/unix/http/apache_kali_compatible/apache/.rubocop_todo.yml diff --git a/modules/services/unix/http/apache_kali_compatible/apache/CHANGELOG.md b/modules/services/unix/http/apache_kali_compatible/apache/CHANGELOG.md new file mode 100644 index 000000000..7ee7a7855 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/CHANGELOG.md @@ -0,0 +1,1482 @@ +# Change log + +All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) and this project adheres to [Semantic Versioning](http://semver.org). + +## [v7.0.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v7.0.0) (2021-10-11) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v6.5.1...v7.0.0) + +### Changed + +- Drop Debian \< 8 and Ubuntu \< 14.04 code [\#2189](https://github.com/puppetlabs/puppetlabs-apache/pull/2189) ([ekohl](https://github.com/ekohl)) +- Drop support and compatibility for Debian \< 9 and Ubuntu \< 16.04 [\#2123](https://github.com/puppetlabs/puppetlabs-apache/pull/2123) ([ekohl](https://github.com/ekohl)) + +### Added + +- pdksync - \(IAC-1751\) - Add Support for Rocky 8 [\#2196](https://github.com/puppetlabs/puppetlabs-apache/pull/2196) ([david22swan](https://github.com/david22swan)) +- Allow `docroot` with `mod_vhost_alias` `virtual_docroot` [\#2195](https://github.com/puppetlabs/puppetlabs-apache/pull/2195) ([yakatz](https://github.com/yakatz)) + +### Fixed + +- Restore Ubuntu 14.04 support in suphp [\#2193](https://github.com/puppetlabs/puppetlabs-apache/pull/2193) ([ekohl](https://github.com/ekohl)) +- add double quote on scope parameter [\#2191](https://github.com/puppetlabs/puppetlabs-apache/pull/2191) ([aba-rechsteiner](https://github.com/aba-rechsteiner)) +- Debian 11: fix typo in `versioncmp()` / set default php to 7.4 [\#2186](https://github.com/puppetlabs/puppetlabs-apache/pull/2186) ([bastelfreak](https://github.com/bastelfreak)) + +## [v6.5.1](https://github.com/puppetlabs/puppetlabs-apache/tree/v6.5.1) (2021-08-25) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v6.5.0...v6.5.1) + +### Fixed + +- \(maint\) Allow stdlib 8.0.0 [\#2184](https://github.com/puppetlabs/puppetlabs-apache/pull/2184) ([smortex](https://github.com/smortex)) + +## [v6.5.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v6.5.0) (2021-08-24) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v6.4.0...v6.5.0) + +### Added + +- pdksync - \(IAC-1709\) - Add Support for Debian 11 [\#2180](https://github.com/puppetlabs/puppetlabs-apache/pull/2180) ([david22swan](https://github.com/david22swan)) + +## [v6.4.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v6.4.0) (2021-08-02) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v6.3.1...v6.4.0) + +### Added + +- \(MODULES-11075\) Improve future version handling for RHEL [\#2174](https://github.com/puppetlabs/puppetlabs-apache/pull/2174) ([mwhahaha](https://github.com/mwhahaha)) +- Allow custom userdir directives [\#2164](https://github.com/puppetlabs/puppetlabs-apache/pull/2164) ([hunner](https://github.com/hunner)) +- Add feature to reload apache service when content of ssl files has changed [\#2157](https://github.com/puppetlabs/puppetlabs-apache/pull/2157) ([timdeluxe](https://github.com/timdeluxe)) + +## [v6.3.1](https://github.com/puppetlabs/puppetlabs-apache/tree/v6.3.1) (2021-07-22) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v6.3.0...v6.3.1) + +### Fixed + +- \(MODULES-10899\) Load php module with the right libphp file [\#2166](https://github.com/puppetlabs/puppetlabs-apache/pull/2166) ([sheenaajay](https://github.com/sheenaajay)) +- \(maint\) Fix puppet-strings docs on apache::vhost [\#2165](https://github.com/puppetlabs/puppetlabs-apache/pull/2165) ([ekohl](https://github.com/ekohl)) + +## [v6.3.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v6.3.0) (2021-06-22) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/kps_ssl_reload_and_cache_disk_combined_tag...v6.3.0) + +### Added + +- The default disk\_cache.conf.erb caches everything. [\#2142](https://github.com/puppetlabs/puppetlabs-apache/pull/2142) ([Pawa2NR](https://github.com/Pawa2NR)) + +### Fixed + +- Update the default version of Apache for Amazon Linux 2 [\#2158](https://github.com/puppetlabs/puppetlabs-apache/pull/2158) ([turnopil](https://github.com/turnopil)) +- Only warn about servername logging if relevant [\#2154](https://github.com/puppetlabs/puppetlabs-apache/pull/2154) ([ekohl](https://github.com/ekohl)) + +## [kps_ssl_reload_and_cache_disk_combined_tag](https://github.com/puppetlabs/puppetlabs-apache/tree/kps_ssl_reload_and_cache_disk_combined_tag) (2021-06-14) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v6.2.0...kps_ssl_reload_and_cache_disk_combined_tag) + +## [v6.2.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v6.2.0) (2021-05-24) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v6.1.0...v6.2.0) + +### Added + +- \(MODULES-11068\) Allow apache::vhost ssl\_honorcipherorder to take boolean parameter [\#2152](https://github.com/puppetlabs/puppetlabs-apache/pull/2152) ([davidc](https://github.com/davidc)) + +## [v6.1.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v6.1.0) (2021-05-17) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v6.0.1...v6.1.0) + +### Added + +- support for uri for severname with use\_servername\_for\_filenames [\#2150](https://github.com/puppetlabs/puppetlabs-apache/pull/2150) ([Zarne](https://github.com/Zarne)) +- \(MODULES-11061\) mod\_security custom rule functionality [\#2145](https://github.com/puppetlabs/puppetlabs-apache/pull/2145) ([k2patel](https://github.com/k2patel)) + +## [v6.0.1](https://github.com/puppetlabs/puppetlabs-apache/tree/v6.0.1) (2021-05-10) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v6.0.0...v6.0.1) + +### Fixed + +- Fix HEADER\* and README\* wildcards in IndexIgnore [\#2138](https://github.com/puppetlabs/puppetlabs-apache/pull/2138) ([keto](https://github.com/keto)) +- Fix dav\_svn for Debian 10 [\#2135](https://github.com/puppetlabs/puppetlabs-apache/pull/2135) ([martijndegouw](https://github.com/martijndegouw)) + +## [v6.0.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v6.0.0) (2021-03-02) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.10.0...v6.0.0) + +### Changed + +- pdksync - \(MAINT\) Remove SLES 11 support [\#2132](https://github.com/puppetlabs/puppetlabs-apache/pull/2132) ([sanfrancrisko](https://github.com/sanfrancrisko)) +- pdksync - Remove Puppet 5 from testing and bump minimal version to 6.0.0 [\#2125](https://github.com/puppetlabs/puppetlabs-apache/pull/2125) ([carabasdaniel](https://github.com/carabasdaniel)) + +## [v5.10.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.10.0) (2021-02-17) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.9.0...v5.10.0) + +### Added + +- \(IAC-1186\) Add $use\_port\_for\_filenames parameter [\#2122](https://github.com/puppetlabs/puppetlabs-apache/pull/2122) ([smortex](https://github.com/smortex)) + +### Fixed + +- \(MODULES-10899\) Handle PHP8 MOD package naming convention changes [\#2121](https://github.com/puppetlabs/puppetlabs-apache/pull/2121) ([sanfrancrisko](https://github.com/sanfrancrisko)) + +## [v5.9.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.9.0) (2021-01-25) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.8.0...v5.9.0) + +### Added + +- Add ssl\_user\_name vhost parameter [\#2093](https://github.com/puppetlabs/puppetlabs-apache/pull/2093) ([bodgit](https://github.com/bodgit)) +- Add support for mod\_md [\#2090](https://github.com/puppetlabs/puppetlabs-apache/pull/2090) ([smortex](https://github.com/smortex)) + +### Fixed + +- \(FIX\) Correct PHP packages on Ubuntu 16.04 [\#2111](https://github.com/puppetlabs/puppetlabs-apache/pull/2111) ([ekohl](https://github.com/ekohl)) + +## [v5.8.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.8.0) (2020-12-07) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.7.0...v5.8.0) + +### Added + +- \(MODULES-10887\) Set `use_servername_for_filenames` for defaults [\#2103](https://github.com/puppetlabs/puppetlabs-apache/pull/2103) ([towo](https://github.com/towo)) +- pdksync - \(feat\) Add support for Puppet 7 [\#2101](https://github.com/puppetlabs/puppetlabs-apache/pull/2101) ([daianamezdrea](https://github.com/daianamezdrea)) +- \(feat\) Add support for apreq2 MOD on Debian 9, 10 [\#2085](https://github.com/puppetlabs/puppetlabs-apache/pull/2085) ([TigerKriika](https://github.com/TigerKriika)) + +### Fixed + +- \(fix\) Convert unnecessary multi line warnings to single lines [\#2104](https://github.com/puppetlabs/puppetlabs-apache/pull/2104) ([rj667](https://github.com/rj667)) +- Fix bool2httpd function call for older ruby versions [\#2102](https://github.com/puppetlabs/puppetlabs-apache/pull/2102) ([carabasdaniel](https://github.com/carabasdaniel)) +- Use Ruby 2.7 compatible string matching [\#2060](https://github.com/puppetlabs/puppetlabs-apache/pull/2060) ([ekohl](https://github.com/ekohl)) + +## [v5.7.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.7.0) (2020-11-24) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.6.0...v5.7.0) + +### Added + +- Add cas\_cookie\_path in vhosts [\#2089](https://github.com/puppetlabs/puppetlabs-apache/pull/2089) ([yakatz](https://github.com/yakatz)) +- \(IAC-1186\) Add new $use\_servername\_for\_filenames parameter [\#2086](https://github.com/puppetlabs/puppetlabs-apache/pull/2086) ([sanfrancrisko](https://github.com/sanfrancrisko)) +- Allow relative paths in oidc\_redirect\_uri [\#2082](https://github.com/puppetlabs/puppetlabs-apache/pull/2082) ([sanfrancrisko](https://github.com/sanfrancrisko)) +- Improve SSLVerify options [\#2081](https://github.com/puppetlabs/puppetlabs-apache/pull/2081) ([bovy89](https://github.com/bovy89)) +- Change icon path [\#2079](https://github.com/puppetlabs/puppetlabs-apache/pull/2079) ([yakatz](https://github.com/yakatz)) +- Support mod\_auth\_gssapi parameters [\#2078](https://github.com/puppetlabs/puppetlabs-apache/pull/2078) ([traylenator](https://github.com/traylenator)) +- Add ssl\_proxy\_machine\_cert\_chain param to vhost class [\#2072](https://github.com/puppetlabs/puppetlabs-apache/pull/2072) ([AbelNavarro](https://github.com/AbelNavarro)) + +### Fixed + +- Use Ruby 2.7 compatible string matching [\#2074](https://github.com/puppetlabs/puppetlabs-apache/pull/2074) ([sanfrancrisko](https://github.com/sanfrancrisko)) + +## [v5.6.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.6.0) (2020-10-01) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.5.0...v5.6.0) + +### Added + +- Configure default shared lib path for mod\_wsgi on RHEL8 [\#2063](https://github.com/puppetlabs/puppetlabs-apache/pull/2063) ([nbarrientos](https://github.com/nbarrientos)) +- Various enhancements to apache::mod::passenger [\#2058](https://github.com/puppetlabs/puppetlabs-apache/pull/2058) ([smortex](https://github.com/smortex)) + +### Fixed + +- make apache::mod::fcgid redhat 8 compatible [\#2071](https://github.com/puppetlabs/puppetlabs-apache/pull/2071) ([creativefre](https://github.com/creativefre)) +- pdksync - \(feat\) - Removal of inappropriate terminology [\#2062](https://github.com/puppetlabs/puppetlabs-apache/pull/2062) ([pmcmaw](https://github.com/pmcmaw)) +- Use python3-mod\_wsgi instead of mod\_wsgi on CentOS8 [\#2052](https://github.com/puppetlabs/puppetlabs-apache/pull/2052) ([kajinamit](https://github.com/kajinamit)) + +## [v5.5.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.5.0) (2020-07-03) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.4.0...v5.5.0) + +### Added + +- Allow IPv6 CIDRs for proxy\_protocol\_exceptions in mod remoteip [\#2033](https://github.com/puppetlabs/puppetlabs-apache/pull/2033) ([thechristschn](https://github.com/thechristschn)) +- \(IAC-746\) - Add ubuntu 20.04 support [\#2032](https://github.com/puppetlabs/puppetlabs-apache/pull/2032) ([david22swan](https://github.com/david22swan)) +- Replace legacy `bool2httpd()` function with shim [\#2025](https://github.com/puppetlabs/puppetlabs-apache/pull/2025) ([alexjfisher](https://github.com/alexjfisher)) +- Tidy up `pw_hash` function [\#2024](https://github.com/puppetlabs/puppetlabs-apache/pull/2024) ([alexjfisher](https://github.com/alexjfisher)) +- Replace validate\_apache\_loglevel\(\) with data type [\#2023](https://github.com/puppetlabs/puppetlabs-apache/pull/2023) ([alexjfisher](https://github.com/alexjfisher)) +- Add ProxyIOBufferSize option [\#2014](https://github.com/puppetlabs/puppetlabs-apache/pull/2014) ([jplindquist](https://github.com/jplindquist)) +- Add support for SetInputFilter directive [\#2007](https://github.com/puppetlabs/puppetlabs-apache/pull/2007) ([HoucemEddine](https://github.com/HoucemEddine)) +- \[MODULES-10530\] Add request limiting directives on virtual host level [\#1996](https://github.com/puppetlabs/puppetlabs-apache/pull/1996) ([aursu](https://github.com/aursu)) +- \[MODULES-10528\] Add ErrorLogFormat directive on virtual host level [\#1995](https://github.com/puppetlabs/puppetlabs-apache/pull/1995) ([aursu](https://github.com/aursu)) +- Add template variables and parameters for ModSecurity Audit Logs [\#1988](https://github.com/puppetlabs/puppetlabs-apache/pull/1988) ([jplindquist](https://github.com/jplindquist)) +- \(MODULES-10432\) Add mod\_auth\_openidc support [\#1987](https://github.com/puppetlabs/puppetlabs-apache/pull/1987) ([asieraguado](https://github.com/asieraguado)) + +### Fixed + +- \(MODULES-10712\) Fix mod\_ldap on RH/CentOS 5 and 6 [\#2041](https://github.com/puppetlabs/puppetlabs-apache/pull/2041) ([h-haaks](https://github.com/h-haaks)) +- Update mod\_dir, alias\_icons\_path, error\_documents\_path for CentOS 8 [\#2038](https://github.com/puppetlabs/puppetlabs-apache/pull/2038) ([initrd](https://github.com/initrd)) +- Ensure switching of thread module works on Debian 10 / Ubuntu 20.04 [\#2034](https://github.com/puppetlabs/puppetlabs-apache/pull/2034) ([tuxmea](https://github.com/tuxmea)) +- MODULES-10586 Centos 8: wrong package used to install mod\_authnz\_ldap [\#2021](https://github.com/puppetlabs/puppetlabs-apache/pull/2021) ([farebers](https://github.com/farebers)) +- Re-add package for fcgid on debian/ubuntu machines [\#2006](https://github.com/puppetlabs/puppetlabs-apache/pull/2006) ([vStone](https://github.com/vStone)) +- Use ldap\_trusted\_mode in conditional [\#1999](https://github.com/puppetlabs/puppetlabs-apache/pull/1999) ([dacron](https://github.com/dacron)) +- Typo in oidcsettings.pp [\#1997](https://github.com/puppetlabs/puppetlabs-apache/pull/1997) ([asieraguado](https://github.com/asieraguado)) +- Fix proxy\_html Module to work on Debian 10 [\#1994](https://github.com/puppetlabs/puppetlabs-apache/pull/1994) ([buchstabensalat](https://github.com/buchstabensalat)) +- \(MODULES-10360\) Fix icon paths for RedHat systems [\#1991](https://github.com/puppetlabs/puppetlabs-apache/pull/1991) ([2and3makes23](https://github.com/2and3makes23)) +- SSLProxyEngine on has to be set before any Proxydirective using it [\#1989](https://github.com/puppetlabs/puppetlabs-apache/pull/1989) ([zivis](https://github.com/zivis)) + +## [v5.4.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.4.0) (2020-01-22) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.3.0...v5.4.0) + +### Added + +- Add an apache::vhost::fragment define [\#1980](https://github.com/puppetlabs/puppetlabs-apache/pull/1980) ([ekohl](https://github.com/ekohl)) + +### Fixed + +- \(MODULES-10391\) ssl\_protocol includes SSLv2 and SSLv3 on all platforms [\#1990](https://github.com/puppetlabs/puppetlabs-apache/pull/1990) ([legooolas](https://github.com/legooolas)) + +## [v5.3.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.3.0) (2019-12-11) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.2.0...v5.3.0) + +### Added + +- \(FM-8672\) - Addition of Support for CentOS 8 [\#1977](https://github.com/puppetlabs/puppetlabs-apache/pull/1977) ([david22swan](https://github.com/david22swan)) +- \(MODULES-9948\) Allow switching of thread modules [\#1961](https://github.com/puppetlabs/puppetlabs-apache/pull/1961) ([tuxmea](https://github.com/tuxmea)) + +### Fixed + +- Fix newline being added before proxy params [\#1984](https://github.com/puppetlabs/puppetlabs-apache/pull/1984) ([oxc](https://github.com/oxc)) +- When using mod jk, we expect the libapache2-mod-jk package to be installed [\#1979](https://github.com/puppetlabs/puppetlabs-apache/pull/1979) ([tuxmea](https://github.com/tuxmea)) +- move unless into manage\_security\_corerules [\#1976](https://github.com/puppetlabs/puppetlabs-apache/pull/1976) ([SimonHoenscheid](https://github.com/SimonHoenscheid)) +- Change mod\_proxy's ProxyTimeout to follow Apache's global timeout [\#1975](https://github.com/puppetlabs/puppetlabs-apache/pull/1975) ([gcoxmoz](https://github.com/gcoxmoz)) +- \(FM-8721\) fix php version and ssl error on redhat8 [\#1973](https://github.com/puppetlabs/puppetlabs-apache/pull/1973) ([sheenaajay](https://github.com/sheenaajay)) + +## [v5.2.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.2.0) (2019-11-01) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.1.0...v5.2.0) + +### Added + +- Add parameter version for mod security [\#1953](https://github.com/puppetlabs/puppetlabs-apache/pull/1953) ([tuxmea](https://github.com/tuxmea)) +- add possibility to define variables inside VirtualHost definition [\#1947](https://github.com/puppetlabs/puppetlabs-apache/pull/1947) ([trefzer](https://github.com/trefzer)) + +### Fixed + +- \(FM-8662\) Correction in manifests/mod/ssl.pp for SLES 11 [\#1963](https://github.com/puppetlabs/puppetlabs-apache/pull/1963) ([sanfrancrisko](https://github.com/sanfrancrisko)) +- always quote ExpiresDefault in vhost::directories [\#1958](https://github.com/puppetlabs/puppetlabs-apache/pull/1958) ([evgeni](https://github.com/evgeni)) +- MODULES-9904 Fix lbmethod module load order [\#1956](https://github.com/puppetlabs/puppetlabs-apache/pull/1956) ([optiz0r](https://github.com/optiz0r)) +- Add owner, group, file\_mode and show\_diff to apache::custom\_config [\#1942](https://github.com/puppetlabs/puppetlabs-apache/pull/1942) ([treydock](https://github.com/treydock)) +- Add shibboleth support for Debian 10 [\#1939](https://github.com/puppetlabs/puppetlabs-apache/pull/1939) ([fabbks](https://github.com/fabbks)) + +## [v5.1.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.1.0) (2019-09-13) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/v5.0.0...v5.1.0) + +### Added + +- \(FM-8393\) add support on Debian 10 [\#1945](https://github.com/puppetlabs/puppetlabs-apache/pull/1945) ([ThoughtCrhyme](https://github.com/ThoughtCrhyme)) +- FM-8140 Add Redhat 8 support [\#1941](https://github.com/puppetlabs/puppetlabs-apache/pull/1941) ([sheenaajay](https://github.com/sheenaajay)) +- \(FM-8214\) converted to use litmus [\#1938](https://github.com/puppetlabs/puppetlabs-apache/pull/1938) ([tphoney](https://github.com/tphoney)) +- \(MODULES-9668 \) Please make ProxyRequests setting in vhost.pp configurable [\#1935](https://github.com/puppetlabs/puppetlabs-apache/pull/1935) ([aukesj](https://github.com/aukesj)) +- Added unmanaged\_path and custom\_fragment options to userdir [\#1931](https://github.com/puppetlabs/puppetlabs-apache/pull/1931) ([GeorgeCox](https://github.com/GeorgeCox)) +- Add LDAP parameters to httpd.conf [\#1930](https://github.com/puppetlabs/puppetlabs-apache/pull/1930) ([daveseff](https://github.com/daveseff)) +- Add LDAPReferrals configuration parameter [\#1928](https://github.com/puppetlabs/puppetlabs-apache/pull/1928) ([HT43-bqxFqB](https://github.com/HT43-bqxFqB)) + +### Fixed + +- \(MODULES-9104\) Add file\_mode to config files. [\#1922](https://github.com/puppetlabs/puppetlabs-apache/pull/1922) ([stevegarn](https://github.com/stevegarn)) +- \(bugfix\) Add default package name for mod\_ldap [\#1913](https://github.com/puppetlabs/puppetlabs-apache/pull/1913) ([turnopil](https://github.com/turnopil)) +- Remove event mpm when using prefork, worker or itk [\#1905](https://github.com/puppetlabs/puppetlabs-apache/pull/1905) ([tuxmea](https://github.com/tuxmea)) + +## [v5.0.0](https://github.com/puppetlabs/puppetlabs-apache/tree/v5.0.0) (2019-05-20) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/4.1.0...v5.0.0) + +### Changed + +- pdksync - \(MODULES-8444\) - Raise lower Puppet bound [\#1908](https://github.com/puppetlabs/puppetlabs-apache/pull/1908) ([david22swan](https://github.com/david22swan)) + +### Added + +- \(FM-7923\) Implement Puppet Strings [\#1916](https://github.com/puppetlabs/puppetlabs-apache/pull/1916) ([eimlav](https://github.com/eimlav)) +- Define SCL package name for mod\_ldap [\#1893](https://github.com/puppetlabs/puppetlabs-apache/pull/1893) ([treydock](https://github.com/treydock)) + +### Fixed + +- \(MODULES-9014\) Improve SSLSessionTickets handling [\#1923](https://github.com/puppetlabs/puppetlabs-apache/pull/1923) ([FredericLespez](https://github.com/FredericLespez)) +- \(MODULES-8931\) Fix stahnma/epel failures [\#1914](https://github.com/puppetlabs/puppetlabs-apache/pull/1914) ([eimlav](https://github.com/eimlav)) +- Fix wsgi\_daemon\_process to support hash data type [\#1884](https://github.com/puppetlabs/puppetlabs-apache/pull/1884) ([mdechiaro](https://github.com/mdechiaro)) + +## [4.1.0](https://github.com/puppetlabs/puppetlabs-apache/tree/4.1.0) (2019-04-05) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/4.0.0...4.1.0) + +### Added + +- \(MODULES-7196\) Allow setting CASRootProxiedAs per virtualhost \(replaces \#1857\) [\#1900](https://github.com/puppetlabs/puppetlabs-apache/pull/1900) ([Lavinia-Dan](https://github.com/Lavinia-Dan)) +- \(feat\) - Amazon Linux 2 compatibility added [\#1898](https://github.com/puppetlabs/puppetlabs-apache/pull/1898) ([david22swan](https://github.com/david22swan)) +- \(MODULES-8731\) Allow CIDRs for proxy\_ips/internal\_proxy in remoteip [\#1891](https://github.com/puppetlabs/puppetlabs-apache/pull/1891) ([JAORMX](https://github.com/JAORMX)) +- Manage all mod\_remoteip parameters supported by Apache [\#1882](https://github.com/puppetlabs/puppetlabs-apache/pull/1882) ([johanfleury](https://github.com/johanfleury)) +- MODULES-8541 : Allow HostnameLookups to be modified [\#1881](https://github.com/puppetlabs/puppetlabs-apache/pull/1881) ([k2patel](https://github.com/k2patel)) +- Add support for mod\_http2 [\#1867](https://github.com/puppetlabs/puppetlabs-apache/pull/1867) ([smortex](https://github.com/smortex)) +- Added code to paramertize the libphp prefix [\#1852](https://github.com/puppetlabs/puppetlabs-apache/pull/1852) ([grahamuk2018](https://github.com/grahamuk2018)) +- Added WSGI Options WSGIApplicationGroup and WSGIPythonOptimize [\#1847](https://github.com/puppetlabs/puppetlabs-apache/pull/1847) ([emetriqLikedeeler](https://github.com/emetriqLikedeeler)) + +### Fixed + +- \(bugfix\) set kernel for facter version test [\#1895](https://github.com/puppetlabs/puppetlabs-apache/pull/1895) ([tphoney](https://github.com/tphoney)) +- \(MODULES-5990\) - Managing conf\_enabled [\#1875](https://github.com/puppetlabs/puppetlabs-apache/pull/1875) ([david22swan](https://github.com/david22swan)) + +## [4.0.0](https://github.com/puppetlabs/puppetlabs-apache/tree/4.0.0) (2019-01-10) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/3.5.0...4.0.0) + +### Changed + +- default server\_tokens to prod - more secure default [\#1746](https://github.com/puppetlabs/puppetlabs-apache/pull/1746) ([juju4](https://github.com/juju4)) + +### Added + +- \(Modules 8141/Modules 8379\) - Addition of support for SLES 15 [\#1862](https://github.com/puppetlabs/puppetlabs-apache/pull/1862) ([david22swan](https://github.com/david22swan)) +- SCL support for httpd and php7.1 [\#1822](https://github.com/puppetlabs/puppetlabs-apache/pull/1822) ([mmoll](https://github.com/mmoll)) + +### Fixed + +- \(MODULES-5990\) - conf-enabled defaulted to undef [\#1869](https://github.com/puppetlabs/puppetlabs-apache/pull/1869) ([david22swan](https://github.com/david22swan)) +- pdksync - \(FM-7655\) Fix rubygems-update for ruby \< 2.3 [\#1866](https://github.com/puppetlabs/puppetlabs-apache/pull/1866) ([tphoney](https://github.com/tphoney)) + +## [3.5.0](https://github.com/puppetlabs/puppetlabs-apache/tree/3.5.0) (2018-12-17) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/3.4.0...3.5.0) + +### Added + +- \(MODULES-5990\) Addition of 'IncludeOptional conf-enabled/\*.conf' to apache2.conf' on Debian Family OS [\#1851](https://github.com/puppetlabs/puppetlabs-apache/pull/1851) ([david22swan](https://github.com/david22swan)) +- \(MODULES-8107\) - Support added for Ubuntu 18.04. [\#1850](https://github.com/puppetlabs/puppetlabs-apache/pull/1850) ([david22swan](https://github.com/david22swan)) +- \(MODULES-8108\) - Support added for Debian 9 [\#1849](https://github.com/puppetlabs/puppetlabs-apache/pull/1849) ([david22swan](https://github.com/david22swan)) +- Add option to add comments to the header of a vhost file [\#1841](https://github.com/puppetlabs/puppetlabs-apache/pull/1841) ([jovandeginste](https://github.com/jovandeginste)) + +### Fixed + +- \(FM-7605\) - Disabling conf\_enabled on Ubuntu 18.04 by default as it conflicts with Shibboleth causing errors with apache2. [\#1856](https://github.com/puppetlabs/puppetlabs-apache/pull/1856) ([david22swan](https://github.com/david22swan)) +- \(MODULES-8429\) Update GPG key for phusion passenger [\#1848](https://github.com/puppetlabs/puppetlabs-apache/pull/1848) ([abottchen](https://github.com/abottchen)) +- Fix default vhost priority in readme [\#1843](https://github.com/puppetlabs/puppetlabs-apache/pull/1843) ([HT43-bqxFqB](https://github.com/HT43-bqxFqB)) +- fix apache::mod::jk example typo and add link for more info [\#1812](https://github.com/puppetlabs/puppetlabs-apache/pull/1812) ([xorpaul](https://github.com/xorpaul)) +- MODULES-7379: Fixing syntax by adding newline [\#1803](https://github.com/puppetlabs/puppetlabs-apache/pull/1803) ([wimvr](https://github.com/wimvr)) +- ensure mpm\_event is disabled under debian 9 if mpm itk is used [\#1766](https://github.com/puppetlabs/puppetlabs-apache/pull/1766) ([zivis](https://github.com/zivis)) + +## [3.4.0](https://github.com/puppetlabs/puppetlabs-apache/tree/3.4.0) (2018-09-27) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/3.3.0...3.4.0) + +### Added + +- pdksync - \(FM-7392\) - Puppet 6 Testing Changes [\#1838](https://github.com/puppetlabs/puppetlabs-apache/pull/1838) ([pmcmaw](https://github.com/pmcmaw)) +- pdksync - \(MODULES-6805\) metadata.json shows support for puppet 6 [\#1836](https://github.com/puppetlabs/puppetlabs-apache/pull/1836) ([tphoney](https://github.com/tphoney)) + +### Fixed + +- Fix "audit\_log\_relevant\_status" typo in README.md [\#1830](https://github.com/puppetlabs/puppetlabs-apache/pull/1830) ([smokris](https://github.com/smokris)) + +## [3.3.0](https://github.com/puppetlabs/puppetlabs-apache/tree/3.3.0) (2018-09-11) + +[Full Changelog](https://github.com/puppetlabs/puppetlabs-apache/compare/3.2.0...3.3.0) + +### Added + +- pdksync - \(MODULES-7705\) - Bumping stdlib dependency from \< 5.0.0 to \< 6.0.0 [\#1821](https://github.com/puppetlabs/puppetlabs-apache/pull/1821) ([pmcmaw](https://github.com/pmcmaw)) +- Add support for ProxyTimeout [\#1805](https://github.com/puppetlabs/puppetlabs-apache/pull/1805) ([agoodno](https://github.com/agoodno)) +- \(MODULES-7343\) - Allow overrides by adding mod\_libs in apache class [\#1800](https://github.com/puppetlabs/puppetlabs-apache/pull/1800) ([karelyatin](https://github.com/karelyatin)) +- Rework passenger VHost and Directories [\#1778](https://github.com/puppetlabs/puppetlabs-apache/pull/1778) ([smortex](https://github.com/smortex)) + +### Fixed + +- MODULES-7575 reverse sort the aliases [\#1808](https://github.com/puppetlabs/puppetlabs-apache/pull/1808) ([k2patel](https://github.com/k2patel)) +- fixes for OpenSUSE ans SLES [\#1783](https://github.com/puppetlabs/puppetlabs-apache/pull/1783) ([tuxmea](https://github.com/tuxmea)) + +## 3.2.0 +### Summary +This is a clean release to prepare for several planned backwards incompatible changes. + +#### Changed +- Parameter `passenger_pre_start` has been moved outside of ``. +- Apache version fact has been enabled on FreeBSD. +- Parameter `ssl_proxyengine` has had it's default changed to false. + +#### Added +- Parameter `passenger_group` can now be set in `apache::vhost`. +- Multiple `passenger_pre_start` URIs can now be set at once. +- Manifest `mod::auth_gssapi` has been added to allow the deployment of authorisation with kerberos, through GSSAPI. + +#### Removed +- Scientific 5 and Debian 7 are no longer supported on Apache. + +## Supported Release [3.1.0] +### Summary +This release includes the module being converted using version 1.4.1 of the PDK. It also includes a couple of additional parameters added. + +#### Added +- Module has been pdk converted with version 1.4.1 ([MODULES-6331](https://tickets.puppet.com/browse/MODULES-6331)) +- Parameter `ssl_cert` to provide a SSLCertificateFile option for use with SSL, optional of type String. +- Parameter `ssl_key` to provide a SSLCertificateKey option for use with SSL, optional of type String. + +#### Fixed +- Documentation updates. +- Updates to the Japanese translation based on documentation update. + +## Supported Release [3.0.0] +### Summary +This major release changes the default value of `keepalive` to `On`. It also includes many other features and bugfixes. + +#### Changed +- Default `apache::keepalive` from `Off` to `On`. + +#### Added +- Class `apache::mod::data` +- Function `apache::apache_pw_hash` function (puppet 4 port of `apache_pw_hash()`) +- Function `apache::bool2httpd` function (puppet 4 port of `bool2httpd()`) +- Function `apache::validate_apache_log_level` function (puppet 4 port of `validate_apache_log_level()`) +- Parameter `apache::balancer::options` for additional directives. +- Parameter `apache::limitreqfields` setting the LimitRequestFields directive to 100. +- Parameter `apache::use_canonical_name` to control how httpd uses self-referential URLs. +- Parameter `apache::mod::disk_cache::cache_ignore_headers` to ignore cache headers. +- Parameter `apache::mod::itk::enablecapabilities` to manage ITK capabilities. +- Parameter `apache::mod::ldap::ldap_trusted_mode` to manage trusted mode. +- Parameters for `apache::mod::passenger`: + - `passenger_allow_encoded_slashes` + - `passenger_app_group_name` + - `passenger_app_root` + - `passenger_app_type` + - `passenger_base_uri` + - `passenger_buffer_response` + - `passenger_buffer_upload` + - `passenger_concurrency_model` + - `passenger_debug_log_file` + - `passenger_debugger` + - `passenger_default_group` + - `passenger_default_user` + - `passenger_disable_security_update_check` + - `passenger_enabled` + - `passenger_error_override` + - `passenger_file_descriptor_log_file` + - `passenger_fly_with` + - `passenger_force_max_concurrent_requests_per_process` + - `passenger_friendly_error_pages` + - `passenger_group` + - `passenger_installed_version` + - `passenger_instance_registry_dir` + - `passenger_load_shell_envvars` + - `passenger_lve_min_uid` + - `passenger_max_instances` + - `passenger_max_preloader_idle_time` + - `passenger_max_request_time` + - `passenger_memory_limit` + - `passenger_meteor_app_settings` + - `passenger_nodejs` + - `passenger_pre_start` + - `passenger_python` + - `passenger_resist_deployment_errors` + - `passenger_resolve_symlinks_in_document_root` + - `passenger_response_buffer_high_watermark` + - `passenger_restart_dir` + - `passenger_rolling_restarts` + - `passenger_security_update_check_proxy` + - `passenger_show_version_in_header` + - `passenger_socket_backlog` + - `passenger_start_timeout` + - `passenger_startup_file` + - `passenger_sticky_sessions` + - `passenger_sticky_sessions_cookie_name` + - `passenger_thread_count` + - `passenger_user` + - `passenger_user_switching` + - `rack_auto_detect` + - `rack_base_uri` + - `rack_env` + - `rails_allow_mod_rewrite` + - `rails_app_spawner_idle_time` + - `rails_auto_detect` + - `rails_base_uri` + - `rails_default_user` + - `rails_env` + - `rails_framework_spawner_idle_time` + - `rails_ruby` + - `rails_spawn_method` + - `rails_user_switching` + - `wsgi_auto_detect` +- Parameter `apache::mod::prefork::listenbacklog` to set the listen backlog to 511. +- Parameter `apache::mod::python::loadfile_name` to workaround python.load filename conflicts. +- Parameter `apache::mod::ssl::ssl_cert` to manage the client auth cert. +- Parameter `apache::mod::ssl::ssl_key` to manage the client auth key. +- Parameter `apache::mod::status::requires` as an alternative to `apache::mod::status::allow_from` +- Parameter `apache::vhost::ssl_proxy_cipher_suite` to manage that directive. +- Parameter `apache::vhost::shib_compat_valid_user` to manage that directive. +- Parameter `apache::vhost::use_canonical_name` to manage that directive. +- Parameter value `mellon_session_length` for `apache::vhost::directories` + +### Fixed +- `apache_version` is confined to just Linux to avoid erroring on AIX. +- Parameter `apache::mod::jk::workers_file_content` docs typo of "mantain" instead of maintain. +- Deduplicate `apache::mod::ldap` managing `File['ldap.conf']` to avoid resource conflicts. +- ITK package name on Debian 9 +- Dav_svn package for SLES +- Log client IP instead of loadbalancer IP when behind a loadbalancer. +- `apache::mod::remoteip` now notifies the `Class['apache::service']` class instead of `Service['httpd']` to avoid restarting the service when `apache::service_manage` is false. +- `apache::vhost::cas_scrub_request_headers` actually manages the directive. + +## Supported Release [2.3.1] +### Summary +This release fixes CVE-2018-6508 which is a potential arbitrary code execution via tasks. + +### Fixed +- Fix init task for arbitrary remote code + +## Supported Release [2.3.0] +### Summary +This is a feature release. It includes a task that will reload the apache service. + +#### Added +- Add a task that allows the reloading of the Apache service. + +## Supported Release [2.2.0] +### Summary +This is a maintainence and feature release. It will include updates to translations in Japanese, some maintainence and adding `PassengerSpawnMethod` to vhost. + +#### Added +- `PassengerSpawnMethod` added to `vhost`. + +#### Changed +- Improve version match fact for `apache_version` +- Update to prefork.conf params for Apache 2.4 +- Updates to `CONTRIBUTING.md` +- Do not install mod_fastcgi on el7 +- Include mod_wsgi when using wsgi options + +## Supported Release [2.1.0] +### Summary +This is a feature release including a security patch (CVE-2017-2299) + +#### Added +- `apache::mod::jk` class for managing the mod_jk connector +- `apache_pw_hash` function +- the ProxyPass directive in location contexts +- more Puppet 4 type validation +- `apache::mod::macro` class for managing mod_macro + +#### Changed +- $ssl_certs_dir default to `undef` for all platorms +- $ssl_verify_client must now be set to use any of the following: `$ssl_certs_dir`, `$ssl_ca`, `$ssl_crl_path`, `$ssl_crl`, `$ssl_verify_depth`, `$ssl_crl_check` + +#### Fixed +- issue where mod_alias was not being loaded when RedirectMatch* directives were being used ([MODULES-3942](https://tickets.puppet.com/browse/MODULES-3942)) +- issue with `$directories` parameter in `apache::vhost` +- issue in UserDir template where the UserDir path did not match the Directory path +- **Issue where the $ssl_certs_dir default set Apache to implicitly trust all client certificates that were issued by any CA in that directory** + +#### Removed +- support for EOL platforms: Ubuntu 10.04, 12.04 and Debian 6 (Squeeze) + +## Supported Release [2.0.0] +### Summary +Major release **removing Puppet 3 support** and other backwards-incompatible changes. + +#### Added +- support for FileETag directive configurable with the `file_e_tag` parameter +- ability to configure multiple ports per vhost +- RequestHeader directive to vhost template ([MODULES-4156](https://tickets.puppet.com/browse/MODULES-4156)) +- customizability for AllowOverride directive in userdir.conf ([MODULES-4516](https://tickets.puppet.com/browse/MODULES-4516)) +- AdvertiseFrequency directive for cluster.conf ([MODULES-4500](https://tickets.puppet.com/browse/MODULES-4500)) +- `ssl_proxy_protocol` and `ssl_sessioncache` parameters for mod::ssl ([MODULES-4737](https://tickets.puppet.com/browse/MODULES-4737)) +- SSLCACertificateFile directive in ssl.conf configurable with `ssl_ca` parameter +- mod::authnz_pam +- mod::intercept_form_submit +- mod::lookup_identity +- Suse compatibility for mod::proxy_html +- support for AddCharset directive configurable with `add_charset` parameter +- support for SSLProxyVerifyDepth and SSLProxyCACertificateFile directives configurable with `ssl_proxy_verify_depth` and `ssl_proxy_ca_cert` respectively +- `manage_security_crs` parameter for mod::security +- support for LimitExcept directive configurable with `limit_except` parameter +- support for WSGIRestrictEmbedded directive configurable with `wsgi_restrict_embedded` parameter +- support for custom UserDir path ([MODULES-4933](https://tickets.puppet.com/browse/MODULES-4933)) +- support for PassengerMaxRequests directive configurable with `passenger_max_requests` +- option to override module package names with `mod_packages` parameter ([MODULES-3838](https://tickets.puppet.com/browse/MODULES-3838)) + +#### Removed +- enclose_ipv6 as it was added to puppetlabs-stdlib +- deprecated `$verifyServerCert` parameter from the `apache::mod::authnz_ldap` class ([MODULES-4445](https://tickets.puppet.com/browse/MODULES-4445)) + +#### Changed +- `keepalive` default to 'On' from 'Off' +- Puppet version compatibility to ">= 4.7.0 < 6.0.0" +- puppetlabs-stdlib dependency to ">= 4.12.0 < 5.0.0" +- `ssl_cipher` to explicitly disable 3DES because of Sweet32 + +#### Fixed +- various issues in the vhost template +- use of deprecated `include_src` parameter in vhost_spec +- management of ssl.conf on RedHat systems +- various SLES/Suse params +- mod::cgi ordering for FreeBSD +- issue where ProxyPreserveHost could not be set without other Proxy* directives +- the module attempting to install proxy_html on Ubuntu Xenial and Debian Stretch + +## Supported Release [1.11.1] +#### Summary +This is a security patch release (CVE-2017-2299). These changes are also in version 2.1.0 and higher. + +#### Changed +- $ssl_certs_dir default to `undef` for all platorms +- $ssl_verify_client must now be set to use any of the following: `$ssl_certs_dir`, `$ssl_ca`, `$ssl_crl_path`, `$ssl_crl`, `$ssl_verify_depth`, `$ssl_crl_check` + +#### Fixed +- **Issue where the $ssl_certs_dir default set Apache to implicitly trust all client certificates that were issued by any CA in that directory** ([MODULES-5471](https://tickets.puppet.com/browse/MODULES-5471)) + +## Supported Release [1.11.0] +### Summary +This release adds SLES12 Support and many more features and bugfixes. + +#### Features +- (MODULES-4049) Adds SLES 12 Support +- Adds additional directories options for LDAP Auth + - `auth_ldap_url` + - `auth_ldap_bind_dn` + - `auth_ldap_bind_password` + - `auth_ldap_group_attribute` + - `auth_ldap_group_attribute_is_dn` +- Allows `mod_event` parameters to be unset +- Allows management of default root directory access rights +- Adds class `apache::vhosts` to create apache::vhost resources +- Adds class `apache::mod::proxy_wstunnel` +- Adds class `apache::mod::dumpio` +- Adds class `apache::mod::socache_shmcb` +- Adds class `apache::mod::authn_dbd` +- Adds support for apache 2.4 on Amazon Linux +- Support the newer `mod_auth_cas` config options +- Adds `wsgi_script_aliases_match` parameter to `apache::vhost` +- Allow to override all SecDefaultAction attributes +- Add audit_log_relevant_status parameter to apache::mod::security +- Allow absolute path to $apache::mod::security::activated_rules +- Allow setting SecAuditLog +- Adds `passenger_max_instances_per_app` to `mod::passenger` +- Allow the proxy_via setting to be configured +- Allow no_proxy_uris to be used within proxy_pass +- Add rpaf.conf template parameter to `mod::rpaf` +- Allow user to specify alternative package and library names for shibboleth module +- Allows configuration of shibboleth lib path +- Adds parameter `passenger_data_buffer_dir` to `mod::passenger` +- Adds SSL stapling +- Allows use of `balance_manager` with `mod_proxy_balancer` +- Raises lower bound of `stdlib` dependency to version 4.2 +- Adds support for Passenger repo on Amazon Linux +- Add ability to set SSLStaplingReturnResponderErrors on server level +- (MODULES-4213) Allow global rewrite rules inheritance in vhosts +- Moves `mod_env` to its own class and load it when required + +#### Bugfixes +- Deny access to .ht and .hg, which are created by mercurial hg. +- Instead of failing, include apache::mod::prefork in manifests/mod/itk.pp instead. +- Only set SSLCompression when it is set to true. +- Remove duplicate shib2 hash element +- (MODULES-3388) Include mpm_module classes instead of class declaration +- Updates `apache::balancer` to respect `apache::confd_dir` +- Wrap mod_security directives in an IfModule +- Fixes to various mods for Ubuntu Xenial +- Fix /etc/modsecurity perms to match package +- Fix PassengerRoot under Debian stretch +- (MODULES-3476) Updates regex in apache_version custom fact to work with EL5 +- Dont sql_injection_attacks.data +- Add force option to confd file resource to purge directory without warnings +- Patch httpoxy through mod_security +- Fixes config ordering of IncludeOptional +- Fixes bug where port numbers were unquoted +- Fixes bug where empty servername for vhost were written to template +- Auto-load `slotmem_shm` and `lbmethod_byrequests` with `proxy_balancer` on 2.4 +- Simplify MPM setup on FreeBSD +- Adds requirement for httpd package +- Do not set ssl_certs_dir on FreeBSD +- Fixes bug that produces a duplicate `Listen 443` after a package update on EL7 +- Fixes bug where custom facts break structured facts +- Avoid relative classname inclusion +- Fixes a failure in `vhost` if the first element of `$rewrites` is not a hash +- (MODULES-3744) Process $crs_package before $modsec_dir +- (MODULES-1491) Adds `::apache` include to mods that need it + +## Supported Release [1.10.0] +#### Summary +This release fixes backwards compatibility bugs introduced in 1.9.0. Also includes a new mod class and a new vhost feature. + +#### Features +- Allow setting KeepAlive related options per vhost + - `apache::vhost::keepalive` + - `apache::vhost::keepalive_timeout` + - `apache::vhost::max_keepalive_requests` +- Adds new class `apache::mod::cluster` + +#### Bugfixes +- MODULES-2890: Allow php_version != 5 +- MODULES-2890: mod::php: Explicit test on jessie +- MODULES-2890: Fix PHP on Debian stretch and Ubuntu Xenial +- MODULES-2890: Fix mod_php SetHandler and cleanup +- Fixed trailing slash in lib_path on Suse +- Revert "MODULES-2956: Enable options within location block on proxy_match". Bug introduced in release 1.9.0. +- Revert "changed rpaf Configuration Directives: RPAF -> RPAF_". Bug introduced in release 1.9.0. +- Set actual path to apachectl on FreeBSD. Fixes snippets verification. + +## Supported Release [1.9.0] [DELETED] +#### Features +- Added `apache_version` fact +- Added `apache::balancer::target` attribute +- Added `apache::fastcgi::server::pass_header` attribute +- Added ability for `apache::fastcgi::server::host` using sockets +- Added `apache::root_directory_options` attribute +- Added for `apache::mod::ldap`: + - `ldap_shared_cache_size` + - `ldap_cache_entries` + - `ldap_cache_ttl` + - `ldap_opcache_entries` + - `ldap_opcache_ttl` +- Added `apache::mod::pagespeed::package_ensure` attribute +- Added `apache::mod::passenger` attributes: + - `passenger_log_level` + - `manage_repo` +- Added upstream repo for `apache::mod::passenger` +- Added `apache::mod::proxy_fcgi` class +- Added `apache::mod::security` attributes: + - `audit_log_parts` + - `secpcrematchlimit` + - `secpcrematchlimitrecursion` + - `secdefaultaction` + - `anomaly_score_blocking` + - `inbound_anomaly_threshold` + - `outbound_anomaly_threshold` +- Added `apache::mod::ssl` attributes: + - `ssl_mutex` + - `apache_version` +- Added ubuntu 16.04 support +- Added `apache::mod::authnz_ldap::package_name` attribute +- Added `apache::mod::ldap::package_name` attribute +- Added `apache::mod::proxy::package_name` attribute +- Added `apache::vhost` attributes: + - `ssl_proxy_check_peen_expire` + - `ssl_proxy_protocol` + - `logroot_owner` + - `logroot_group` + - `setenvifnocase` + - `passenger_user` + - `passenger_high_performance` + - `jk_mounts` + - `fastcgi_idle_timeout` + - `modsec_disable_msgs` + - `modsec_disable_tags` +- Added ability for 2.4-style `RequireAll|RequireNone|RequireAny` directory permissions +- Added ability for includes in vhost directory +- Added directory values: + - `AuthMerging` + - `MellonSPMetadataFile` +- Adds Configurability of Collaborative Detection Severity Levels for OWASP Core Rule Set to `apache::mod::security` class + - `critical_anomaly_score` + - `error_anomaly_score` + - `warning_anomaly_score` + - `notice_anomaly_score` +- Adds ability to configure `info_path` in `apache::mod::info` class +- Adds ability to configure `verify_config` in `apache::vhost::custom` + +#### Bugfixes +- Fixed apache mod setup for event/worker failing syntax +- Fixed concat deprecation warnings +- Fixed pagespeed mod +- Fixed service restart on mod update +- Fixed mod dir purging to happen after package installs +- Fixed various `apache::mod::*` file modes +- Fixed `apache::mod::authnz_ldap` parameter `verifyServerCert` to be `verify_server_cert` +- Fixed loadfile name in `apache::mod::fcgid` +- Fixed `apache::mod::remoteip` to fail on apache < 2.4 (because it is not available) +- Fixed `apache::mod::ssl::ssl_honorcipherorder` interpolation +- Lint fixes +- Strict variable fixes +- Fixed `apache::vhost` attribute `redirectmatch_status` to be optional +- Fixed SSLv3 on by default in mod\_nss +- Fixed mod\_rpaf directive names in template +- Fixed mod\_worker needing MaxClients with ThreadLimit +- Fixed quoting on vhost php\_value +- Fixed xml2enc for proxy\_html on debian +- Fixed a problem where the apache service restarts too fast + +## Supported Release [1.8.1] +### Summary +This release includes bug fixes and a documentation update. + +#### Bugfixes +- Fixes a bug that occurs when using the module in combination with puppetlabs-concat 2.x. +- Fixes a bug where passenger.conf was vulnerable to purging. +- Removes the pin of the concat module dependency. + +## Supported Release [1.8.0] +### Summary +This release includes a lot of bug fixes and feature updates, including support for Debian 8, as well as many test improvements. + +#### Features +- Debian 8 Support. +- Added the 'file_mode' property to allow a custom permission setting for config files. +- Enable 'PassengerMaxRequestQueueSize' to be set for mod_passenger. +- MODULES-2956: Enable options within location block on proxy_match. +- Support itk on redhat. +- Support the mod_ssl SSLProxyVerify directive. +- Support ProxPassReverseCookieDomain directive (mod_proxy). +- Support proxy provider for vhost directories. +- Added new 'apache::vhost::custom' resource. + +#### Bugfixes +- Fixed ProxyPassReverse configuration. +- Fixed error in Amazon operatingsystem detection. +- Fixed mod_security catalog ordering issues for RedHat 7. +- Fixed paths and packages for the shib2 apache module on Debian pre Jessie. +- Fixed EL7 directory path for apache modules. +- Fixed validation error when empty array is passed for the rewrites parameter. +- Idempotency fixes with regards to '::apache::mod_enable_dir'. +- ITK fixes. +- (MODULES-2865) fix $mpm_module logic for 'false'. +- Set SSLProxy directives even if ssl is false, due to issue with RewriteRules and ProxyPass directives. +- Enable setting LimitRequestFieldSize globally, and remove it from vhost. + +#### Improvements +- apache::mod::php now uses FilesMatch to configure the php handler. This is following the recommended upstream configuration guidelines (http://php.net/manual/en/install.unix.apache2.php#example-20) and distribution's default config (e.g.: http://bazaar.launchpad.net/~ubuntu-branches/ubuntu/vivid/php5/vivid/view/head:/debian/php5.conf). It avoids inadvertently exposing the PHP handler to executing uploads with names like 'file.php.jpg', but might impact setups with unusual requirements. +- Improved compatibility for Gentoo. +- Vhosts can now be supplied with a wildcard listen value. +- Numerous test improvements. +- Removed workarounds for https://bz.apache.org/bugzilla/show_bug.cgi?id=38864 as the issues have been fixed in Apache. +- Documentation updates. +- Ensureed order of ProxyPass and ProxyPassMatch parameters. +- Ensure that ProxyPreserveHost is set to off mode explicitly if not set in manifest. +- Put headers and request headers before proxy with regards to template generation. +- Added X-Forwarded-For into log_formats defaults. +- (MODULES-2703) Allow mod pagespeed to take an array of lines as additional_configuration. + +## Supported Release [1.7.1] +###Summary + +Small release for support of newer PE versions. This increments the version of PE in the metadata.json file. + +## Supported Release [1.7.0] +### Summary +This release includes many new features and bugfixes. There are test, documentation and misc improvements. + +#### Features +- allow groups with - like vhost-users +- ability to enable/disable the secruleengine through a parameter +- add mod_auth_kerb parameters to vhost +- client auth for reverse proxy +- support for mod_auth_mellon +- change SSLProtocol in apache::vhost to be space separated +- RewriteLock support + +#### Bugfixes +- fix apache::mod::cgid so it can be used with the event MPM +- load unixd before fcgid on all operating systems +- fixes conditional in vhost aliases +- corrects mod_cgid worker/event defaults +- ProxyPassMatch parameters were ending up on a newline +- catch that mod_authz_default has been removed in Apache 2.4 +- mod::ssl fails on SLES +- fix typo of MPM_PREFORK for FreeBSD package install +- install all modules before adding custom configs +- fix acceptance testing for SSLProtocol behaviour for real +- fix ordering issue with conf_file and ports_file + +#### Known Issues +- mod_passenger is having issues installing on Redhat/Centos 6, This is due to package dependency issues. + +#### Improvements +- added docs for forcetype directive +- removes ruby 1.8.7 from the travisci test matrix +- readme reorganisation, minor fixups +- support the mod_proxy ProxyPassReverseCookiePath directive +- the purge_vhost_configs parameter is actually called purge_vhost_dir +- add ListenBacklog for mod worker +- deflate application/json by default +- install mod_authn_alias as default mod in debian for apache < 2.4 +- optionally set LimitRequestFieldSize on an apache::vhost +- add SecUploadDir parameter to support file uploads with mod_security +- optionally set parameters for mod_ext_filter module +- allow SetOutputFilter to be set on a directory +- RC4 is deprecated +- allow empty docroot +- add option to configure the include pattern for the vhost_enable dir +- allow multiple IP addresses per vhost +- default document root update for Ubuntu 14.04 and Debian 8 + +## Supported Release [1.6.0] +### Summary +This release includes a couple of new features, along with test and documentation updates, and support for the latest AIO puppet builds. + +#### Features +- Add `scan_proxy_header_field` parameter to `apache::mod::geoip` +- Add `ssl_openssl_conf_cmd` parameter to `apache::vhost` and `apache::mod::ssl` +- Add `filters` parameter to `apache::vhost` + +#### Bugfixes +- Test updates +- Do not use systemd on Amazon Linux +- Add missing docs for `timeout` parameter (MODULES-2148) + +## Supported Release [1.5.0] +### Summary +This release primarily adds Suse compatibility. It also adds a handful of other +parameters for greater configuration control. + +#### Features +- Add `apache::lib_path` parameter +- Add `apache::service_restart` parameter +- Add `apache::vhost::geoip_enable` parameter +- Add `apache::mod::geoip` class +- Add `apache::mod::remoteip` class +- Add parameters to `apache::mod::expires` class +- Add `index_style_sheet` handling to `apache::vhost::directories` +- Add some compatibility for SLES 11 +- Add `apache::mod::ssl::ssl_sessioncachetimeout` parameter +- Add `apache::mod::ssl::ssl_cryptodevice` parameter +- Add `apache::mod::ssl::ssl_honorcipherorder` parameter +- Add `apache::mod::userdir::options` parameter + +#### Bugfixes +- Document `apache::user` parameter +- Document `apache::group` parameter +- Fix apache::dev on FreeBSD +- Fix proxy\_connect on apache >= 2.2 +- Validate log levels better +- Fix `apache::apache_name` for package and vhost +- Fix Debian Jessie mod\_prefork package name +- Fix alias module being declared even when vhost is absent +- Fix proxy\_pass\_match handling in vhost's proxy template +- Fix userdir access permissions +- Fix issue where the module was trying to use systemd on Amazon Linux. + +## Supported Release [1.4.1] + +This release corrects a metadata issue that has been present since release 1.2.0. The refactoring of `apache::vhost` to use `puppetlabs-concat` requires a version of concat newer than the version required in PE. If you are using PE 3.3.0 or earlier you will need to use version 1.1.1 or earlier of the `puppetlabs-apache` module. + +## Supported Release [1.4.0] +###Summary + +This release fixes the issue where the docroot was still managed even if the default vhosts were disabled and has many other features and bugfixes including improved support for 'deny' and 'require' as arrays in the 'directories' parameter under `apache::vhost` + +#### Features +- New parameters to `apache` + - `default_charset` + - `default_type` +- New parameters to `apache::vhost` + - `proxy_error_override` + - `passenger_app_env` (MODULES-1776) + - `proxy_dest_match` + - `proxy_dest_reverse_match` + - `proxy_pass_match` + - `no_proxy_uris_match` +- New parameters to `apache::mod::passenger` + - `passenger_app_env` + - `passenger_min_instances` +- New parameter to `apache::mod::alias` + - `icons_options` +- New classes added under `apache::mod::*` + - `authn_file` + - `authz_default` + - `authz_user` +- Added support for 'deny' as an array in 'directories' under `apache::vhost` +- Added support for RewriteMap +- Improved support for FreeBSD. (Note: If using apache < 2.4.12, see the discussion [here](https://github.com/puppetlabs/puppetlabs-apache/pull/1030)) +- Added check for deprecated options in directories and fail when they are unsupported +- Added gentoo compatibility +- Added proper array support for `require` in the `directories` parameter in `apache::vhost` +- Added support for `setenv` inside proxy locations + +### Bugfixes +- Fix issue in `apache::vhost` that was preventing the scriptalias fragment from being included (MODULES-1784) +- Install required `mod_ldap` package for EL7 (MODULES-1779) +- Change default value of `maxrequestworkers` in `apache::mod::event` to be a multiple of the default `ThreadsPerChild` of 25. +- Use the correct `mod_prefork` package name for trusty and jessie +- Don't manage docroot when default vhosts are disabled +- Ensure resources notify `Class['Apache::Service']` instead of `Service['httpd']` (MODULES-1829) +- Change the loadfile name for `mod_passenger` so `mod_proxy` will load by default before `mod_passenger` +- Remove old Debian work-around that removed `passenger_extra.conf` + +## Supported Release [1.3.0] +### Summary + +This release has many new features and bugfixes, including the ability to optionally not trigger service restarts on config changes. + +#### Features +- New parameters - `apache` + - `service_manage` + - `use_optional_includes` +- New parameters - `apache::service` + - `service_manage` +- New parameters - `apache::vhost` + - `access_logs` + - `php_flags` + - `php_values` + - `modsec_disable_vhost` + - `modsec_disable_ids` + - `modsec_disable_ips` + - `modsec_body_limit` +- Improved FreeBSD support +- Add ability to omit priority prefix if `$priority` is set to false +- Add `apache::security::rule_link` define +- Improvements to `apache::mod::*` + - Add `apache::mod::auth_cas` class + - Add `threadlimit`, `listenbacklog`, `maxrequestworkers`, `maxconnectionsperchild` parameters to `apache::mod::event` + - Add `apache::mod::filter` class + - Add `root_group` to `apache::mod::php` + - Add `apache::mod::proxy_connect` class + - Add `apache::mod::security` class + - Add `ssl_pass_phrase_dialog` and `ssl_random_seed_bytes` parameters to `apache::mod::ssl` (MODULES-1719) + - Add `status_path` parameter to `apache::mod::status` + - Add `apache_version` parameter to `apache::mod::version` + - Add `package_name` and `mod_path` parameters to `apache::mod::wsgi` (MODULES-1458) +- Improved SCL support + - Add support for specifying the docroot +- Updated `_directories.erb` to add support for SetEnv +- Support multiple access log directives (MODULES-1382) +- Add passenger support for Debian Jessie +- Add support for not having puppet restart the apache service (MODULES-1559) + +#### Bugfixes +- For apache 2.4 `mod_itk` requires `mod_prefork` (MODULES-825) +- Allow SSLCACertificatePath to be unset in `apache::vhost` (MODULES-1457) +- Load fcgid after unixd on RHEL7 +- Allow disabling default vhost for Apache 2.4 +- Test fixes +- `mod_version` is now built-in (MODULES-1446) +- Sort LogFormats for idempotency +- `allow_encoded_slashes` was omitted from `apache::vhost` +- Fix documentation bug (MODULES-1403, MODULES-1510) +- Sort `wsgi_script_aliases` for idempotency (MODULES-1384) +- lint fixes +- Fix automatic version detection for Debian Jessie +- Fix error docs and icons path for RHEL7-based systems (MODULES-1554) +- Sort php_* hashes for idempotency (MODULES-1680) +- Ensure `mod::setenvif` is included if needed (MODULES-1696) +- Fix indentation in `vhost/_directories.erb` template (MODULES-1688) +- Create symlinks on all distros if `vhost_enable_dir` is specified + +## Supported Release [1.2.0] +### Summary + +This release features many improvements and bugfixes, including several new defines, a reworking of apache::vhost for more extensibility, and many new parameters for more customization. This release also includes improved support for strict variables and the future parser. + +#### Features +- Convert apache::vhost to use concat for easier extensions +- Test improvements +- Synchronize files with modulesync +- Strict variable and future parser support +- Added apache::custom_config defined type to allow validation of configs before they are created +- Added bool2httpd function to convert true/false to apache 'On' and 'Off'. Intended for internal use in the module. +- Improved SCL support + - allow overriding of the mod_ssl package name +- Add support for reverse_urls/ProxyPassReverse in apache::vhost +- Add satisfy directive in apache::vhost::directories +- Add apache::fastcgi::server defined type +- New parameters - apache + - allow_encoded_slashes + - apache_name + - conf_dir + - default_ssl_crl_check + - docroot + - logroot_mode + - purge_vhost_dir +- New parameters - apache::vhost + - add_default_charset + - allow_encoded_slashes + - logroot_ensure + - logroot_mode + - manage_docroot + - passenger_app_root + - passenger_min_instances + - passenger_pre_start + - passenger_ruby + - passenger_start_timeout + - proxy_preserve_host + - proxy_requests + - redirectmatch_dest + - ssl_crl_check + - wsgi_chunked_request + - wsgi_pass_authorization +- Add support for ScriptAlias and ScriptAliasMatch in the apache::vhost::aliases parameter +- Add support for rewrites in the apache::vhost::directories parameter +- If the service_ensure parameter in apache::service is set to anything other than true, false, running, or stopped, ensure will not be passed to the service resource, allowing for the service to not be managed by puppet +- Turn of SSLv3 by default +- Improvements to apache::mod* + - Add restrict_access parameter to apache::mod::info + - Add force_language_priority and language_priority parameters to apache::mod::negotiation + - Add threadlimit parameter to apache::mod::worker + - Add content, template, and source parameters to apache::mod::php + - Add mod_authz_svn support via the authz_svn_enabled parameter in apache::mod::dav_svn + - Add loadfile_name parameter to apache::mod + - Add apache::mod::deflate class + - Add options parameter to apache::mod::fcgid + - Add timeouts parameter to apache::mod::reqtimeout + - Add apache::mod::shib + - Add apache_version parameter to apache::mod::ldap + - Add magic_file parameter to apache::mod::mime_magic + - Add apache_version parameter to apache::mod::pagespeed + - Add passenger_default_ruby parameter to apache::mod::passenger + - Add content, template, and source parameters to apache::mod::php + - Add apache_version parameter to apache::mod::proxy + - Add loadfiles parameter to apache::mod::proxy_html + - Add ssl_protocol and package_name parameters to apache::mod::ssl + - Add apache_version parameter to apache::mod::status + - Add apache_version parameter to apache::mod::userdir + - Add apache::mod::version class + +#### Bugfixes +- Set osfamily defaults for wsgi_socket_prefix +- Support multiple balancermembers with the same url +- Validate apache::vhost::custom_fragment +- Add support for itk with mod_php +- Allow apache::vhost::ssl_certs_dir to not be set +- Improved passenger support for Debian +- Improved 2.4 support without mod_access_compat +- Support for more than one 'Allow from'-directive in _directories.erb +- Don't load systemd on Amazon linux based on CentOS6 with apache 2.4 +- Fix missing newline in ModPagespeed filter and memcached servers directive +- Use interpolated strings instead of numbers where required by future parser +- Make auth_require take precedence over default with apache 2.4 +- Lint fixes +- Set default for php_admin_flags and php_admin_values to be empty hash instead of empty array +- Correct typo in mod::pagespeed +- spec_helper fixes +- Install mod packages before dealing with the configuration +- Use absolute scope to check class definition in apache::mod::php +- Fix dependency loop in apache::vhost +- Properly scope variables in the inline template in apache::balancer +- Documentation clarification, typos, and formatting +- Set apache::mod::ssl::ssl_mutex to default for debian on apache >= 2.4 +- Strict variables fixes +- Add authn_core mode to Ubuntu trusty defaults +- Keep default loadfile for authz_svn on Debian +- Remove '.conf' from the site-include regexp for better Ubuntu/Debian support +- Load unixd before fcgid for EL7 +- Fix RedirectMatch rules +- Fix misleading error message in apache::version + +#### Known Bugs +* By default, the version of Apache that ships with Ubuntu 10.04 does not work with `wsgi_import_script`. +* SLES is unsupported. + +## Supported Release [1.1.1] +### Summary + +This release merely updates metadata.json so the module can be uninstalled and +upgraded via the puppet module command. + +## Supported Release [1.1.0] + +### Summary + +This release primarily focuses on extending the httpd 2.4 support, tested +through adding RHEL7 and Ubuntu 14.04 support. It also includes Passenger +4 support, as well as several new modules and important bugfixes. + +#### Features + +- Add support for RHEL7 and Ubuntu 14.04 +- More complete apache24 support +- Passenger 4 support +- Add support for max_keepalive_requests and log_formats parameters +- Add mod_pagespeed support +- Add mod_speling support +- Added several parameters for mod_passenger +- Added ssl_cipher parameter to apache::mod::ssl +- Improved examples in documentation +- Added docroot_mode, action, and suexec_user_group parameters to apache::vhost +- Add support for custom extensions for mod_php +- Improve proxy_html support for Debian + +#### Bugfixes + +- Remove NameVirtualHost directive for apache >= 2.4 +- Order proxy_set option so it doesn't change between runs +- Fix inverted SSL compression +- Fix missing ensure on concat::fragment resources +- Fix bad dependencies in apache::mod and apache::mod::mime + +#### Known Bugs +* By default, the version of Apache that ships with Ubuntu 10.04 does not work with `wsgi_import_script`. +* SLES is unsupported. + +## Supported Release [1.0.1] +### Summary + +This is a supported release. This release removes a testing symlink that can +cause trouble on systems where /var is on a seperate filesystem from the +modulepath. + +#### Features +#### Bugfixes +#### Known Bugs +* By default, the version of Apache that ships with Ubuntu 10.04 does not work with `wsgi_import_script`. +* SLES is unsupported. + +## Supported Release [1.0.0] +### Summary + +This is a supported release. This release introduces Apache 2.4 support for +Debian and RHEL based osfamilies. + +#### Features + +- Add apache24 support +- Add rewrite_base functionality to rewrites +- Updated README documentation +- Add WSGIApplicationGroup and WSGIImportScript directives + +#### Bugfixes + +- Replace mutating hashes with merge() for Puppet 3.5 +- Fix WSGI import_script and mod_ssl issues on Lucid + +#### Known Bugs +* By default, the version of Apache that ships with Ubuntu 10.04 does not work with `wsgi_import_script`. +* SLES is unsupported. + +--- + +## Supported Release [0.11.0] +### Summary: + +This release adds preliminary support for Windows compatibility and multiple rewrite support. + +#### Backwards-incompatible Changes: + +- The rewrite_rule parameter is deprecated in favor of the new rewrite parameter + and will be removed in a future release. + +#### Features: + +- add Match directive +- quote paths for windows compatibility +- add auth_group_file option to README.md +- allow AuthGroupFile directive for vhosts +- Support Header directives in vhost context +- Don't purge mods-available dir when separate enable dir is used +- Fix the servername used in log file name +- Added support for mod_include +- Remove index parameters. +- Support environment variable control for CustomLog +- added redirectmatch support +- Setting up the ability to do multiple rewrites and conditions. +- Convert spec tests to beaker. +- Support php_admin_(flag|value)s + +#### Bugfixes: + +- directories are either a Hash or an Array of Hashes +- Configure Passenger in separate .conf file on RH so PassengerRoot isn't lost +- (docs) Update list of `apache::mod::[name]` classes +- (docs) Fix apache::namevirtualhost example call style +- Fix $ports_file reference in apache::listen. +- Fix $ports_file reference in Namevirtualhost. + + +## Supported Release [0.10.0] +### Summary: + +This release adds FreeBSD osfamily support and various other improvements to some mods. + +#### Features: + +- Add suPHP_UserGroup directive to directory context +- Add support for ScriptAliasMatch directives +- Set SSLOptions StdEnvVars in server context +- No implicit entry for ScriptAlias path +- Add support for overriding ErrorDocument +- Add support for AliasMatch directives +- Disable default "allow from all" in vhost-directories +- Add WSGIPythonPath as an optional parameter to mod_wsgi. +- Add mod_rpaf support +- Add directives: IndexOptions, IndexOrderDefault +- Add ability to include additional external configurations in vhost +- need to use the provider variable not the provider key value from the directory hash for matches +- Support for FreeBSD and few other features +- Add new params to apache::mod::mime class +- Allow apache::mod to specify module id and path +- added $server_root parameter +- Add Allow and ExtendedStatus support to mod_status +- Expand vhost/_directories.pp directive support +- Add initial support for nss module (no directives in vhost template yet) +- added peruser and event mpms +- added $service_name parameter +- add parameter for TraceEnable +- Make LogLevel configurable for server and vhost +- Add documentation about $ip +- Add ability to pass ip (instead of wildcard) in default vhost files + +#### Bugfixes: + +- Don't listen on port or set NameVirtualHost for non-existent vhost +- only apply Directory defaults when provider is a directory +- Working mod_authnz_ldap support on Debian/Ubuntu + +## Supported Release [0.9.0] +### Summary: +This release adds more parameters to the base apache class and apache defined +resource to make the module more flexible. It also adds or enhances SuPHP, +WSGI, and Passenger mod support, and support for the ITK mpm module. + +#### Backwards-incompatible Changes: +- Remove many default mods that are not normally needed. +- Remove `rewrite_base` `apache::vhost` parameter; did not work anyway. +- Specify dependencies on stdlib >=2.4.0 (this was already the case, but +making explicit) +- Deprecate `a2mod` in favor of the `apache::mod::*` classes and `apache::mod` +defined resource. + +#### Features: +- `apache` class + - Add `httpd_dir` parameter to change the location of the configuration + files. + - Add `logroot` parameter to change the logroot + - Add `ports_file` parameter to changes the `ports.conf` file location + - Add `keepalive` parameter to enable persistent connections + - Add `keepalive_timeout` parameter to change the timeout + - Update `default_mods` to be able to take an array of mods to enable. +- `apache::vhost` + - Add `wsgi_daemon_process`, `wsgi_daemon_process_options`, + `wsgi_process_group`, and `wsgi_script_aliases` parameters for per-vhost + WSGI configuration. + - Add `access_log_syslog` parameter to enable syslogging. + - Add `error_log_syslog` parameter to enable syslogging of errors. + - Add `directories` hash parameter. Please see README for documentation. + - Add `sslproxyengine` parameter to enable SSLProxyEngine + - Add `suphp_addhandler`, `suphp_engine`, and `suphp_configpath` for + configuring SuPHP. + - Add `custom_fragment` parameter to allow for arbitrary apache + configuration injection. (Feature pull requests are prefered over using + this, but it is available in a pinch.) +- Add `apache::mod::suphp` class for configuring SuPHP. +- Add `apache::mod::itk` class for configuring ITK mpm module. +- Update `apache::mod::wsgi` class for global WSGI configuration with +`wsgi_socket_prefix` and `wsgi_python_home` parameters. +- Add README.passenger.md to document the `apache::mod::passenger` usage. +Added `passenger_high_performance`, `passenger_pool_idle_time`, +`passenger_max_requests`, `passenger_stat_throttle_rate`, `rack_autodetect`, +and `rails_autodetect` parameters. +- Separate the httpd service resource into a new `apache::service` class for +dependency chaining of `Class['apache'] -> ~> +Class['apache::service']` +- Added `apache::mod::proxy_balancer` class for `apache::balancer` + +#### Bugfixes: +- Change dependency to puppetlabs-concat +- Fix ruby 1.9 bug for `a2mod` +- Change servername to be `$::hostname` if there is no `$::fqdn` +- Make `/etc/ssl/certs` the default ssl certs directory for RedHat non-5. +- Make `php` the default php package for RedHat non-5. +- Made `aliases` able to take a single alias hash instead of requiring an +array. + +## Supported Release [0.8.1] +#### Bugfixes: +- Update `apache::mpm_module` detection for worker/prefork +- Update `apache::mod::cgi` and `apache::mod::cgid` detection for +worker/prefork + +## Supported Release [0.8.0] +#### Features: +- Add `servername` parameter to `apache` class +- Add `proxy_set` parameter to `apache::balancer` define + +#### Bugfixes: +- Fix ordering for multiple `apache::balancer` clusters +- Fix symlinking for sites-available on Debian-based OSs +- Fix dependency ordering for recursive confdir management +- Fix `apache::mod::*` to notify the service on config change +- Documentation updates + +## Supported Release [0.7.0] +#### Changes: +- Essentially rewrite the module -- too many to list +- `apache::vhost` has many abilities -- see README.md for details +- `apache::mod::*` classes provide httpd mod-loading capabilities +- `apache` base class is much more configurable + +#### Bugfixes: +- Many. And many more to come + +## Supported Release [0.6.0] +- update travis tests (add more supported versions) +- add access log_parameter +- make purging of vhost dir configurable + +## Supported Release [0.4.0] +#### Changes: +- `include apache` is now required when using `apache::mod::*` + +#### Bugfixes: +- Fix syntax for validate_re +- Fix formatting in vhost template +- Fix spec tests such that they pass + +## Supported Release [0.0.4] +* e62e362 Fix broken tests for ssl, vhost, vhost::* +* 42c6363 Changes to match style guide and pass puppet-lint without error +* 42bc8ba changed name => path for file resources in order to name namevar by it's name +* 72e13de One end too much +* 0739641 style guide fixes: 'true' <> true, $operatingsystem needs to be $::operatingsystem, etc. +* 273f94d fix tests +* a35ede5 (#13860) Make a2enmod/a2dismo commands optional +* 98d774e (#13860) Autorequire Package['httpd'] +* 05fcec5 (#13073) Add missing puppet spec tests +* 541afda (#6899) Remove virtual a2mod definition +* 976cb69 (#13072) Move mod python and wsgi package names to params +* 323915a (#13060) Add .gitignore to repo +* fdf40af (#13060) Remove pkg directory from source tree +* fd90015 Add LICENSE file and update the ModuleFile +* d3d0d23 Re-enable local php class +* d7516c7 Make management of firewalls configurable for vhosts +* 60f83ba Explicitly lookup scope of apache_name in templates. +* f4d287f (#12581) Add explicit ordering for vdir directory +* 88a2ac6 (#11706) puppetlabs-apache depends on puppetlabs-firewall +* a776a8b (#11071) Fix to work with latest firewall module +* 2b79e8b (#11070) Add support for Scientific Linux +* 405b3e9 Fix for a2mod +* 57b9048 Commit apache::vhost::redirect Manifest +* 8862d01 Commit apache::vhost::proxy Manifest +* d5c1fd0 Commit apache::mod::wsgi Manifest +* a825ac7 Commit apache::mod::python Manifest +* b77062f Commit Templates +* 9a51b4a Vhost File Declarations +* 6cf7312 Defaults for Parameters +* 6a5b11a Ensure installed +* f672e46 a2mod fix +* 8a56ee9 add pthon support to apache + +[3.2.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/3.1.0...3.2.0 +[3.1.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/3.0.0...3.1.0 +[3.0.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/2.3.1...3.0.0 +[2.3.1]:https://github.com/puppetlabs/puppetlabs-apache/compare/2.3.0...2.3.1 +[2.3.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/2.2.0...2.3.0 +[2.2.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/2.1.0...2.2.0 +[2.1.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/2.0.0...2.1.0 +[2.0.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.11.0...2.0.0 +[1.11.1]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.11.0...1.11.1 +[1.11.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.10.0...1.11.0 +[1.10.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.9.0...1.10.0 +[1.9.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.8.1...1.9.0 +[1.8.1]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.8.0...1.8.1 +[1.8.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.7.1...1.8.0 +[1.7.1]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.7.0...1.7.1 +[1.7.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.6.0...1.7.0 +[1.6.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.5.0...1.6.0 +[1.5.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.4.1...1.5.0 +[1.4.1]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.4.0...1.4.1 +[1.4.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.3.0...1.4.0 +[1.3.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.2.0...1.3.0 +[1.2.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.1.1...1.2.0 +[1.1.1]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.1.0...1.1.1 +[1.1.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.0.1...1.1.0 +[1.0.1]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.0.0...1.0.1 +[1.0.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/0.11.0...1.0.0 +[0.11.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.10.0...0.11.0 +[0.10.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.9.0...0.10.0 +[0.9.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/1.8.1...0.9.0 +[0.8.1]:https://github.com/puppetlabs/puppetlabs-apache/compare/0.8.0...0.8.1 +[0.8.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/0.7.0...0.8.0 +[0.7.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/0.6.0...0.7.0 +[0.6.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/0.5.0-rc1...0.6.0 +[0.5.0-rc1]:https://github.com/puppetlabs/puppetlabs-apache/compare/0.4.0...0.5.0-rc1 +[0.4.0]:https://github.com/puppetlabs/puppetlabs-apache/compare/0.3.0...0.4.0 +[0.0.4]:https://github.com/puppetlabs/puppetlabs-apache/commits/0.0.4 + + +\* *This Changelog was automatically generated by [github_changelog_generator](https://github.com/github-changelog-generator/github-changelog-generator)* diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/CODEOWNERS b/modules/services/unix/http/apache_kali_compatible/apache/CODEOWNERS similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/CODEOWNERS rename to modules/services/unix/http/apache_kali_compatible/apache/CODEOWNERS diff --git a/modules/services/unix/http/apache_kali_compatible/apache/CONTRIBUTING.md b/modules/services/unix/http/apache_kali_compatible/apache/CONTRIBUTING.md new file mode 100644 index 000000000..e7a3a7c3f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/CONTRIBUTING.md @@ -0,0 +1,3 @@ +# Contributing to Puppet modules + +Check out our [Contributing to Supported Modules Blog Post](https://puppetlabs.github.io/iac/docs/contributing_to_a_module.html) to find all the information that you will need. diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/HISTORY.md b/modules/services/unix/http/apache_kali_compatible/apache/HISTORY.md similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/HISTORY.md rename to modules/services/unix/http/apache_kali_compatible/apache/HISTORY.md diff --git a/modules/services/unix/http/apache_kali_compatible/apache/LICENSE b/modules/services/unix/http/apache_kali_compatible/apache/LICENSE new file mode 100644 index 000000000..d64569567 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/LICENSE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/modules/services/unix/http/apache_kali_compatible/apache/NOTICE b/modules/services/unix/http/apache_kali_compatible/apache/NOTICE new file mode 100644 index 000000000..0bd06041e --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/NOTICE @@ -0,0 +1,15 @@ +Puppet Module - puppetlabs-apache + +Copyright 2018 Puppet, Inc. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. \ No newline at end of file diff --git a/modules/services/unix/http/apache_kali_compatible/apache/README.md b/modules/services/unix/http/apache_kali_compatible/apache/README.md new file mode 100755 index 000000000..481cda31b --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/README.md @@ -0,0 +1,1008 @@ +# apache + +[Module description]: #module-description + +[Setup]: #setup +[Beginning with Apache]: #beginning-with-apache + +[Usage]: #usage +[Configuring virtual hosts]: #configuring-virtual-hosts +[Configuring virtual hosts with SSL]: #configuring-virtual-hosts-with-ssl +[Configuring virtual host port and address bindings]: #configuring-virtual-host-port-and-address-bindings +[Configuring virtual hosts for apps and processors]: #configuring-virtual-hosts-for-apps-and-processors +[Configuring IP-based virtual hosts]: #configuring-ip-based-virtual-hosts +[Installing Apache modules]: #installing-apache-modules +[Installing arbitrary modules]: #installing-arbitrary-modules +[Installing specific modules]: #installing-specific-modules +[Configuring FastCGI servers]: #configuring-fastcgi-servers-to-handle-php-files +[Load balancing examples]: #load-balancing-examples +[apache affects]: #what-the-apache-module-affects + +[Reference]: #reference + +[Limitations]: #limitations + +[Development]: #development +[Contributing]: #contributing + +[`AddDefaultCharset`]: https://httpd.apache.org/docs/current/mod/core.html#adddefaultcharset +[`add_listen`]: #add_listen +[`Alias`]: https://httpd.apache.org/docs/current/mod/mod_alias.html#alias +[`AliasMatch`]: https://httpd.apache.org/docs/current/mod/mod_alias.html#aliasmatch +[aliased servers]: https://httpd.apache.org/docs/current/urlmapping.html +[`AllowEncodedSlashes`]: https://httpd.apache.org/docs/current/mod/core.html#allowencodedslashes +[`apache`]: #class-apache +[`apache_version`]: #apache_version +[`apache::balancer`]: #defined-type-apachebalancer +[`apache::balancermember`]: #defined-type-apachebalancermember +[`apache::fastcgi::server`]: #defined-type-apachefastcgiserver +[`apache::mod`]: #defined-type-apachemod +[`apache::mod::`]: #classes-apachemodmodule-name +[`apache::mod::alias`]: #class-apachemodalias +[`apache::mod::auth_cas`]: #class-apachemodauth_cas +[`apache::mod::auth_mellon`]: #class-apachemodauth_mellon +[`apache::mod::authn_dbd`]: #class-apachemodauthn_dbd +[`apache::mod::authnz_ldap`]: #class-apachemodauthnz_ldap +[`apache::mod::cluster`]: #class-apachemodcluster +[`apache::mod::data]: #class-apachemoddata +[`apache::mod::disk_cache`]: #class-apachemoddisk_cache +[`apache::mod::dumpio`]: #class-apachemoddumpio +[`apache::mod::event`]: #class-apachemodevent +[`apache::mod::ext_filter`]: #class-apachemodext_filter +[`apache::mod::geoip`]: #class-apachemodgeoip +[`apache::mod::http2`]: #class-apachemodhttp2 +[`apache::mod::itk`]: #class-apachemoditk +[`apache::mod::jk`]: #class-apachemodjk +[`apache::mod::ldap`]: #class-apachemodldap +[`apache::mod::passenger`]: #class-apachemodpassenger +[`apache::mod::peruser`]: #class-apachemodperuser +[`apache::mod::prefork`]: #class-apachemodprefork +[`apache::mod::proxy`]: #class-apachemodproxy +[`apache::mod::proxy_balancer`]: #class-apachemodproxybalancer +[`apache::mod::proxy_fcgi`]: #class-apachemodproxy_fcgi +[`apache::mod::proxy_html`]: #class-apachemodproxy_html +[`apache::mod::python`]: #class-apachemodpython +[`apache::mod::security`]: #class-apachemodsecurity +[`apache::mod::shib`]: #class-apachemodshib +[`apache::mod::ssl`]: #class-apachemodssl +[`apache::mod::status`]: #class-apachemodstatus +[`apache::mod::userdir`]: #class-apachemoduserdir +[`apache::mod::worker`]: #class-apachemodworker +[`apache::mod::wsgi`]: #class-apachemodwsgi +[`apache::params`]: #class-apacheparams +[`apache::version`]: #class-apacheversion +[`apache::vhost`]: #defined-type-apachevhost +[`apache::vhost::custom`]: #defined-type-apachevhostcustom +[`apache::vhost::WSGIImportScript`]: #wsgiimportscript +[Apache HTTP Server]: https://httpd.apache.org +[Apache modules]: https://httpd.apache.org/docs/current/mod/ +[array]: https://docs.puppet.com/puppet/latest/reference/lang_data_array.html + +[audit log]: https://github.com/SpiderLabs/ModSecurity/wiki/ModSecurity-2-Data-Formats#audit-log + +[beaker-rspec]: https://github.com/puppetlabs/beaker-rspec + +[certificate revocation list]: https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcarevocationfile +[certificate revocation list path]: https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcarevocationpath +[common gateway interface]: https://httpd.apache.org/docs/current/howto/cgi.html +[`confd_dir`]: #confd_dir +[`content`]: #content +[CONTRIBUTING.md]: CONTRIBUTING.md +[custom error documents]: https://httpd.apache.org/docs/current/custom-error.html +[`custom_fragment`]: #custom_fragment + +[`default_mods`]: #default_mods +[`default_ssl_crl`]: #default_ssl_crl +[`default_ssl_crl_path`]: #default_ssl_crl_path +[`default_ssl_vhost`]: #default_ssl_vhost +[`dev_packages`]: #dev_packages +[`directory`]: #directory +[`directories`]: #parameter-directories-for-apachevhost +[`DirectoryIndex`]: https://httpd.apache.org/docs/current/mod/mod_dir.html#directoryindex +[`docroot`]: #docroot +[`docroot_owner`]: #docroot_owner +[`docroot_group`]: #docroot_group +[`DocumentRoot`]: https://httpd.apache.org/docs/current/mod/core.html#documentroot + +[`EnableSendfile`]: https://httpd.apache.org/docs/current/mod/core.html#enablesendfile +[enforcing mode]: http://selinuxproject.org/page/Guide/Mode +[`ensure`]: https://docs.puppet.com/latest/type.html#package-attribute-ensure +[`error_log_file`]: #error_log_file +[`error_log_syslog`]: #error_log_syslog +[`error_log_pipe`]: #error_log_pipe +[`ExpiresByType`]: https://httpd.apache.org/docs/current/mod/mod_expires.html#expiresbytype +[exported resources]: http://docs.puppet.com/latest/reference/lang_exported.md +[`ExtendedStatus`]: https://httpd.apache.org/docs/current/mod/core.html#extendedstatus + +[Facter]: http://docs.puppet.com/facter/ +[FastCGI]: http://www.fastcgi.com/ +[FallbackResource]: https://httpd.apache.org/docs/current/mod/mod_dir.html#fallbackresource +[`fallbackresource`]: #fallbackresource +[`FileETag`]: https://httpd.apache.org/docs/current/mod/core.html#fileetag +[filter rules]: https://httpd.apache.org/docs/current/filter.html +[`filters`]: #filters +[`ForceType`]: https://httpd.apache.org/docs/current/mod/core.html#forcetype + +[GeoIPScanProxyHeaders]: http://dev.maxmind.com/geoip/legacy/mod_geoip2/#Proxy-Related_Directives +[`gentoo/puppet-portage`]: https://github.com/gentoo/puppet-portage + +[Hash]: https://docs.puppet.com/puppet/latest/reference/lang_data_hash.html +[`HttpProtocolOptions`]: http://httpd.apache.org/docs/current/mod/core.html#httpprotocoloptions + +[IAC Team]: https://puppetlabs.github.io/iac/ +[`IncludeOptional`]: https://httpd.apache.org/docs/current/mod/core.html#includeoptional +[`Include`]: https://httpd.apache.org/docs/current/mod/core.html#include +[interval syntax]: https://httpd.apache.org/docs/current/mod/mod_expires.html#AltSyn +[`ip`]: #ip +[`ip_based`]: #ip_based +[IP-based virtual hosts]: https://httpd.apache.org/docs/current/vhosts/ip-based.html + +[`KeepAlive`]: https://httpd.apache.org/docs/current/mod/core.html#keepalive +[`KeepAliveTimeout`]: https://httpd.apache.org/docs/current/mod/core.html#keepalivetimeout +[`keepalive` parameter]: #keepalive +[`keepalive_timeout`]: #keepalive_timeout +[`limitreqfieldsize`]: https://httpd.apache.org/docs/current/mod/core.html#limitrequestfieldsize +[`limitreqfields`]: http://httpd.apache.org/docs/current/mod/core.html#limitrequestfields + +[`lib`]: #lib +[`lib_path`]: #lib_path +[`Listen`]: https://httpd.apache.org/docs/current/bind.html +[`ListenBackLog`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#listenbacklog +[`LoadFile`]: https://httpd.apache.org/docs/current/mod/mod_so.html#loadfile +[`LogFormat`]: https://httpd.apache.org/docs/current/mod/mod_log_config.html#logformat +[`logroot`]: #logroot +[Log security]: https://httpd.apache.org/docs/current/logs.html#security + +[`manage_docroot`]: #manage_docroot +[`manage_user`]: #manage_user +[`manage_group`]: #manage_group +[`supplementary_groups`]: #supplementary_groups +[`MaxConnectionsPerChild`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#maxconnectionsperchild +[`max_keepalive_requests`]: #max_keepalive_requests +[`MaxRequestWorkers`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#maxrequestworkers +[`MaxSpareThreads`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#maxsparethreads +[MIME `content-type`]: https://www.iana.org/assignments/media-types/media-types.xhtml +[`MinSpareThreads`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#minsparethreads +[`mod_alias`]: https://httpd.apache.org/docs/current/mod/mod_alias.html +[`mod_auth_cas`]: https://github.com/Jasig/mod_auth_cas +[`mod_auth_kerb`]: http://modauthkerb.sourceforge.net/configure.html +[`mod_auth_gssapi`]: https://github.com/modauthgssapi/mod_auth_gssapi +[`mod_authnz_external`]: https://github.com/phokz/mod-auth-external +[`mod_auth_dbd`]: http://httpd.apache.org/docs/current/mod/mod_authn_dbd.html +[`mod_auth_mellon`]: https://github.com/UNINETT/mod_auth_mellon +[`mod_dbd`]: http://httpd.apache.org/docs/current/mod/mod_dbd.html +[`mod_disk_cache`]: https://httpd.apache.org/docs/2.2/mod/mod_disk_cache.html +[`mod_dumpio`]: https://httpd.apache.org/docs/2.4/mod/mod_dumpio.html +[`mod_env`]: http://httpd.apache.org/docs/current/mod/mod_env.html +[`mod_expires`]: https://httpd.apache.org/docs/current/mod/mod_expires.html +[`mod_ext_filter`]: https://httpd.apache.org/docs/current/mod/mod_ext_filter.html +[`mod_fcgid`]: https://httpd.apache.org/mod_fcgid/mod/mod_fcgid.html +[`mod_geoip`]: http://dev.maxmind.com/geoip/legacy/mod_geoip2/ +[`mod_http2`]: https://httpd.apache.org/docs/current/mod/mod_http2.html +[`mod_info`]: https://httpd.apache.org/docs/current/mod/mod_info.html +[`mod_ldap`]: https://httpd.apache.org/docs/2.2/mod/mod_ldap.html +[`mod_mpm_event`]: https://httpd.apache.org/docs/current/mod/event.html +[`mod_negotiation`]: https://httpd.apache.org/docs/current/mod/mod_negotiation.html +[`mod_pagespeed`]: https://developers.google.com/speed/pagespeed/module/?hl=en +[`mod_passenger`]: https://www.phusionpassenger.com/library/config/apache/reference/ +[`mod_php`]: http://php.net/manual/en/book.apache.php +[`mod_proxy`]: https://httpd.apache.org/docs/current/mod/mod_proxy.html +[`mod_proxy_balancer`]: https://httpd.apache.org/docs/current/mod/mod_proxy_balancer.html +[`mod_reqtimeout`]: https://httpd.apache.org/docs/current/mod/mod_reqtimeout.html +[`mod_python`]: http://modpython.org/ +[`mod_rewrite`]: https://httpd.apache.org/docs/current/mod/mod_rewrite.html +[`mod_security`]: https://www.modsecurity.org/ +[`mod_ssl`]: https://httpd.apache.org/docs/current/mod/mod_ssl.html +[`mod_status`]: https://httpd.apache.org/docs/current/mod/mod_status.html +[`mod_version`]: https://httpd.apache.org/docs/current/mod/mod_version.html +[`mod_wsgi`]: https://modwsgi.readthedocs.org/en/latest/ +[module contribution guide]: https://docs.puppet.com/forge/contributing.html +[`mpm_module`]: #mpm_module +[multi-processing module]: https://httpd.apache.org/docs/current/mpm.html + +[name-based virtual hosts]: https://httpd.apache.org/docs/current/vhosts/name-based.html +[`no_proxy_uris`]: #no_proxy_uris + +[open source Puppet]: https://docs.puppet.com/puppet/ +[`Options`]: https://httpd.apache.org/docs/current/mod/core.html#options + +[`path`]: #path +[`Peruser`]: https://www.freebsd.org/cgi/url.cgi?ports/www/apache22-peruser-mpm/pkg-descr +[`port`]: #port +[`priority`]: #defined-types-apachevhost +[`proxy_dest`]: #proxy_dest +[`proxy_dest_match`]: #proxy_dest_match +[`proxy_pass`]: #proxy_pass +[`ProxyPass`]: https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxypass +[`ProxySet`]: https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxyset +[Puppet Enterprise]: https://docs.puppet.com/pe/ +[Puppet Forge]: https://forge.puppet.com +[Puppet]: https://puppet.com +[Puppet module]: https://docs.puppet.com/puppet/latest/reference/modules_fundamentals.html +[Puppet module's code]: https://github.com/puppetlabs/puppetlabs-apache/blob/main/manifests/default_mods.pp +[`purge_configs`]: #purge_configs +[`purge_vhost_dir`]: #purge_vhost_dir +[Python]: https://www.python.org/ + +[Rack]: http://rack.github.io/ +[`rack_base_uris`]: #rack_base_uris +[RFC 2616]: https://www.ietf.org/rfc/rfc2616.txt +[`RequestReadTimeout`]: https://httpd.apache.org/docs/current/mod/mod_reqtimeout.html#requestreadtimeout +[rspec-puppet]: http://rspec-puppet.com/ + +[`ScriptAlias`]: https://httpd.apache.org/docs/current/mod/mod_alias.html#scriptalias +[`ScriptAliasMatch`]: https://httpd.apache.org/docs/current/mod/mod_alias.html#scriptaliasmatch +[`scriptalias`]: #scriptalias +[SELinux]: http://selinuxproject.org/ +[`ServerAdmin`]: https://httpd.apache.org/docs/current/mod/core.html#serveradmin +[`serveraliases`]: #serveraliases +[`ServerLimit`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#serverlimit +[`ServerName`]: https://httpd.apache.org/docs/current/mod/core.html#servername +[`ServerRoot`]: https://httpd.apache.org/docs/current/mod/core.html#serverroot +[`ServerTokens`]: https://httpd.apache.org/docs/current/mod/core.html#servertokens +[`ServerSignature`]: https://httpd.apache.org/docs/current/mod/core.html#serversignature +[Service attribute restart]: http://docs.puppet.com/latest/type.html#service-attribute-restart +[`source`]: #source +[`SSLCARevocationCheck`]: https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcarevocationcheck +[SSL certificate key file]: https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcertificatekeyfile +[SSL chain]: https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcertificatechainfile +[SSL encryption]: https://httpd.apache.org/docs/current/ssl/index.html +[`ssl`]: #ssl +[`ssl_cert`]: #ssl_cert +[`ssl_compression`]: #ssl_compression +[`ssl_key`]: #ssl_key +[`StartServers`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#startservers +[suPHP]: http://www.suphp.org/Home.html +[`suphp_addhandler`]: #suphp_addhandler +[`suphp_configpath`]: #suphp_configpath +[`suphp_engine`]: #suphp_engine +[supported operating system]: https://forge.puppet.com/supported#puppet-supported-modules-compatibility-matrix + +[`ThreadLimit`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#threadlimit +[`ThreadsPerChild`]: https://httpd.apache.org/docs/current/mod/mpm_common.html#threadsperchild +[`TimeOut`]: https://httpd.apache.org/docs/current/mod/core.html#timeout +[template]: http://docs.puppet.com/puppet/latest/reference/lang_template.html +[`TraceEnable`]: https://httpd.apache.org/docs/current/mod/core.html#traceenable + +[`UseCanonicalName`]: https://httpd.apache.org/docs/current/mod/core.html#usecanonicalname + +[`verify_config`]: #verify_config +[`vhost`]: #defined-type-apachevhost +[`vhost_dir`]: #vhost_dir +[`virtual_docroot`]: #virtual_docroot + +[Web Server Gateway Interface]: https://www.python.org/dev/peps/pep-3333/#abstract +[`WSGIRestrictEmbedded`]: http://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIRestrictEmbedded.html +[`WSGIPythonPath`]: http://modwsgi.readthedocs.org/en/develop/configuration-directives/WSGIPythonPath.html +[`WSGIPythonHome`]: http://modwsgi.readthedocs.org/en/develop/configuration-directives/WSGIPythonHome.html +[`WSGIApplicationGroup`]: https://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIApplicationGroup.html +[`WSGIPythonOptimize`]: https://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIPythonOptimize.html + +#### Table of Contents + +1. [Module description - What is the apache module, and what does it do?][Module description] +2. [Setup - The basics of getting started with apache][Setup] + - [What the apache module affects][apache affects] + - [Beginning with Apache - Installation][Beginning with Apache] +3. [Usage - The classes and defined types available for configuration][Usage] + - [Configuring virtual hosts - Examples to help get started][Configuring virtual hosts] + - [Configuring FastCGI servers to handle PHP files][Configuring FastCGI servers] + - [Load balancing with exported and non-exported resources][Load balancing examples] +4. [Reference - An under-the-hood peek at what the module is doing and how][Reference] +5. [Limitations - OS compatibility, etc.][Limitations] +6. [Development - Guide for contributing to the module][Development] + - [Contributing to the apache module][Contributing] + + +## Module description + +[Apache HTTP Server][] (also called Apache HTTPD, or simply Apache) is a widely used web server. This [Puppet module][] simplifies the task of creating configurations to manage Apache servers in your infrastructure. It can configure and manage a range of virtual host setups and provides a streamlined way to install and configure [Apache modules][]. + + +## Setup + + +### What the apache module affects: + +- Configuration files and directories (created and written to) + - **WARNING**: Configurations *not* managed by Puppet will be purged. +- Package/service/configuration files for Apache +- Apache modules +- Virtual hosts +- Listened-to ports +- `/etc/make.conf` on FreeBSD and Gentoo + +On Gentoo, this module depends on the [`gentoo/puppet-portage`][] Puppet module. Note that while several options apply or enable certain features and settings for Gentoo, it is not a [supported operating system][] for this module. + +> **Warning**: This module modifies Apache configuration files and directories and purges any configuration not managed by Puppet. Apache configuration should be managed by Puppet, as unmanaged configuration files can cause unexpected failures. +> +>To temporarily disable full Puppet management, set the [`purge_configs`][] parameter in the [`apache`][] class declaration to false. We recommend this only as a temporary means of saving and relocating customized configurations. + + +### Beginning with Apache + +To have Puppet install Apache with the default parameters, declare the [`apache`][] class: + +``` puppet +class { 'apache': } +``` + +When you declare this class with the default options, the module: + +- Installs the appropriate Apache software package and [required Apache modules](#default_mods) for your operating system. +- Places the required configuration files in a directory, with the [default location](#conf_dir) Depends on operating system. +- Configures the server with a default virtual host and standard port ('80') and address ('\*') bindings. +- Creates a document root directory Depends on operating system, typically `/var/www`. +- Starts the Apache service. + +Apache defaults depend on your operating system. These defaults work in testing environments but are not suggested for production. We recommend customizing the class's parameters to suit your site. + +For instance, this declaration installs Apache without the apache module's [default virtual host configuration][Configuring virtual hosts], allowing you to customize all Apache virtual hosts: + +``` puppet +class { 'apache': + default_vhost => false, +} +``` + +> **Note**: When `default_vhost` is set to `false`, you have to add at least one `apache::vhost` resource or Apache will not start. To establish a default virtual host, either set the `default_vhost` in the `apache` class or use the [`apache::vhost`][] defined type. You can also configure additional specific virtual hosts with the [`apache::vhost`][] defined type. + + +## Usage + + +### Configuring virtual hosts + +The default [`apache`][] class sets up a virtual host on port 80, listening on all interfaces and serving the [`docroot`][] parameter's default directory of `/var/www`. + + +To configure basic [name-based virtual hosts][], specify the [`port`][] and [`docroot`][] parameters in the [`apache::vhost`][] defined type: + +``` puppet +apache::vhost { 'vhost.example.com': + port => '80', + docroot => '/var/www/vhost', +} +``` + +See the [`apache::vhost`][] defined type's reference for a list of all virtual host parameters. + +> **Note**: Apache processes virtual hosts in alphabetical order, and server administrators can prioritize Apache's virtual host processing by prefixing a virtual host's configuration file name with a number. The [`apache::vhost`][] defined type applies a default [`priority`][] of 25, which Puppet interprets by prefixing the virtual host's file name with `25-`. This means that if multiple sites have the same priority, or if you disable priority numbers by setting the `priority` parameter's value to false, Apache still processes virtual hosts in alphabetical order. + +To configure user and group ownership for `docroot`, use the [`docroot_owner`][] and [`docroot_group`][] parameters: + +``` puppet +apache::vhost { 'user.example.com': + port => '80', + docroot => '/var/www/user', + docroot_owner => 'www-data', + docroot_group => 'www-data', +} +``` + +#### Configuring virtual hosts with SSL + +To configure a virtual host to use [SSL encryption][] and default SSL certificates, set the [`ssl`][] parameter. You must also specify the [`port`][] parameter, typically with a value of '443', to accommodate HTTPS requests: + +``` puppet +apache::vhost { 'ssl.example.com': + port => '443', + docroot => '/var/www/ssl', + ssl => true, +} +``` + +To configure a virtual host to use SSL and specific SSL certificates, use the paths to the certificate and key in the [`ssl_cert`][] and [`ssl_key`][] parameters, respectively: + +``` puppet +apache::vhost { 'cert.example.com': + port => '443', + docroot => '/var/www/cert', + ssl => true, + ssl_cert => '/etc/ssl/fourth.example.com.cert', + ssl_key => '/etc/ssl/fourth.example.com.key', +} +``` + +To configure a mix of SSL and unencrypted virtual hosts at the same domain, declare them with separate [`apache::vhost`][] defined types: + +``` puppet +# The non-ssl virtual host +apache::vhost { 'mix.example.com non-ssl': + servername => 'mix.example.com', + port => '80', + docroot => '/var/www/mix', +} + +# The SSL virtual host at the same domain +apache::vhost { 'mix.example.com ssl': + servername => 'mix.example.com', + port => '443', + docroot => '/var/www/mix', + ssl => true, +} +``` + +To configure a virtual host to redirect unencrypted connections to SSL, declare them with separate [`apache::vhost`][] defined types and redirect unencrypted requests to the virtual host with SSL enabled: + +``` puppet +apache::vhost { 'redirect.example.com non-ssl': + servername => 'redirect.example.com', + port => '80', + docroot => '/var/www/redirect', + redirect_status => 'permanent', + redirect_dest => 'https://redirect.example.com/' +} + +apache::vhost { 'redirect.example.com ssl': + servername => 'redirect.example.com', + port => '443', + docroot => '/var/www/redirect', + ssl => true, +} +``` + +#### Configuring virtual host port and address bindings + +Virtual hosts listen on all IP addresses ('\*') by default. To configure the virtual host to listen on a specific IP address, use the [`ip`][] parameter: + +``` puppet +apache::vhost { 'ip.example.com': + ip => '127.0.0.1', + port => '80', + docroot => '/var/www/ip', +} +``` + +You can also configure more than one IP address per virtual host by using an array of IP addresses for the [`ip`][] parameter: + +``` puppet +apache::vhost { 'ip.example.com': + ip => ['127.0.0.1','169.254.1.1'], + port => '80', + docroot => '/var/www/ip', +} +``` + +You can configure multiple ports per virtual host by using an array of ports for the [`port`][] parameter: + +``` puppet +apache::vhost { 'ip.example.com': + ip => ['127.0.0.1'], + port => ['80','8080'] + docroot => '/var/www/ip', +} +``` + +To configure a virtual host with [aliased servers][], refer to the aliases using the [`serveraliases`][] parameter: + +``` puppet +apache::vhost { 'aliases.example.com': + serveraliases => [ + 'aliases.example.org', + 'aliases.example.net', + ], + port => '80', + docroot => '/var/www/aliases', +} +``` + +To set up a virtual host with a wildcard alias for the subdomain mapped to a directory of the same name, such as 'http://example.com.loc' mapped to `/var/www/example.com`, define the wildcard alias using the [`serveraliases`][] parameter and the document root with the [`virtual_docroot`][] parameter: + +``` puppet +apache::vhost { 'subdomain.loc': + vhost_name => '*', + port => '80', + virtual_docroot => '/var/www/%-2+', + docroot => '/var/www', + serveraliases => ['*.loc',], +} +``` + +To configure a virtual host with [filter rules][], pass the filter directives as an [array][] using the [`filters`][] parameter: + +``` puppet +apache::vhost { 'subdomain.loc': + port => '80', + filters => [ + 'FilterDeclare COMPRESS', + 'FilterProvider COMPRESS DEFLATE resp=Content-Type $text/html', + 'FilterChain COMPRESS', + 'FilterProtocol COMPRESS DEFLATE change=yes;byteranges=no', + ], + docroot => '/var/www/html', +} +``` + +#### Configuring virtual hosts for apps and processors + +To set up a virtual host with [suPHP][], use the following parameters: + +* [`suphp_engine`][], to enable the suPHP engine. +* [`suphp_addhandler`][], to define a MIME type. +* [`suphp_configpath`][], to set which path suPHP passes to the PHP interpreter. +* [`directory`][], to configure Directory, File, and Location directive blocks. + +For example: + +``` puppet +apache::vhost { 'suphp.example.com': + port => '80', + docroot => '/home/appuser/myphpapp', + suphp_addhandler => 'x-httpd-php', + suphp_engine => 'on', + suphp_configpath => '/etc/php5/apache2', + directories => [ + { 'path' => '/home/appuser/myphpapp', + 'suphp' => { + user => 'myappuser', + group => 'myappgroup', + }, + }, + ], +} +``` + +To configure a virtual host to use the [Web Server Gateway Interface][] (WSGI) for [Python][] applications, use the `wsgi` set of parameters: + +``` puppet +apache::vhost { 'wsgi.example.com': + port => '80', + docroot => '/var/www/pythonapp', + wsgi_application_group => '%{GLOBAL}', + wsgi_daemon_process => 'wsgi', + wsgi_daemon_process_options => { + processes => '2', + threads => '15', + display-name => '%{GROUP}', + }, + wsgi_import_script => '/var/www/demo.wsgi', + wsgi_import_script_options => { + process-group => 'wsgi', + application-group => '%{GLOBAL}', + }, + wsgi_process_group => 'wsgi', + wsgi_script_aliases => { '/' => '/var/www/demo.wsgi' }, +} +``` + +As of Apache 2.2.16, Apache supports [FallbackResource][], a simple replacement for common RewriteRules. You can set a FallbackResource using the [`fallbackresource`][] parameter: + +``` puppet +apache::vhost { 'wordpress.example.com': + port => '80', + docroot => '/var/www/wordpress', + fallbackresource => '/index.php', +} +``` + +> **Note**: The `fallbackresource` parameter only supports the 'disabled' value since Apache 2.2.24. + +To configure a virtual host with a designated directory for [Common Gateway Interface][] (CGI) files, use the [`scriptalias`][] parameter to define the `cgi-bin` path: + +``` puppet +apache::vhost { 'cgi.example.com': + port => '80', + docroot => '/var/www/cgi', + scriptalias => '/usr/lib/cgi-bin', +} +``` + +To configure a virtual host for [Rack][], use the [`rack_base_uris`][] parameter: + +``` puppet +apache::vhost { 'rack.example.com': + port => '80', + docroot => '/var/www/rack', + rack_base_uris => ['/rackapp1', '/rackapp2'], +} +``` + +#### Configuring IP-based virtual hosts + +You can configure [IP-based virtual hosts][] to listen on any port and have them respond to requests on specific IP addresses. In this example, the server listens on ports 80 and 81, because the example virtual hosts are _not_ declared with a [`port`][] parameter: + +``` puppet +apache::listen { '80': } + +apache::listen { '81': } +``` + +Configure the IP-based virtual hosts with the [`ip_based`][] parameter: + +``` puppet +apache::vhost { 'first.example.com': + ip => '10.0.0.10', + docroot => '/var/www/first', + ip_based => true, +} + +apache::vhost { 'second.example.com': + ip => '10.0.0.11', + docroot => '/var/www/second', + ip_based => true, +} +``` + +You can also configure a mix of IP- and [name-based virtual hosts][] in any combination of [SSL][SSL encryption] and unencrypted configurations. + +In this example, we add two IP-based virtual hosts on an IP address (in this example, 10.0.0.10). One uses SSL and the other is unencrypted: + +``` puppet +apache::vhost { 'The first IP-based virtual host, non-ssl': + servername => 'first.example.com', + ip => '10.0.0.10', + port => '80', + ip_based => true, + docroot => '/var/www/first', +} + +apache::vhost { 'The first IP-based vhost, ssl': + servername => 'first.example.com', + ip => '10.0.0.10', + port => '443', + ip_based => true, + docroot => '/var/www/first-ssl', + ssl => true, +} +``` + +Next, we add two name-based virtual hosts listening on a second IP address (10.0.0.20): + +``` puppet +apache::vhost { 'second.example.com': + ip => '10.0.0.20', + port => '80', + docroot => '/var/www/second', +} + +apache::vhost { 'third.example.com': + ip => '10.0.0.20', + port => '80', + docroot => '/var/www/third', +} +``` + +To add name-based virtual hosts that answer on either 10.0.0.10 or 10.0.0.20, you **must** disable the Apache default `Listen 80`, as it conflicts with the preceding IP-based virtual hosts. To do this, set the [`add_listen`][] parameter to `false`: + +``` puppet +apache::vhost { 'fourth.example.com': + port => '80', + docroot => '/var/www/fourth', + add_listen => false, +} + +apache::vhost { 'fifth.example.com': + port => '80', + docroot => '/var/www/fifth', + add_listen => false, +} +``` + +### Installing Apache modules + +There are two ways to install [Apache modules][] using the Puppet apache module: + +- Use the [`apache::mod::`][] classes to [install specific Apache modules with parameters][Installing specific modules]. +- Use the [`apache::mod`][] defined type to [install arbitrary Apache modules][Installing arbitrary modules]. + +#### Installing specific modules + +The Puppet apache module supports installing many common [Apache modules][], often with parameterized configuration options. For a list of supported Apache modules, see the [`apache::mod::`][] class references. + +For example, you can install the `mod_ssl` Apache module with default settings by declaring the [`apache::mod::ssl`][] class: + +``` puppet +class { 'apache::mod::ssl': } +``` + +[`apache::mod::ssl`][] has several parameterized options that you can set when declaring it. For instance, to enable `mod_ssl` with compression enabled, set the [`ssl_compression`][] parameter to true: + +``` puppet +class { 'apache::mod::ssl': + ssl_compression => true, +} +``` + +Note that some modules have prerequisites, which are documented in their references under [`apache::mod::`][]. + +#### Installing arbitrary modules + +You can pass the name of any module that your operating system's package manager can install to the [`apache::mod`][] defined type to install it. Unlike the specific-module classes, the [`apache::mod`][] defined type doesn't tailor the installation based on other installed modules or with specific parameters---Puppet only grabs and installs the module's package, leaving detailed configuration up to you. + +For example, to install the [`mod_authnz_external`][] Apache module, declare the defined type with the 'mod_authnz_external' name: + +``` puppet +apache::mod { 'mod_authnz_external': } +``` + +There are several optional parameters you can specify when defining Apache modules this way. See the [defined type's reference][`apache::mod`] for details. + + +### Configuring FastCGI servers to handle PHP files + +#### FastCGI on Ubuntu 18.04 + +On Ubuntu 18.04, `mod_fastcgi` is no longer supported. So considering: + +* an Apache Vhost with docroot set to `/var/www/html` +* a FastCGI server listening on `127.0.0.1:9000` + +you can then use the [`custom_fragment`][] parameter to configure the virtual host to have the FastCGI server handle the specified file type: + +``` puppet +apache::vhost { 'www': + ... + docroot => '/var/www/html/', + custom_fragment => 'ProxyPassMatch ^/(.*\.php)$ fcgi://127.0.0.1:9000/var/www/html/$1', + ... +} +``` + +Please note you have to adjust the second ProxyPassMatch parameter to you docroot value (here `/var/www/html/`). + +#### Other OSes + +Add the [`apache::fastcgi::server`][] defined type to allow [FastCGI][] servers to handle requests for specific files. For example, the following defines a FastCGI server at 127.0.0.1 (localhost) on port 9000 to handle PHP requests: + +``` puppet +apache::fastcgi::server { 'php': + host => '127.0.0.1:9000', + timeout => 15, + flush => false, + faux_path => '/var/www/php.fcgi', + fcgi_alias => '/php.fcgi', + file_type => 'application/x-httpd-php' +} +``` + +You can then use the [`custom_fragment`][] parameter to configure the virtual host to have the FastCGI server handle the specified file type: + +``` puppet +apache::vhost { 'www': + ... + custom_fragment => 'AddType application/x-httpd-php .php' + ... +} +``` + + +### Load balancing examples + +Apache supports load balancing across groups of servers through the [`mod_proxy`][] Apache module. Puppet supports configuring Apache load balancing groups (also known as balancer clusters) through the [`apache::balancer`][] and [`apache::balancermember`][] defined types. + +To enable load balancing with [exported resources][], export the [`apache::balancermember`][] defined type from the load balancer member server: + +``` puppet +@@apache::balancermember { "${::fqdn}-puppet00": + balancer_cluster => 'puppet00', + url => "ajp://${::fqdn}:8009", + options => ['ping=5', 'disablereuse=on', 'retry=5', 'ttl=120'], +} +``` + +Then, on the proxy server, create the load balancing group: + +``` puppet +apache::balancer { 'puppet00': } +``` + +To enable load balancing without exporting resources, declare the following on the proxy server: + +``` puppet +apache::balancer { 'puppet00': } + +apache::balancermember { "${::fqdn}-puppet00": + balancer_cluster => 'puppet00', + url => "ajp://${::fqdn}:8009", + options => ['ping=5', 'disablereuse=on', 'retry=5', 'ttl=120'], +} +``` + +Then declare the `apache::balancer` and `apache::balancermember` defined types on the proxy server. + +To use the [ProxySet](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxyset) directive on the balancer, use the [`proxy_set`](#proxy_set) parameter of `apache::balancer`: + +``` puppet +apache::balancer { 'puppet01': + proxy_set => { + 'stickysession' => 'JSESSIONID', + 'lbmethod' => 'bytraffic', + }, +} +``` + +Load balancing scheduler algorithms (`lbmethod`) are listed [in mod_proxy_balancer documentation](https://httpd.apache.org/docs/current/mod/mod_proxy_balancer.html). + + +## Reference + +For information on classes, types and functions see the [REFERENCE.md](https://github.com/puppetlabs/puppetlabs-apache/blob/main/REFERENCE.md) + +### Templates + +The Apache module relies heavily on templates to enable the [`apache::vhost`][] and [`apache::mod`][] defined types. These templates are built based on [Facter][] facts that are specific to your operating system. Unless explicitly called out, most templates are not meant for configuration. + +### Tasks + +The Apache module has a task that allows a user to reload the Apache config without restarting the service. Please refer to to the [PE documentation](https://puppet.com/docs/pe/2017.3/orchestrator/running_tasks.html) or [Bolt documentation](https://puppet.com/docs/bolt/latest/bolt.html) on how to execute a task. + + +## Limitations + +For an extensive list of supported operating systems, see [metadata.json](https://github.com/puppetlabs/puppetlabs-apache/blob/main/metadata.json) + +### FreeBSD + +In order to use this module on FreeBSD, you _must_ use apache24-2.4.12 (www/apache24) or newer. + +### Gentoo + +On Gentoo, this module depends on the [`gentoo/puppet-portage`][] Puppet module. Although several options apply or enable certain features and settings for Gentoo, it is not a [supported operating system][] for this module. + +### RHEL/CentOS + +The [`apache::mod::auth_cas`][], [`apache::mod::passenger`][], [`apache::mod::proxy_html`][] and [`apache::mod::shib`][] classes are not functional on RH/CentOS without providing dependency packages from extra repositories. + +See their respective documentation below for related repositories and packages. + +#### RHEL/CentOS 5 + +The [`apache::mod::passenger`][] and [`apache::mod::proxy_html`][] classes are untested because repositories are missing compatible packages. + +#### RHEL/CentOS 6 + +The [`apache::mod::passenger`][] class is not installing, because the EL6 repository is missing compatible packages. + +#### RHEL/CentOS 7 + +The [`apache::mod::passenger`][] and [`apache::mod::proxy_html`][] classes are untested because the EL7 repository is missing compatible packages, which also blocks us from testing the [`apache::vhost`][] defined type's [`rack_base_uris`][] parameter. + +### SELinux and custom paths + +If [SELinux][] is in [enforcing mode][] and you want to use custom paths for `logroot`, `mod_dir`, `vhost_dir`, and `docroot`, you need to manage the files' context yourself. + +You can do this with Puppet: + +``` puppet +exec { 'set_apache_defaults': + command => 'semanage fcontext -a -t httpd_sys_content_t "/custom/path(/.*)?"', + path => '/bin:/usr/bin/:/sbin:/usr/sbin', + require => Package['policycoreutils-python'], +} + +package { 'policycoreutils-python': + ensure => installed, +} + +exec { 'restorecon_apache': + command => 'restorecon -Rv /apache_spec', + path => '/bin:/usr/bin/:/sbin:/usr/sbin', + before => Class['Apache::Service'], + require => Class['apache'], +} + +class { 'apache': } + +host { 'test.server': + ip => '127.0.0.1', +} + +file { '/custom/path': + ensure => directory, +} + +file { '/custom/path/include': + ensure => present, + content => '#additional_includes', +} + +apache::vhost { 'test.server': + docroot => '/custom/path', + additional_includes => '/custom/path/include', +} +``` + +**NOTE:** On RHEL 8, the SELinux packages contained in `policycoreutils-python` have been replaced by the `policycoreutils-python-utils` package. +See [here](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html-single/considerations_in_adopting_rhel_8/index#selinux-python3_security) for more details. + +You must set the contexts using `semanage fcontext` instead of `chcon` because Puppet's `file` resources reset the values' context in the database if the resource doesn't specify it. + +### Ubuntu 16.04 +The [`apache::mod::suphp`][] class is untested since repositories are missing compatible packages. + + +## Development + +### Testing + +To run the unit tests, install the necessary gems: + +``` +bundle install +``` + +And then execute the command: + +``` +bundle exec rake parallel_spec +``` + +To check the code coverage, run: + +``` +COVERAGE=yes bundle exec rake parallel_spec +``` + + + +Acceptance tests for this module leverage [puppet_litmus](https://github.com/puppetlabs/puppet_litmus). +To run the acceptance tests follow the instructions [here](https://github.com/puppetlabs/puppet_litmus/wiki/Tutorial:-use-Litmus-to-execute-acceptance-tests-with-a-sample-module-(MoTD)#install-the-necessary-gems-for-the-module). +You can also find a tutorial and walkthrough of using Litmus and the PDK on [YouTube](https://www.youtube.com/watch?v=FYfR7ZEGHoE). + +### Development Support +If you run into an issue with this module, or if you would like to request a feature, please [file a ticket](https://tickets.puppetlabs.com/browse/MODULES/). +Every Monday the Puppet IA Content Team has [office hours](https://puppet.com/community/office-hours) in the [Puppet Community Slack](http://slack.puppet.com/), alternating between an EMEA friendly time (1300 UTC) and an Americas friendly time (0900 Pacific, 1700 UTC). + +If you have problems getting this module up and running, please [contact Support](http://puppetlabs.com/services/customer-support). + +If you submit a change to this module, be sure to regenerate the reference documentation as follows: + +```bash +puppet strings generate --format markdown --out REFERENCE.md +``` + +### Apache MOD Test & Support Lifecycle +#### Adding Support for a new Apache MOD +Support for new [Apache Modules] can be added under the [`apache::mod`] namespace. +Acceptance tests should be added for each new [Apache Module][Apache Modules] added. +Ideally, the acceptance tests should run on all compatible platforms that this module is supported on (see `metdata.json`), however there are cases when a more niche module is difficult to set up and install on a particular Linux distro. +This could be for one or more of the following reasons: +- Package not available in default repositories of distro +- Package dependencies not available in default repositories of distro +- Package (and/or its dependencies) are only available in a specific version of an OS + +In these cases, it is possible to exclude a module from a test platform using a specific tag, defined above the class declaration: +```puppet +# @note Unsupported platforms: OS: ver, ver; OS: ver, ver, ver; OS: all +class apache::mod::foobar { +... +} +``` +For example: +```puppet +# @note Unsupported platforms: RedHat: 5, 6; Ubuntu: 14.04; SLES: all; Scientific: 11 SP1 +class apache::mod::actions { +... +} +``` +Please be aware of the following format guidelines for the tag: +- All OS/Version declarations must be preceded with `@note Unsupported platforms:` +- The tag must be declared ABOVE the class declaration (i.e. not as footer at the bottom of the file) +- Each OS/Version declaration must be separated by semicolons (`;`) +- Each version must be separated by a comma (`,`) +- Versions CANNOT be declared in ranges (e.g. `RedHat:5-7`), they should be explicitly declared (e.g. `RedHat:5,6,7`) +- However, to declare all versions of an OS as unsupported, use the word `all` (e.g. `SLES:all`) +- OSs with word characters as part of their versions are acceptable (e.g. `Scientific: 11 SP1, 11 SP2, 12, 13`) +- Spaces are permitted between OS/Version declarations and version numbers within a declaration +- Refer to the `operatingsystem_support` values in the `metadata.json` to find the acceptable OS name and version syntax: + - E.g. `OracleLinux` OR `oraclelinux`, not: `Oracle` or `OraLinux` + - E.g. `RedHat` OR `redhat`, not: `Red Hat Enterprise Linux`, `RHEL`, or `Red Hat` + +If the tag is incorrectly formatted, a warning will be printed out at the end of the test run, indicating what tag(s) could not be parsed. +This will not halt the execution of other tests. + +Once the class is tagged, it is possible to exclude a test for that particular [Apache MOD][Apache Modules] using RSpec's filtering and a helper method: +```ruby +describe 'auth_oidc', if: mod_supported_on_platform('apache::mod::auth_openidc') do +``` +The `mod_supported_on_platform` helper method takes the [Apache Module][Apache Modules] class definition as defined in the manifests under `manifest/mod`. + +This functionality can be disabled by setting the `DISABLE_MOD_TEST_EXCLUSION` environment variable. +When set, all exclusions will be ignored. +#### Test Support Lifecycle +The puppetlabs-apache module supports a large number of compatible platforms and [Apache Modules][Apache modules]. +As a result, Apache Module tests can fail because a package or package dependency has been removed from a Linux distribution repository. +The [IAC Team][IAC Team] will try to resolve these issues and keep instructions updated, but due to limited resources this won’t always be possible. +In these cases, we will exclude test(s) from certain platforms. +As always, we welcome help from our community members, and the IAC team is here to assist and answer questions. diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/REFERENCE.md b/modules/services/unix/http/apache_kali_compatible/apache/REFERENCE.md similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/REFERENCE.md rename to modules/services/unix/http/apache_kali_compatible/apache/REFERENCE.md diff --git a/modules/services/unix/http/apache_kali_compatible/apache/apache.pp b/modules/services/unix/http/apache_kali_compatible/apache/apache.pp new file mode 100644 index 000000000..0c63066b8 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/apache.pp @@ -0,0 +1,29 @@ +# +# apache::fastcgi::server { 'php': +# host => '127.0.0.1:9000', +# timeout => 15, +# flush => false, +# faux_path => '/var/www/php.fcgi', +# fcgi_alias => '/php.fcgi', +# file_type => 'application/x-httpd-php' +# } +# +# apache::vhost { 'www': +# custom_fragment => 'AddType application/x-httpd-php .php', +# docroot => '/var/www/wordpress' +# } + +class { 'apache': + mpm_module => 'prefork' +} + +exec { 'apache2-systemd-reload': + command => 'systemctl daemon-reload; systemctl enable apache2', + path => [ '/usr/bin', '/bin', '/usr/sbin' ], +} +#-> +#service { 'apache2': +# ensure => running, +# provider => systemd, +# enable => true, +#} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/data/common.yaml b/modules/services/unix/http/apache_kali_compatible/apache/data/common.yaml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/data/common.yaml rename to modules/services/unix/http/apache_kali_compatible/apache/data/common.yaml diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/apache.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/apache.pp new file mode 100644 index 000000000..0d4543564 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/apache.pp @@ -0,0 +1,6 @@ +include apache +include apache::mod::php +include apache::mod::cgi +include apache::mod::userdir +include apache::mod::disk_cache +include apache::mod::proxy_http diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/dev.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/dev.pp new file mode 100644 index 000000000..6c4f95571 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/dev.pp @@ -0,0 +1 @@ +include apache::mod::dev diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/init.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/init.pp new file mode 100644 index 000000000..b3f9f13aa --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/init.pp @@ -0,0 +1 @@ +include apache diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/mod_load_params.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/mod_load_params.pp new file mode 100644 index 000000000..879f2cfe5 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/mod_load_params.pp @@ -0,0 +1,10 @@ +# Tests the path and identifier parameters for the apache::mod class + +# Base class for clarity: +class { 'apache': } + +# Exaple parameter usage: +apache::mod { 'testmod': + path => '/usr/some/path/mod_testmod.so', + id => 'testmod_custom_name', +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/mods.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/mods.pp new file mode 100644 index 000000000..dd64e3b23 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/mods.pp @@ -0,0 +1,8 @@ +## Default mods + +# Base class. Declares default vhost on port 80 and default ssl +# vhost on port 443 listening on all interfaces and serving +# $apache::docroot, and declaring our default set of modules. +class { 'apache': + default_mods => true, +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/mods_custom.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/mods_custom.pp new file mode 100644 index 000000000..103e52a4f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/mods_custom.pp @@ -0,0 +1,15 @@ +## custom mods + +# Base class. Declares default vhost on port 80 and default ssl +# vhost on port 443 listening on all interfaces and serving +# $apache::docroot, and declaring a custom set of modules. +class { 'apache': + default_mods => [ + 'info', + 'alias', + 'mime', + 'env', + 'setenv', + 'expires', + ], +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/php.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/php.pp new file mode 100644 index 000000000..1d926bfb4 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/php.pp @@ -0,0 +1,4 @@ +class { 'apache': + mpm_module => 'prefork', +} +include apache::mod::php diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost.pp new file mode 100644 index 000000000..c0813d160 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost.pp @@ -0,0 +1,256 @@ +## Default vhosts, and custom vhosts +# NB: Please see the other vhost_*.pp example files for further +# examples. + +# Base class. Declares default vhost on port 80 and default ssl +# vhost on port 443 listening on all interfaces and serving +# $apache::docroot +class { 'apache': } + +# Most basic vhost +apache::vhost { 'first.example.com': + port => '80', + docroot => '/var/www/first', +} + +# Vhost with different docroot owner/group/mode +apache::vhost { 'second.example.com': + port => '80', + docroot => '/var/www/second', + docroot_owner => 'third', + docroot_group => 'third', + docroot_mode => '0770', +} + +# Vhost with serveradmin +apache::vhost { 'third.example.com': + port => '80', + docroot => '/var/www/third', + serveradmin => 'admin@example.com', +} + +# Vhost with ssl (uses default ssl certs) +apache::vhost { 'ssl.example.com': + port => '443', + docroot => '/var/www/ssl', + ssl => true, +} + +# Vhost with ssl and specific ssl certs +apache::vhost { 'fourth.example.com': + port => '443', + docroot => '/var/www/fourth', + ssl => true, + ssl_cert => '/etc/ssl/fourth.example.com.cert', + ssl_key => '/etc/ssl/fourth.example.com.key', +} + +# Vhost with english title and servername parameter +apache::vhost { 'The fifth vhost': + servername => 'fifth.example.com', + port => '80', + docroot => '/var/www/fifth', +} + +# Vhost with server aliases +apache::vhost { 'sixth.example.com': + serveraliases => [ + 'sixth.example.org', + 'sixth.example.net', + ], + port => '80', + docroot => '/var/www/fifth', +} + +# Vhost with alternate options +apache::vhost { 'seventh.example.com': + port => '80', + docroot => '/var/www/seventh', + options => [ + 'Indexes', + 'MultiViews', + ], +} + +# Vhost with AllowOverride for .htaccess +apache::vhost { 'eighth.example.com': + port => '80', + docroot => '/var/www/eighth', + override => 'All', +} + +# Vhost with access and error logs disabled +apache::vhost { 'ninth.example.com': + port => '80', + docroot => '/var/www/ninth', + access_log => false, + error_log => false, +} + +# Vhost with custom access and error logs and logroot +apache::vhost { 'tenth.example.com': + port => '80', + docroot => '/var/www/tenth', + access_log_file => 'tenth_vhost.log', + error_log_file => 'tenth_vhost_error.log', + logroot => '/var/log', +} + +# Vhost with a cgi-bin +apache::vhost { 'eleventh.example.com': + port => '80', + docroot => '/var/www/eleventh', + scriptalias => '/usr/lib/cgi-bin', +} + +# Vhost with a proxypass configuration +apache::vhost { 'twelfth.example.com': + port => '80', + docroot => '/var/www/twelfth', + proxy_dest => 'http://internal.example.com:8080/twelfth', + no_proxy_uris => ['/login','/logout'], +} + +# Vhost to redirect /login and /logout +apache::vhost { 'thirteenth.example.com': + port => '80', + docroot => '/var/www/thirteenth', + redirect_source => [ + '/login', + '/logout', + ], + redirect_dest => [ + 'http://10.0.0.10/login', + 'http://10.0.0.10/logout', + ], +} + +# Vhost to permamently redirect +apache::vhost { 'fourteenth.example.com': + port => '80', + docroot => '/var/www/fourteenth', + redirect_source => '/blog', + redirect_dest => 'http://blog.example.com', + redirect_status => 'permanent', +} + +# Vhost with a rack configuration +apache::vhost { 'fifteenth.example.com': + port => '80', + docroot => '/var/www/fifteenth', + rack_base_uris => ['/rackapp1', '/rackapp2'], +} + +# Vhost to redirect non-ssl to ssl +apache::vhost { 'sixteenth.example.com non-ssl': + servername => 'sixteenth.example.com', + port => '80', + docroot => '/var/www/sixteenth', + rewrites => [ + { + comment => 'redirect non-SSL traffic to SSL site', + rewrite_cond => ['%{HTTPS} off'], + rewrite_rule => ['(.*) https://%{HTTP_HOST}%{REQUEST_URI}'], + } + ], +} + +# Rewrite a URL to lower case +apache::vhost { 'sixteenth.example.com non-ssl': + servername => 'sixteenth.example.com', + port => '80', + docroot => '/var/www/sixteenth', + rewrites => [ + { comment => 'Rewrite to lower case', + rewrite_cond => ['%{REQUEST_URI} [A-Z]'], + rewrite_map => ['lc int:tolower'], + rewrite_rule => ["(.*) \${lc:\$1} [R=301,L]"], + } + ], +} + +apache::vhost { 'sixteenth.example.com ssl': + servername => 'sixteenth.example.com', + port => '443', + docroot => '/var/www/sixteenth', + ssl => true, +} + +# Vhost to redirect non-ssl to ssl using old rewrite method +apache::vhost { 'sixteenth.example.com non-ssl old rewrite': + servername => 'sixteenth.example.com', + port => '80', + docroot => '/var/www/sixteenth', + rewrite_cond => '%{HTTPS} off', + rewrite_rule => '(.*) https://%{HTTP_HOST}%{REQUEST_URI}', +} +apache::vhost { 'sixteenth.example.com ssl old rewrite': + servername => 'sixteenth.example.com', + port => '443', + docroot => '/var/www/sixteenth', + ssl => true, +} + +# Vhost to block repository files +apache::vhost { 'seventeenth.example.com': + port => '80', + docroot => '/var/www/seventeenth', + block => 'scm', +} + +# Vhost with special environment variables +apache::vhost { 'eighteenth.example.com': + port => '80', + docroot => '/var/www/eighteenth', + setenv => ['SPECIAL_PATH /foo/bin','KILROY was_here'], +} + +apache::vhost { 'nineteenth.example.com': + port => '80', + docroot => '/var/www/nineteenth', + setenvif => 'Host "^([^\.]*)\.website\.com$" CLIENT_NAME=$1', +} + +# Vhost with additional include files +apache::vhost { 'twentyieth.example.com': + port => '80', + docroot => '/var/www/twelfth', + additional_includes => ['/tmp/proxy_group_a','/tmp/proxy_group_b'], +} + +# Vhost with alias for subdomain mapped to same named directory +# http://example.com.loc => /var/www/example.com +apache::vhost { 'subdomain.loc': + vhost_name => '*', + port => '80', + virtual_docroot => '/var/www/%-2+', + docroot => '/var/www', + serveraliases => ['*.loc',], +} + +# Vhost with SSL (SSLProtocol, SSLCipherSuite & SSLHonorCipherOrder from default) +apache::vhost { 'securedomain.com': + priority => '10', + vhost_name => 'www.securedomain.com', + port => '443', + docroot => '/var/www/secure', + ssl => true, + ssl_cert => '/etc/ssl/securedomain.cert', + ssl_key => '/etc/ssl/securedomain.key', + ssl_chain => '/etc/ssl/securedomain.crt', + add_listen => false, +} + +# Vhost with access log environment variables writing control +apache::vhost { 'twentyfirst.example.com': + port => '80', + docroot => '/var/www/twentyfirst', + access_log_env_var => 'admin', +} + +# Vhost with a passenger_base configuration +apache::vhost { 'twentysecond.example.com': + port => '80', + docroot => '/var/www/twentysecond', + rack_base_uris => ['/passengerapp1', '/passengerapp2'], +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_directories.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_directories.pp new file mode 100644 index 000000000..f02734d02 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_directories.pp @@ -0,0 +1,43 @@ +# Base class. Declares default vhost on port 80 and default ssl +# vhost on port 443 listening on all interfaces and serving +# $apache::docroot +class { 'apache': } + +# Example from README adapted. +apache::vhost { 'readme.example.net': + docroot => '/var/www/readme', + directories => [ + { + 'path' => '/var/www/readme', + 'ServerTokens' => 'prod' , + }, + { + 'path' => '/usr/share/empty', + 'allow' => 'from all', + }, + ], +} + +# location test +apache::vhost { 'location.example.net': + docroot => '/var/www/location', + directories => [ + { + 'path' => '/location', + 'provider' => 'location', + 'ServerTokens' => 'prod' + }, + ], +} + +# files test, curedly disable access to accidental backup files. +apache::vhost { 'files.example.net': + docroot => '/var/www/files', + directories => [ + { + 'path' => '(\.swp|\.bak|~)$', + 'provider' => 'filesmatch', + 'deny' => 'from all' + }, + ], +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_filter.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_filter.pp new file mode 100644 index 000000000..ef27639c9 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_filter.pp @@ -0,0 +1,16 @@ +# Base class. Declares default vhost on port 80 with filters. +class { 'apache': } + +# Example from README adapted. +apache::vhost { 'readme.example.net': + docroot => '/var/www/html', + filters => [ + 'FilterDeclare COMPRESS', + 'FilterProvider COMPRESS DEFLATE resp=Content-Type $text/html', + 'FilterProvider COMPRESS DEFLATE resp=Content-Type $text/css', + 'FilterProvider COMPRESS DEFLATE resp=Content-Type $text/plain', + 'FilterProvider COMPRESS DEFLATE resp=Content-Type $text/xml', + 'FilterChain COMPRESS', + 'FilterProtocol COMPRESS DEFLATE change=yes;byteranges=no', + ], +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_ip_based.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_ip_based.pp new file mode 100644 index 000000000..dc0fa4f33 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_ip_based.pp @@ -0,0 +1,25 @@ +## IP-based vhosts on any listen port +# IP-based vhosts respond to requests on specific IP addresses. + +# Base class. Turn off the default vhosts; we will be declaring +# all vhosts below. +class { 'apache': + default_vhost => false, +} + +# Listen on port 80 and 81; required because the following vhosts +# are not declared with a port parameter. +apache::listen { '80': } +apache::listen { '81': } + +# IP-based vhosts +apache::vhost { 'first.example.com': + ip => '10.0.0.10', + docroot => '/var/www/first', + ip_based => true, +} +apache::vhost { 'second.example.com': + ip => '10.0.0.11', + docroot => '/var/www/second', + ip_based => true, +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_proxypass.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_proxypass.pp new file mode 100644 index 000000000..ca9c57dff --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_proxypass.pp @@ -0,0 +1,66 @@ +## vhost with proxyPass directive +# NB: Please see the other vhost_*.pp example files for further +# examples. + +# Base class. Declares default vhost on port 80 and default ssl +# vhost on port 443 listening on all interfaces and serving +# $apache::docroot +class { 'apache': } + +# Most basic vhost with proxy_pass +apache::vhost { 'first.example.com': + port => 80, + docroot => '/var/www/first', + proxy_pass => [ + { + 'path' => '/first', + 'url' => 'http://localhost:8080/first' + }, + ], +} + +# vhost with proxy_pass and parameters +apache::vhost { 'second.example.com': + port => 80, + docroot => '/var/www/second', + proxy_pass => [ + { + 'path' => '/second', + 'url' => 'http://localhost:8080/second', + 'params' => { + 'retry' => '0', + 'timeout' => '5', + } + }, + ], +} + +# vhost with proxy_pass and keywords +apache::vhost { 'third.example.com': + port => 80, + docroot => '/var/www/third', + proxy_pass => [ + { + 'path' => '/third', + 'url' => 'http://localhost:8080/third', + 'keywords' => ['noquery', 'interpolate'] + }, + ], +} + +# vhost with proxy_pass, parameters and keywords +apache::vhost { 'fourth.example.com': + port => 80, + docroot => '/var/www/fourth', + proxy_pass => [ + { + 'path' => '/fourth', + 'url' => 'http://localhost:8080/fourth', + 'params' => { + 'retry' => '0', + 'timeout' => '5', + }, + 'keywords' => ['noquery', 'interpolate'] + }, + ], +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_ssl.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_ssl.pp new file mode 100644 index 000000000..8e7a2b279 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhost_ssl.pp @@ -0,0 +1,23 @@ +## SSL-enabled vhosts +# SSL-enabled vhosts respond only to HTTPS queries. + +# Base class. Turn off the default vhosts; we will be declaring +# all vhosts below. +class { 'apache': + default_vhost => false, +} + +# Non-ssl vhost +apache::vhost { 'first.example.com non-ssl': + servername => 'first.example.com', + port => '80', + docroot => '/var/www/first', +} + +# SSL vhost at the same domain +apache::vhost { 'first.example.com ssl': + servername => 'first.example.com', + port => '443', + docroot => '/var/www/first', + ssl => true, +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/examples/vhosts_without_listen.pp b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhosts_without_listen.pp new file mode 100644 index 000000000..d42118bc2 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/examples/vhosts_without_listen.pp @@ -0,0 +1,52 @@ +## Declare ip-based and name-based vhosts +# Mixing Name-based vhost with IP-specific vhosts requires `add_listen => +# 'false'` on the non-IP vhosts + +# Base class. Turn off the default vhosts; we will be declaring +# all vhosts below. +class { 'apache': + default_vhost => false, +} + +# Add two an IP-based vhost on 10.0.0.10, ssl and non-ssl +apache::vhost { 'The first IP-based vhost, non-ssl': + servername => 'first.example.com', + ip => '10.0.0.10', + port => '80', + ip_based => true, + docroot => '/var/www/first', +} +apache::vhost { 'The first IP-based vhost, ssl': + servername => 'first.example.com', + ip => '10.0.0.10', + port => '443', + ip_based => true, + docroot => '/var/www/first-ssl', + ssl => true, +} + +# Two name-based vhost listening on 10.0.0.20 +apache::vhost { 'second.example.com': + ip => '10.0.0.20', + port => '80', + docroot => '/var/www/second', +} +apache::vhost { 'third.example.com': + ip => '10.0.0.20', + port => '80', + docroot => '/var/www/third', +} + +# Two name-based vhosts without IPs specified, so that they will answer on either 10.0.0.10 or 10.0.0.20 . It is requried to declare +# `add_listen => 'false'` to disable declaring "Listen 80" which will conflict +# with the IP-based preceeding vhosts. +apache::vhost { 'fourth.example.com': + port => '80', + docroot => '/var/www/fourth', + add_listen => false, +} +apache::vhost { 'fifth.example.com': + port => '80', + docroot => '/var/www/fifth', + add_listen => false, +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/files/httpd b/modules/services/unix/http/apache_kali_compatible/apache/files/httpd new file mode 100644 index 000000000..d65a8d445 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/files/httpd @@ -0,0 +1,24 @@ +# Configuration file for the httpd service. + +# +# The default processing model (MPM) is the process-based +# 'prefork' model. A thread-based model, 'worker', is also +# available, but does not work with some modules (such as PHP). +# The service must be stopped before changing this variable. +# +#HTTPD=/usr/sbin/httpd.worker + +# +# To pass additional options (for instance, -D definitions) to the +# httpd binary at startup, set OPTIONS here. +# +#OPTIONS= +#OPTIONS=-DDOWN + +# +# By default, the httpd process is started in the C locale; to +# change the locale in which the server runs, the HTTPD_LANG +# variable can be set. +# +#HTTPD_LANG=C +export SHORTHOST=`hostname -s` diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/hiera.yaml b/modules/services/unix/http/apache_kali_compatible/apache/hiera.yaml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/hiera.yaml rename to modules/services/unix/http/apache_kali_compatible/apache/hiera.yaml diff --git a/modules/services/unix/http/apache_kali_compatible/apache/lib/facter/apache_version.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/facter/apache_version.rb new file mode 100644 index 000000000..bb16670db --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/lib/facter/apache_version.rb @@ -0,0 +1,29 @@ +# frozen_string_literal: true + +Facter.add(:apache_version) do + confine kernel: ['FreeBSD', 'Linux'] + setcode do + apache_version = nil + + if Facter::Util::Resolution.which('httpd') + apache_version = Facter::Util::Resolution.exec('httpd -V 2>&1') + Facter.debug "Matching httpd '#{apache_version}'" + elsif Facter::Util::Resolution.which('apache2') + apache_version = Facter::Util::Resolution.exec('apache2 -V 2>&1') + Facter.debug "Matching apache2 '#{apache_version}'" + elsif Facter::Util::Resolution.which('apachectl') + apache_version = Facter::Util::Resolution.exec('apachectl -v 2>&1') + Facter.debug "Matching apachectl '#{apache_version}'" + elsif Facter::Util::Resolution.which('apache2ctl') + apache_version = Facter::Util::Resolution.exec('apache2ctl -v 2>&1') + Facter.debug "Matching apache2ctl '#{apache_version}'" + end + + unless apache_version.nil? + match = %r{^Server version: Apache\/(\d+.\d+(.\d+)?)}.match(apache_version) + unless match.nil? + match[1] + end + end + end +end diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/lib/puppet/functions/apache/apache_pw_hash.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/functions/apache/apache_pw_hash.rb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/lib/puppet/functions/apache/apache_pw_hash.rb rename to modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/functions/apache/apache_pw_hash.rb diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/lib/puppet/functions/apache/bool2httpd.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/functions/apache/bool2httpd.rb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/lib/puppet/functions/apache/bool2httpd.rb rename to modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/functions/apache/bool2httpd.rb diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/lib/puppet/functions/apache/pw_hash.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/functions/apache/pw_hash.rb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/lib/puppet/functions/apache/pw_hash.rb rename to modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/functions/apache/pw_hash.rb diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/lib/puppet/functions/apache_pw_hash.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/functions/apache_pw_hash.rb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/lib/puppet/functions/apache_pw_hash.rb rename to modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/functions/apache_pw_hash.rb diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/lib/puppet/functions/bool2httpd.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/functions/bool2httpd.rb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/lib/puppet/functions/bool2httpd.rb rename to modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/functions/bool2httpd.rb diff --git a/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod.rb new file mode 100644 index 000000000..7406e01da --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod.rb @@ -0,0 +1,43 @@ +# frozen_string_literal: true + +# a2mod.rb +class Puppet::Provider::A2mod < Puppet::Provider + # Fetches the mod provider + def self.prefetch(mods) + instances.each do |prov| + mod = mods[prov.name] + if mod + mod.provider = prov + end + end + end + + # Clear's the property_hash + def flush + @property_hash.clear + end + + # Returns a copy of the property_hash + def properties + if @property_hash.empty? + @property_hash = query || { ensure: :absent } + @property_hash[:ensure] = :absent if @property_hash.empty? + end + @property_hash.dup + end + + # Returns the properties of the given mod if it exists. + def query + self.class.instances.each do |mod| + if mod.name == name || mod.name.downcase == name + return mod.properties + end + end + nil + end + + # Return's if the ensure property is absent or not + def exists? + properties[:ensure] != :absent + end +end diff --git a/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/a2mod.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/a2mod.rb new file mode 100644 index 000000000..3330fd5dc --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/a2mod.rb @@ -0,0 +1,37 @@ +# frozen_string_literal: true + +require 'puppet/provider/a2mod' + +Puppet::Type.type(:a2mod).provide(:a2mod, parent: Puppet::Provider::A2mod) do + desc 'Manage Apache 2 modules on Debian and Ubuntu' + + optional_commands encmd: 'a2enmod' + optional_commands discmd: 'a2dismod' + commands apache2ctl: 'apache2ctl' + + confine osfamily: :debian + defaultfor operatingsystem: [:debian, :ubuntu] + + def self.instances + modules = apache2ctl('-M').lines.map { |line| + m = line.match(%r{(\w+)_module \(shared\)$}) + m[1] if m + }.compact + + modules.map do |mod| + new( + name: mod, + ensure: :present, + provider: :a2mod, + ) + end + end + + def create + encmd resource[:name] + end + + def destroy + discmd resource[:name] + end +end diff --git a/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/gentoo.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/gentoo.rb new file mode 100644 index 000000000..c53fbd5b6 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/gentoo.rb @@ -0,0 +1,116 @@ +# frozen_string_literal: true + +require 'puppet/util/filetype' +Puppet::Type.type(:a2mod).provide(:gentoo, parent: Puppet::Provider) do + desc 'Manage Apache 2 modules on Gentoo' + + confine operatingsystem: :gentoo + defaultfor operatingsystem: :gentoo + + attr_accessor :property_hash + + def create + @property_hash[:ensure] = :present + end + + def exists? + (!@property_hash[:ensure].nil? && @property_hash[:ensure] == :present) + end + + def destroy + @property_hash[:ensure] = :absent + end + + def flush + self.class.flush + end + + class << self + attr_reader :conf_file + end + + def self.clear + @mod_resources = [] + @modules = [] + @other_args = '' + end + + def self.initvars + @conf_file = '/etc/conf.d/apache2' + @filetype = Puppet::Util::FileType.filetype(:flat).new(conf_file) + @mod_resources = [] + @modules = [] + @other_args = '' + end + + initvars + + # Retrieve an array of all existing modules + def self.modules + if @modules.length <= 0 + # Locate the APACHE_OPTS variable + records = filetype.read.split(%r{\n}) + apache2_opts = records.grep(%r{^\s*APACHE2_OPTS=}).first + + # Extract all defines + @modules << Regexp.last_match(1).downcase while apache2_opts.sub!(%r{-D\s+(\w+)}, '') + + # Hang on to any remaining options. + if apache2_opts =~ %r{APACHE2_OPTS="(.+)"} + @other_args = Regexp.last_match(1).strip + end + + @modules.sort!.uniq! + end + + @modules + end + + def self.prefetch(resources = {}) + # Match resources with existing providers + instances.each do |provider| + resource = resources[provider.name] + if resource + resource.provider = provider + end + end + + # Store all resources using this provider for flushing + resources.each do |_name, resource| + @mod_resources << resource + end + end + + def self.instances + modules.map { |mod| new(name: mod, provider: :gentoo, ensure: :present) } + end + + def self.flush + mod_list = modules + mods_to_remove = @mod_resources.select { |mod| mod.should(:ensure) == :absent }.map { |mod| mod[:name] } + mods_to_add = @mod_resources.select { |mod| mod.should(:ensure) == :present }.map { |mod| mod[:name] } + + mod_list -= mods_to_remove + mod_list += mods_to_add + mod_list.sort!.uniq! + + return unless modules != mod_list + + opts = @other_args + ' ' + opts << mod_list.map { |mod| "-D #{mod.upcase}" }.join(' ') + opts.strip! + opts.gsub!(%r{\s+}, ' ') + + apache2_opts = %(APACHE2_OPTS="#{opts}") + Puppet.debug("Writing back \"#{apache2_opts}\" to #{conf_file}") + + records = filetype.read.split(%r{\n}) + + opts_index = records.find_index { |i| i.match(%r{^\s*APACHE2_OPTS}) } + records[opts_index] = apache2_opts + + filetype.backup + filetype.write(records.join("\n")) + @modules = mod_list + end +end diff --git a/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/modfix.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/modfix.rb new file mode 100644 index 000000000..755c927e4 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/modfix.rb @@ -0,0 +1,13 @@ +# frozen_string_literal: true + +Puppet::Type.type(:a2mod).provide :modfix do + desc "Dummy provider for A2mod. + Fake nil resources when there is no crontab binary available. Allows + puppetd to run on a bootstrapped machine before a Cron package has been + installed. Workaround for: http://projects.puppetlabs.com/issues/2384 + " + + def self.instances + [] + end +end diff --git a/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/redhat.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/redhat.rb new file mode 100644 index 000000000..149a7b909 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/provider/a2mod/redhat.rb @@ -0,0 +1,62 @@ +# frozen_string_literal: true + +require 'puppet/provider/a2mod' + +Puppet::Type.type(:a2mod).provide(:redhat, parent: Puppet::Provider::A2mod) do + desc 'Manage Apache 2 modules on RedHat family OSs' + + commands apachectl: 'apachectl' + + confine osfamily: :redhat + defaultfor osfamily: :redhat + + require 'pathname' + + # modpath: Path to default apache modules directory /etc/httpd/mod.d + # modfile: Path to module load configuration file; Default: resides under modpath directory + # libfile: Path to actual apache module library. Added in modfile LoadModule + + attr_accessor :modfile, :libfile + class << self + attr_accessor :modpath + def preinit + @modpath = '/etc/httpd/mod.d' + end + end + + preinit + + def create + File.open(modfile, 'w') do |f| + f.puts "LoadModule #{resource[:identifier]} #{libfile}" + end + end + + def destroy + File.delete(modfile) + end + + def self.instances + modules = apachectl('-M').lines.map { |line| + m = line.match(%r{(\w+)_module \(shared\)$}) + m[1] if m + }.compact + + modules.map do |mod| + new( + name: mod, + ensure: :present, + provider: :redhat, + ) + end + end + + def modfile + "#{self.class.modpath}/#{resource[:name]}.load" + end + + # Set libfile path: If absolute path is passed, then maintain it. Else, make it default from 'modules' dir. + def libfile + Pathname.new(resource[:lib]).absolute? ? resource[:lib] : "modules/#{resource[:lib]}" + end +end diff --git a/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/type/a2mod.rb b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/type/a2mod.rb new file mode 100644 index 000000000..da04d7f4d --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/lib/puppet/type/a2mod.rb @@ -0,0 +1,30 @@ +# frozen_string_literal: true + +Puppet::Type.newtype(:a2mod) do + @doc = 'Manage Apache 2 modules' + + ensurable + + newparam(:name) do + Puppet.warning 'The a2mod provider is deprecated, please use apache::mod instead' + desc 'The name of the module to be managed' + + isnamevar + end + + newparam(:lib) do + desc 'The name of the .so library to be loaded' + + defaultto { "mod_#{@resource[:name]}.so" } + end + + newparam(:identifier) do + desc 'Module identifier string used by LoadModule. Default: module-name_module' + + # http://httpd.apache.org/docs/2.2/mod/module-dict.html#ModuleIdentifier + + defaultto { "#{resource[:name]}_module" } + end + + autorequire(:package) { catalog.resource(:package, 'httpd') } +end diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/balancer.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/balancer.pp new file mode 100644 index 000000000..6740a73c2 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/balancer.pp @@ -0,0 +1,106 @@ +# @summary +# This type will create an apache balancer cluster file inside the conf.d +# directory. +# +# Each balancer cluster needs one or more balancer members (that can +# be declared with the apache::balancermember defined resource type). Using +# storeconfigs, you can export the apache::balancermember resources on all +# balancer members, and then collect them on a single apache load balancer +# server. +# +# @note +# Currently requires the puppetlabs/concat module on the Puppet Forge and uses +# storeconfigs on the Puppet Server to export/collect resources from all +# balancer members. +# +# @param name +# The namevar of the defined resource type is the balancer clusters name.
+# This name is also used in the name of the conf.d file +# +# @param proxy_set +# Configures key-value pairs to be used as a ProxySet lines in the configuration. +# +# @param target +# The path to the file the balancer definition will be written in. +# +# @param collect_exported +# Determines whether to use exported resources.
+# If you statically declare all of your backend servers, set this parameter to false to rely +# on existing, declared balancer member resources. Also, use apache::balancermember with array +# arguments.
+# To dynamically declare backend servers via exported resources collected on a central node, +# set this parameter to true to collect the balancer member resources exported by the balancer +# member nodes.
+# If you don't use exported resources, a single Puppet run configures all balancer members. If +# you use exported resources, Puppet has to run on the balanced nodes first, then run on the +# balancer. +# +# @param options +# Specifies an array of [options](https://httpd.apache.org/docs/current/mod/mod_proxy.html#balancermember) +# after the balancer URL, and accepts any key-value pairs available to `ProxyPass`. +# +# @example +# apache::balancer { 'puppet00': } +# +define apache::balancer ( + $proxy_set = {}, + $collect_exported = true, + $target = undef, + $options = [], +) { + include apache::mod::proxy_balancer + + if versioncmp($apache::mod::proxy_balancer::apache_version, '2.4') >= 0 { + $lbmethod = $proxy_set['lbmethod'] ? { + undef => 'byrequests', + default => $proxy_set['lbmethod'], + } + ensure_resource('apache::mod', "lbmethod_${lbmethod}", { + 'loadfile_name' => "proxy_balancer_lbmethod_${lbmethod}.load" + }) + } + + if $target { + $_target = $target + } else { + $_target = "${apache::confd_dir}/balancer_${name}.conf" + } + + if !empty($options) { + $_options = " ${join($options, ' ')}" + } else { + $_options = '' + } + + concat { "apache_balancer_${name}": + owner => '0', + group => '0', + path => $_target, + mode => $apache::file_mode, + notify => Class['Apache::Service'], + } + + concat::fragment { "00-${name}-header": + target => "apache_balancer_${name}", + order => '01', + content => "\n", + } + + if $collect_exported { + Apache::Balancermember <<| balancer_cluster == $name |>> + } + # else: the resources have been created and they introduced their + # concat fragments. We don't have to do anything about them. + + concat::fragment { "01-${name}-proxyset": + target => "apache_balancer_${name}", + order => '19', + content => inline_template("<% @proxy_set.keys.sort.each do |key| %> Proxyset <%= key %>=<%= @proxy_set[key] %>\n<% end %>"), + } + + concat::fragment { "01-${name}-footer": + target => "apache_balancer_${name}", + order => '20', + content => "\n", + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/balancermember.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/balancermember.pp new file mode 100644 index 000000000..3fa54960d --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/balancermember.pp @@ -0,0 +1,50 @@ +# @summary +# Defines members of `mod_proxy_balancer` +# +# Sets up a balancer member inside a listening service configuration block in +# the load balancer's `apache.cfg`. +# +# This type will setup a balancer member inside a listening service +# configuration block in /etc/apache/apache.cfg on the load balancer. +# Currently it only has the ability to specify the instance name, url and an +# array of options. More features can be added as needed. The best way to +# implement this is to export this resource for all apache balancer member +# servers, and then collect them on the main apache load balancer. +# +# @note +# Currently requires the puppetlabs/concat module on the Puppet Forge and +# uses storeconfigs on the Puppet Server to export/collect resources +# from all balancer members. +# +# @param name +# The title of the resource is arbitrary and only utilized in the concat +# fragment name. +# +# @param balancer_cluster +# The apache service's instance name (or, the title of the apache::balancer +# resource). This must match up with a declared apache::balancer resource. +# +# @param url +# The url used to contact the balancer member server. +# +# @param options +# Specifies an array of [options](https://httpd.apache.org/docs/current/mod/mod_proxy.html#balancermember) +# after the URL, and accepts any key-value pairs available to `ProxyPass`. +# +# @example +# @@apache::balancermember { 'apache': +# balancer_cluster => 'puppet00', +# url => "ajp://${::fqdn}:8009" +# options => ['ping=5', 'disablereuse=on', 'retry=5', 'ttl=120'], +# } +# +define apache::balancermember ( + $balancer_cluster, + $url = "http://${::fqdn}/", + $options = [], +) { + concat::fragment { "BalancerMember ${name}": + target => "apache_balancer_${balancer_cluster}", + content => inline_template(" BalancerMember ${url} <%= @options.join ' ' %>\n"), + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/confd/no_accf.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/confd/no_accf.pp new file mode 100644 index 000000000..024a088a9 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/confd/no_accf.pp @@ -0,0 +1,14 @@ +# @summary +# Manages the `no-accf.conf` file. +# +# @api private +class apache::confd::no_accf { + # Template uses no variables + file { 'no-accf.conf': + ensure => 'file', + path => "${apache::confd_dir}/no-accf.conf", + content => template('apache/confd/no-accf.conf.erb'), + require => Exec["mkdir ${apache::confd_dir}"], + before => File[$apache::confd_dir], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/custom_config.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/custom_config.pp new file mode 100644 index 000000000..52b94b489 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/custom_config.pp @@ -0,0 +1,125 @@ +# @summary +# Adds a custom configuration file to the Apache server's `conf.d` directory. +# +# If the file is invalid and this defined type's `verify_config` parameter's value is +# `true`, Puppet throws an error during a Puppet run. +# +# @param ensure +# Specifies whether the configuration file should be present. +# +# @param confdir +# Sets the directory in which Puppet places configuration files. +# +# @param content +# Sets the configuration file's content. The `content` and `source` parameters are exclusive +# of each other. +# +# @param filename +# Sets the name of the file under `confdir` in which Puppet stores the configuration. +# +# @param priority +# Sets the configuration file's priority by prefixing its filename with this parameter's +# numeric value, as Apache processes configuration files in alphanumeric order.
+# To omit the priority prefix in the configuration file's name, set this parameter to `false`. +# +# @param source +# Points to the configuration file's source. The `content` and `source` parameters are +# exclusive of each other. +# +# @param verify_command +# Specifies the command Puppet uses to verify the configuration file. Use a fully qualified +# command.
+# This parameter is used only if the `verify_config` parameter's value is `true`. If the +# `verify_command` fails, the Puppet run deletes the configuration file and raises an error, +# but does not notify the Apache service. +# +# @param verify_config +# Specifies whether to validate the configuration file before notifying the Apache service. +# +# @param owner +# File owner of configuration file +# +# @param group +# File group of configuration file +# +# @param file_mode +# File mode of configuration file +# +# @param show_diff +# show_diff property for configuration file resource +# +define apache::custom_config ( + Enum['absent', 'present'] $ensure = 'present', + $confdir = $apache::confd_dir, + $content = undef, + $priority = '25', + $source = undef, + $verify_command = $apache::params::verify_command, + Boolean $verify_config = true, + $filename = undef, + $owner = undef, + $group = undef, + $file_mode = undef, + Boolean $show_diff = true, +) { + if $content and $source { + fail('Only one of $content and $source can be specified.') + } + + if $ensure == 'present' and ! $content and ! $source { + fail('One of $content and $source must be specified.') + } + + if $filename { + $_filename = $filename + } else { + if $priority { + $priority_prefix = "${priority}-" + } else { + $priority_prefix = '' + } + + ## Apache include does not always work with spaces in the filename + $filename_middle = regsubst($name, ' ', '_', 'G') + $_filename = "${priority_prefix}${filename_middle}.conf" + } + + if ! $verify_config or $ensure == 'absent' { + $notifies = Class['Apache::Service'] + } else { + $notifies = undef + } + + $_file_mode = pick($file_mode, $apache::file_mode) + + file { "apache_${name}": + ensure => $ensure, + path => "${confdir}/${_filename}", + owner => $owner, + group => $group, + mode => $_file_mode, + content => $content, + source => $source, + show_diff => $show_diff, + require => Package['httpd'], + notify => $notifies, + } + + if $ensure == 'present' and $verify_config { + exec { "syntax verification for ${name}": + command => $verify_command, + subscribe => File["apache_${name}"], + refreshonly => true, + notify => Class['Apache::Service'], + before => Exec["remove ${name} if invalid"], + require => Anchor['::apache::modules_set_up'], + } + + exec { "remove ${name} if invalid": + command => "/bin/rm ${confdir}/${_filename}", + unless => $verify_command, + subscribe => File["apache_${name}"], + refreshonly => true, + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/default_confd_files.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/default_confd_files.pp new file mode 100644 index 000000000..ecf543eed --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/default_confd_files.pp @@ -0,0 +1,19 @@ +# @summary +# Helper for setting up default conf.d files. +# +# @api private +class apache::default_confd_files ( + $all = true, +) { + # The rest of the conf.d/* files only get loaded if we want them + if $all { + case $::osfamily { + 'freebsd': { + include apache::confd::no_accf + } + default: { + # do nothing + } + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/default_mods.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/default_mods.pp new file mode 100644 index 000000000..255c9239f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/default_mods.pp @@ -0,0 +1,186 @@ +# @summary +# Installs and congfigures default mods for Apache +# +# @api private +class apache::default_mods ( + $all = true, + $mods = undef, + $apache_version = $apache::apache_version, + $use_systemd = $apache::use_systemd, +) { + # These are modules required to run the default configuration. + # They are not configurable at this time, so we just include + # them to make sure it works. + case $::osfamily { + 'redhat': { + ::apache::mod { 'log_config': } + if versioncmp($apache_version, '2.4') >= 0 { + # Lets fork it + # Do not try to load mod_systemd on RHEL/CentOS 6 SCL. + if ( !($::osfamily == 'redhat' and versioncmp($::operatingsystemmajrelease, '7') == -1) and !($::operatingsystem == 'Amazon') ) { + if ($use_systemd) { + ::apache::mod { 'systemd': } + } + } + if ($::operatingsystem == 'Amazon' and $::operatingsystemrelease == '2') { + ::apache::mod { 'systemd': } + } + ::apache::mod { 'unixd': } + } + } + 'freebsd': { + ::apache::mod { 'log_config': } + ::apache::mod { 'unixd': } + } + 'Suse': { + ::apache::mod { 'log_config': } + } + default: {} + } + case $::osfamily { + 'gentoo': {} + default: { + ::apache::mod { 'authz_host': } + } + } + # The rest of the modules only get loaded if we want all modules enabled + if $all { + case $::osfamily { + 'debian': { + include apache::mod::authn_core + include apache::mod::reqtimeout + if versioncmp($apache_version, '2.4') < 0 { + ::apache::mod { 'authn_alias': } + } + } + 'redhat': { + include apache::mod::actions + include apache::mod::authn_core + include apache::mod::cache + include apache::mod::ext_filter + include apache::mod::mime + include apache::mod::mime_magic + include apache::mod::rewrite + include apache::mod::speling + include apache::mod::suexec + include apache::mod::version + include apache::mod::vhost_alias + ::apache::mod { 'auth_digest': } + ::apache::mod { 'authn_anon': } + ::apache::mod { 'authn_dbm': } + ::apache::mod { 'authz_dbm': } + ::apache::mod { 'authz_owner': } + ::apache::mod { 'expires': } + ::apache::mod { 'include': } + ::apache::mod { 'logio': } + ::apache::mod { 'substitute': } + ::apache::mod { 'usertrack': } + + if versioncmp($apache_version, '2.4') < 0 { + ::apache::mod { 'authn_alias': } + ::apache::mod { 'authn_default': } + } + } + 'freebsd': { + include apache::mod::actions + include apache::mod::authn_core + include apache::mod::cache + include apache::mod::disk_cache + include apache::mod::headers + include apache::mod::info + include apache::mod::mime_magic + include apache::mod::reqtimeout + include apache::mod::rewrite + include apache::mod::userdir + include apache::mod::version + include apache::mod::vhost_alias + include apache::mod::speling + include apache::mod::filter + + ::apache::mod { 'asis': } + ::apache::mod { 'auth_digest': } + ::apache::mod { 'auth_form': } + ::apache::mod { 'authn_anon': } + ::apache::mod { 'authn_dbm': } + ::apache::mod { 'authn_socache': } + ::apache::mod { 'authz_dbd': } + ::apache::mod { 'authz_dbm': } + ::apache::mod { 'authz_owner': } + ::apache::mod { 'dumpio': } + ::apache::mod { 'expires': } + ::apache::mod { 'file_cache': } + ::apache::mod { 'imagemap': } + ::apache::mod { 'include': } + ::apache::mod { 'logio': } + ::apache::mod { 'request': } + ::apache::mod { 'session': } + ::apache::mod { 'unique_id': } + } + default: {} + } + case $apache::mpm_module { + 'prefork': { + include apache::mod::cgi + } + 'worker': { + include apache::mod::cgid + } + default: { + # do nothing + } + } + include apache::mod::alias + include apache::mod::authn_file + include apache::mod::autoindex + include apache::mod::dav + include apache::mod::dav_fs + include apache::mod::deflate + include apache::mod::dir + include apache::mod::mime + include apache::mod::negotiation + include apache::mod::setenvif + ::apache::mod { 'auth_basic': } + + if versioncmp($apache_version, '2.4') >= 0 { + # filter is needed by mod_deflate + include apache::mod::filter + + # authz_core is needed for 'Require' directive + ::apache::mod { 'authz_core': + id => 'authz_core_module', + } + + # lots of stuff seems to break without access_compat + ::apache::mod { 'access_compat': } + } else { + include apache::mod::authz_default + } + + include apache::mod::authz_user + + ::apache::mod { 'authz_groupfile': } + include apache::mod::env + } elsif $mods { + ::apache::default_mods::load { $mods: } + + if versioncmp($apache_version, '2.4') >= 0 { + # authz_core is needed for 'Require' directive + ::apache::mod { 'authz_core': + id => 'authz_core_module', + } + + # filter is needed by mod_deflate + include apache::mod::filter + } + } else { + if versioncmp($apache_version, '2.4') >= 0 { + # authz_core is needed for 'Require' directive + ::apache::mod { 'authz_core': + id => 'authz_core_module', + } + + # filter is needed by mod_deflate + include apache::mod::filter + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/default_mods/load.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/default_mods/load.pp new file mode 100644 index 000000000..fc44ebcb3 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/default_mods/load.pp @@ -0,0 +1,11 @@ +# @summary +# Helper used by `apache::default_mods` +# +# @api private +define apache::default_mods::load ($module = $title) { + if defined("apache::mod::${module}") { + include "::apache::mod::${module}" + } else { + ::apache::mod { $module: } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/dev.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/dev.pp new file mode 100644 index 000000000..106541032 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/dev.pp @@ -0,0 +1,22 @@ +# @summary +# Installs Apache development libraries. +# +# The libraries installed depends on the `dev_packages` parameter of the `apache::params` +# class, based on your operating system: +# - **Debian** : `libaprutil1-dev`, `libapr1-dev`; `apache2-dev` +# - **FreeBSD**: `undef`; on FreeBSD, you must declare the `apache::package` or `apache` classes before declaring `apache::dev`. +# - **Gentoo**: `undef`. +# - **Red Hat**: `httpd-devel`. +class apache::dev { + if ! defined(Class['apache']) { + fail('You must include the apache base class before using any apache defined resources') + } + + $packages = $apache::dev_packages + if $packages { # FreeBSD doesn't have dev packages to install + package { $packages: + ensure => present, + require => Package['httpd'], + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/fastcgi/server.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/fastcgi/server.pp new file mode 100644 index 000000000..2e372b1a1 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/fastcgi/server.pp @@ -0,0 +1,59 @@ +# @summary +# Defines one or more external FastCGI servers to handle specific file types. Use this +# defined type with `mod_fastcgi`. +# +# @param host +# Determines the FastCGI's hostname or IP address and TCP port number (1-65535). +# +# @param timeout +# Sets the number of seconds a [FastCGI](http://www.fastcgi.com/) application can be inactive before aborting the +# request and logging the event at the error LogLevel. The inactivity timer applies only as +# long as a connection is pending with the FastCGI application. If a request is queued to an +# application, but the application doesn't respond by writing and flushing within this period, +# the request is aborted. If communication is complete with the application but incomplete with +# the client (the response is buffered), the timeout does not apply. +# +# @param flush +# Forces `mod_fastcgi` to write to the client as data is received from the +# application. By default, `mod_fastcgi` buffers data in order to free the application +# as quickly as possible. +# +# @param faux_path +# Apache has FastCGI handle URIs that resolve to this filename. The path set in this +# parameter does not have to exist in the local filesystem. +# +# @param fcgi_alias +# Internally links actions with the FastCGI server. This alias must be unique. +# +# @param file_type +# Sets the MIME `content-type` of the file to be processed by the FastCGI server. +# +define apache::fastcgi::server ( + $host = '127.0.0.1:9000', + $timeout = 15, + $flush = false, + $faux_path = "/var/www/${name}.fcgi", + $fcgi_alias = "/${name}.fcgi", + $file_type = 'application/x-httpd-php', + $pass_header = undef, +) { + include apache::mod::fastcgi + + Apache::Mod['fastcgi'] -> Apache::Fastcgi::Server[$title] + + if $host =~ Stdlib::Absolutepath { + $socket = $host + } + + file { "fastcgi-pool-${name}.conf": + ensure => file, + path => "${apache::confd_dir}/fastcgi-pool-${name}.conf", + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + content => template('apache/fastcgi/server.erb'), + require => Exec["mkdir ${apache::confd_dir}"], + before => File[$apache::confd_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/init.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/init.pp new file mode 100755 index 000000000..26ded53a7 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/init.pp @@ -0,0 +1,870 @@ +# @summary +# Guides the basic setup and installation of Apache on your system. +# +# When this class is declared with the default options, Puppet: +# - Installs the appropriate Apache software package and [required Apache modules](#default_mods) for your operating system. +# - Places the required configuration files in a directory, with the [default location](#conf_dir) determined by your operating system. +# - Configures the server with a default virtual host and standard port (`80`) and address (`\*`) bindings. +# - Creates a document root directory determined by your operating system, typically `/var/www`. +# - Starts the Apache service. +# +# @example +# class { 'apache': } +# +# @param allow_encoded_slashes +# Sets the server default for the `AllowEncodedSlashes` declaration, which modifies the +# responses to URLs containing '\' and '/' characters. If not specified, this parameter omits +# the declaration from the server's configuration and uses Apache's default setting of 'off'. +# +# @param apache_version +# Configures module template behavior, package names, and default Apache modules by defining +# the version of Apache to use. We do not recommend manually configuring this parameter +# without reason. +# +# @param conf_dir +# Sets the directory where the Apache server's main configuration file is located. +# +# @param conf_template +# Defines the template used for the main Apache configuration file. Modifying this +# parameter is potentially risky, as the apache module is designed to use a minimal +# configuration file customized by `conf.d` entries. +# +# @param confd_dir +# Sets the location of the Apache server's custom configuration directory. +# +# @param default_charset +# Used as the `AddDefaultCharset` directive in the main configuration file. +# +# @param default_confd_files +# Determines whether Puppet generates a default set of includable Apache configuration files +# in the directory defined by the `confd_dir` parameter. These configuration files +# correspond to what is typically installed with the Apache package on the server's +# operating system. +# +# @param default_mods +# Determines whether to configure and enable a set of default Apache modules depending on +# your operating system.
+# If `false`, Puppet includes only the Apache modules required to make the HTTP daemon work +# on your operating system, and you can declare any other modules separately using the +# `apache::mod::` class or `apache::mod` defined type.
+# If `true`, Puppet installs additional modules, depending on the operating system and +# the values of `apache_version` and `mpm_module` parameters. Because these lists of +# modules can change frequently, consult the Puppet module's code for up-to-date lists.
+# If this parameter contains an array, Puppet instead enables all passed Apache modules. +# +# @param default_ssl_ca +# Sets the default certificate authority for the Apache server.
+# Although the default value results in a functioning Apache server, you **must** update +# this parameter with your certificate authority information before deploying this server in +# a production environment. +# +# @param default_ssl_cert +# Sets the SSL encryption certificate location.
+# Although the default value results in a functioning Apache server, you **must** update this +# parameter with your certificate location before deploying this server in a production environment. +# +# @param default_ssl_chain +# Sets the default SSL chain location.
+# Although this default value results in a functioning Apache server, you **must** update +# this parameter with your SSL chain before deploying this server in a production environment. +# +# @param default_ssl_crl +# Sets the path of the default certificate revocation list (CRL) file to use.
+# Although this default value results in a functioning Apache server, you **must** update +# this parameter with the CRL file path before deploying this server in a production +# environment. You can use this parameter with or in place of the `default_ssl_crl_path`. +# +# @param default_ssl_crl_path +# Sets the server's certificate revocation list path, which contains your CRLs.
+# Although this default value results in a functioning Apache server, you **must** update +# this parameter with the CRL file path before deploying this server in a production environment. +# +# @param default_ssl_crl_check +# Sets the default certificate revocation check level via the `SSLCARevocationCheck` directive. +# This parameter applies only to Apache 2.4 or higher and is ignored on older versions.
+# Although this default value results in a functioning Apache server, you **must** specify +# this parameter when using certificate revocation lists in a production environment. +# +# @param default_ssl_key +# Sets the SSL certificate key file location. +# Although the default values result in a functioning Apache server, you **must** update +# this parameter with your SSL key's location before deploying this server in a production +# environment. +# +# @param default_ssl_reload_on_change +# Enable reloading of apache if the content of ssl files have changed. +# +# @param default_ssl_vhost +# Configures a default SSL virtual host. +# If `true`, Puppet automatically configures the following virtual host using the +# `apache::vhost` defined type: +# ```puppet +# apache::vhost { 'default-ssl': +# port => 443, +# ssl => true, +# docroot => $docroot, +# scriptalias => $scriptalias, +# serveradmin => $serveradmin, +# access_log_file => "ssl_${access_log_file}", +# } +# ``` +# **Note**: SSL virtual hosts only respond to HTTPS queries. +# +# @param default_type +# _Apache 2.2 only_. Sets the MIME `content-type` sent if the server cannot otherwise +# determine an appropriate `content-type`. This directive is deprecated in Apache 2.4 and +# newer, and is only for backwards compatibility in configuration files. +# +# @param default_vhost +# Configures a default virtual host when the class is declared.
+# To configure customized virtual hosts, set this parameter's +# value to `false`.
+# > **Note**: Apache will not start without at least one virtual host. If you set this +# to `false` you must configure a virtual host elsewhere. +# +# @param dev_packages +# Configures a specific dev package to use.
+# For example, using httpd 2.4 from the IUS yum repo:
+# ``` puppet +# include ::apache::dev +# class { 'apache': +# apache_name => 'httpd24u', +# dev_packages => 'httpd24u-devel', +# } +# ``` +# +# @param docroot +# Sets the default `DocumentRoot` location. +# +# @param error_documents +# Determines whether to enable [custom error documents](https://httpd.apache.org/docs/current/custom-error.html) on the Apache server. +# +# @param group +# Sets the group ID that owns any Apache processes spawned to answer requests.
+# By default, Puppet attempts to manage this group as a resource under the `apache` +# class, determining the group based on the operating system as detected by the +# `apache::params` class. To prevent the group resource from being created and use a group +# created by another Puppet module, set the `manage_group` parameter's value to `false`.
+# > **Note**: Modifying this parameter only changes the group ID that Apache uses to spawn +# child processes to access resources. It does not change the user that owns the parent server +# process. +# +# @param httpd_dir +# Sets the Apache server's base configuration directory. This is useful for specially +# repackaged Apache server builds but might have unintended consequences when combined +# with the default distribution packages. +# +# @param http_protocol_options +# Specifies the strictness of HTTP protocol checks.
+# Valid options: any sequence of the following alternative values: `Strict` or `Unsafe`, +# `RegisteredMethods` or `LenientMethods`, and `Allow0.9` or `Require1.0`. +# +# @param keepalive +# Determines whether to enable persistent HTTP connections with the `KeepAlive` directive. +# If you set this to `On`, use the `keepalive_timeout` and `max_keepalive_requests` parameters +# to set relevant options.
+# +# @param keepalive_timeout +# Sets the `KeepAliveTimeout` directive, which determines the amount of time the Apache +# server waits for subsequent requests on a persistent HTTP connection. This parameter is +# only relevant if the `keepalive` parameter is enabled. +# +# @param max_keepalive_requests +# Limits the number of requests allowed per connection when the `keepalive` parameter is enabled. +# +# @param hostname_lookups +# This directive enables DNS lookups so that host names can be logged and passed to +# CGIs/SSIs in REMOTE_HOST.
+# > **Note**: If enabled, it impacts performance significantly. +# +# @param ldap_trusted_mode +# The following modes are supported: +# +# NONE - no encryption +# SSL - ldaps:// encryption on default port 636 +# TLS - STARTTLS encryption on default port 389 +# Not all LDAP toolkits support all the above modes. An error message will be logged at +# runtime if a mode is not supported, and the connection to the LDAP server will fail. +# +#If an ldaps:// URL is specified, the mode becomes SSL and the setting of LDAPTrustedMode is ignored. +# +# @param ldap_verify_server_cert +# Specifies whether to force the verification of a server certificate when establishing an SSL +# connection to the LDAP server. +# On|Off +# +# @param lib_path +# Specifies the location whereApache module files are stored.
+# > **Note**: Do not configure this parameter manually without special reason. +# +# @param log_level +# Configures the apache [LogLevel](https://httpd.apache.org/docs/current/mod/core.html#loglevel) directive +# which adjusts the verbosity of the messages recorded in the error logs. +# +# @param log_formats +# Define additional `LogFormat` directives. Values: A hash, such as: +# ``` puppet +# $log_formats = { vhost_common => '%v %h %l %u %t \"%r\" %>s %b' } +# ``` +# There are a number of predefined `LogFormats` in the `httpd.conf` that Puppet creates: +# ``` httpd +# LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined +# LogFormat "%h %l %u %t \"%r\" %>s %b" common +# LogFormat "%{Referer}i -> %U" referer +# LogFormat "%{User-agent}i" agent +# LogFormat "%{X-Forwarded-For}i %l %u %t \"%r\" %s %b \"%{Referer}i\" \"%{User-agent}i\"" forwarded +# ``` +# If your `log_formats` parameter contains one of those, it will be overwritten with **your** definition. +# +# @param logroot +# Changes the directory of Apache log files for the virtual host. +# +# @param logroot_mode +# Overrides the default `logroot` directory's mode.
+# > **Note**: Do _not_ grant write access to the directory where the logs are stored +# without being aware of the consequences. See the [Apache documentation](https://httpd.apache.org/docs/current/logs.html#security) +# for details. +# +# @param manage_group +# When `false`, stops Puppet from creating the group resource.
+# If you have a group created from another Puppet module that you want to use to run Apache, +# set this to `false`. Without this parameter, attempting to use a previously established +# group results in a duplicate resource error. +# +# @param supplementary_groups +# A list of groups to which the user belongs. These groups are in addition to the primary group.
+# Notice: This option only has an effect when `manage_user` is set to true. +# +# @param manage_user +# When `false`, stops Puppet from creating the user resource.
+# This is for instances when you have a user, created from another Puppet module, you want +# to use to run Apache. Without this parameter, attempting to use a previously established +# user would result in a duplicate resource error. +# +# @param mod_dir +# Sets where Puppet places configuration files for your Apache modules. +# +# @param mod_libs +# Allows the user to override default module library names. +# ```puppet +# include apache::params +# class { 'apache': +# mod_libs => merge($::apache::params::mod_libs, { +# 'wsgi' => 'mod_wsgi_python3.so', +# }) +# } +# ``` +# +# @param mod_packages +# Allows the user to override default module package names. +# ```puppet +# include apache::params +# class { 'apache': +# mod_packages => merge($::apache::params::mod_packages, { +# 'auth_kerb' => 'httpd24-mod_auth_kerb', +# }) +# } +# ``` +# +# @param mpm_module +# Determines which [multi-processing module](https://httpd.apache.org/docs/current/mpm.html) (MPM) is loaded and configured for the +# HTTPD process. Valid values are: `event`, `itk`, `peruser`, `prefork`, `worker` or `false`.
+# You must set this to `false` to explicitly declare the following classes with custom parameters: +# - `apache::mod::event` +# - `apache::mod::itk` +# - `apache::mod::peruser` +# - `apache::mod::prefork` +# - `apache::mod::worker` +# +# @param package_ensure +# Controls the `package` resource's `ensure` attribute. Valid values are: `absent`, `installed` +# (or equivalent `present`), or a version string. +# +# @param pidfile +# Allows settting a custom location for the pid file. Useful if using a custom-built Apache rpm. +# +# @param ports_file +# Sets the path to the file containing Apache ports configuration. +# +# @param protocols +# Sets the [Protocols](https://httpd.apache.org/docs/current/en/mod/core.html#protocols) +# directive, which lists available protocols for the server. +# +# @param protocols_honor_order +# Sets the [ProtocolsHonorOrder](https://httpd.apache.org/docs/current/en/mod/core.html#protocolshonororder) +# directive which determines whether the order of Protocols sets precedence during negotiation. +# +# @param purge_configs +# Removes all other Apache configs and virtual hosts.
+# Setting this to `false` is a stopgap measure to allow the apache module to coexist with +# existing or unmanaged configurations. We recommend moving your configuration to resources +# within this module. For virtual host configurations, see `purge_vhost_dir`. +# +# @param purge_vhost_dir +# If the `vhost_dir` parameter's value differs from the `confd_dir` parameter's, this parameter +# determines whether Puppet removes any configurations inside `vhost_dir` that are _not_ managed +# by Puppet.
+# Setting `purge_vhost_dir` to `false` is a stopgap measure to allow the apache module to +# coexist with existing or otherwise unmanaged configurations within `vhost_dir`. +# +# @param rewrite_lock +# Allows setting a custom location for a rewrite lock - considered best practice if using +# a RewriteMap of type prg in the `rewrites` parameter of your virtual host. This parameter +# only applies to Apache version 2.2 or lower and is ignored on newer versions. +# +# @param sendfile +# Forces Apache to use the Linux kernel's `sendfile` support to serve static files, via the +# `EnableSendfile` directive. +# +# @param serveradmin +# Sets the Apache server administrator's contact information via Apache's `ServerAdmin` directive. +# +# @param servername +# Sets the Apache server name via Apache's `ServerName` directive. +# Setting to `false` will not set ServerName at all. +# +# @param server_root +# Sets the Apache server's root directory via Apache's `ServerRoot` directive. +# +# @param server_signature +# Configures a trailing footer line to display at the bottom of server-generated documents, +# such as error documents and output of certain Apache modules, via Apache's `ServerSignature` +# directive. Valid values are: `On` or `Off`. +# +# @param server_tokens +# Controls how much information Apache sends to the browser about itself and the operating +# system, via Apache's `ServerTokens` directive. +# +# @param service_enable +# Determines whether Puppet enables the Apache HTTPD service when the system is booted. +# +# @param service_ensure +# Determines whether Puppet should make sure the service is running. +# Valid values are: `true` (or `running`) or `false` (or `stopped`).
+# The `false` or `stopped` values set the 'httpd' service resource's `ensure` parameter +# to `false`, which is useful when you want to let the service be managed by another +# application, such as Pacemaker.
+# +# @param service_name +# Sets the name of the Apache service. +# +# @param service_manage +# Determines whether Puppet manages the HTTPD service's state. +# +# @param service_restart +# Determines whether Puppet should use a specific command to restart the HTTPD service. +# Values: a command to restart the Apache service. +# +# @param timeout +# Sets Apache's `TimeOut` directive, which defines the number of seconds Apache waits for +# certain events before failing a request. +# +# @param trace_enable +# Controls how Apache handles `TRACE` requests (per RFC 2616) via the `TraceEnable` directive. +# +# @param use_canonical_name +# Controls Apache's `UseCanonicalName` directive which controls how Apache handles +# self-referential URLs. If not specified, this parameter omits the declaration from the +# server's configuration and uses Apache's default setting of 'off'. +# +# @param use_systemd +# Controls whether the systemd module should be installed on Centos 7 servers, this is +# especially useful if using custom-built RPMs. +# +# @param file_mode +# Sets the desired permissions mode for config files. +# Valid values are: a string, with permissions mode in symbolic or numeric notation. +# +# @param root_directory_options +# Array of the desired options for the `/` directory in httpd.conf. +# +# @param root_directory_secured +# Sets the default access policy for the `/` directory in httpd.conf. A value of `false` +# allows access to all resources that are missing a more specific access policy. A value of +# `true` denies access to all resources by default. If `true`, more specific rules must be +# used to allow access to these resources (for example, in a directory block using the +# `directories` parameter). +# +# @param vhost_dir +# Changes your virtual host configuration files' location. +# +# @param vhost_include_pattern +# Defines the pattern for files included from the `vhost_dir`. +# If set to a value like `[^.#]\*.conf[^~]` to make sure that files accidentally created in +# this directory (such as files created by version control systems or editor backups) are +# *not* included in your server configuration.
+# Some operating systems use a value of `*.conf`. By default, this module creates configuration +# files ending in `.conf`. +# +# @param user +# Changes the user that Apache uses to answer requests. Apache's parent process continues +# to run as root, but child processes access resources as the user defined by this parameter. +# To prevent Puppet from managing the user, set the `manage_user` parameter to `false`. +# +# @param apache_name +# The name of the Apache package to install. If you are using a non-standard Apache package +# you might need to override the default setting.
+# For CentOS/RHEL Software Collections (SCL), you can also use `apache::version::scl_httpd_version`. +# +# @param error_log +# The name of the error log file for the main server instance. If the string starts with +# `/`, `|`, or `syslog`: the full path is set. Otherwise, the filename is prefixed with +# `$logroot`. +# +# @param scriptalias +# Directory to use for global script alias +# +# @param access_log_file +# The name of the access log file for the main server instance. +# +# @param limitreqfields +# The `limitreqfields` parameter sets the maximum number of request header fields in +# an HTTP request. This directive gives the server administrator greater control over +# abnormal client request behavior, which may be useful for avoiding some forms of +# denial-of-service attacks. The value should be increased if normal clients see an error +# response from the server that indicates too many fields were sent in the request. +# +# @param limitreqfieldsize +# The `limitreqfieldsize` parameter sets the maximum ammount of _bytes_ that will +# be allowed within a request header. +# +# @param ip +# Specifies the ip address +# +# @param purge_vdir +# Removes all other Apache configs and virtual hosts.
+# > **Note**: This parameter is deprecated in favor of the `purge_config` parameter.
+# +# @param conf_enabled +# Whether the additional config files in `/etc/apache2/conf-enabled` should be managed. +# +# @param vhost_enable_dir +# Set's whether the vhost definitions will be stored in sites-availible and if +# they will be symlinked to and from sites-enabled. +# +# @param mod_enable_dir +# Set's whether the mods-enabled directory should be managed. +# +# @param ssl_file +# This parameter allows you to set an ssl.conf file to be managed in order to implement +# an SSL Certificate. +# +# @param file_e_tag +# Sets the server default for the `FileETag` declaration, which modifies the response header +# field for static files. +# +# @param use_optional_includes +# Specifies whether Apache uses the `IncludeOptional` directive instead of `Include` for +# `additional_includes` in Apache 2.4 or newer. +# +# @param mime_types_additional +# Specifies any idditional Internet media (mime) types that you wish to be configured. +# +class apache ( + $apache_name = $apache::params::apache_name, + $service_name = $apache::params::service_name, + $default_mods = true, + Boolean $default_vhost = true, + $default_charset = undef, + Boolean $default_confd_files = true, + Boolean $default_ssl_vhost = false, + $default_ssl_cert = $apache::params::default_ssl_cert, + $default_ssl_key = $apache::params::default_ssl_key, + $default_ssl_chain = undef, + $default_ssl_ca = undef, + $default_ssl_crl_path = undef, + $default_ssl_crl = undef, + $default_ssl_crl_check = undef, + Boolean $default_ssl_reload_on_change = false, + $default_type = 'none', + $dev_packages = $apache::params::dev_packages, + $ip = undef, + Boolean $service_enable = true, + Boolean $service_manage = true, + $service_ensure = 'running', + $service_restart = undef, + $purge_configs = true, + $purge_vhost_dir = undef, + $purge_vdir = false, + $serveradmin = 'root@localhost', + Enum['On', 'Off', 'on', 'off'] $sendfile = 'On', + $ldap_verify_server_cert = undef, + $ldap_trusted_mode = undef, + $error_documents = false, + $timeout = '60', + $httpd_dir = $apache::params::httpd_dir, + $server_root = $apache::params::server_root, + $conf_dir = $apache::params::conf_dir, + $confd_dir = $apache::params::confd_dir, + Enum['Off', 'On', 'Double', 'off', 'on', 'double'] $hostname_lookups = $apache::params::hostname_lookups, + $conf_enabled = $apache::params::conf_enabled, + $vhost_dir = $apache::params::vhost_dir, + $vhost_enable_dir = $apache::params::vhost_enable_dir, + $mod_libs = $apache::params::mod_libs, + $mod_packages = $apache::params::mod_packages, + $vhost_include_pattern = $apache::params::vhost_include_pattern, + $mod_dir = $apache::params::mod_dir, + $mod_enable_dir = $apache::params::mod_enable_dir, + $mpm_module = $apache::params::mpm_module, + $lib_path = $apache::params::lib_path, + $conf_template = $apache::params::conf_template, + $servername = $apache::params::servername, + $pidfile = $apache::params::pidfile, + Optional[Stdlib::Absolutepath] $rewrite_lock = undef, + Boolean $manage_user = true, + Boolean $manage_group = true, + $user = $apache::params::user, + $group = $apache::params::group, + $http_protocol_options = $apache::params::http_protocol_options, + $supplementary_groups = [], + $keepalive = $apache::params::keepalive, + $keepalive_timeout = $apache::params::keepalive_timeout, + $max_keepalive_requests = $apache::params::max_keepalive_requests, + $limitreqfieldsize = '8190', + $limitreqfields = '100', + $logroot = $apache::params::logroot, + $logroot_mode = $apache::params::logroot_mode, + Apache::LogLevel $log_level = $apache::params::log_level, + $log_formats = {}, + $ssl_file = undef, + $ports_file = $apache::params::ports_file, + $docroot = $apache::params::docroot, + $apache_version = $apache::version::default, + $server_tokens = 'Prod', + $server_signature = 'On', + $trace_enable = 'On', + Optional[Enum['on', 'off', 'nodecode']] $allow_encoded_slashes = undef, + $file_e_tag = undef, + Optional[Enum['On', 'on', 'Off', 'off', 'DNS', 'dns']] + $use_canonical_name = undef, + $package_ensure = 'installed', + Boolean $use_optional_includes = $apache::params::use_optional_includes, + $use_systemd = $apache::params::use_systemd, + $mime_types_additional = $apache::params::mime_types_additional, + $file_mode = $apache::params::file_mode, + $root_directory_options = $apache::params::root_directory_options, + Boolean $root_directory_secured = false, + $error_log = $apache::params::error_log, + $scriptalias = $apache::params::scriptalias, + $access_log_file = $apache::params::access_log_file, + Array[Enum['h2', 'h2c', 'http/1.1']] $protocols = [], + Optional[Boolean] $protocols_honor_order = undef, +) inherits ::apache::params { + $valid_mpms_re = $apache_version ? { + '2.4' => '(event|itk|peruser|prefork|worker)', + default => '(event|itk|prefork|worker)' + } + + if $::osfamily == 'RedHat' and $facts['operatingsystemmajrelease'] == '7' { + # On redhat 7 the ssl.conf lives in /etc/httpd/conf.d (the confd_dir) + # when all other module configs live in /etc/httpd/conf.modules.d (the + # mod_dir). On all other platforms and versions, ssl.conf lives in the + # mod_dir. This should maintain the expected location of ssl.conf + $_ssl_file = $ssl_file ? { + undef => "${apache::confd_dir}/ssl.conf", + default => $ssl_file + } + } else { + $_ssl_file = $ssl_file ? { + undef => "${apache::mod_dir}/ssl.conf", + default => $ssl_file + } + } + + if $mpm_module and $mpm_module != 'false' { # lint:ignore:quoted_booleans + assert_type(Pattern[$valid_mpms_re], $mpm_module) + } + + # NOTE: on FreeBSD it's mpm module's responsibility to install httpd package. + # NOTE: the same strategy may be introduced for other OSes. For this, you + # should delete the 'if' block below and modify all MPM modules' manifests + # such that they include apache::package class (currently event.pp, itk.pp, + # peruser.pp, prefork.pp, worker.pp). + if $::osfamily != 'FreeBSD' { + package { 'httpd': + ensure => $package_ensure, + name => $apache_name, + notify => Class['Apache::Service'], + } + } + + # declare the web server user and group + # Note: requiring the package means the package ought to create them and not puppet + if $manage_user { + user { $user: + ensure => present, + gid => $group, + groups => $supplementary_groups, + require => Package['httpd'], + } + } + if $manage_group { + group { $group: + ensure => present, + require => Package['httpd'], + } + } + + class { 'apache::service': + service_name => $service_name, + service_enable => $service_enable, + service_manage => $service_manage, + service_ensure => $service_ensure, + service_restart => $service_restart, + } + + # Deprecated backwards-compatibility + if $purge_vdir { + warning('Class[\'apache\'] parameter purge_vdir is deprecated in favor of purge_configs') + $purge_confd = $purge_vdir + } else { + $purge_confd = $purge_configs + } + + # Set purge vhostd appropriately + if $purge_vhost_dir == undef { + $purge_vhostd = $purge_confd + } else { + $purge_vhostd = $purge_vhost_dir + } + + Exec { + path => '/bin:/sbin:/usr/bin:/usr/sbin', + } + + exec { "mkdir ${confd_dir}": + creates => $confd_dir, + require => Package['httpd'], + } + file { $confd_dir: + ensure => directory, + recurse => true, + purge => $purge_confd, + force => $purge_confd, + notify => Class['Apache::Service'], + require => Package['httpd'], + } + + if $conf_enabled and ! defined(File[$conf_enabled]) { + file { $conf_enabled: + ensure => directory, + recurse => true, + purge => $purge_confd, + force => $purge_confd, + notify => Class['Apache::Service'], + require => Package['httpd'], + } + } + + if ! defined(File[$mod_dir]) { + exec { "mkdir ${mod_dir}": + creates => $mod_dir, + require => Package['httpd'], + } + # Don't purge available modules if an enable dir is used + $purge_mod_dir = $purge_configs and !$mod_enable_dir + file { $mod_dir: + ensure => directory, + recurse => true, + purge => $purge_mod_dir, + notify => Class['Apache::Service'], + require => Package['httpd'], + before => Anchor['::apache::modules_set_up'], + } + } + + if $mod_enable_dir and ! defined(File[$mod_enable_dir]) { + $mod_load_dir = $mod_enable_dir + exec { "mkdir ${mod_enable_dir}": + creates => $mod_enable_dir, + require => Package['httpd'], + } + file { $mod_enable_dir: + ensure => directory, + recurse => true, + purge => $purge_configs, + notify => Class['Apache::Service'], + require => Package['httpd'], + } + } else { + $mod_load_dir = $mod_dir + } + + if ! defined(File[$vhost_dir]) { + exec { "mkdir ${vhost_dir}": + creates => $vhost_dir, + require => Package['httpd'], + } + file { $vhost_dir: + ensure => directory, + recurse => true, + purge => $purge_vhostd, + notify => Class['Apache::Service'], + require => Package['httpd'], + } + } + + if $vhost_enable_dir and ! defined(File[$vhost_enable_dir]) { + $vhost_load_dir = $vhost_enable_dir + exec { "mkdir ${vhost_load_dir}": + creates => $vhost_load_dir, + require => Package['httpd'], + } + file { $vhost_enable_dir: + ensure => directory, + recurse => true, + purge => $purge_vhostd, + notify => Class['Apache::Service'], + require => Package['httpd'], + } + } else { + $vhost_load_dir = $vhost_dir + } + + concat { $ports_file: + ensure => present, + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + notify => Class['Apache::Service'], + require => Package['httpd'], + } + concat::fragment { 'Apache ports header': + target => $ports_file, + content => template('apache/ports_header.erb'), + } + + if $apache::conf_dir and $apache::params::conf_file { + if $::osfamily == 'gentoo' { + $error_documents_path = '/usr/share/apache2/error' + if $default_mods =~ Array { + if versioncmp($apache_version, '2.4') >= 0 { + if defined('apache::mod::ssl') { + ::portage::makeconf { 'apache2_modules': + content => concat($default_mods, ['authz_core', 'socache_shmcb']), + } + } else { + ::portage::makeconf { 'apache2_modules': + content => concat($default_mods, 'authz_core'), + } + } + } else { + ::portage::makeconf { 'apache2_modules': + content => $default_mods, + } + } + } + + file { [ + '/etc/apache2/modules.d/.keep_www-servers_apache-2', + '/etc/apache2/vhosts.d/.keep_www-servers_apache-2', + ]: + ensure => absent, + require => Package['httpd'], + } + } + + $apxs_workaround = $::osfamily ? { + 'freebsd' => true, + default => false + } + + # Template uses: + # - $pidfile + # - $user + # - $group + # - $logroot + # - $error_log + # - $sendfile + # - $mod_dir + # - $ports_file + # - $confd_dir + # - $vhost_dir + # - $error_documents + # - $error_documents_path + # - $apxs_workaround + # - $http_protocol_options + # - $keepalive + # - $keepalive_timeout + # - $max_keepalive_requests + # - $server_root + # - $server_tokens + # - $server_signature + # - $trace_enable + # - $rewrite_lock + # - $root_directory_secured + file { "${apache::conf_dir}/${apache::params::conf_file}": + ensure => file, + mode => $apache::file_mode, + content => template($conf_template), + notify => Class['Apache::Service'], + require => [Package['httpd'], Concat[$ports_file]], + } + + # preserve back-wards compatibility to the times when default_mods was + # only a boolean value. Now it can be an array (too) + if $default_mods =~ Array { + class { 'apache::default_mods': + all => false, + mods => $default_mods, + } + } else { + class { 'apache::default_mods': + all => $default_mods, + } + } + class { 'apache::default_confd_files': + all => $default_confd_files, + } + if $mpm_module and $mpm_module != 'false' { # lint:ignore:quoted_booleans + include "::apache::mod::${mpm_module}" + } + + $default_vhost_ensure = $default_vhost ? { + true => 'present', + false => 'absent' + } + $default_ssl_vhost_ensure = $default_ssl_vhost ? { + true => 'present', + false => 'absent' + } + + ::apache::vhost { 'default': + ensure => $default_vhost_ensure, + port => '80', + docroot => $docroot, + scriptalias => $scriptalias, + serveradmin => $serveradmin, + access_log_file => $access_log_file, + priority => '15', + ip => $ip, + logroot_mode => $logroot_mode, + manage_docroot => $default_vhost, + use_servername_for_filenames => true, + use_port_for_filenames => true, + } + $ssl_access_log_file = $::osfamily ? { + 'freebsd' => $access_log_file, + default => "ssl_${access_log_file}", + } + ::apache::vhost { 'default-ssl': + ensure => $default_ssl_vhost_ensure, + port => '443', + ssl => true, + docroot => $docroot, + scriptalias => $scriptalias, + serveradmin => $serveradmin, + access_log_file => $ssl_access_log_file, + priority => '15', + ip => $ip, + logroot_mode => $logroot_mode, + manage_docroot => $default_ssl_vhost, + use_servername_for_filenames => true, + use_port_for_filenames => true, + } + } + + # This anchor can be used as a reference point for things that need to happen *after* + # all modules have been put in place. + anchor { '::apache::modules_set_up': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/listen.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/listen.pp new file mode 100644 index 000000000..3eb60baad --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/listen.pp @@ -0,0 +1,15 @@ +# @summary +# Adds `Listen` directives to `ports.conf` that define the +# Apache server's or a virtual host's listening address and port. +# +# The `apache::vhost` class uses this defined type, and titles take the form +# ``, `:`, or `:`. +define apache::listen { + $listen_addr_port = $name + + # Template uses: $listen_addr_port + concat::fragment { "Listen ${listen_addr_port}": + target => $apache::ports_file, + content => template('apache/listen.erb'), + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod.pp new file mode 100644 index 000000000..0f7105d63 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod.pp @@ -0,0 +1,210 @@ +# @summary +# Installs packages for an Apache module that doesn't have a corresponding +# `apache::mod::` class. +# +# Checks for or places the module's default configuration files in the Apache server's +# `module` and `enable` directories. The default locations depend on your operating system. +# +# @param package +# **Required**.
+# Names the package Puppet uses to install the Apache module. +# +# @param package_ensure +# Determines whether Puppet ensures the Apache module should be installed. +# +# @param lib +# Defines the module's shared object name. Do not configure manually without special reason. +# +# @param lib_path +# Specifies a path to the module's libraries. Do not manually set this parameter +# without special reason. The `path` parameter overrides this value. +# +# @param loadfile_name +# Sets the filename for the module's `LoadFile` directive, which can also set +# the module load order as Apache processes them in alphanumeric order. +# +# @param id +# Specifies the package id +# +# @param loadfiles +# Specifies an array of `LoadFile` directives. +# +# @param path +# Specifies a path to the module. Do not manually set this parameter without a special reason. +# +define apache::mod ( + $package = undef, + $package_ensure = 'present', + $lib = undef, + $lib_path = $apache::lib_path, + $id = undef, + $path = undef, + $loadfile_name = undef, + $loadfiles = undef, +) { + if ! defined(Class['apache']) { + fail('You must include the apache base class before using any apache defined resources') + } + + $mod = $name + #include apache #This creates duplicate resources in rspec-puppet + $mod_dir = $apache::mod_dir + + # Determine if we have special lib + $mod_libs = $apache::mod_libs + if $lib { + $_lib = $lib + } elsif has_key($mod_libs, $mod) { # 2.6 compatibility hack + $_lib = $mod_libs[$mod] + } else { + $_lib = "mod_${mod}.so" + } + + # Determine if declaration specified a path to the module + if $path { + $_path = $path + } else { + $_path = "${lib_path}/${_lib}" + } + + if $id { + $_id = $id + } else { + $_id = "${mod}_module" + } + + if $loadfile_name { + $_loadfile_name = $loadfile_name + } else { + $_loadfile_name = "${mod}.load" + } + + # Determine if we have a package + $mod_packages = $apache::mod_packages + if $package { + $_package = $package + } elsif has_key($mod_packages, $mod) { # 2.6 compatibility hack + if ($apache::apache_version == '2.4' and $::operatingsystem =~ /^[Aa]mazon$/ and $::operatingsystemmajrelease != '2') { + # On amazon linux we need to prefix our package name with mod24 instead of mod to support apache 2.4 + $_package = regsubst($mod_packages[$mod],'^(mod_)?(.*)','mod24_\2') + } else { + $_package = $mod_packages[$mod] + } + } else { + $_package = undef + } + if $_package and ! defined(Package[$_package]) { + # note: FreeBSD/ports uses apxs tool to activate modules; apxs clutters + # httpd.conf with 'LoadModule' directives; here, by proper resource + # ordering, we ensure that our version of httpd.conf is reverted after + # the module gets installed. + $package_before = $::osfamily ? { + 'freebsd' => [ + File[$_loadfile_name], + File["${apache::conf_dir}/${apache::params::conf_file}"] + ], + default => [ + File[$_loadfile_name], + File[$apache::confd_dir], + ], + } + # if there are any packages, they should be installed before the associated conf file + Package[$_package] -> File<| title == "${mod}.conf" |> + # $_package may be an array + package { $_package: + ensure => $package_ensure, + require => Package['httpd'], + before => $package_before, + notify => Class['apache::service'], + } + } + + file { $_loadfile_name: + ensure => file, + path => "${mod_dir}/${_loadfile_name}", + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + content => template('apache/mod/load.erb'), + require => [ + Package['httpd'], + Exec["mkdir ${mod_dir}"], + ], + before => File[$mod_dir], + notify => Class['apache::service'], + } + + if $::osfamily == 'Debian' { + $enable_dir = $apache::mod_enable_dir + file { "${_loadfile_name} symlink": + ensure => link, + path => "${enable_dir}/${_loadfile_name}", + target => "${mod_dir}/${_loadfile_name}", + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + require => [ + File[$_loadfile_name], + Exec["mkdir ${enable_dir}"], + ], + before => File[$enable_dir], + notify => Class['apache::service'], + } + # Each module may have a .conf file as well, which should be + # defined in the class apache::mod::module + # Some modules do not require this file. + if defined(File["${mod}.conf"]) { + file { "${mod}.conf symlink": + ensure => link, + path => "${enable_dir}/${mod}.conf", + target => "${mod_dir}/${mod}.conf", + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + require => [ + File["${mod}.conf"], + Exec["mkdir ${enable_dir}"], + ], + before => File[$enable_dir], + notify => Class['apache::service'], + } + } + } elsif $::osfamily == 'Suse' { + $enable_dir = $apache::mod_enable_dir + file { "${_loadfile_name} symlink": + ensure => link, + path => "${enable_dir}/${_loadfile_name}", + target => "${mod_dir}/${_loadfile_name}", + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + require => [ + File[$_loadfile_name], + Exec["mkdir ${enable_dir}"], + ], + before => File[$enable_dir], + notify => Class['apache::service'], + } + # Each module may have a .conf file as well, which should be + # defined in the class apache::mod::module + # Some modules do not require this file. + if defined(File["${mod}.conf"]) { + file { "${mod}.conf symlink": + ensure => link, + path => "${enable_dir}/${mod}.conf", + target => "${mod_dir}/${mod}.conf", + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + require => [ + File["${mod}.conf"], + Exec["mkdir ${enable_dir}"], + ], + before => File[$enable_dir], + notify => Class['apache::service'], + } + } + } + + Apache::Mod[$name] -> Anchor['::apache::modules_set_up'] +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/actions.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/actions.pp new file mode 100644 index 000000000..c9b7d15d6 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/actions.pp @@ -0,0 +1,8 @@ +# @summary +# Installs Apache mod_actions +# +# @see https://httpd.apache.org/docs/current/mod/mod_actions.html for additional documentation. +# +class apache::mod::actions { + apache::mod { 'actions': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/alias.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/alias.pp new file mode 100644 index 000000000..58ab0bdf8 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/alias.pp @@ -0,0 +1,46 @@ +# @summary +# Installs and configures `mod_alias`. +# +# @param apache_version +# The version of Apache, if not set will be retrieved from the init class. +# +# @param icons_options +# Disables directory listings for the icons directory, via Apache [Options](https://httpd.apache.org/docs/current/mod/core.html#options) +# directive. +# +# @param icons_path +# Sets the local path for an /icons/ Alias. Default depends on operating system: +# - Debian: /usr/share/apache2/icons +# - FreeBSD: /usr/local/www/apache24/icons +# - Gentoo: /var/www/icons +# - Red Hat: /var/www/icons, except on Apache 2.4, where it's /usr/share/httpd/icons +# +# @param icons_path +# Change the alias for /icons/. +# +# @see https://httpd.apache.org/docs/current/mod/mod_alias.html for additional documentation. +# +class apache::mod::alias ( + $apache_version = undef, + $icons_options = 'Indexes MultiViews', + # set icons_path to false to disable the alias + $icons_path = $apache::params::alias_icons_path, + $icons_prefix = $apache::params::icons_prefix +) inherits ::apache::params { + include apache + $_apache_version = pick($apache_version, $apache::apache_version) + apache::mod { 'alias': } + + # Template uses $icons_path, $_apache_version + if $icons_path { + file { 'alias.conf': + ensure => file, + path => "${apache::mod_dir}/alias.conf", + mode => $apache::file_mode, + content => template('apache/mod/alias.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/apreq2.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/apreq2.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/apreq2.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/apreq2.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_basic.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_basic.pp new file mode 100644 index 000000000..cb2d1313c --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_basic.pp @@ -0,0 +1,8 @@ +# @summary +# Installs `mod_auth_basic` +# +# @see https://httpd.apache.org/docs/current/mod/mod_auth_basic.html for additional documentation. +# +class apache::mod::auth_basic { + ::apache::mod { 'auth_basic': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_cas.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_cas.pp new file mode 100644 index 000000000..51e7d2c08 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_cas.pp @@ -0,0 +1,136 @@ +# @summary +# Installs and configures `mod_auth_cas`. +# +# @param cas_login_url +# Sets the URL to which the module redirects users when they attempt to access a +# CAS-protected resource and don't have an active session. +# +# @param cas_validate_url +# Sets the URL to use when validating a client-presented ticket in an HTTP query string. +# +# @param cas_cookie_path +# Sets the location where information on the current session should be stored. This should +# be writable by the web server only. +# +# @param cas_cookie_path_mode +# The mode of cas_cookie_path. +# +# @param cas_version +# The version of the CAS protocol to adhere to. +# +# @param cas_debug +# Whether to enable or disable debug mode. +# +# @param cas_validate_server +# Whether to validate the presented certificate. This has been deprecated and +# removed from Version 1.1-RC1 onward. +# +# @param cas_validatedepth +# The maximum depth for chained certificate validation. +# +# @param cas_proxy_validate_url +# The URL to use when performing a proxy validation. +# +# @param cas_root_proxied_as +# Sets the URL end users see when access to this Apache server is proxied per vhost. +# This URL should not include a trailing slash. +# +# @param cas_cookie_entropy +# When creating a local session, this many random bytes are used to create a unique +# session identifier. +# +# @param cas_timeout +# The hard limit, in seconds, for a mod_auth_cas session. +# +# @param cas_idle_timeout +# The limit, in seconds, of how long a mod_auth_cas session can be idle. +# +# @param cas_cache_clean_interval +# The minimum amount of time that must pass inbetween cache cleanings. +# +# @param cas_cookie_domain +# The value for the 'Domain=' parameter in the Set-Cookie header. +# +# @param cas_cookie_http_only +# Setting this flag prevents the mod_auth_cas cookies from being accessed by +# client side Javascript. +# +# @param cas_authoritative +# Determines whether an optional authorization directive is authoritative and thus binding. +# +# @param cas_validate_saml +# Parse response from CAS server for SAML. +# +# @param cas_sso_enabled +# Enables experimental support for single sign out (may mangle POST data). +# +# @param cas_attribute_prefix +# Adds a header with the value of this header being the attribute values when SAML +# validation is enabled. +# +# @param cas_attribute_delimiter +# Sets the delimiter between attribute values in the header created by `cas_attribute_prefix`. +# +# @param cas_scrub_request_headers +# Remove inbound request headers that may have special meaning within mod_auth_cas. +# +# @param suppress_warning +# Suppress warning about being on RedHat (mod_auth_cas package is now available in epel-testing repo). +# +# @note The auth_cas module isn't available on RH/CentOS without providing dependency packages provided by EPEL. +# +# @see https://github.com/apereo/mod_auth_cas for additional documentation. +# +class apache::mod::auth_cas ( + String $cas_login_url, + String $cas_validate_url, + String $cas_cookie_path = $apache::params::cas_cookie_path, + $cas_cookie_path_mode = '0750', + $cas_version = 2, + $cas_debug = 'Off', + $cas_validate_server = undef, + $cas_validate_depth = undef, + $cas_certificate_path = undef, + $cas_proxy_validate_url = undef, + $cas_root_proxied_as = undef, + $cas_cookie_entropy = undef, + $cas_timeout = undef, + $cas_idle_timeout = undef, + $cas_cache_clean_interval = undef, + $cas_cookie_domain = undef, + $cas_cookie_http_only = undef, + $cas_authoritative = undef, + $cas_validate_saml = undef, + $cas_sso_enabled = undef, + $cas_attribute_prefix = undef, + $cas_attribute_delimiter = undef, + $cas_scrub_request_headers = undef, + $suppress_warning = false, +) inherits ::apache::params { + if $::osfamily == 'RedHat' and ! $suppress_warning { + warning('RedHat distributions do not have Apache mod_auth_cas in their default package repositories.') + } + + include apache + ::apache::mod { 'auth_cas': } + + file { $cas_cookie_path: + ensure => directory, + before => File['auth_cas.conf'], + mode => $cas_cookie_path_mode, + owner => $apache::user, + group => $apache::group, + } + + # Template uses + # - All variables beginning with cas_ + file { 'auth_cas.conf': + ensure => file, + path => "${apache::mod_dir}/auth_cas.conf", + mode => $apache::file_mode, + content => template('apache/mod/auth_cas.conf.erb'), + require => [Exec["mkdir ${apache::mod_dir}"],], + before => File[$apache::mod_dir], + notify => Class['Apache::Service'], + } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/auth_gssapi.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_gssapi.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/auth_gssapi.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_gssapi.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_kerb.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_kerb.pp new file mode 100644 index 000000000..093c26d22 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_kerb.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_auth_kerb` +# +# @see http://modauthkerb.sourceforge.net for additional documentation. +class apache::mod::auth_kerb { + include apache + include apache::mod::authn_core + ::apache::mod { 'auth_kerb': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_mellon.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_mellon.pp new file mode 100644 index 000000000..d585aed64 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_mellon.pp @@ -0,0 +1,50 @@ +# @summary +# Installs and configures `mod_auth_mellon`. +# +# @param mellon_cache_size +# Maximum number of sessions which can be active at once. +# +# @param mellon_lock_file +# Full path to a file used for synchronizing access to the session data. +# +# @param mellon_post_directory +# Full path of a directory where POST requests are saved during authentication. +# +# @param mellon_cache_entry_size +# Maximum size for a single session entry in bytes. +# +# @param mellon_post_ttl +# Delay in seconds before a saved POST request can be flushed. +# +# @param mellon_post_size +# Maximum size for saved POST requests. +# +# @param mellon_post_count +# Maximum amount of saved POST requests. +# +# @see https://github.com/Uninett/mod_auth_mellon for additional documentation. +# +class apache::mod::auth_mellon ( + $mellon_cache_size = $apache::params::mellon_cache_size, + $mellon_lock_file = $apache::params::mellon_lock_file, + $mellon_post_directory = $apache::params::mellon_post_directory, + $mellon_cache_entry_size = undef, + $mellon_post_ttl = undef, + $mellon_post_size = undef, + $mellon_post_count = undef +) inherits ::apache::params { + include apache + ::apache::mod { 'auth_mellon': } + + # Template uses + # - All variables beginning with mellon_ + file { 'auth_mellon.conf': + ensure => file, + path => "${apache::mod_dir}/auth_mellon.conf", + mode => $apache::file_mode, + content => template('apache/mod/auth_mellon.conf.erb'), + require => [Exec["mkdir ${apache::mod_dir}"],], + before => File[$apache::mod_dir], + notify => Class['Apache::Service'], + } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/auth_openidc.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_openidc.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/auth_openidc.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/auth_openidc.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authn_core.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authn_core.pp new file mode 100644 index 000000000..f145982e2 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authn_core.pp @@ -0,0 +1,15 @@ +# @summary +# Installs `mod_authn_core`. +# +# @param apache_version +# The version of apache being run. +# +# @see https://httpd.apache.org/docs/current/mod/mod_authn_core.html for additional documentation. +# +class apache::mod::authn_core ( + $apache_version = $apache::apache_version +) { + if versioncmp($apache_version, '2.4') >= 0 { + ::apache::mod { 'authn_core': } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authn_dbd.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authn_dbd.pp new file mode 100644 index 000000000..b5e8d2c91 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authn_dbd.pp @@ -0,0 +1,59 @@ +# @summary +# Installs `mod_authn_dbd`. +# +# @param authn_dbd_params +# The params needed for the mod to function. +# +# @param authn_dbd_dbdriver +# Selects an apr_dbd driver by name. +# +# @param authn_dbd_query +# +# @param authn_dbd_min +# Set the minimum number of connections per process. +# +# @param authn_dbd_max +# Set the maximum number of connections per process. +# +# @param authn_dbd_keep +# Set the maximum number of connections per process to be sustained. +# +# @param authn_dbd_exptime +# Set the time to keep idle connections alive when the number of +# connections specified in DBDKeep has been exceeded. +# +# @param authn_dbd_alias +# Sets an alias for `AuthnProvider. +# +# @see https://httpd.apache.org/docs/current/mod/mod_authn_dbd.html for additional documentation. +# +class apache::mod::authn_dbd ( + $authn_dbd_params, + $authn_dbd_dbdriver = 'mysql', + $authn_dbd_query = undef, + $authn_dbd_min = '4', + $authn_dbd_max = '20', + $authn_dbd_keep = '8', + $authn_dbd_exptime = '300', + $authn_dbd_alias = undef, +) inherits ::apache::params { + include apache + include apache::mod::dbd + ::apache::mod { 'authn_dbd': } + + if $authn_dbd_alias { + include apache::mod::authn_core + } + + # Template uses + # - All variables beginning with authn_dbd + file { 'authn_dbd.conf': + ensure => file, + path => "${apache::mod_dir}/authn_dbd.conf", + mode => $apache::file_mode, + content => template('apache/mod/authn_dbd.conf.erb'), + require => [Exec["mkdir ${apache::mod_dir}"],], + before => File[$apache::mod_dir], + notify => Class['Apache::Service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authn_file.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authn_file.pp new file mode 100644 index 000000000..141804507 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authn_file.pp @@ -0,0 +1,8 @@ +# @summary +# Installs `mod_authn_file`. +# +# @see https://httpd.apache.org/docs/2.4/mod/mod_authn_file.html for additional documentation. +# +class apache::mod::authn_file { + ::apache::mod { 'authn_file': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authnz_ldap.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authnz_ldap.pp new file mode 100644 index 000000000..3f194d736 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authnz_ldap.pp @@ -0,0 +1,33 @@ +# @summary +# Installs `mod_authnz_ldap`. +# +# @param verify_server_cert +# Whether to force te verification of a server cert or not. +# +# @param package_name +# The name of the ldap package. +# +# @see https://httpd.apache.org/docs/current/mod/mod_authnz_ldap.html for additional documentation. +# @note Unsupported platforms: RedHat: 6, 8; CentOS: 6, 8; OracleLinux: 6, 8; Ubuntu: all; Debian: all; SLES: all +class apache::mod::authnz_ldap ( + Boolean $verify_server_cert = true, + $package_name = undef, +) { + include apache + include 'apache::mod::ldap' + ::apache::mod { 'authnz_ldap': + package => $package_name, + } + + # Template uses: + # - $verify_server_cert + file { 'authnz_ldap.conf': + ensure => file, + path => "${apache::mod_dir}/authnz_ldap.conf", + mode => $apache::file_mode, + content => template('apache/mod/authnz_ldap.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authnz_pam.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authnz_pam.pp new file mode 100644 index 000000000..35ddb779e --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authnz_pam.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_authnz_pam`. +# +# @see https://www.adelton.com/apache/mod_authnz_pam for additional documentation. +# +class apache::mod::authnz_pam { + include apache + ::apache::mod { 'authnz_pam': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authz_default.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authz_default.pp new file mode 100644 index 000000000..540d086ab --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authz_default.pp @@ -0,0 +1,17 @@ +# @summary +# Installs and configures `mod_authz_default`. +# +# @param apache_version +# Version of Apache to install module on. +# +# @see https://httpd.apache.org/docs/current/mod/mod_authz_default.html for additional documentation. +# +class apache::mod::authz_default ( + $apache_version = $apache::apache_version +) { + if versioncmp($apache_version, '2.4') >= 0 { + warning('apache::mod::authz_default has been removed in Apache 2.4') + } else { + ::apache::mod { 'authz_default': } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authz_user.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authz_user.pp new file mode 100644 index 000000000..81bdf5f31 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/authz_user.pp @@ -0,0 +1,8 @@ +# @summary +# Installs `mod_authz_user` +# +# @see https://httpd.apache.org/docs/current/mod/mod_authz_user.html for additional documentation. +# +class apache::mod::authz_user { + ::apache::mod { 'authz_user': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/autoindex.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/autoindex.pp new file mode 100644 index 000000000..e3215540a --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/autoindex.pp @@ -0,0 +1,31 @@ +# @summary +# Installs `mod_autoindex` +# +# @see https://httpd.apache.org/docs/current/mod/mod_autoindex.html for additional documentation. +# +class apache::mod::autoindex ( + $icons_prefix = $apache::params::icons_prefix +) inherits ::apache::params { + include apache + ::apache::mod { 'autoindex': } + + # Determine icon filename suffix for autoindex.conf.erb + case $::operatingsystem { + 'Debian', 'Ubuntu': { + $icon_suffix = '-20x22' + } + default: { + $icon_suffix = '' + } + } + + file { 'autoindex.conf': + ensure => file, + path => "${apache::mod_dir}/autoindex.conf", + mode => $apache::file_mode, + content => template('apache/mod/autoindex.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cache.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cache.pp new file mode 100644 index 000000000..a822ae9aa --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cache.pp @@ -0,0 +1,8 @@ +# @summary +# Installs `mod_cache` +# +# @see https://httpd.apache.org/docs/current/mod/mod_cache.html for additional documentation. +# +class apache::mod::cache { + ::apache::mod { 'cache': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cgi.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cgi.pp new file mode 100644 index 000000000..c11ea7fc9 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cgi.pp @@ -0,0 +1,28 @@ +# @summary +# Installs `mod_cgi`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_cgi.html for additional documentation. +# +class apache::mod::cgi { + include apache + case $::osfamily { + 'FreeBSD': {} + default: { + if defined(Class['::apache::mod::itk']) { + Class['::apache::mod::itk'] -> Class['::apache::mod::cgi'] + } elsif defined(Class['::apache::mod::peruser']) { + Class['::apache::mod::peruser'] -> Class['::apache::mod::cgi'] + } else { + Class['::apache::mod::prefork'] -> Class['::apache::mod::cgi'] + } + } + } + + if $::osfamily == 'Suse' { + ::apache::mod { 'cgi': + lib_path => '/usr/lib64/apache2-prefork', + } + } else { + ::apache::mod { 'cgi': } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cgid.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cgid.pp new file mode 100644 index 000000000..e40af45b4 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cgid.pp @@ -0,0 +1,47 @@ +# @summary +# Installs `mod_cgid`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_cgid.html +# +class apache::mod::cgid { + include apache + case $::osfamily { + 'FreeBSD': {} + default: { + if defined(Class['::apache::mod::event']) { + Class['::apache::mod::event'] -> Class['::apache::mod::cgid'] + } else { + Class['::apache::mod::worker'] -> Class['::apache::mod::cgid'] + } + } + } + + # Debian specifies it's cgid sock path, but RedHat uses the default value + # with no config file + $cgisock_path = $::osfamily ? { + 'debian' => "\${APACHE_RUN_DIR}/cgisock", + 'freebsd' => 'cgisock', + default => undef, + } + + if $::osfamily == 'Suse' { + ::apache::mod { 'cgid': + lib_path => '/usr/lib64/apache2-worker', + } + } else { + ::apache::mod { 'cgid': } + } + + if $cgisock_path { + # Template uses $cgisock_path + file { 'cgid.conf': + ensure => file, + path => "${apache::mod_dir}/cgid.conf", + mode => $apache::file_mode, + content => template('apache/mod/cgid.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cluster.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cluster.pp new file mode 100644 index 000000000..9b827f763 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/cluster.pp @@ -0,0 +1,87 @@ +# @summary +# Installs `mod_cluster`. +# +# @param allowed_network +# Balanced members network. +# +# @param balancer_name +# Name of balancer. +# +# @param ip +# Specifies the IP address to listen to. +# +# @param version +# Specifies the mod_cluster version. Version 1.3.0 or greater is required for httpd 2.4. +# +# @param enable_mcpm_receive +# Whether MCPM should be enabled. +# +# @param port +# mod_cluster listen port. +# +# @param keep_alive_timeout +# Specifies how long Apache should wait for a request, in seconds. +# +# @param manager_allowed_network +# Whether to allow the network to access the mod_cluster_manager. +# +# @param max_keep_alive_requests +# Maximum number of requests kept alive. +# +# @param server_advertise +# Whether the server should advertise. +# +# @param advertise_frequency +# Sets the interval between advertise messages in seconds. +# +# @example +# class { '::apache::mod::cluster': +# ip => '172.17.0.1', +# allowed_network => '172.17.0.', +# balancer_name => 'mycluster', +# version => '1.3.1' +# } +# +# @note +# There is no official package available for mod_cluster, so you must make it available outside of the apache module. +# Binaries can be found [here](https://modcluster.io/). +# +# @see https://modcluster.io/ for additional documentation. +# +class apache::mod::cluster ( + $allowed_network, + $balancer_name, + $ip, + $version, + $enable_mcpm_receive = true, + $port = '6666', + $keep_alive_timeout = 60, + $manager_allowed_network = '127.0.0.1', + $max_keep_alive_requests = 0, + $server_advertise = true, + $advertise_frequency = undef, +) { + include apache + + ::apache::mod { 'proxy': } + ::apache::mod { 'proxy_ajp': } + ::apache::mod { 'manager': } + ::apache::mod { 'proxy_cluster': } + ::apache::mod { 'advertise': } + + if (versioncmp($version, '1.3.0') >= 0 ) { + ::apache::mod { 'cluster_slotmem': } + } else { + ::apache::mod { 'slotmem': } + } + + file { 'cluster.conf': + ensure => file, + path => "${apache::mod_dir}/cluster.conf", + mode => $apache::file_mode, + content => template('apache/mod/cluster.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/data.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/data.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/data.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/data.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dav.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dav.pp new file mode 100644 index 000000000..616492705 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dav.pp @@ -0,0 +1,8 @@ +# @summary +# Installs `mod_dav`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_dav.html for additional documentation. +# +class apache::mod::dav { + ::apache::mod { 'dav': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dav_fs.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dav_fs.pp new file mode 100644 index 000000000..20fd5c015 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dav_fs.pp @@ -0,0 +1,27 @@ +# @summary +# Installs `mod_dav_fs`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_dav_fs.html for additional documentation. +# +class apache::mod::dav_fs { + include apache + $dav_lock = $::osfamily ? { + 'debian' => "\${APACHE_LOCK_DIR}/DAVLock", + 'freebsd' => '/usr/local/var/DavLock', + default => '/var/lib/dav/lockdb', + } + + Class['::apache::mod::dav'] -> Class['::apache::mod::dav_fs'] + ::apache::mod { 'dav_fs': } + + # Template uses: $dav_lock + file { 'dav_fs.conf': + ensure => file, + path => "${apache::mod_dir}/dav_fs.conf", + mode => $apache::file_mode, + content => template('apache/mod/dav_fs.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dav_svn.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dav_svn.pp new file mode 100644 index 000000000..4c04d1b35 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dav_svn.pp @@ -0,0 +1,32 @@ +# @summary +# Installs and configures `mod_dav_svn`. +# +# @param authz_svn_enabled +# Specifies whether to install Apache mod_authz_svn +# +# @see https://httpd.apache.org/docs/current/mod/mod_dav_svn.html for additional documentation. +# +class apache::mod::dav_svn ( + $authz_svn_enabled = false, +) { + Class['::apache::mod::dav'] -> Class['::apache::mod::dav_svn'] + include apache + include apache::mod::dav + if($::operatingsystem == 'SLES' and versioncmp($::operatingsystemmajrelease, '12') < 0) { + package { 'subversion-server': + ensure => 'installed', + provider => 'zypper', + } + } + + ::apache::mod { 'dav_svn': } + + if $authz_svn_enabled { + ::apache::mod { 'authz_svn': + # authz_svn depends on symbols from the dav_svn module, + # therefore, make sure authz_svn is loaded after dav_svn. + loadfile_name => 'dav_svn_authz_svn.load', + require => Apache::Mod['dav_svn'], + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dbd.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dbd.pp new file mode 100644 index 000000000..cdc9cdf6f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dbd.pp @@ -0,0 +1,11 @@ +# @summary +# Installs `mod_dbd`. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @see https://httpd.apache.org/docs/current/mod/mod_dbd.html for additional documentation. +# +class apache::mod::dbd { + ::apache::mod { 'dbd': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/deflate.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/deflate.pp new file mode 100644 index 000000000..777c2f888 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/deflate.pp @@ -0,0 +1,38 @@ +# @summary +# Installs and configures `mod_deflate`. +# +# @param types +# An array of MIME types to be deflated. See https://www.iana.org/assignments/media-types/media-types.xhtml. +# +# @param notes +# A Hash where the key represents the type and the value represents the note name. +# +# @see https://httpd.apache.org/docs/current/mod/mod_deflate.html for additional documentation. +# +class apache::mod::deflate ( + $types = [ + 'text/html text/plain text/xml', + 'text/css', + 'application/x-javascript application/javascript application/ecmascript', + 'application/rss+xml', + 'application/json', + ], + $notes = { + 'Input' => 'instream', + 'Output' => 'outstream', + 'Ratio' => 'ratio', + } +) { + include apache + ::apache::mod { 'deflate': } + + file { 'deflate.conf': + ensure => file, + path => "${apache::mod_dir}/deflate.conf", + mode => $apache::file_mode, + content => template('apache/mod/deflate.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dev.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dev.pp new file mode 100644 index 000000000..4039ff1fd --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dev.pp @@ -0,0 +1,11 @@ +# @summary +# Installs `mod_dev`. +# +# @note +# This module is deprecated. Please use `apache::dev`. +# +class apache::mod::dev { + # Development packages are not apache modules + warning('apache::mod::dev is deprecated; please use apache::dev') + include apache::dev +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dir.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dir.pp new file mode 100644 index 000000000..86f97a070 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dir.pp @@ -0,0 +1,34 @@ +# @summary +# Installs and configures `mod_dir`. +# +# @param types +# Specifies the text-based content types to compress. +# +# @param indexes +# Provides a string for the DirectoryIndex directive +# +# @todo +# This sets the global DirectoryIndex directive, so it may be necessary to consider being able to modify the apache::vhost to declare +# DirectoryIndex statements in a vhost configuration +# +# @see https://httpd.apache.org/docs/current/mod/mod_dir.html for additional documentation. +# +class apache::mod::dir ( + $dir = 'public_html', + Array[String] $indexes = ['index.html','index.html.var','index.cgi','index.pl','index.php','index.xhtml'], +) { + include apache + ::apache::mod { 'dir': } + + # Template uses + # - $indexes + file { 'dir.conf': + ensure => file, + path => "${apache::mod_dir}/dir.conf", + mode => $apache::file_mode, + content => template('apache/mod/dir.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/disk_cache.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/disk_cache.pp new file mode 100644 index 000000000..cb82b7b6b --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/disk_cache.pp @@ -0,0 +1,68 @@ +# @summary +# Installs and configures `mod_disk_cache`. +# +# @param cache_root +# Defines the name of the directory on the disk to contain cache files. +# Default depends on the Apache version and operating system: +# - Debian: /var/cache/apache2/mod_cache_disk +# - FreeBSD: /var/cache/mod_cache_disk +# - Red Hat, Apache 2.4: /var/cache/httpd/proxy +# - Red Hat, Apache 2.2: /var/cache/mod_proxy +# +# @param cache_ignore_headers +# Specifies HTTP header(s) that should not be stored in the cache. +# +# @param default_cache_enable +# Default value is true, which enables "CacheEnable disk /" in disk_cache.conf for the webserver. This would cache +# every request to apache by default for every vhost. If set to false the default cache all behaviour is supressed. +# You can then control this behaviour in individual vhosts by explicitly defining CacheEnable. +# +# @note +# Apache 2.2, mod_disk_cache installed. On Apache 2.4, mod_cache_disk installed. +# +# @see https://httpd.apache.org/docs/2.2/mod/mod_disk_cache.html for additional documentation. +# +class apache::mod::disk_cache ( + $cache_root = undef, + $cache_ignore_headers = undef, + Boolean $default_cache_enable = true, +) { + include apache + if $cache_root { + $_cache_root = $cache_root + } + elsif versioncmp($apache::apache_version, '2.4') >= 0 { + $_cache_root = $::osfamily ? { + 'debian' => '/var/cache/apache2/mod_cache_disk', + 'redhat' => '/var/cache/httpd/proxy', + 'freebsd' => '/var/cache/mod_cache_disk', + } + } + else { + $_cache_root = $::osfamily ? { + 'debian' => '/var/cache/apache2/mod_disk_cache', + 'redhat' => '/var/cache/mod_proxy', + 'freebsd' => '/var/cache/mod_disk_cache', + } + } + + if versioncmp($apache::apache_version, '2.4') >= 0 { + apache::mod { 'cache_disk': } + } + else { + apache::mod { 'disk_cache': } + } + + Class['::apache::mod::cache'] -> Class['::apache::mod::disk_cache'] + + # Template uses $_cache_root + file { 'disk_cache.conf': + ensure => file, + path => "${apache::mod_dir}/disk_cache.conf", + mode => $apache::file_mode, + content => template('apache/mod/disk_cache.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dumpio.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dumpio.pp new file mode 100644 index 000000000..df892a919 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/dumpio.pp @@ -0,0 +1,38 @@ +# @summary +# Installs and configures `mod_dumpio`. +# +# @param dump_io_input +# Dump all input data to the error log +# +# @param dump_io_output +# Dump all output data to the error log +# +# @example +# class{'apache': +# default_mods => false, +# log_level => 'dumpio:trace7', +# } +# class{'apache::mod::dumpio': +# dump_io_input => 'On', +# dump_io_output => 'Off', +# } +# +# @see https://httpd.apache.org/docs/current/mod/mod_dumpio.html for additional documentation. +# +class apache::mod::dumpio ( + Enum['Off', 'On', 'off', 'on'] $dump_io_input = 'Off', + Enum['Off', 'On', 'off', 'on'] $dump_io_output = 'Off', +) { + include apache + + ::apache::mod { 'dumpio': } + file { 'dumpio.conf': + ensure => file, + path => "${apache::mod_dir}/dumpio.conf", + mode => $apache::file_mode, + content => template('apache/mod/dumpio.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/env.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/env.pp new file mode 100644 index 000000000..2ca17a5e7 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/env.pp @@ -0,0 +1,8 @@ +# @summary +# Installs `mod_env`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_env.html for additional documentation. +# +class apache::mod::env { + ::apache::mod { 'env': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/event.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/event.pp new file mode 100644 index 000000000..402a8530e --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/event.pp @@ -0,0 +1,124 @@ +# @summary +# Installs and configures `mod_event`. +# +# @param startservers +# Sets the number of child server processes created at startup, via the module's `StartServers` directive. Setting this to `false` +# removes the parameter. +# +# @param maxclients +# Apache 2.3.12 or older alias for the `MaxRequestWorkers` directive. +# +# @param maxrequestworkers +# Sets the maximum number of connections Apache can simultaneously process, via the module's `MaxRequestWorkers` directive. Setting +# these to `false` removes the parameters. +# +# @param minsparethreads +# Sets the minimum number of idle threads, via the `MinSpareThreads` directive. Setting this to `false` removes the parameters. +# +# @param maxsparethreads +# Sets the maximum number of idle threads, via the `MaxSpareThreads` directive. Setting this to `false` removes the parameters. +# +# @param threadsperchild +# Number of threads created by each child process. +# +# @param maxrequestsperchild +# Apache 2.3.8 or older alias for the `MaxConnectionsPerChild` directive. +# +# @param maxconnectionsperchild +# Limit on the number of connections that an individual child server will handle during its life. +# +# @param serverlimit +# Limits the configurable number of processes via the `ServerLimit` directive. Setting this to `false` removes the parameter. +# +# @param apache_version +# Version of Apache to install module on. +# +# @param threadlimit +# Limits the number of event threads via the module's `ThreadLimit` directive. Setting this to `false` removes the parameter. +# +# @param listenbacklog +# Sets the maximum length of the pending connections queue via the module's `ListenBackLog` directive. Setting this to `false` removes +# the parameter. +# +# @note +# You cannot include apache::mod::event with apache::mod::itk, apache::mod::peruser, apache::mod::prefork, or +# apache::mod::worker on the same server. +# +# @see https://httpd.apache.org/docs/current/mod/event.html for additional documentation. +# @note Unsupported platforms: SLES: all +class apache::mod::event ( + $startservers = '2', + $maxclients = '150', + $maxrequestworkers = undef, + $minsparethreads = '25', + $maxsparethreads = '75', + $threadsperchild = '25', + $maxrequestsperchild = '0', + $maxconnectionsperchild = undef, + $serverlimit = '25', + $apache_version = undef, + $threadlimit = '64', + $listenbacklog = '511', +) { + include apache + + $_apache_version = pick($apache_version, $apache::apache_version) + + if defined(Class['apache::mod::itk']) { + fail('May not include both apache::mod::event and apache::mod::itk on the same node') + } + if defined(Class['apache::mod::peruser']) { + fail('May not include both apache::mod::event and apache::mod::peruser on the same node') + } + if defined(Class['apache::mod::prefork']) { + fail('May not include both apache::mod::event and apache::mod::prefork on the same node') + } + if defined(Class['apache::mod::worker']) { + fail('May not include both apache::mod::event and apache::mod::worker on the same node') + } + File { + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + } + + # Template uses: + # - $startservers + # - $maxclients + # - $minsparethreads + # - $maxsparethreads + # - $threadsperchild + # - $maxrequestsperchild + # - $serverlimit + file { "${apache::mod_dir}/event.conf": + ensure => file, + mode => $apache::file_mode, + content => template('apache/mod/event.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + + case $::osfamily { + 'redhat': { + if versioncmp($_apache_version, '2.4') >= 0 { + apache::mpm { 'event': + apache_version => $_apache_version, + } + } + } + 'debian','freebsd' : { + apache::mpm { 'event': + apache_version => $_apache_version, + } + } + 'gentoo': { + ::portage::makeconf { 'apache2_mpms': + content => 'event', + } + } + default: { + fail("Unsupported osfamily ${::osfamily}") + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/expires.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/expires.pp new file mode 100644 index 000000000..7a5bfddea --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/expires.pp @@ -0,0 +1,38 @@ +# @summary +# Installs and configures `mod_expires`. +# +# @param expires_active +# Enables generation of Expires headers. +# +# @param expires_default +# Specifies the default algorithm for calculating expiration time using ExpiresByType syntax or interval syntax. +# +# @param expires_by_type +# Describes a set of [MIME content-types](https://www.iana.org/assignments/media-types/media-types.xhtml) and their expiration +# times. This should be used as an array of Hashes, with each Hash's key a valid MIME content-type (i.e. 'text/json') and its +# value following valid interval syntax. +# +# @see https://httpd.apache.org/docs/current/mod/mod_expires.html for additional documentation. +# +class apache::mod::expires ( + $expires_active = true, + $expires_default = undef, + $expires_by_type = undef, +) { + include apache + ::apache::mod { 'expires': } + + # Template uses + # $expires_active + # $expires_default + # $expires_by_type + file { 'expires.conf': + ensure => file, + path => "${apache::mod_dir}/expires.conf", + mode => $apache::file_mode, + content => template('apache/mod/expires.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ext_filter.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ext_filter.pp new file mode 100644 index 000000000..d2a3d635e --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ext_filter.pp @@ -0,0 +1,38 @@ +# @summary +# Installs and configures `mod_ext_filter`. +# +# @param ext_filter_define +# Hash of filter names and their parameters. +# +# @example +# class { 'apache::mod::ext_filter': +# ext_filter_define => { +# 'slowdown' => 'mode=output cmd=/bin/cat preservescontentlength', +# 'puppetdb-strip' => 'mode=output outtype=application/json cmd="pdb-resource-filter"', +# }, +# } +# +# @see https://httpd.apache.org/docs/current/mod/mod_ext_filter.html for additional documentation. +# +class apache::mod::ext_filter ( + Optional[Hash] $ext_filter_define = undef +) { + include apache + + ::apache::mod { 'ext_filter': } + + # Template uses + # -$ext_filter_define + + if $ext_filter_define { + file { 'ext_filter.conf': + ensure => file, + path => "${apache::mod_dir}/ext_filter.conf", + mode => $apache::file_mode, + content => template('apache/mod/ext_filter.conf.erb'), + require => [Exec["mkdir ${apache::mod_dir}"],], + before => File[$apache::mod_dir], + notify => Class['Apache::Service'], + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/fastcgi.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/fastcgi.pp new file mode 100644 index 000000000..a3445c917 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/fastcgi.pp @@ -0,0 +1,35 @@ +# @summary +# Installs `mod_fastcgi`. +# +# @see https://github.com/FastCGI-Archives/mod_fastcgi for additional documentation. +# +class apache::mod::fastcgi { + include apache + if ($::osfamily == 'Redhat' and versioncmp($::operatingsystemmajrelease, '7') >= 0) { + fail('mod_fastcgi is no longer supported on el7 and above.') + } + if ($facts['os']['name'] == 'Ubuntu' and versioncmp($facts['os']['release']['major'], '18.04') >= 0) { + fail('mod_fastcgi is no longer supported on Ubuntu 18.04 and above. Please use mod_proxy_fcgi') + } + # Debian specifies it's fastcgi lib path, but RedHat uses the default value + # with no config file + $fastcgi_lib_path = $apache::params::fastcgi_lib_path + + ::apache::mod { 'fastcgi': } + + if $fastcgi_lib_path { + # Template uses: + # - $fastcgi_server + # - $fastcgi_socket + # - $fastcgi_dir + file { 'fastcgi.conf': + ensure => file, + path => "${apache::mod_dir}/fastcgi.conf", + mode => $apache::file_mode, + content => template('apache/mod/fastcgi.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/fcgid.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/fcgid.pp new file mode 100644 index 000000000..14aa141d9 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/fcgid.pp @@ -0,0 +1,65 @@ +# @summary +# Installs and configures `mod_fcgid`. +# +# @param expires_active +# Enables generation of Expires headers. +# +# @param expires_default +# Default algorithm for calculating expiration time. +# +# @param expires_by_type +# Value of the Expires header configured by MIME type. +# +# @example The class does not individually parameterize all available options. Instead, configure mod_fcgid using the options hash. +# class { 'apache::mod::fcgid': +# options => { +# 'FcgidIPCDir' => '/var/run/fcgidsock', +# 'SharememPath' => '/var/run/fcgid_shm', +# 'AddHandler' => 'fcgid-script .fcgi', +# }, +# } +# +# @example If you include apache::mod::fcgid, you can set the [FcgidWrapper][] per directory, per virtual host. The module must be +# loaded first; Puppet will not automatically enable it if you set the fcgiwrapper parameter in apache::vhost. +# include apache::mod::fcgid +# +# apache::vhost { 'example.org': +# docroot => '/var/www/html', +# directories => { +# path => '/var/www/html', +# fcgiwrapper => { +# command => '/usr/local/bin/fcgiwrapper', +# } +# }, +# } +# +# @see https://httpd.apache.org/docs/current/mod/mod_fcgid.html for additional documentation. +# +class apache::mod::fcgid ( + $options = {}, +) { + include apache + if ($::osfamily == 'RedHat' and $::operatingsystemmajrelease >= '7') or $::osfamily == 'FreeBSD' { + $loadfile_name = 'unixd_fcgid.load' + $conf_name = 'unixd_fcgid.conf' + } else { + $loadfile_name = undef + $conf_name = 'fcgid.conf' + } + + ::apache::mod { 'fcgid': + loadfile_name => $loadfile_name, + } + + # Template uses: + # - $options + file { $conf_name: + ensure => file, + path => "${apache::mod_dir}/${conf_name}", + mode => $apache::file_mode, + content => template('apache/mod/fcgid.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/filter.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/filter.pp new file mode 100644 index 000000000..5cee27718 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/filter.pp @@ -0,0 +1,8 @@ +# @summary +# Installs `mod_filter`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_filter.html for additional documentation. +# +class apache::mod::filter { + ::apache::mod { 'filter': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/geoip.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/geoip.pp new file mode 100644 index 000000000..b77ea05c6 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/geoip.pp @@ -0,0 +1,61 @@ +# @summary +# Installs and configures `mod_geoip`. +# +# @param enable +# Toggles whether to enable geoip. +# +# @param db_file +# Path to database for GeoIP to use. +# +# @param flag +# Caching directive to use. Values: 'CheckCache', 'IndexCache', 'MemoryCache', 'Standard'. +# +# @param output +# Output variable locations. Values: 'All', 'Env', 'Request', 'Notes'. +# +# @param enable_utf8 +# Changes the output from ISO88591 (Latin1) to UTF8. +# +# @param scan_proxy_headers +# Enables the GeoIPScanProxyHeaders option. +# +# @param scan_proxy_headers_field +# Specifies the header mod_geoip uses to determine the client's IP address. +# +# @param use_last_xforwarededfor_ip +# Determines whether to use the first or last IP address for the client's IP in a comma-separated list of IP addresses is found. +# +# @see https://dev.maxmind.com/geoip/legacy/mod_geoip2 for additional documentation. +# +class apache::mod::geoip ( + $enable = false, + $db_file = '/usr/share/GeoIP/GeoIP.dat', + $flag = 'Standard', + $output = 'All', + $enable_utf8 = undef, + $scan_proxy_headers = undef, + $scan_proxy_header_field = undef, + $use_last_xforwarededfor_ip = undef, +) { + include apache + ::apache::mod { 'geoip': } + + # Template uses: + # - enable + # - db_file + # - flag + # - output + # - enable_utf8 + # - scan_proxy_headers + # - scan_proxy_header_field + # - use_last_xforwarededfor_ip + file { 'geoip.conf': + ensure => file, + path => "${apache::mod_dir}/geoip.conf", + mode => $apache::file_mode, + content => template('apache/mod/geoip.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/headers.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/headers.pp new file mode 100644 index 000000000..a86dbf76a --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/headers.pp @@ -0,0 +1,11 @@ +# @summary +# Installs and configures `mod_headers`. +# +# @param apache_version +# Version of Apache to install module on. +# +# @see https://httpd.apache.org/docs/current/mod/mod_headers.html for additional documentation. +# +class apache::mod::headers { + ::apache::mod { 'headers': } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/http2.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/http2.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/http2.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/http2.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/include.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/include.pp new file mode 100644 index 000000000..af9675a95 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/include.pp @@ -0,0 +1,8 @@ +# @summary +# Installs `mod_include`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_include.html for additional documentation. +# +class apache::mod::include { + ::apache::mod { 'include': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/info.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/info.pp new file mode 100644 index 000000000..baf20cb32 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/info.pp @@ -0,0 +1,51 @@ +# @summary +# Installs and configures `mod_info`. +# +# @param allow_from +# Allowlist of IPv4 or IPv6 addresses or ranges that can access the info path. +# +# @param apache_version +# Version of Apache to install module on. +# +# @param restrict_access +# Toggles whether to restrict access to info path. If `false`, the `allow_from` allowlist is ignored and any IP address can +# access the info path. +# +# @param info_path +# Path on server to file containing server configuration information. +# +# @see https://httpd.apache.org/docs/current/mod/mod_info.html for additional documentation. +# +class apache::mod::info ( + $allow_from = ['127.0.0.1','::1'], + $apache_version = undef, + $restrict_access = true, + $info_path = '/server-info', +) { + include apache + $_apache_version = pick($apache_version, $apache::apache_version) + + if $::osfamily == 'Suse' { + if defined(Class['::apache::mod::worker']) { + $suse_path = '/usr/lib64/apache2-worker' + } else { + $suse_path = '/usr/lib64/apache2-prefork' + } + ::apache::mod { 'info': + lib_path => $suse_path, + } + } else { + ::apache::mod { 'info': } + } + + # Template uses $allow_from, $_apache_version + file { 'info.conf': + ensure => file, + path => "${apache::mod_dir}/info.conf", + mode => $apache::file_mode, + content => template('apache/mod/info.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/intercept_form_submit.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/intercept_form_submit.pp new file mode 100644 index 000000000..f6ccf653b --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/intercept_form_submit.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_intercept_form_submit`. +# +# @see https://www.adelton.com/apache/mod_intercept_form_submit for additional documentation. +# +class apache::mod::intercept_form_submit { + include apache + ::apache::mod { 'intercept_form_submit': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/itk.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/itk.pp new file mode 100644 index 000000000..2f44b01a8 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/itk.pp @@ -0,0 +1,128 @@ +# @summary +# Installs MPM `mod_itk`. +# +# @param startservers +# Number of child server processes created on startup. +# +# @param minspareservers +# Minimum number of idle child server processes. +# +# @param maxspareservers +# Maximum number of idle child server processes. +# +# @param serverlimit +# Maximum configured value for `MaxRequestWorkers` for the lifetime of the Apache httpd process. +# +# @param maxclients +# Limit on the number of simultaneous requests that will be served. +# +# @param maxrequestsperchild +# Limit on the number of connections that an individual child server process will handle. +# +# @param enablecapabilities +# Drop most root capabilities in the parent process, and instead run as the user given by the User/Group directives with some extra +# capabilities (in particular setuid). Somewhat more secure, but can cause problems when serving from filesystems that do not honor +# capabilities, such as NFS. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @see http://mpm-itk.sesse.net for additional documentation. +# @note Unsupported platforms: CentOS: 8; RedHat: 8; SLES: all +class apache::mod::itk ( + $startservers = '8', + $minspareservers = '5', + $maxspareservers = '20', + $serverlimit = '256', + $maxclients = '256', + $maxrequestsperchild = '4000', + $enablecapabilities = undef, + $apache_version = undef, +) { + include apache + + $_apache_version = pick($apache_version, $apache::apache_version) + + if defined(Class['apache::mod::event']) { + fail('May not include both apache::mod::itk and apache::mod::event on the same node') + } + if defined(Class['apache::mod::peruser']) { + fail('May not include both apache::mod::itk and apache::mod::peruser on the same node') + } + if versioncmp($_apache_version, '2.4') < 0 { + if defined(Class['apache::mod::prefork']) { + fail('May not include both apache::mod::itk and apache::mod::prefork on the same node') + } + } else { + # prefork is a requirement for itk in 2.4; except on FreeBSD and Gentoo, which are special + if $::osfamily =~ /^(FreeBSD|Gentoo)/ { + if defined(Class['apache::mod::prefork']) { + fail('May not include both apache::mod::itk and apache::mod::prefork on the same node') + } + } else { + if ! defined(Class['apache::mod::prefork']) { + include apache::mod::prefork + } + } + } + if defined(Class['apache::mod::worker']) { + fail('May not include both apache::mod::itk and apache::mod::worker on the same node') + } + File { + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + } + + # Template uses: + # - $startservers + # - $minspareservers + # - $maxspareservers + # - $serverlimit + # - $maxclients + # - $maxrequestsperchild + file { "${apache::mod_dir}/itk.conf": + ensure => file, + mode => $apache::file_mode, + content => template('apache/mod/itk.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + + case $::osfamily { + 'redhat': { + package { 'httpd-itk': + ensure => present, + } + if versioncmp($_apache_version, '2.4') >= 0 { + ::apache::mpm { 'itk': + apache_version => $_apache_version, + } + } + else { + file_line { '/etc/sysconfig/httpd itk enable': + ensure => present, + path => '/etc/sysconfig/httpd', + line => 'HTTPD=/usr/sbin/httpd.itk', + match => '#?HTTPD=/usr/sbin/httpd.itk', + require => Package['httpd'], + notify => Class['apache::service'], + } + } + } + 'debian', 'freebsd': { + apache::mpm { 'itk': + apache_version => $_apache_version, + } + } + 'gentoo': { + ::portage::makeconf { 'apache2_mpms': + content => 'itk', + } + } + default: { + fail("Unsupported osfamily ${::osfamily}") + } + } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/jk.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/jk.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/jk.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/jk.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ldap.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ldap.pp new file mode 100644 index 000000000..9c37b09e6 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ldap.pp @@ -0,0 +1,79 @@ +# @summary +# Installs and configures `mod_ldap`. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @param package_name +# Specifies the custom package name. +# +# @param ldap_trusted_global_cert_file +# Sets the file or database containing global trusted Certificate Authority or global client certificates. +# +# @param ldap_trusted_global_cert_type +# Sets the certificate parameter of the global trusted Certificate Authority or global client certificates. +# +# @param ldap_shared_cache_size +# Size in bytes of the shared-memory cache +# +# @param ldap_cache_entries +# Maximum number of entries in the primary LDAP cache +# +# @param ldap_cache_ttl +# Time that cached items remain valid (in seconds). +# +# @param ldap_opcache_entries +# Number of entries used to cache LDAP compare operations +# +# @param ldap_opcache_ttl +# Time that entries in the operation cache remain valid (in seconds). +# +# @param ldap_trusted_mode +# Specifies the SSL/TLS mode to be used when connecting to an LDAP server. +# +# @param ldap_path +# The server location of the ldap status page. +# +# @example +# class { 'apache::mod::ldap': +# ldap_trusted_global_cert_file => '/etc/pki/tls/certs/ldap-trust.crt', +# ldap_trusted_global_cert_type => 'CA_DER', +# ldap_trusted_mode => 'TLS', +# ldap_shared_cache_size => '500000', +# ldap_cache_entries => '1024', +# ldap_cache_ttl => '600', +# ldap_opcache_entries => '1024', +# ldap_opcache_ttl => '600', +# } +# +# @see https://httpd.apache.org/docs/current/mod/mod_ldap.html for additional documentation. +# @note Unsupported platforms: CentOS: 8; RedHat: 8 +class apache::mod::ldap ( + $apache_version = undef, + $package_name = undef, + $ldap_trusted_global_cert_file = undef, + Optional[String] $ldap_trusted_global_cert_type = 'CA_BASE64', + $ldap_shared_cache_size = undef, + $ldap_cache_entries = undef, + $ldap_cache_ttl = undef, + $ldap_opcache_entries = undef, + $ldap_opcache_ttl = undef, + $ldap_trusted_mode = undef, + String $ldap_path = '/ldap-status', +) { + include apache + $_apache_version = pick($apache_version, $apache::apache_version) + ::apache::mod { 'ldap': + package => $package_name, + } + # Template uses $_apache_version + file { 'ldap.conf': + ensure => file, + path => "${apache::mod_dir}/ldap.conf", + mode => $apache::file_mode, + content => template('apache/mod/ldap.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/lookup_identity.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/lookup_identity.pp new file mode 100644 index 000000000..3161ec329 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/lookup_identity.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_lookup_identity` +# +# @see https://www.adelton.com/apache/mod_lookup_identity for additional documentation. +# +class apache::mod::lookup_identity { + include apache + ::apache::mod { 'lookup_identity': } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/macro.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/macro.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/macro.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/macro.pp diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/md.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/md.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/md.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/md.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/mime.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/mime.pp new file mode 100644 index 000000000..9243ae1e1 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/mime.pp @@ -0,0 +1,39 @@ +# @summary +# Installs and configures `mod_mime`. +# +# @param mime_support_package +# Name of the MIME package to be installed. +# +# @param mime_types_config +# The location of the mime.types file. +# +# @param mime_types_additional +# List of additional MIME types to include. +# +# @see https://httpd.apache.org/docs/current/mod/mod_mime.html for additional documentation. +# +class apache::mod::mime ( + $mime_support_package = $apache::params::mime_support_package, + $mime_types_config = $apache::params::mime_types_config, + $mime_types_additional = undef, +) inherits ::apache::params { + include apache + $_mime_types_additional = pick($mime_types_additional, $apache::mime_types_additional) + apache::mod { 'mime': } + # Template uses $_mime_types_config + file { 'mime.conf': + ensure => file, + path => "${apache::mod_dir}/mime.conf", + mode => $apache::file_mode, + content => template('apache/mod/mime.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + if $mime_support_package { + package { $mime_support_package: + ensure => 'installed', + before => File['mime.conf'], + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/mime_magic.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/mime_magic.pp new file mode 100644 index 000000000..99a1ec4bb --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/mime_magic.pp @@ -0,0 +1,25 @@ +# @summary +# Installs and configures `mod_mime_magic`. +# +# @param magic_file +# Enable MIME-type determination based on file contents using the specified magic file. +# +# @see https://httpd.apache.org/docs/current/mod/mod_mime_magic.html for additional documentation. +# +class apache::mod::mime_magic ( + $magic_file = undef, +) { + include apache + $_magic_file = pick($magic_file, "${apache::conf_dir}/magic") + apache::mod { 'mime_magic': } + # Template uses $magic_file + file { 'mime_magic.conf': + ensure => file, + path => "${apache::mod_dir}/mime_magic.conf", + mode => $apache::file_mode, + content => template('apache/mod/mime_magic.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/negotiation.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/negotiation.pp new file mode 100644 index 000000000..bc018001a --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/negotiation.pp @@ -0,0 +1,32 @@ +# @summary +# Installs and configures `mod_negotiation`. +# +# @param force_language_priority +# Action to take if a single acceptable document is not found. +# +# @param language_priority +# The precedence of language variants for cases where the client does not express a preference. +# +# @see [https://httpd.apache.org/docs/current/mod/mod_negotiation.html for additional documentation. +# +class apache::mod::negotiation ( + Variant[Array[String], String] $force_language_priority = 'Prefer Fallback', + Variant[Array[String], String] $language_priority = ['en', 'ca', 'cs', 'da', 'de', 'el', 'eo', 'es', 'et', + 'fr', 'he', 'hr', 'it', 'ja', 'ko', 'ltz', 'nl', 'nn', + 'no', 'pl', 'pt', 'pt-BR', 'ru', 'sv', 'zh-CN', + 'zh-TW'], +) { + include apache + + ::apache::mod { 'negotiation': } + # Template uses no variables + file { 'negotiation.conf': + ensure => file, + mode => $apache::file_mode, + path => "${apache::mod_dir}/negotiation.conf", + content => template('apache/mod/negotiation.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/nss.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/nss.pp new file mode 100644 index 000000000..4c986ff81 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/nss.pp @@ -0,0 +1,45 @@ +# @summary +# Installs and configures `mod_nss`. +# +# @param transfer_log +# Path to `access.log`. +# +# @param error_Log +# Path to `error.log` +# +# @param passwd_file +# Path to file containing token passwords used for NSSPassPhraseDialog. +# +# @param port +# Sets the SSL port that should be used by mod_nss. +# +# @see https://pagure.io/mod_nss for additional documentation. +# +class apache::mod::nss ( + $transfer_log = "${apache::params::logroot}/access.log", + $error_log = "${apache::params::logroot}/error.log", + $passwd_file = undef, + $port = 8443, +) { + include apache + include apache::mod::mime + + apache::mod { 'nss': } + + $httpd_dir = $apache::httpd_dir + + # Template uses: + # $transfer_log + # $error_log + # $http_dir + # passwd_file + file { 'nss.conf': + ensure => file, + path => "${apache::mod_dir}/nss.conf", + mode => $apache::file_mode, + content => template('apache/mod/nss.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/pagespeed.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/pagespeed.pp new file mode 100644 index 000000000..54181545a --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/pagespeed.pp @@ -0,0 +1,75 @@ +# @summary +# Installs and configures `mod_pagespeed`. +# +# @todo +# Add docs +# +# @note +# Verify that your system is compatible with the latest Google Pagespeed requirements. +# +# Although this apache module requires the mod-pagespeed-stable package, Puppet does not manage the software repositories required to +# automatically install the package. If you declare this class when the package is either not installed or not available to your +# package manager, your Puppet run will fail. +# +# @see https://developers.google.com/speed/pagespeed/module/ for additional documentation. +# +class apache::mod::pagespeed ( + $inherit_vhost_config = 'on', + $filter_xhtml = false, + $cache_path = '/var/cache/mod_pagespeed/', + $log_dir = '/var/log/pagespeed', + $memcache_servers = [], + $rewrite_level = 'CoreFilters', + $disable_filters = [], + $enable_filters = [], + $forbid_filters = [], + $rewrite_deadline_per_flush_ms = 10, + $additional_domains = undef, + $file_cache_size_kb = 102400, + $file_cache_clean_interval_ms = 3600000, + $lru_cache_per_process = 1024, + $lru_cache_byte_limit = 16384, + $css_flatten_max_bytes = 2048, + $css_inline_max_bytes = 2048, + $css_image_inline_max_bytes = 2048, + $image_inline_max_bytes = 2048, + $js_inline_max_bytes = 2048, + $css_outline_min_bytes = 3000, + $js_outline_min_bytes = 3000, + $inode_limit = 500000, + $image_max_rewrites_at_once = 8, + $num_rewrite_threads = 4, + $num_expensive_rewrite_threads = 4, + $collect_statistics = 'on', + $statistics_logging = 'on', + $allow_view_stats = [], + $allow_pagespeed_console = [], + $allow_pagespeed_message = [], + $message_buffer_size = 100000, + $additional_configuration = {}, + $apache_version = undef, + $package_ensure = undef, +) { + include apache + $_apache_version = pick($apache_version, $apache::apache_version) + $_lib = $_apache_version ? { + '2.4' => 'mod_pagespeed_ap24.so', + default => undef + } + + apache::mod { 'pagespeed': + lib => $_lib, + package_ensure => $package_ensure, + } + + # Template uses $_apache_version + file { 'pagespeed.conf': + ensure => file, + path => "${apache::mod_dir}/pagespeed.conf", + mode => $apache::file_mode, + content => template('apache/mod/pagespeed.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/passenger.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/passenger.pp new file mode 100644 index 000000000..9019c33e4 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/passenger.pp @@ -0,0 +1,965 @@ +# @summary +# Installs `mod_pasenger`. +# +# @param manage_repo +# Toggle whether to manage yum repo if on a RedHat node. +# +# @param mod_id +# Specifies the package id. +# +# @param mod_lib +# Defines the module's shared object name. Do not configure manually without special reason. +# +# @param mod_lib_path +# Specifies a path to the module's libraries. Do not manually set this parameter without special reason. The `path` parameter overrides +# this value. +# +# @param mod_package +# Name of the module package to install. +# +# @param mod_package_ensure +# Determines whether Puppet ensures the module should be installed. +# +# @param mod_path +# Specifies a path to the module. Do not manually set this parameter without a special reason. +# +# @param passenger_allow_encoded_slashes +# Toggle whether URLs with encoded slashes (%2f) can be used (by default Apache does not support this). +# +# @param passenger_app_env +# This option sets, for the current application, the value of the following environment variables: +# - RAILS_ENV +# - RACK_ENV +# - WSGI_ENV +# - NODE_ENV +# - PASSENGER_APP_ENV +# +# @param passenger_app_group_name +# Sets the name of the application group that the current application should belong to. +# +# @param passenger_app_root +# Path to the application root which allows access independent from the DocumentRoot. +# +# @param passenger_app_type +# Specifies the type of the application. If you set this option, then you must also set PassengerAppRoot, otherwise Passenger will +# not properly recognize your application. +# +# @param passenger_base_uri +# Used to specify that the given URI is an distinct application that should be served by Passenger. +# +# @param passenger_buffer_response +# Toggle whether application-generated responses are buffered by Apache. Buffering will happen in memory. +# +# @param passenger_buffer_upload +# Toggle whether HTTP client request bodies are buffered before they are sent to the application. +# +# @param passenger_concurrency_model +# Specifies the I/O concurrency model that should be used for Ruby application processes. +# +# @param passenger_conf_file +# +# +# @param passenger_conf_package_file +# +# +# @param passenger_data_buffer_dir +# Specifies the directory in which to store data buffers. +# +# @param passenger_debug_log_file +# +# +# @param passenger_debugger +# Turns support for Ruby application debugging on or off. +# +# @param passenger_default_group +# Allows you to specify the group that applications must run as, if user switching fails or is disabled. +# +# @param passenger_default_ruby +# File path to desired ruby interpreter to use by default. +# +# @param passenger_default_user +# Allows you to specify the user that applications must run as, if user switching fails or is disabled. +# +# @param passenger_disable_security_update_check +# Allows disabling the Passenger security update check, a daily check with https://securitycheck.phusionpassenger.com for important +# security updates that might be available. +# +# @param passenger_enabled +# Toggles whether Passenger should be enabled for that particular context. +# +# @param passenger_error_override +# Toggles whether Apache will intercept and handle responses with HTTP status codes of 400 and higher. +# +# @param passenger_file_descriptor_log_file +# Log file descriptor debug tracing messages to the given file. +# +# @param passenger_fly_with +# Enables the Flying Passenger mode, and configures Apache to connect to the Flying Passenger daemon that's listening on the +# given socket filename. +# +# @param passenger_force_max_concurrent_requests_per_process +# Use this option to tell Passenger how many concurrent requests the application can handle per process. +# +# @param passenger_friendly_error_pages +# Toggles whether Passenger should display friendly error pages whenever an application fails to start. +# +# @param passenger_group +# Allows you to override that behavior and explicitly set a group to run the web application as, regardless of the ownership of the +# startup file. +# +# @param passenger_high_performance +# Toggles whether to enable PassengerHighPerformance which will make Passenger will be a little faster, in return for reduced +# compatibility with other Apache modules. +# +# @param passenger_installed_version +# +# +# @param passenger_instance_registry_dir +# Specifies the directory that Passenger should use for registering its current instance. +# +# @param passenger_load_shell_envvars +# Enables or disables the loading of shell environment variables before spawning the application. +# +# @param passenger_log_file +# File path to log file. By default Passenger log messages are written to the Apache global error log. +# +# @param passenger_log_level +# Specifies how much information Passenger should log to its log file. A higher log level value means that more +# information will be logged. +# +# @param passenger_lve_min_uid +# When using Passenger on a LVE-enabled kernel, a security check (enter) is run for spawning application processes. This options +# tells the check to only allow processes with UIDs equal to, or higher than, the specified value. +# +# @param passenger_max_instances +# The maximum number of application processes that may simultaneously exist for an application. +# +# @param passenger_max_instances_per_app +# The maximum number of application processes that may simultaneously exist for a single application. +# +# @param passenger_max_pool_size +# The maximum number of application processes that may simultaneously exist. +# +# @param passenger_max_preloader_idle_time +# Set the preloader's idle timeout, in seconds. A value of 0 means that it should never idle timeout. +# +# @param passenger_max_request_queue_size +# Specifies the maximum size for the queue of all incoming requests. +# +# @param passenger_max_request_time +# The maximum amount of time, in seconds, that an application process may take to process a request. +# +# @param passenger_max_requests +# The maximum number of requests an application process will process. +# +# @param passenger_memory_limit +# The maximum amount of memory that an application process may use, in megabytes. +# +# @param passenger_meteor_app_settings +# When using a Meteor application in non-bundled mode, use this option to specify a JSON file with settings for the application. +# +# @param passenger_min_instances +# Specifies the minimum number of application processes that should exist for a given application. +# +# @param passenger_nodejs +# Specifies the Node.js command to use for serving Node.js web applications. +# +# @param passenger_pool_idle_time +# The maximum number of seconds that an application process may be idle. +# +# @param passenger_pre_start +# URL of the web application you want to pre-start. +# +# @param passenger_python +# Specifies the Python interpreter to use for serving Python web applications. +# +# @param passenger_resist_deployment_errors +# Enables or disables resistance against deployment errors. +# +# @param passenger_resolve_symlinks_in_document_root +# This option is no longer available in version 5.2.0. Switch to PassengerAppRoot if you are setting the application root via a +# document root containing symlinks. +# +# @param passenger_response_buffer_high_watermark +# Configures the maximum size of the real-time disk-backed response buffering system. +# +# @param passenger_restart_dir +# Path to directory containing restart.txt file. Can be either absolute or relative. +# +# @param passenger_rolling_restarts +# Enables or disables support for zero-downtime application restarts through restart.txt. +# +# @param passenger_root +# Refers to the location to the Passenger root directory, or to a location configuration file. +# +# @param passenger_ruby +# Specifies the Ruby interpreter to use for serving Ruby web applications. +# +# @param passenger_security_update_check_proxy +# Allows use of an intermediate proxy for the Passenger security update check. +# +# @param passenger_show_version_in_header +# Toggle whether Passenger will output its version number in the X-Powered-By header in all Passenger-served requests: +# +# @param passenger_socket_backlog +# This option can be raised if Apache manages to overflow the backlog queue. +# +# @param passenger_spawn_method +# Controls whether Passenger spawns applications directly, or using a prefork copy-on-write mechanism. +# +# @param passenger_start_timeout +# Specifies a timeout for the startup of application processes. +# +# @param passenger_startup_file +# Specifies the startup file that Passenger should use when loading the application. +# +# @param passenger_stat_throttle_rate +# Setting this option to a value of x means that certain filesystem checks will be performed at most once every x seconds. +# +# @param passenger_sticky_sessions +# Toggles whether all requests that a client sends will be routed to the same originating application process, whenever possible. +# +# @param passenger_sticky_sessions_cookie_name +# Sets the name of the sticky sessions cookie. +# +# @param passenger_thread_count +# Specifies the number of threads that Passenger should spawn per Ruby application process. +# +# @param passenger_use_global_queue +# N/A. +# +# @param passenger_user +# Allows you to override that behavior and explicitly set a user to run the web application as, regardless of the ownership of the +# startup file. +# +# @param passenger_user_switching +# Toggles whether to attempt to enable user account sandboxing, also known as user switching. +# +# @param rack_auto_detect +# This option has been removed in version 4.0.0 as part of an optimization. You should use PassengerEnabled instead. +# +# @param rack_autodetect +# This option has been removed in version 4.0.0 as part of an optimization. You should use PassengerEnabled instead. +# +# @param rack_base_uri +# Deprecated in 3.0.0 in favor of PassengerBaseURI. +# +# @param rack_env +# Alias for PassengerAppEnv. +# +# @param rails_allow_mod_rewrite +# This option doesn't do anything anymore since version 4.0.0. +# +# @param rails_app_spawner_idle_time +# This option has been removed in version 4.0.0, and replaced with PassengerMaxPreloaderIdleTime. +# +# @param rails_auto_detect +# This option has been removed in version 4.0.0 as part of an optimization. You should use PassengerEnabled instead. +# +# @param rails_autodetect +# This option has been removed in version 4.0.0 as part of an optimization. You should use PassengerEnabled instead. +# +# @param rails_base_uri +# Deprecated in 3.0.0 in favor of PassengerBaseURI. +# +# @param rails_default_user +# Deprecated in 3.0.0 in favor of PassengerDefaultUser +# +# @param rails_env +# Alias for PassengerAppEnv. +# +# @param rails_framework_spawner_idle_time +# This option is no longer available in version 4.0.0. There is no alternative because framework spawning has been removed +# altogether. You should use smart spawning instead. +# +# @param rails_ruby +# Deprecated in 3.0.0 in favor of PassengerRuby. +# +# @param rails_spawn_method +# Deprecated in 3.0.0 in favor of PassengerSpawnMethod. +# +# @param rails_user_switching +# Deprecated in 3.0.0 in favor of PassengerUserSwitching. +# +# @param wsgi_auto_detect +# This option has been removed in version 4.0.0 as part of an optimization. You should use PassengerEnabled instead. +# +# @note +# In Passenger source code you can strip out what are all the available options by looking in +# - src/apache2_module/Configuration.cpp +# - src/apache2_module/ConfigurationCommands.cpp +# There are also several undocumented settings. +# +# @note +# For Red Hat based systems, ensure that you meet the minimum requirements described in the passenger docs. +# +# The current set of server configurations settings were taken directly from the Passenger Reference. To enable deprecation warnings +# and removal failure messages, set the passenger_installed_version to the version number installed on the server. +# +# Change Log: +# - As of 08/13/2017 there are 84 available/deprecated/removed settings. +# - Around 08/20/2017 UnionStation was discontinued options were removed. +# - As of 08/20/2017 there are 77 available/deprecated/removed settings. +# +# @see https://www.phusionpassenger.com/docs/references/config_reference/apache/ for additional documentation. +# +class apache::mod::passenger ( + $manage_repo = true, + $mod_id = undef, + $mod_lib = undef, + $mod_lib_path = undef, + $mod_package = undef, + $mod_package_ensure = undef, + $mod_path = undef, + $passenger_allow_encoded_slashes = undef, + Optional[String] $passenger_anonymous_telemetry_proxy = undef, + $passenger_app_env = undef, + $passenger_app_group_name = undef, + $passenger_app_root = undef, + $passenger_app_type = undef, + $passenger_base_uri = undef, + $passenger_buffer_response = undef, + $passenger_buffer_upload = undef, + $passenger_concurrency_model = undef, + $passenger_conf_file = $apache::params::passenger_conf_file, + $passenger_conf_package_file = $apache::params::passenger_conf_package_file, + $passenger_data_buffer_dir = undef, + $passenger_debug_log_file = undef, + $passenger_debugger = undef, + $passenger_default_group = undef, + $passenger_default_ruby = $apache::params::passenger_default_ruby, + $passenger_default_user = undef, + Optional[Boolean] $passenger_disable_anonymous_telemetry = undef, + Optional[Boolean] $passenger_disable_log_prefix = undef, + $passenger_disable_security_update_check = undef, + $passenger_enabled = undef, + $passenger_error_override = undef, + $passenger_file_descriptor_log_file = undef, + $passenger_fly_with = undef, + $passenger_force_max_concurrent_requests_per_process = undef, + $passenger_friendly_error_pages = undef, + $passenger_group = undef, + $passenger_high_performance = undef, + $passenger_installed_version = undef, + $passenger_instance_registry_dir = undef, + $passenger_load_shell_envvars = undef, + Optional[Stdlib::Absolutepath] $passenger_log_file = undef, + $passenger_log_level = undef, + $passenger_lve_min_uid = undef, + $passenger_max_instances = undef, + $passenger_max_instances_per_app = undef, + $passenger_max_pool_size = undef, + $passenger_max_preloader_idle_time = undef, + $passenger_max_request_queue_size = undef, + $passenger_max_request_time = undef, + $passenger_max_requests = undef, + $passenger_memory_limit = undef, + $passenger_meteor_app_settings = undef, + $passenger_min_instances = undef, + $passenger_nodejs = undef, + $passenger_pool_idle_time = undef, + Optional[Variant[String,Array[String]]] $passenger_pre_start = undef, + $passenger_python = undef, + $passenger_resist_deployment_errors = undef, + $passenger_resolve_symlinks_in_document_root = undef, + $passenger_response_buffer_high_watermark = undef, + $passenger_restart_dir = undef, + $passenger_rolling_restarts = undef, + $passenger_root = $apache::params::passenger_root, + $passenger_ruby = $apache::params::passenger_ruby, + $passenger_security_update_check_proxy = undef, + $passenger_show_version_in_header = undef, + $passenger_socket_backlog = undef, + Optional[String] $passenger_spawn_dir = undef, + Optional[Enum['smart', 'direct', 'smart-lv2', 'conservative']] $passenger_spawn_method = undef, + $passenger_start_timeout = undef, + $passenger_startup_file = undef, + $passenger_stat_throttle_rate = undef, + $passenger_sticky_sessions = undef, + $passenger_sticky_sessions_cookie_name = undef, + Optional[String] $passenger_sticky_sessions_cookie_attributes = undef, + $passenger_thread_count = undef, + $passenger_use_global_queue = undef, + $passenger_user = undef, + $passenger_user_switching = undef, + $rack_auto_detect = undef, + $rack_autodetect = undef, + $rack_base_uri = undef, + $rack_env = undef, + $rails_allow_mod_rewrite = undef, + $rails_app_spawner_idle_time = undef, + $rails_auto_detect = undef, + $rails_autodetect = undef, + $rails_base_uri = undef, + $rails_default_user = undef, + $rails_env = undef, + $rails_framework_spawner_idle_time = undef, + $rails_ruby = undef, + $rails_spawn_method = undef, + $rails_user_switching = undef, + $wsgi_auto_detect = undef, +) inherits ::apache::params { + include apache + if $passenger_installed_version { + if $passenger_allow_encoded_slashes { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_allow_encoded_slashes is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_anonymous_telemetry_proxy { + if (versioncmp($passenger_installed_version, '6.0.0') < 0) { + fail("Passenger config option :: passenger_anonymous_telemetry_proxy is not introduced until version 6.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_app_env { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_app_env is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_app_group_name { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_app_group_name is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_app_root { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_app_root is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_app_type { + if (versioncmp($passenger_installed_version, '4.0.25') < 0) { + fail("Passenger config option :: passenger_app_type is not introduced until version 4.0.25 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_base_uri { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_base_uri is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_buffer_response { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_buffer_response is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_buffer_upload { + if (versioncmp($passenger_installed_version, '4.0.26') < 0) { + fail("Passenger config option :: passenger_buffer_upload is not introduced until version 4.0.26 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_concurrency_model { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_concurrency_model is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_data_buffer_dir { + if (versioncmp($passenger_installed_version, '5.0.0') < 0) { + fail("Passenger config option :: passenger_data_buffer_dir is not introduced until version 5.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_debug_log_file { + if (versioncmp($passenger_installed_version, '5.0.5') > 0) { + warning('DEPRECATED PASSENGER OPTION :: passenger_debug_log_file :: This option has been renamed in version 5.0.5 to PassengerLogFile.') + } + } + if $passenger_debugger { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_debugger is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_default_group { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_default_group is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_default_ruby { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_default_ruby is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_default_user { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_default_user is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_disable_anonymous_telemetry { + if (versioncmp($passenger_installed_version, '6.0.0') < 0) { + fail("Passenger config option :: passenger_disable_anonymous_telemetry is not introduced until version 6.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_disable_log_prefix { + if (versioncmp($passenger_installed_version, '6.0.2') < 0) { + fail("Passenger config option :: passenger_disable_log_prefix is not introduced until version 6.0.2 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_disable_security_update_check { + if (versioncmp($passenger_installed_version, '5.1.0') < 0) { + fail("Passenger config option :: passenger_disable_security_update_check is not introduced until version 5.1.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_enabled { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_enabled is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_error_override { + if (versioncmp($passenger_installed_version, '4.0.24') < 0) { + fail("Passenger config option :: passenger_error_override is not introduced until version 4.0.24 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_file_descriptor_log_file { + if (versioncmp($passenger_installed_version, '5.0.5') < 0) { + fail("Passenger config option :: passenger_file_descriptor_log_file is not introduced until version 5.0.5 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_fly_with { + if (versioncmp($passenger_installed_version, '4.0.45') < 0) { + fail("Passenger config option :: passenger_fly_with is not introduced until version 4.0.45 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_force_max_concurrent_requests_per_process { + if (versioncmp($passenger_installed_version, '5.0.22') < 0) { + fail("Passenger config option :: passenger_force_max_concurrent_requests_per_process is not introduced until version 5.0.22 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_friendly_error_pages { + if (versioncmp($passenger_installed_version, '4.0.42') < 0) { + fail("Passenger config option :: passenger_friendly_error_pages is not introduced until version 4.0.42 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_group { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_group is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_high_performance { + if (versioncmp($passenger_installed_version, '2.0.0') < 0) { + fail("Passenger config option :: passenger_high_performance is not introduced until version 2.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_instance_registry_dir { + if (versioncmp($passenger_installed_version, '5.0.0') < 0) { + fail("Passenger config option :: passenger_instance_registry_dir is not introduced until version 5.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_load_shell_envvars { + if (versioncmp($passenger_installed_version, '4.0.20') < 0) { + fail("Passenger config option :: passenger_load_shell_envvars is not introduced until version 4.0.20 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_log_file { + if (versioncmp($passenger_installed_version, '5.0.5') < 0) { + fail("Passenger config option :: passenger_log_file is not introduced until version 5.0.5 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_log_level { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_log_level is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_lve_min_uid { + if (versioncmp($passenger_installed_version, '5.0.28') < 0) { + fail("Passenger config option :: passenger_lve_min_uid is not introduced until version 5.0.28 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_max_instances { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_max_instances is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_max_instances_per_app { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_max_instances_per_app is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_max_pool_size { + if (versioncmp($passenger_installed_version, '1.0.0') < 0) { + fail("Passenger config option :: passenger_max_pool_size is not introduced until version 1.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_max_preloader_idle_time { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_max_preloader_idle_time is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_max_request_queue_size { + if (versioncmp($passenger_installed_version, '4.0.15') < 0) { + fail("Passenger config option :: passenger_max_request_queue_size is not introduced until version 4.0.15 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_max_request_time { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_max_request_time is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_max_requests { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_max_requests is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_memory_limit { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_memory_limit is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_meteor_app_settings { + if (versioncmp($passenger_installed_version, '5.0.7') < 0) { + fail("Passenger config option :: passenger_meteor_app_settings is not introduced until version 5.0.7 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_min_instances { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_min_instances is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_nodejs { + if (versioncmp($passenger_installed_version, '4.0.24') < 0) { + fail("Passenger config option :: passenger_nodejs is not introduced until version 4.0.24 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_pool_idle_time { + if (versioncmp($passenger_installed_version, '1.0.0') < 0) { + fail("Passenger config option :: passenger_pool_idle_time is not introduced until version 1.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_pre_start { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_pre_start is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_python { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_python is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_resist_deployment_errors { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_resist_deployment_errors is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_resolve_symlinks_in_document_root { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_resolve_symlinks_in_document_root is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_response_buffer_high_watermark { + if (versioncmp($passenger_installed_version, '5.0.0') < 0) { + fail("Passenger config option :: passenger_response_buffer_high_watermark is not introduced until version 5.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_restart_dir { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_restart_dir is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_rolling_restarts { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_rolling_restarts is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_root { + if (versioncmp($passenger_installed_version, '1.0.0') < 0) { + fail("Passenger config option :: passenger_root is not introduced until version 1.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_ruby { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_ruby is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_security_update_check_proxy { + if (versioncmp($passenger_installed_version, '5.1.0') < 0) { + fail("Passenger config option :: passenger_security_update_check_proxy is not introduced until version 5.1.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_show_version_in_header { + if (versioncmp($passenger_installed_version, '5.1.0') < 0) { + fail("Passenger config option :: passenger_show_version_in_header is not introduced until version 5.1.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_socket_backlog { + if (versioncmp($passenger_installed_version, '5.0.24') < 0) { + fail("Passenger config option :: passenger_socket_backlog is not introduced until version 5.0.24 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_spawn_dir { + if (versioncmp($passenger_installed_version, '6.0.3') < 0) { + fail("Passenger config option :: passenger_spawn_dir is not introduced until version 6.0.3 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_spawn_method { + if (versioncmp($passenger_installed_version, '2.0.0') < 0) { + fail("Passenger config option :: passenger_spawn_method is not introduced until version 2.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_start_timeout { + if (versioncmp($passenger_installed_version, '4.0.15') < 0) { + fail("Passenger config option :: passenger_start_timeout is not introduced until version 4.0.15 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_startup_file { + if (versioncmp($passenger_installed_version, '4.0.25') < 0) { + fail("Passenger config option :: passenger_startup_file is not introduced until version 4.0.25 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_stat_throttle_rate { + if (versioncmp($passenger_installed_version, '2.2.0') < 0) { + fail("Passenger config option :: passenger_stat_throttle_rate is not introduced until version 2.2.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_sticky_sessions { + if (versioncmp($passenger_installed_version, '4.0.45') < 0) { + fail("Passenger config option :: passenger_sticky_sessions is not introduced until version 4.0.45 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_sticky_sessions_cookie_name { + if (versioncmp($passenger_installed_version, '4.0.45') < 0) { + fail("Passenger config option :: passenger_sticky_sessions_cookie_name is not introduced until version 4.0.45 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_sticky_sessions_cookie_attributes { + if (versioncmp($passenger_installed_version, '6.0.5') < 0) { + fail("Passenger config option :: passenger_sticky_sessions_cookie_attributes is not introduced until version 6.0.5 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_thread_count { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_thread_count is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_use_global_queue { + if (versioncmp($passenger_installed_version, '4.0.0') > 0) { + fail('REMOVED PASSENGER OPTION :: passenger_use_global_queue :: -- no message on the current passenger reference webpage -- ') + } + if (versioncmp($passenger_installed_version, '2.0.4') < 0) { + fail("Passenger config option :: passenger_use_global_queue is not introduced until version 2.0.4 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_user { + if (versioncmp($passenger_installed_version, '4.0.0') < 0) { + fail("Passenger config option :: passenger_user is not introduced until version 4.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $passenger_user_switching { + if (versioncmp($passenger_installed_version, '3.0.0') < 0) { + fail("Passenger config option :: passenger_user_switching is not introduced until version 3.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if ($rack_auto_detect or $rack_autodetect) { + if (versioncmp($passenger_installed_version, '4.0.0') > 0) { + fail('REMOVED PASSENGER OPTION :: rack_auto_detect :: These options have been removed in version 4.0.0 as part of an optimization. You should use PassengerEnabled instead.') + } + } + if $rack_base_uri { + if (versioncmp($passenger_installed_version, '3.0.0') > 0) { + warning('DEPRECATED PASSENGER OPTION :: rack_base_uri :: Deprecated in 3.0.0 in favor of PassengerBaseURI.') + } + } + if $rack_env { + if (versioncmp($passenger_installed_version, '2.0.0') < 0) { + fail("Passenger config option :: rack_env is not introduced until version 2.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $rails_allow_mod_rewrite { + if (versioncmp($passenger_installed_version, '4.0.0') > 0) { + warning("DEPRECATED PASSENGER OPTION :: rails_allow_mod_rewrite :: This option doesn't do anything anymore in since version 4.0.0.") + } + } + if $rails_app_spawner_idle_time { + if (versioncmp($passenger_installed_version, '4.0.0') > 0) { + fail('REMOVED PASSENGER OPTION :: rails_app_spawner_idle_time :: This option has been removed in version 4.0.0, and replaced with PassengerMaxPreloaderIdleTime.') + } + } + if ($rails_auto_detect or $rails_autodetect) { + if (versioncmp($passenger_installed_version, '4.0.0') > 0) { + fail('REMOVED PASSENGER OPTION :: rails_auto_detect :: These options have been removed in version 4.0.0 as part of an optimization. You should use PassengerEnabled instead.') + } + } + if $rails_base_uri { + if (versioncmp($passenger_installed_version, '3.0.0') > 0) { + warning('DEPRECATED PASSENGER OPTION :: rails_base_uri :: Deprecated in 3.0.0 in favor of PassengerBaseURI.') + } + } + if $rails_default_user { + if (versioncmp($passenger_installed_version, '3.0.0') > 0) { + warning('DEPRECATED PASSENGER OPTION :: rails_default_user :: Deprecated in 3.0.0 in favor of PassengerDefaultUser.') + } + } + if $rails_env { + if (versioncmp($passenger_installed_version, '2.0.0') < 0) { + fail("Passenger config option :: rails_env is not introduced until version 2.0.0 :: ${passenger_installed_version} is the version reported") + } + } + if $rails_framework_spawner_idle_time { + if (versioncmp($passenger_installed_version, '4.0.0') > 0) { + fail('REMOVED PASSENGER OPTION :: rails_framework_spawner_idle_time :: This option is no longer available in version 4.0.0. There is no alternative because framework spawning has been removed altogether. You should use smart spawning instead.') + } + } + if $rails_ruby { + if (versioncmp($passenger_installed_version, '3.0.0') > 0) { + warning('DEPRECATED PASSENGER OPTION :: rails_ruby :: Deprecated in 3.0.0 in favor of PassengerRuby.') + } + } + if $rails_spawn_method { + if (versioncmp($passenger_installed_version, '3.0.0') > 0) { + warning('DEPRECATED PASSENGER OPTION :: rails_spawn_method :: Deprecated in 3.0.0 in favor of PassengerSpawnMethod.') + } + } + if $rails_user_switching { + if (versioncmp($passenger_installed_version, '3.0.0') > 0) { + warning('DEPRECATED PASSENGER OPTION :: rails_user_switching :: Deprecated in 3.0.0 in favor of PassengerUserSwitching.') + } + } + if $wsgi_auto_detect { + if (versioncmp($passenger_installed_version, '4.0.0') > 0) { + fail('REMOVED PASSENGER OPTION :: wsgi_auto_detect :: These options have been removed in version 4.0.0 as part of an optimization. You should use PassengerEnabled instead.') + } + } + } + # Managed by the package, but declare it to avoid purging + if $passenger_conf_package_file { + file { 'passenger_package.conf': + path => "${apache::confd_dir}/${passenger_conf_package_file}", + } + } + + $_package = $mod_package + $_package_ensure = $mod_package_ensure + $_lib = $mod_lib + if $::osfamily == 'FreeBSD' { + if $mod_lib_path { + $_lib_path = $mod_lib_path + } else { + $_lib_path = "${passenger_root}/buildout/apache2" + } + } else { + $_lib_path = $mod_lib_path + } + + if $::osfamily == 'RedHat' and $manage_repo { + if $::operatingsystem == 'Amazon' { + if $::operatingsystemmajrelease == '2' { + $baseurl = 'https://oss-binaries.phusionpassenger.com/yum/passenger/el/7/$basearch' + } else { + $baseurl = 'https://oss-binaries.phusionpassenger.com/yum/passenger/el/6/$basearch' + } + } else { + $baseurl = 'https://oss-binaries.phusionpassenger.com/yum/passenger/el/$releasever/$basearch' + } + + yumrepo { 'passenger': + ensure => 'present', + baseurl => $baseurl, + descr => 'passenger', + enabled => '1', + gpgcheck => '0', + gpgkey => 'https://oss-binaries.phusionpassenger.com/auto-software-signing-gpg-key.txt', + repo_gpgcheck => '1', + sslcacert => '/etc/pki/tls/certs/ca-bundle.crt', + sslverify => '1', + before => Apache::Mod['passenger'], + } + } + + unless ($::operatingsystem == 'SLES') { + $_id = $mod_id + $_path = $mod_path + ::apache::mod { 'passenger': + package => $_package, + package_ensure => $_package_ensure, + lib => $_lib, + lib_path => $_lib_path, + id => $_id, + path => $_path, + loadfile_name => 'zpassenger.load', + } + } + + # Template uses: + # - $passenger_allow_encoded_slashes : since 4.0.0. + # - $passenger_app_env : since 4.0.0. + # - $passenger_app_group_name : since 4.0.0. + # - $passenger_app_root : since 4.0.0. + # - $passenger_app_type : since 4.0.25. + # - $passenger_base_uri : since 4.0.0. + # - $passenger_buffer_response : since 4.0.0. + # - $passenger_buffer_upload : since 4.0.26. + # - $passenger_concurrency_model : since 4.0.0. + # - $passenger_data_buffer_dir : since 5.0.0. + # - $passenger_debug_log_file : since unkown. Deprecated in 5.0.5. + # - $passenger_debugger : since 3.0.0. + # - $passenger_default_group : since 3.0.0. + # - $passenger_default_ruby : since 4.0.0. + # - $passenger_default_user : since 3.0.0. + # - $passenger_disable_security_update_check : since 5.1.0. + # - $passenger_enabled : since 4.0.0. + # - $passenger_error_override : since 4.0.24. + # - $passenger_file_descriptor_log_file : since 5.0.5. + # - $passenger_fly_with : since 4.0.45. + # - $passenger_force_max_concurrent_requests_per_process : since 5.0.22. + # - $passenger_friendly_error_pages : since 4.0.42. + # - $passenger_group : since 4.0.0. + # - $passenger_high_performance : since 2.0.0. + # - $passenger_instance_registry_dir : since 5.0.0. + # - $passenger_load_shell_envvars : since 4.0.20. + # - $passenger_log_file : since 5.0.5. + # - $passenger_log_level : since 3.0.0. + # - $passenger_lve_min_uid : since 5.0.28. + # - $passenger_max_instances : since 3.0.0. + # - $passenger_max_instances_per_app : since 3.0.0. + # - $passenger_max_pool_size : since 1.0.0. + # - $passenger_max_preloader_idle_time : since 4.0.0. + # - $passenger_max_request_queue_size : since 4.0.15. + # - $passenger_max_request_time : since 3.0.0. + # - $passenger_max_requests : since 3.0.0. + # - $passenger_memory_limit : since 3.0.0. + # - $passenger_meteor_app_settings : since 5.0.7. + # - $passenger_min_instances : since 3.0.0. + # - $passenger_nodejs : since 4.0.24. + # - $passenger_pool_idle_time : since 1.0.0. + # - $passenger_pre_start : since 3.0.0. + # - $passenger_python : since 4.0.0. + # - $passenger_resist_deployment_errors : since 3.0.0. + # - $passenger_resolve_symlinks_in_document_root : since 3.0.0. + # - $passenger_response_buffer_high_watermark : since 5.0.0. + # - $passenger_restart_dir : since 3.0.0. + # - $passenger_rolling_restarts : since 3.0.0. + # - $passenger_root : since 1.0.0. + # - $passenger_ruby : since 4.0.0. + # - $passenger_security_update_check_proxy : since 5.1.0. + # - $passenger_show_version_in_header : since 5.1.0. + # - $passenger_socket_backlog : since 5.0.24. + # - $passenger_spawn_method : since 2.0.0. + # - $passenger_start_timeout : since 4.0.15. + # - $passenger_startup_file : since 4.0.25. + # - $passenger_stat_throttle_rate : since 2.2.0. + # - $passenger_sticky_sessions : since 4.0.45. + # - $passenger_sticky_sessions_cookie_name : since 4.0.45. + # - $passenger_thread_count : since 4.0.0. + # - $passenger_use_global_queue : since 2.0.4.Deprecated in 4.0.0. + # - $passenger_user : since 4.0.0. + # - $passenger_user_switching : since 3.0.0. + # - $rack_auto_detect : since unkown. Deprecated in 4.0.0. + # - $rack_base_uri : since unkown. Deprecated in 3.0.0. + # - $rack_env : since 2.0.0. + # - $rails_allow_mod_rewrite : since unkown. Deprecated in 4.0.0. + # - $rails_app_spawner_idle_time : since unkown. Deprecated in 4.0.0. + # - $rails_auto_detect : since unkown. Deprecated in 4.0.0. + # - $rails_base_uri : since unkown. Deprecated in 3.0.0. + # - $rails_default_user : since unkown. Deprecated in 3.0.0. + # - $rails_env : since 2.0.0. + # - $rails_framework_spawner_idle_time : since unkown. Deprecated in 4.0.0. + # - $rails_ruby : since unkown. Deprecated in 3.0.0. + # - $rails_spawn_method : since unkown. Deprecated in 3.0.0. + # - $rails_user_switching : since unkown. Deprecated in 3.0.0. + # - $wsgi_auto_detect : since unkown. Deprecated in 4.0.0. + # - $rails_autodetect : this options is only for backward compatiblity with older versions of this class + # - $rack_autodetect : this options is only for backward compatiblity with older versions of this class + file { 'passenger.conf': + ensure => file, + path => "${apache::mod_dir}/${passenger_conf_file}", + content => template('apache/mod/passenger.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/perl.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/perl.pp new file mode 100644 index 000000000..f883305ea --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/perl.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_perl`. +# +# @see https://perl.apache.org for additional documentation. +# +class apache::mod::perl { + include apache + ::apache::mod { 'perl': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/peruser.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/peruser.pp new file mode 100644 index 000000000..4fec2c04c --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/peruser.pp @@ -0,0 +1,82 @@ +# @summary +# Installs `mod_peruser`. +# +# @todo +# Add docs +class apache::mod::peruser ( + $minspareprocessors = '2', + $minprocessors = '2', + $maxprocessors = '10', + $maxclients = '150', + $maxrequestsperchild = '1000', + $idletimeout = '120', + $expiretimeout = '120', + $keepalive = 'Off', +) { + include apache + case $::osfamily { + 'freebsd' : { + fail("Unsupported osfamily ${::osfamily}") + } + default: { + if $::osfamily == 'gentoo' { + ::portage::makeconf { 'apache2_mpms': + content => 'peruser', + } + } + + if defined(Class['apache::mod::event']) { + fail('May not include both apache::mod::peruser and apache::mod::event on the same node') + } + if defined(Class['apache::mod::itk']) { + fail('May not include both apache::mod::peruser and apache::mod::itk on the same node') + } + if defined(Class['apache::mod::prefork']) { + fail('May not include both apache::mod::peruser and apache::mod::prefork on the same node') + } + if defined(Class['apache::mod::worker']) { + fail('May not include both apache::mod::peruser and apache::mod::worker on the same node') + } + File { + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + } + + $mod_dir = $apache::mod_dir + + # Template uses: + # - $minspareprocessors + # - $minprocessors + # - $maxprocessors + # - $maxclients + # - $maxrequestsperchild + # - $idletimeout + # - $expiretimeout + # - $keepalive + # - $mod_dir + file { "${apache::mod_dir}/peruser.conf": + ensure => file, + mode => $apache::file_mode, + content => template('apache/mod/peruser.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + file { "${apache::mod_dir}/peruser": + ensure => directory, + require => File[$apache::mod_dir], + } + file { "${apache::mod_dir}/peruser/multiplexers": + ensure => directory, + require => File["${apache::mod_dir}/peruser"], + } + file { "${apache::mod_dir}/peruser/processors": + ensure => directory, + require => File["${apache::mod_dir}/peruser"], + } + + ::apache::peruser::multiplexer { '01-default': } + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/php.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/php.pp new file mode 100644 index 000000000..02c51be64 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/php.pp @@ -0,0 +1,118 @@ +# @summary +# Installs `mod_php`. +# +# @todo +# Add docs +class apache::mod::php ( + $package_name = undef, + $package_ensure = 'present', + $path = undef, + Array $extensions = ['.php'], + $content = undef, + $template = 'apache/mod/php.conf.erb', + $source = undef, + $root_group = $apache::params::root_group, + $php_version = $apache::params::php_version, + $libphp_prefix = 'libphp' +) inherits apache::params { + include apache + if (versioncmp($php_version, '8') < 0) { + $mod = "php${php_version}" + } else { + $mod = 'php' + } + + if $apache::version::scl_httpd_version == undef and $apache::version::scl_php_version != undef { + fail('If you define apache::version::scl_php_version, you also need to specify apache::version::scl_httpd_version') + } + if defined(Class['::apache::mod::prefork']) { + Class['::apache::mod::prefork']->File["${mod}.conf"] + } + elsif defined(Class['::apache::mod::itk']) { + Class['::apache::mod::itk']->File["${mod}.conf"] + } + else { + fail('apache::mod::php requires apache::mod::prefork or apache::mod::itk; please enable mpm_module => \'prefork\' or mpm_module => \'itk\' on Class[\'apache\']') + } + + if $source and ($content or $template != 'apache/mod/php.conf.erb') { + warning('source and content or template parameters are provided. source parameter will be used') + } elsif $content and $template != 'apache/mod/php.conf.erb' { + warning('content and template parameters are provided. content parameter will be used') + } + + $manage_content = $source ? { + undef => $content ? { + undef => template($template), + default => $content, + }, + default => undef, + } + + # Determine if we have a package + $mod_packages = $apache::mod_packages + if $package_name { + $_package_name = $package_name + } elsif has_key($mod_packages, $mod) { # 2.6 compatibility hack + $_package_name = $mod_packages[$mod] + } elsif has_key($mod_packages, 'phpXXX') { # 2.6 compatibility hack + $_package_name = regsubst($mod_packages['phpXXX'], 'XXX', $php_version) + } else { + $_package_name = undef + } + + $_php_major = regsubst($php_version, '^(\d+)\..*$', '\1') + $_php_version_no_dot = regsubst($php_version, '\.', '') + if $apache::version::scl_httpd_version { + $_lib = "librh-php${_php_version_no_dot}-php${_php_major}.so" + } else { + # Controls php version and libphp prefix + $_lib = $_php_major ? { + '8' => "${libphp_prefix}.so", + default => "${libphp_prefix}${php_version}.so", + } + } + $_module_id = $_php_major ? { + '5' => 'php5_module', + '7' => 'php7_module', + default => 'php_module', + } + + if $::operatingsystem == 'SLES' { + ::apache::mod { $mod: + package => $_package_name, + package_ensure => $package_ensure, + lib => "mod_${mod}.so", + id => $_module_id, + path => "${apache::lib_path}/mod_${mod}.so", + } + } else { + ::apache::mod { $mod: + package => $_package_name, + package_ensure => $package_ensure, + lib => $_lib, + id => $_module_id, + path => $path, + } + } + + include apache::mod::mime + include apache::mod::dir + Class['::apache::mod::mime'] -> Class['::apache::mod::dir'] -> Class['::apache::mod::php'] + + # Template uses $extensions + file { "${mod}.conf": + ensure => file, + path => "${apache::mod_dir}/${mod}.conf", + owner => 'root', + group => $root_group, + mode => $apache::file_mode, + content => $manage_content, + source => $source, + require => [ + Exec["mkdir ${apache::mod_dir}"], + ], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/prefork.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/prefork.pp new file mode 100644 index 000000000..f6c6315ae --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/prefork.pp @@ -0,0 +1,134 @@ +# @summary +# Installs and configures MPM `prefork`. +# +# @param startservers +# Number of child server processes created at startup. +# +# @param minspareservers +# Minimum number of idle child server processes. +# +# @param maxspareservers +# Maximum number of idle child server processes. +# +# @param serverlimit +# Upper limit on configurable number of processes. +# +# @param maxclients +# Old alias for MaxRequestWorkers. +# +# @param maxrequestworkers +# Maximum number of connections that will be processed simultaneously. +# +# @param maxrequestsperchild +# Old alias for MaxConnectionsPerChild. +# +# @param maxconnectionsperchild +# Limit on the number of connections that an individual child server will handle during its life. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @param listenbacklog +# Maximum length of the queue of pending connections. +# +# @see https://httpd.apache.org/docs/current/mod/prefork.html for additional documentation. +# +class apache::mod::prefork ( + $startservers = '8', + $minspareservers = '5', + $maxspareservers = '20', + $serverlimit = '256', + $maxclients = '256', + $maxrequestworkers = undef, + $maxrequestsperchild = '4000', + $maxconnectionsperchild = undef, + $apache_version = undef, + $listenbacklog = '511' +) { + include apache + $_apache_version = pick($apache_version, $apache::apache_version) + if defined(Class['apache::mod::event']) { + fail('May not include both apache::mod::prefork and apache::mod::event on the same node') + } + if versioncmp($_apache_version, '2.4') < 0 { + if defined(Class['apache::mod::itk']) { + fail('May not include both apache::mod::prefork and apache::mod::itk on the same node') + } + } + if defined(Class['apache::mod::peruser']) { + fail('May not include both apache::mod::prefork and apache::mod::peruser on the same node') + } + if defined(Class['apache::mod::worker']) { + fail('May not include both apache::mod::prefork and apache::mod::worker on the same node') + } + + if versioncmp($_apache_version, '2.3.13') < 0 { + if $maxrequestworkers == undef { + warning("For newer versions of Apache, \$maxclients is deprecated, please use \$maxrequestworkers.") + } elsif $maxconnectionsperchild == undef { + warning("For newer versions of Apache, \$maxrequestsperchild is deprecated, please use \$maxconnectionsperchild.") + } + } + + File { + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + } + + # Template uses: + # - $startservers + # - $minspareservers + # - $maxspareservers + # - $serverlimit + # - $maxclients + # - $maxrequestworkers + # - $maxrequestsperchild + # - $maxconnectionsperchild + file { "${apache::mod_dir}/prefork.conf": + ensure => file, + content => template('apache/mod/prefork.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + + case $::osfamily { + 'redhat': { + if versioncmp($_apache_version, '2.4') >= 0 { + ::apache::mpm { 'prefork': + apache_version => $_apache_version, + } + } + else { + file_line { '/etc/sysconfig/httpd prefork enable': + ensure => present, + path => '/etc/sysconfig/httpd', + line => '#HTTPD=/usr/sbin/httpd.worker', + match => '#?HTTPD=/usr/sbin/httpd.worker', + require => Package['httpd'], + notify => Class['apache::service'], + } + } + } + 'debian', 'freebsd': { + ::apache::mpm { 'prefork': + apache_version => $_apache_version, + } + } + 'Suse': { + ::apache::mpm { 'prefork': + apache_version => $apache_version, + lib_path => '/usr/lib64/apache2-prefork', + } + } + 'gentoo': { + ::portage::makeconf { 'apache2_mpms': + content => 'prefork', + } + } + default: { + fail("Unsupported osfamily ${::osfamily}") + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy.pp new file mode 100644 index 000000000..2a9eb7149 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy.pp @@ -0,0 +1,52 @@ +# @summary +# Installs and configures `mod_proxy`. +# +# @param proxy_requests +# Enables forward (standard) proxy requests. +# +# @param allow_from +# List of IPs allowed to access proxy. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @param package_name +# Name of the proxy package to install. +# +# @param proxy_via +# Set local IP address for outgoing proxy connections. +# +# @param proxy_timeout +# Network timeout for proxied requests. +# +# @param proxy_iobuffersize +# Set the size of internal data throughput buffer +# +# @see https://httpd.apache.org/docs/current/mod/mod_proxy.html for additional documentation. +# +class apache::mod::proxy ( + $proxy_requests = 'Off', + $allow_from = undef, + $apache_version = undef, + $package_name = undef, + $proxy_via = 'On', + $proxy_timeout = undef, + $proxy_iobuffersize = undef, +) { + include apache + $_proxy_timeout = $apache::timeout + $_apache_version = pick($apache_version, $apache::apache_version) + ::apache::mod { 'proxy': + package => $package_name, + } + # Template uses $proxy_requests, $_apache_version + file { 'proxy.conf': + ensure => file, + path => "${apache::mod_dir}/proxy.conf", + mode => $apache::file_mode, + content => template('apache/mod/proxy.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_ajp.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_ajp.pp new file mode 100644 index 000000000..36bea00c8 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_ajp.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_proxy_ajp`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_proxy_ajp.html for additional documentation. +# +class apache::mod::proxy_ajp { + Class['::apache::mod::proxy'] -> Class['::apache::mod::proxy_ajp'] + ::apache::mod { 'proxy_ajp': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_balancer.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_balancer.pp new file mode 100644 index 000000000..43bd0af65 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_balancer.pp @@ -0,0 +1,45 @@ +# @summary +# Installs and configures `mod_proxy_balancer`. +# +# @param manager +# Toggle whether to enable balancer manager support. +# +# @param maanger_path +# Server relative path to balancer manager. +# +# @param allow_from +# List of IPs from which the balancer manager can be accessed. +# +# @param apache_version +# Version of Apache to install module on. +# +# @see https://httpd.apache.org/docs/current/mod/mod_proxy_balancer.html for additional documentation. +# +class apache::mod::proxy_balancer ( + Boolean $manager = false, + Stdlib::Absolutepath $manager_path = '/balancer-manager', + Array $allow_from = ['127.0.0.1','::1'], + $apache_version = $apache::apache_version, +) { + include apache::mod::proxy + include apache::mod::proxy_http + if versioncmp($apache_version, '2.4') >= 0 { + ::apache::mod { 'slotmem_shm': } + } + + Class['::apache::mod::proxy'] -> Class['::apache::mod::proxy_balancer'] + Class['::apache::mod::proxy_http'] -> Class['::apache::mod::proxy_balancer'] + ::apache::mod { 'proxy_balancer': } + if $manager { + include apache::mod::status + file { 'proxy_balancer.conf': + ensure => file, + path => "${apache::mod_dir}/proxy_balancer.conf", + mode => $apache::file_mode, + content => template('apache/mod/proxy_balancer.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_connect.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_connect.pp new file mode 100644 index 000000000..e09cab079 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_connect.pp @@ -0,0 +1,18 @@ +# @summary +# Installs `mod_proxy_connect`. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @see https://httpd.apache.org/docs/current/mod/mod_proxy_connect.html for additional documentation. +# +class apache::mod::proxy_connect ( + $apache_version = undef, +) { + include apache + $_apache_version = pick($apache_version, $apache::apache_version) + if versioncmp($_apache_version, '2.2') >= 0 { + Class['::apache::mod::proxy'] -> Class['::apache::mod::proxy_connect'] + ::apache::mod { 'proxy_connect': } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_fcgi.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_fcgi.pp new file mode 100644 index 000000000..84bc3d178 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_fcgi.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_proxy_fcgi`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_proxy_fcgi.html for additional documentation. +# +class apache::mod::proxy_fcgi { + Class['::apache::mod::proxy'] -> Class['::apache::mod::proxy_fcgi'] + ::apache::mod { 'proxy_fcgi': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_html.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_html.pp new file mode 100644 index 000000000..0205af848 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_html.pp @@ -0,0 +1,60 @@ +# @summary +# Installs `mod_proxy_html`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_proxy_html.html for additional documentation. +# +class apache::mod::proxy_html { + include apache + Class['::apache::mod::proxy'] -> Class['::apache::mod::proxy_html'] + Class['::apache::mod::proxy_http'] -> Class['::apache::mod::proxy_html'] + + # Add libxml2 + case $::osfamily { + /RedHat|FreeBSD|Gentoo|Suse/: { + ::apache::mod { 'xml2enc': } + $loadfiles = undef + } + 'Debian': { + $gnu_path = $::hardwaremodel ? { + 'i686' => 'i386', + default => $::hardwaremodel, + } + case $::operatingsystem { + 'Ubuntu': { + $loadfiles = $facts['operatingsystemmajrelease'] ? { + '10' => ['/usr/lib/libxml2.so.2'], + default => ["/usr/lib/${gnu_path}-linux-gnu/libxml2.so.2"], + } + } + 'Debian': { + $loadfiles = $facts['operatingsystemmajrelease'] ? { + '6' => ['/usr/lib/libxml2.so.2'], + default => ["/usr/lib/${gnu_path}-linux-gnu/libxml2.so.2"], + } + } + default: { + $loadfiles = ["/usr/lib/${gnu_path}-linux-gnu/libxml2.so.2"] + } + } + if versioncmp($apache::apache_version, '2.4') >= 0 { + ::apache::mod { 'xml2enc': } + } + } + default: {} + } + + ::apache::mod { 'proxy_html': + loadfiles => $loadfiles, + } + + # Template uses $icons_path + file { 'proxy_html.conf': + ensure => file, + path => "${apache::mod_dir}/proxy_html.conf", + mode => $apache::file_mode, + content => template('apache/mod/proxy_html.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_http.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_http.pp new file mode 100644 index 000000000..b80857c20 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_http.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_proxy_http`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_proxy_http.html for additional documentation. +# +class apache::mod::proxy_http { + Class['::apache::mod::proxy'] -> Class['::apache::mod::proxy_http'] + ::apache::mod { 'proxy_http': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_wstunnel.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_wstunnel.pp new file mode 100644 index 000000000..a7dc00f0f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/proxy_wstunnel.pp @@ -0,0 +1,10 @@ +# @summary +# Installs `mod_proxy_wstunnel`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_proxy_wstunnel.html for additional documentation. +# +class apache::mod::proxy_wstunnel { + include apache, apache::mod::proxy + Class['::apache::mod::proxy'] -> Class['::apache::mod::proxy_wstunnel'] + ::apache::mod { 'proxy_wstunnel': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/python.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/python.pp new file mode 100644 index 000000000..91f1d3818 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/python.pp @@ -0,0 +1,16 @@ +# @summary +# Installs and configures `mod_python`. +# +# @param loadfile_name +# Sets the name of the configuration file that is used to load the python module. +# +# @see https://github.com/grisha/mod_python for additional documentation. +# +class apache::mod::python ( + Optional[String] $loadfile_name = undef, +) { + include apache + ::apache::mod { 'python': + loadfile_name => $loadfile_name, + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/remoteip.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/remoteip.pp new file mode 100644 index 000000000..addc966fa --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/remoteip.pp @@ -0,0 +1,114 @@ +# @summary +# Installs and configures `mod_remoteip`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_remoteip.html +# +# @param header +# The header field in which `mod_remoteip` will look for the useragent IP. +# +# @param internal_proxy +# A list of IP addresses, IP blocks or hostname that are trusted to set a +# valid value inside specified header. Unlike the `$trusted_proxy_ips` +# parameter, any IP address (including private addresses) presented by these +# proxies will trusted by `mod_remoteip`. +# +# @param proxy_ips +# *Deprecated*: use `$internal_proxy` instead. +# +# @param internal_proxy_list +# The path to a file containing a list of IP addresses, IP blocks or hostname +# that are trusted to set a valid value inside the specified header. See +# `$internal_proxy` for details. +# +# @param proxies_header +# A header into which `mod_remoteip` will collect a list of all of the +# intermediate client IP addresses trusted to resolve the useragent IP of the +# request (e.g. `X-Forwarded-By`). +# +# @param proxy_protocol +# Wether or not to enable the PROXY protocol header handling. If enabled +# upstream clients must set the header every time they open a connection. +# +# @param proxy_protocol_exceptions +# A list of IP address or IP blocks that are not required to use the PROXY +# protocol. +# +# @param trusted_proxy +# A list of IP addresses, IP blocks or hostname that are trusted to set a +# valid value inside the specified header. Unlike the `$proxy_ips` parameter, +# any private IP presented by these proxies will be disgarded by +# `mod_remoteip`. +# +# @param trusted_proxy_ips +# *Deprecated*: use `$trusted_proxy` instead. +# +# @param trusted_proxy_list +# The path to a file containing a list of IP addresses, IP blocks or hostname +# that are trusted to set a valid value inside the specified header. See +# `$trusted_proxy` for details. +# +# @param apache_version +# A version string used to validate that your apache version supports +# `mod_remoteip`. If not specified, `$::apache::apache_version` is used. +# +# @see https://httpd.apache.org/docs/current/mod/mod_remoteip.html for additional documentation. +# +class apache::mod::remoteip ( + String $header = 'X-Forwarded-For', + Optional[Array[Variant[Stdlib::Host,Stdlib::IP::Address]]] $internal_proxy = undef, + Optional[Array[Variant[Stdlib::Host,Stdlib::IP::Address]]] $proxy_ips = undef, + Optional[Stdlib::Absolutepath] $internal_proxy_list = undef, + Optional[String] $proxies_header = undef, + Boolean $proxy_protocol = false, + Optional[Array[Variant[Stdlib::Host,Stdlib::IP::Address]]] $proxy_protocol_exceptions = undef, + Optional[Array[Stdlib::Host]] $trusted_proxy = undef, + Optional[Array[Stdlib::Host]] $trusted_proxy_ips = undef, + Optional[Stdlib::Absolutepath] $trusted_proxy_list = undef, + Optional[String] $apache_version = undef, +) { + include apache + + $_apache_version = pick($apache_version, $apache::apache_version) + if versioncmp($_apache_version, '2.4') < 0 { + fail('mod_remoteip is only available in Apache 2.4') + } + + if $proxy_ips { + deprecation('apache::mod::remoteip::proxy_ips', 'This parameter is deprecated, please use `internal_proxy`.') + $_internal_proxy = $proxy_ips + } elsif $internal_proxy { + $_internal_proxy = $internal_proxy + } else { + $_internal_proxy = ['127.0.0.1'] + } + + if $trusted_proxy_ips { + deprecation('apache::mod::remoteip::trusted_proxy_ips', 'This parameter is deprecated, please use `trusted_proxy`.') + $_trusted_proxy = $trusted_proxy_ips + } else { + $_trusted_proxy = $trusted_proxy + } + + ::apache::mod { 'remoteip': } + + $template_parameters = { + header => $header, + internal_proxy => $_internal_proxy, + internal_proxy_list => $internal_proxy_list, + proxies_header => $proxies_header, + proxy_protocol => $proxy_protocol, + proxy_protocol_exceptions => $proxy_protocol_exceptions, + trusted_proxy => $_trusted_proxy, + trusted_proxy_list => $trusted_proxy_list, + } + + file { 'remoteip.conf': + ensure => file, + path => "${apache::mod_dir}/remoteip.conf", + mode => $apache::file_mode, + content => epp('apache/mod/remoteip.conf.epp', $template_parameters), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/reqtimeout.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/reqtimeout.pp new file mode 100644 index 000000000..a971e045d --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/reqtimeout.pp @@ -0,0 +1,24 @@ +# @summary +# Installs and configures `mod_reqtimeout`. +# +# @param timeouts +# List of timeouts and data rates for receiving requests. +# +# @see https://httpd.apache.org/docs/current/mod/mod_reqtimeout.html for additional documentation. +# +class apache::mod::reqtimeout ( + $timeouts = ['header=20-40,minrate=500', 'body=10,minrate=500'] +) { + include apache + ::apache::mod { 'reqtimeout': } + # Template uses no variables + file { 'reqtimeout.conf': + ensure => file, + path => "${apache::mod_dir}/reqtimeout.conf", + mode => $apache::file_mode, + content => template('apache/mod/reqtimeout.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/rewrite.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/rewrite.pp new file mode 100644 index 000000000..06986d1e8 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/rewrite.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_rewrite`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_rewrite.html for additional documentation. +# +class apache::mod::rewrite { + include apache::params + ::apache::mod { 'rewrite': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/rpaf.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/rpaf.pp new file mode 100644 index 000000000..7e4bab23e --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/rpaf.pp @@ -0,0 +1,40 @@ +# @summary +# Installs and configures `mod_rpaf`. +# +# @param sethostname +# Toggles whether to update vhost name so ServerName and ServerAlias work. +# +# @param proxy_ips +# List of IPs & bitmasked subnets to adjust requests for +# +# @param header +# Header to use for the real IP address. +# +# @param template +# Path to template to use for configuring mod_rpaf. +# +# @see https://github.com/gnif/mod_rpaf for additional documentation. +# +class apache::mod::rpaf ( + $sethostname = true, + $proxy_ips = ['127.0.0.1'], + $header = 'X-Forwarded-For', + $template = 'apache/mod/rpaf.conf.erb' +) { + include apache + ::apache::mod { 'rpaf': } + + # Template uses: + # - $sethostname + # - $proxy_ips + # - $header + file { 'rpaf.conf': + ensure => file, + path => "${apache::mod_dir}/rpaf.conf", + mode => $apache::file_mode, + content => template($template), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/security.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/security.pp new file mode 100644 index 000000000..4234f4088 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/security.pp @@ -0,0 +1,269 @@ +# @summary +# Installs and configures `mod_security`. +# +# @param version +# Manage mod_security or mod_security2 +# +# @param logroot +# Configures the location of audit and debug logs. +# +# @param crs_package +# Name of package that installs CRS rules. +# +# @param activated_rules +# An array of rules from the modsec_crs_path or absolute to activate via symlinks. +# +# @param modsec_dir +# Defines the path where Puppet installs the modsec configuration and activated rules links. +# +# @param modsec_secruleengine +# Configures the rules engine. +# +# @param audit_log_relevant_status +# Configures which response status code is to be considered relevant for the purpose of audit logging. +# +# @param audit_log_parts +# Defines which parts of each transaction are going to be recorded in the audit log. Each part is assigned a single letter; when a +# letter appears in the list then the equivalent part will be recorded. +# +# @param audit_log_type +# Defines the type of audit logging mechanism to be used. +# +# @param audit_log_storage_dir +# Defines the directory where concurrent audit log entries are to be stored. This directive is only needed when concurrent audit logging is used. +# +# @param secpcrematchlimit +# Sets the match limit in the PCRE library. +# +# @param secpcrematchlimitrecursion +# Sets the match limit recursion in the PCRE library. +# +# @param allowed_methods +# A space-separated list of allowed HTTP methods. +# +# @param content_types +# A list of one or more allowed MIME types. +# +# @param restricted_extensions +# A space-sparated list of prohibited file extensions. +# +# @param restricted_headers +# A list of restricted headers separated by slashes and spaces. +# +# @param secdefaultaction +# Defines the default list of actions, which will be inherited by the rules in the same configuration context. +# +# @param anomaly_score_blocking +# Activates or deactivates the Collaborative Detection Blocking of the OWASP ModSecurity Core Rule Set. +# +# @param inbound_anomaly_threshold +# Sets the scoring threshold level of the inbound blocking rules for the Collaborative Detection Mode in the OWASP ModSecurity Core Rule Set. +# +# @param outbound_anomaly_threshold +# Sets the scoring threshold level of the outbound blocking rules for the Collaborative Detection Mode in the OWASP ModSecurity Core Rule Set. +# +# @param critical_anomaly_score +# Sets the Anomaly Score for rules assigned with a critical severity. +# +# @param error_anomaly_score +# Sets the Anomaly Score for rules assigned with a error severity. +# +# @param warning_anomaly_score +# Sets the Anomaly Score for rules assigned with a warning severity. +# +# @param notice_anomaly_score +# Sets the Anomaly Score for rules assigned with a notice severity. +# +# @param secrequestmaxnumargs +# Sets the maximum number of arguments in the request. +# +# @param secrequestbodylimit +# Sets the maximum request body size ModSecurity will accept for buffering. +# +# @param secrequestbodynofileslimit +# Configures the maximum request body size ModSecurity will accept for buffering, excluding the size of any files being transported +# in the request. +# +# @param secrequestbodyinmemorylimit +# Configures the maximum request body size that ModSecurity will store in memory. +# +# @param manage_security_crs +# Toggles whether to manage ModSecurity Core Rule Set +# +# @see https://github.com/SpiderLabs/ModSecurity/wiki for additional documentation. +# +class apache::mod::security ( + $logroot = $apache::params::logroot, + $version = $apache::params::modsec_version, + $crs_package = $apache::params::modsec_crs_package, + $activated_rules = $apache::params::modsec_default_rules, + $custom_rules = $apache::params::modsec_custom_rules, + $custom_rules_set = $apache::params::modsec_custom_rules_set, + $modsec_dir = $apache::params::modsec_dir, + $modsec_secruleengine = $apache::params::modsec_secruleengine, + $audit_log_relevant_status = '^(?:5|4(?!04))', + $audit_log_parts = $apache::params::modsec_audit_log_parts, + $audit_log_type = $apache::params::modsec_audit_log_type, + $audit_log_storage_dir = undef, + $secpcrematchlimit = $apache::params::secpcrematchlimit, + $secpcrematchlimitrecursion = $apache::params::secpcrematchlimitrecursion, + $allowed_methods = 'GET HEAD POST OPTIONS', + $content_types = 'application/x-www-form-urlencoded|multipart/form-data|text/xml|application/xml|application/x-amf', + $restricted_extensions = '.asa/ .asax/ .ascx/ .axd/ .backup/ .bak/ .bat/ .cdx/ .cer/ .cfg/ .cmd/ .com/ .config/ .conf/ .cs/ .csproj/ .csr/ .dat/ .db/ .dbf/ .dll/ .dos/ .htr/ .htw/ .ida/ .idc/ .idq/ .inc/ .ini/ .key/ .licx/ .lnk/ .log/ .mdb/ .old/ .pass/ .pdb/ .pol/ .printer/ .pwd/ .resources/ .resx/ .sql/ .sys/ .vb/ .vbs/ .vbproj/ .vsdisco/ .webinfo/ .xsd/ .xsx/', + $restricted_headers = '/Proxy-Connection/ /Lock-Token/ /Content-Range/ /Translate/ /via/ /if/', + $secdefaultaction = 'deny', + $anomaly_score_blocking = 'off', + $inbound_anomaly_threshold = '5', + $outbound_anomaly_threshold = '4', + $critical_anomaly_score = '5', + $error_anomaly_score = '4', + $warning_anomaly_score = '3', + $notice_anomaly_score = '2', + $secrequestmaxnumargs = '255', + $secrequestbodylimit = '13107200', + $secrequestbodynofileslimit = '131072', + $secrequestbodyinmemorylimit = '131072', + $manage_security_crs = true, +) inherits ::apache::params { + include apache + + $_secdefaultaction = $secdefaultaction ? { + /log/ => $secdefaultaction, # it has log or nolog,auditlog or log,noauditlog + default => "${secdefaultaction},log", + } + + if $::osfamily == 'FreeBSD' { + fail('FreeBSD is not currently supported') + } + + if ($::osfamily == 'Suse' and versioncmp($::operatingsystemrelease, '11') < 0) { + fail('SLES 10 is not currently supported.') + } + + case $version { + 1: { + $mod_name = 'security' + $mod_conf_name = 'security.conf' + } + 2: { + $mod_name = 'security2' + $mod_conf_name = 'security2.conf' + } + default: { + fail('Unsuported version for mod security') + } + } + ::apache::mod { $mod_name: + id => 'security2_module', + lib => 'mod_security2.so', + } + + ::apache::mod { 'unique_id_module': + id => 'unique_id_module', + lib => 'mod_unique_id.so', + } + + if $crs_package { + package { $crs_package: + ensure => 'installed', + before => [ + File[$apache::confd_dir], + File[$modsec_dir], + ], + } + } + + # Template uses: + # - logroot + # - $modsec_dir + # - $audit_log_parts + # - $audit_log_type + # - $audit_log_storage_dir + # - secpcrematchlimit + # - secpcrematchlimitrecursion + # - secrequestbodylimit + # - secrequestbodynofileslimit + # - secrequestbodyinmemorylimit + file { 'security.conf': + ensure => file, + content => template('apache/mod/security.conf.erb'), + mode => $apache::file_mode, + path => "${apache::mod_dir}/${mod_conf_name}", + owner => $apache::params::user, + group => $apache::params::group, + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + + file { $modsec_dir: + ensure => directory, + owner => 'root', + group => 'root', + mode => '0755', + purge => true, + force => true, + recurse => true, + require => Package['httpd'], + } + + file { "${modsec_dir}/activated_rules": + ensure => directory, + owner => $apache::params::user, + group => $apache::params::group, + mode => '0555', + purge => true, + force => true, + recurse => true, + notify => Class['apache::service'], + } + + if $custom_rules { + # Template to add custom rule and included in security configuration + file {"${modsec_dir}/custom_rules": + ensure => directory, + owner => $apache::params::user, + group => $apache::params::group, + mode => $apache::file_mode, + require => File[$modsec_dir], + } + + file { "${modsec_dir}/custom_rules/custom_01_rules.conf": + ensure => file, + owner => $apache::params::user, + group => $apache::params::group, + mode => $apache::file_mode, + content => template('apache/mod/security_custom.conf.erb'), + require => File["${modsec_dir}/custom_rules"], + notify => Class['apache::service'], + } + } + + if $manage_security_crs { + # Template uses: + # - $_secdefaultaction + # - $critical_anomaly_score + # - $error_anomaly_score + # - $warning_anomaly_score + # - $notice_anomaly_score + # - $inbound_anomaly_threshold + # - $outbound_anomaly_threshold + # - $anomaly_score_blocking + # - $allowed_methods + # - $content_types + # - $restricted_extensions + # - $restricted_headers + # - $secrequestmaxnumargs + file { "${modsec_dir}/security_crs.conf": + ensure => file, + content => template('apache/mod/security_crs.conf.erb'), + require => File[$modsec_dir], + notify => Class['apache::service'], + } + + # Debian 9 has a different rule setup + unless $::operatingsystem == 'SLES' or ($::operatingsystem == 'Debian' and versioncmp($::operatingsystemrelease, '9') >= 0) or ($::operatingsystem == 'Ubuntu' and versioncmp($::operatingsystemrelease, '18.04') >= 0) { + apache::security::rule_link { $activated_rules: } + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/setenvif.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/setenvif.pp new file mode 100644 index 000000000..6b3586a7a --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/setenvif.pp @@ -0,0 +1,19 @@ +# @summary +# Installs `mod_setenvif`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_setenvif.html for additional documentation. +# +class apache::mod::setenvif { + include apache + ::apache::mod { 'setenvif': } + # Template uses no variables + file { 'setenvif.conf': + ensure => file, + path => "${apache::mod_dir}/setenvif.conf", + mode => $apache::file_mode, + content => template('apache/mod/setenvif.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/shib.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/shib.pp new file mode 100644 index 000000000..85946a10b --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/shib.pp @@ -0,0 +1,45 @@ +# @summary +# Installs and configures `mod_shib`. +# +# @param suppress_warning +# Toggles whether to trigger warning on RedHat nodes. +# +# @param mod_full_path +# Specifies a path to the module. Do not manually set this parameter without a special reason. +# +# @param package_name +# Name of the Shibboleth package to be installed. +# +# @param mod_lib +# Specifies a path to the module's libraries. Do not manually set this parameter without special reason. The `path` parameter +# overrides this value. +# +# This class installs and configures only the Apache components of a web application that consumes Shibboleth SSO identities. You +# can manage the Shibboleth configuration manually, with Puppet, or using a [Shibboleth Puppet Module](https://github.com/aethylred/puppet-shibboleth). +# +# @note +# The Shibboleth module isn't available on RH/CentOS without providing dependency packages provided by Shibboleth's repositories. +# See the [Shibboleth Service Provider Installation Guide](http://wiki.aaf.edu.au/tech-info/sp-install-guide). +# +# @see https://wiki.shibboleth.net/confluence/display/SHIB2/NativeSPApacheConfig for additional documentation. +# @note Unsupported platforms: RedHat: all; CentOS: all; Scientific: all; SLES: all; Debian: 7, 8; Ubuntu: all; OracleLinux: all +class apache::mod::shib ( + $suppress_warning = false, + $mod_full_path = undef, + $package_name = undef, + $mod_lib = undef, +) { + include apache + if $::osfamily == 'RedHat' and ! $suppress_warning { + warning('RedHat distributions do not have Apache mod_shib in their default package repositories.') + } + + $mod_shib = 'shib2' + + apache::mod { $mod_shib: + id => 'mod_shib', + path => $mod_full_path, + package => $package_name, + lib => $mod_lib, + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/socache_shmcb.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/socache_shmcb.pp new file mode 100644 index 000000000..e9be75dce --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/socache_shmcb.pp @@ -0,0 +1,8 @@ +# @summary +# Installs `mod_socache_shmcb`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_socache_shmcb.html for additional documentation. +# +class apache::mod::socache_shmcb { + ::apache::mod { 'socache_shmcb': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/speling.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/speling.pp new file mode 100644 index 000000000..538e8ffa6 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/speling.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_spelling`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_speling.html for additional documentation. +# +class apache::mod::speling { + include apache + ::apache::mod { 'speling': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ssl.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ssl.pp new file mode 100644 index 000000000..20acb814e --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ssl.pp @@ -0,0 +1,224 @@ +# @summary +# Installs `mod_ssl`. +# +# @param ssl_compression +# Enable compression on the SSL level. +# +# @param ssl_cryptodevice +# Enable use of a cryptographic hardware accelerator. +# +# @param ssl_options +# Configure various SSL engine run-time options. +# +# @param ssl_openssl_conf_cmd +# Configure OpenSSL parameters through its SSL_CONF API. +# +# @param ssl_cert +# Path to server PEM-encoded X.509 certificate data file. +# +# @param ssl_key +# Path to server PEM-encoded private key file +# +# @param ssl_ca +# File of concatenated PEM-encoded CA Certificates for Client Auth. +# +# @param ssl_cipher +# Cipher Suite available for negotiation in SSL handshake. +# +# @param ssl_honorcipherorder +# Option to prefer the server's cipher preference order. +# +# @param ssl_protocol +# Configure usable SSL/TLS protocol versions. +# Default based on the OS: +# - RedHat 8: [ 'all' ]. +# - Other Platforms: [ 'all', '-SSLv2', '-SSLv3' ]. +# +# @param ssl_proxy_protocol +# Configure usable SSL protocol flavors for proxy usage. +# +# @param ssl_pass_phrase_dialog +# Type of pass phrase dialog for encrypted private keys. +# +# @param ssl_random_seed_bytes +# Pseudo Random Number Generator (PRNG) seeding source. +# +# @param ssl_sessioncache +# Configures the storage type of the global/inter-process SSL Session Cache +# +# @param ssl_sessioncachetimeout +# Number of seconds before an SSL session expires in the Session Cache. +# +# @param ssl_stapling +# Enable stapling of OCSP responses in the TLS handshake. +# +# @param ssl_stapling_return_errors +# Pass stapling related OCSP errors on to client. +# +# @param ssl_mutex +# Configures mutex mechanism and lock file directory for all or specified mutexes. +# Default based on the OS and/or Apache version: +# - RedHat/FreeBSD/Suse/Gentoo: 'default'. +# - Debian/Ubuntu + Apache >= 2.4: 'default'. +# - Debian/Ubuntu + Apache < 2.4: 'file:${APACHE_RUN_DIR}/ssl_mutex'. +# +# @param ssl_reload_on_change +# Enable reloading of apache if the content of ssl files have changed. It only affects ssl files configured here and not vhost ones. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @param package_name +# Name of ssl package to install. +# +# On most operating systems, the ssl.conf is placed in the module configuration directory. On Red Hat based operating systems, this +# file is placed in /etc/httpd/conf.d, the same location in which the RPM stores the configuration. +# +# To use SSL with a virtual host, you must either set the default_ssl_vhost parameter in ::apache to true or the ssl parameter in +# apache::vhost to true. +# +# @see https://httpd.apache.org/docs/current/mod/mod_ssl.html for additional documentation. +# +class apache::mod::ssl ( + Boolean $ssl_compression = false, + Optional[Boolean] $ssl_sessiontickets = undef, + $ssl_cryptodevice = 'builtin', + $ssl_options = ['StdEnvVars'], + $ssl_openssl_conf_cmd = undef, + Optional[String] $ssl_cert = undef, + Optional[String] $ssl_key = undef, + $ssl_ca = undef, + $ssl_cipher = 'HIGH:MEDIUM:!aNULL:!MD5:!RC4:!3DES', + Variant[Boolean, Enum['on', 'off']] $ssl_honorcipherorder = true, + $ssl_protocol = $apache::params::ssl_protocol, + Array $ssl_proxy_protocol = [], + $ssl_pass_phrase_dialog = 'builtin', + $ssl_random_seed_bytes = '512', + String $ssl_sessioncache = $apache::params::ssl_sessioncache, + $ssl_sessioncachetimeout = '300', + Boolean $ssl_stapling = false, + Optional[String] $stapling_cache = undef, + Optional[Boolean] $ssl_stapling_return_errors = undef, + $ssl_mutex = undef, + Boolean $ssl_reload_on_change = false, + $apache_version = undef, + $package_name = undef, +) inherits ::apache::params { + include apache + include apache::mod::mime + $_apache_version = pick($apache_version, $apache::apache_version) + if $ssl_mutex { + $_ssl_mutex = $ssl_mutex + } else { + case $::osfamily { + 'debian': { + if versioncmp($_apache_version, '2.4') >= 0 { + $_ssl_mutex = 'default' + } else { + $_ssl_mutex = "file:\${APACHE_RUN_DIR}/ssl_mutex" + } + } + 'redhat': { + $_ssl_mutex = 'default' + } + 'freebsd': { + $_ssl_mutex = 'default' + } + 'gentoo': { + $_ssl_mutex = 'default' + } + 'Suse': { + $_ssl_mutex = 'default' + } + default: { + fail("Unsupported osfamily ${::osfamily}, please explicitly pass in \$ssl_mutex") + } + } + } + + if $ssl_honorcipherorder =~ Boolean { + $_ssl_honorcipherorder = $ssl_honorcipherorder + } else { + $_ssl_honorcipherorder = $ssl_honorcipherorder ? { + 'on' => true, + 'off' => false, + default => true, + } + } + + if $stapling_cache =~ Undef { + $_stapling_cache = $::osfamily ? { + 'debian' => "\${APACHE_RUN_DIR}/ocsp(32768)", + 'redhat' => '/run/httpd/ssl_stapling(32768)', + 'freebsd' => '/var/run/ssl_stapling(32768)', + 'gentoo' => '/var/run/ssl_stapling(32768)', + 'Suse' => '/var/lib/apache2/ssl_stapling(32768)', + } + } else { + $_stapling_cache = $stapling_cache + } + + if $::osfamily == 'Suse' { + if defined(Class['::apache::mod::worker']) { + $suse_path = '/usr/lib64/apache2-worker' + } else { + $suse_path = '/usr/lib64/apache2-prefork' + } + ::apache::mod { 'ssl': + package => $package_name, + lib_path => $suse_path, + } + } else { + ::apache::mod { 'ssl': + package => $package_name, + } + } + + if versioncmp($_apache_version, '2.4') >= 0 { + include apache::mod::socache_shmcb + } + + if $ssl_reload_on_change { + [$ssl_cert, $ssl_key, $ssl_ca].each |$ssl_file| { + if $ssl_file { + include apache::mod::ssl::reload + $_ssl_file_copy = regsubst($ssl_file, '/', '_', 'G') + file { $_ssl_file_copy: + path => "${apache::params::puppet_ssl_dir}/${_ssl_file_copy}", + source => "file://${ssl_file}", + owner => 'root', + group => $apache::params::root_group, + mode => '0640', + seltype => 'cert_t', + notify => Class['apache::service'], + } + } + } + } + + # Template uses + # + # $ssl_compression + # $ssl_sessiontickets + # $ssl_cryptodevice + # $ssl_ca + # $ssl_cipher + # $ssl_honorcipherorder + # $ssl_options + # $ssl_openssl_conf_cmd + # $ssl_sessioncache + # $_stapling_cache + # $ssl_mutex + # $ssl_random_seed_bytes + # $ssl_sessioncachetimeout + # $_apache_version + file { 'ssl.conf': + ensure => file, + path => $apache::_ssl_file, + mode => $apache::file_mode, + content => template('apache/mod/ssl.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/ssl/reload.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ssl/reload.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/ssl/reload.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/ssl/reload.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/status.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/status.pp new file mode 100644 index 000000000..ddd969049 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/status.pp @@ -0,0 +1,66 @@ +# @summary +# Installs and configures `mod_status`. +# +# @param allow_from +# Array of hosts, ip addresses, partial network numbers or networks, in CIDR notation specifying what hosts can view the special +# /server-status URL. Defaults to ['127.0.0.1', '::1']. +# > Creates Apache < 2.4 directive "Allow from". +# +# @param requires +# A Variant type that can be: +# - String with: +# - '' or 'unmanaged' - Host auth control done elsewhere +# - 'ip ' - Allowed IPs/ranges +# - 'host ' - Allowed names/domains +# - 'all [granted|denied]' +# - Array of strings with ip or host as above +# - Hash with following keys: +# - 'requires' - Value => Array as above +# - 'enforce' - Value => String 'Any', 'All' or 'None' +# This encloses "Require" directives in "" block +# Optional - If unspecified, "Require" directives follow current flow +# > Creates Apache >= 2.4 directives "Require" +# +# @param extended_status +# Determines whether to track extended status information for each request, via the ExtendedStatus directive. +# +# @param status_path +# Path assigned to the Location directive which defines the URL to access the server status. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @example +# # Simple usage allowing access from localhost and a private subnet +# class { 'apache::mod::status': +# $allow_from => ['127.0.0.1', '10.10.10.10/24'], +# } +# +# @see http://httpd.apache.org/docs/current/mod/mod_status.html for additional documentation. +# +class apache::mod::status ( + Optional[Array] $allow_from = undef, + Optional[Variant[String, Array, Hash]] $requires = undef, + Enum['On', 'Off', 'on', 'off'] $extended_status = 'On', + $apache_version = undef, + $status_path = '/server-status', +) inherits ::apache::params { + include apache + $_apache_version = pick($apache_version, $apache::apache_version) + ::apache::mod { 'status': } + + # Defaults for "Allow from" or "Require" directives + $allow_defaults = ['127.0.0.1','::1'] + $requires_defaults = 'ip 127.0.0.1 ::1' + + # Template uses $allow_from, $extended_status, $_apache_version, $status_path + file { 'status.conf': + ensure => file, + path => "${apache::mod_dir}/status.conf", + mode => $apache::file_mode, + content => template('apache/mod/status.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/suexec.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/suexec.pp new file mode 100644 index 000000000..b6a28b1f1 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/suexec.pp @@ -0,0 +1,8 @@ +# @summary +# Installs `mod_suexec`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_suexec.html for additional documentation. +# +class apache::mod::suexec { + ::apache::mod { 'suexec': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/suphp.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/suphp.pp new file mode 100644 index 000000000..ae8841321 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/suphp.pp @@ -0,0 +1,23 @@ +# @summary +# Installs `mod_suphp`. +# +# @see https://www.suphp.org/DocumentationView.html?file=apache/INSTALL for additional documentation. +# +class apache::mod::suphp ( +) { + if $facts['os']['family'] == 'Debian' { + fail("suphp was declared EOL by it's creators as of 2013 and so is no longer supported on Ubuntu 15.10/Debian 8 and above. Please use php-fpm") + } + include apache + ::apache::mod { 'suphp': } + + file { 'suphp.conf': + ensure => file, + path => "${apache::mod_dir}/suphp.conf", + mode => $apache::file_mode, + content => template('apache/mod/suphp.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/userdir.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/userdir.pp new file mode 100644 index 000000000..67d7717dd --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/userdir.pp @@ -0,0 +1,80 @@ +# @summary +# Installs and configures `mod_userdir`. +# +# @param home +# *Deprecated* Path to system home directory. +# +# @param dir +# *Deprecated* Path from user's home directory to public directory. +# +# @param userdir +# Path or directory name to be used as the UserDir. +# +# @param disable_root +# Toggles whether to allow use of root directory. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @param path +# Path to directory or pattern from which to find user-specific directories. +# +# @param overrides +# Array of directives that are allowed in .htaccess files. +# +# @param options +# Configures what features are available in a particular directory. +# +# @param unmanaged_path +# Toggles whether to manage path in userdir.conf +# +# @param custom_fragment +# Custom configuration to be added to userdir.conf +# +# @see https://httpd.apache.org/docs/current/mod/mod_userdir.html for additional documentation. +# +class apache::mod::userdir ( + $home = undef, + $dir = undef, + Optional[String[1]] $userdir = undef, + $disable_root = true, + $apache_version = undef, + $path = '/home/*/public_html', + $overrides = ['FileInfo', 'AuthConfig', 'Limit', 'Indexes'], + $options = ['MultiViews', 'Indexes', 'SymLinksIfOwnerMatch', 'IncludesNoExec'], + $unmanaged_path = false, + $custom_fragment = undef, +) { + include apache + $_apache_version = pick($apache_version, $apache::apache_version) + + if $home or $dir { + $_home = $home ? { + undef => '/home', + default => $home, + } + $_dir = $dir ? { + undef => 'public_html', + default => $dir, + } + warning('home and dir are deprecated; use path instead') + $_path = "${_home}/*/${_dir}" + } else { + $_path = $path + } + + $_userdir = pick($userdir, $_path) + + ::apache::mod { 'userdir': } + + # Template uses $home, $dir, $disable_root, $_apache_version + file { 'userdir.conf': + ensure => file, + path => "${apache::mod_dir}/userdir.conf", + mode => $apache::file_mode, + content => template('apache/mod/userdir.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/version.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/version.pp new file mode 100644 index 000000000..7dd89adce --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/version.pp @@ -0,0 +1,17 @@ +# @summary +# Installs `mod_version`. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @see https://httpd.apache.org/docs/current/mod/mod_version.html for additional documentation. +# +class apache::mod::version ( + $apache_version = $apache::apache_version +) { + if ($::osfamily == 'debian' and versioncmp($apache_version, '2.4') >= 0) { + warning("${module_name}: module version_module is built-in and can't be loaded") + } else { + ::apache::mod { 'version': } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/vhost_alias.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/vhost_alias.pp new file mode 100644 index 000000000..3ff6fd1aa --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/vhost_alias.pp @@ -0,0 +1,8 @@ +# @summary +# Installs Apache `mod_vhost_alias`. +# +# @see https://httpd.apache.org/docs/current/mod/mod_vhost_alias.html for additional documentation. +# +class apache::mod::vhost_alias { + ::apache::mod { 'vhost_alias': } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/watchdog.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/watchdog.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mod/watchdog.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/watchdog.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/worker.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/worker.pp new file mode 100644 index 000000000..d6b57b89b --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/worker.pp @@ -0,0 +1,136 @@ +# @summary +# Installs and manages the MPM `worker`. +# +# @param startservers +# The number of child server processes created on startup +# +# @param maxclients +# The max number of simultaneous requests that will be served. +# This is the old name and is still supported. The new name is +# MaxRequestWorkers as of 2.3.13. +# +# @param minsparethreads +# Minimum number of idle threads to handle request spikes. +# +# @param maxsparethreads +# Maximum number of idle threads. +# +# @param threadsperchild +# The number of threads created by each child process. +# +# @param maxrequestsperchild +# Limit on the number of connectiojns an individual child server +# process will handle. This is the old name and is still supported. The new +# name is MaxConnectionsPerChild as of 2.3.9+. +# +# @param serverlimit +# With worker, use this directive only if your MaxRequestWorkers +# and ThreadsPerChild settings require more than 16 server processes +# (default). Do not set the value of this directive any higher than the +# number of server processes required by what you may want for +# MaxRequestWorkers and ThreadsPerChild. +# +# @param threadlimit +# This directive sets the maximum configured value for +# ThreadsPerChild for the lifetime of the Apache httpd process. +# +# @param listenbacklog +# Maximum length of the queue of pending connections. +# +# @param apache_version +# Used to verify that the Apache version you have requested is compatible with the module. +# +# @see https://httpd.apache.org/docs/current/mod/worker.html for additional documentation. +# +class apache::mod::worker ( + $startservers = '2', + $maxclients = '150', + $minsparethreads = '25', + $maxsparethreads = '75', + $threadsperchild = '25', + $maxrequestsperchild = '0', + $serverlimit = '25', + $threadlimit = '64', + $listenbacklog = '511', + $apache_version = undef, +) { + include apache + $_apache_version = pick($apache_version, $apache::apache_version) + + if defined(Class['apache::mod::event']) { + fail('May not include both apache::mod::worker and apache::mod::event on the same node') + } + if defined(Class['apache::mod::itk']) { + fail('May not include both apache::mod::worker and apache::mod::itk on the same node') + } + if defined(Class['apache::mod::peruser']) { + fail('May not include both apache::mod::worker and apache::mod::peruser on the same node') + } + if defined(Class['apache::mod::prefork']) { + fail('May not include both apache::mod::worker and apache::mod::prefork on the same node') + } + File { + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + } + + # Template uses: + # - $startservers + # - $maxclients + # - $minsparethreads + # - $maxsparethreads + # - $threadsperchild + # - $maxrequestsperchild + # - $serverlimit + # - $threadLimit + # - $listenbacklog + file { "${apache::mod_dir}/worker.conf": + ensure => file, + content => template('apache/mod/worker.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } + + case $::osfamily { + 'redhat': { + if versioncmp($_apache_version, '2.4') >= 0 { + ::apache::mpm { 'worker': + apache_version => $_apache_version, + } + } + else { + file_line { '/etc/sysconfig/httpd worker enable': + ensure => present, + path => '/etc/sysconfig/httpd', + line => 'HTTPD=/usr/sbin/httpd.worker', + match => '#?HTTPD=/usr/sbin/httpd.worker', + require => Package['httpd'], + notify => Class['apache::service'], + } + } + } + + 'debian', 'freebsd': { + ::apache::mpm { 'worker': + apache_version => $_apache_version, + } + } + 'Suse': { + ::apache::mpm { 'worker': + apache_version => $apache_version, + lib_path => '/usr/lib64/apache2-worker', + } + } + + 'gentoo': { + ::portage::makeconf { 'apache2_mpms': + content => 'worker', + } + } + default: { + fail("Unsupported osfamily ${::osfamily}") + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/wsgi.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/wsgi.pp new file mode 100644 index 000000000..0d326a4d5 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/wsgi.pp @@ -0,0 +1,74 @@ +# @summary +# Installs and configures `mod_wsgi`. +# +# @param wsgi_restrict_embedded +# Enable restrictions on use of embedded mode. +# +# @param wsgi_socket_prefix +# Configure directory to use for daemon sockets. +# +# @param wsgi_python_path +# Additional directories to search for Python modules. +# +# @param wsgi_python_home +# Absolute path to Python prefix/exec_prefix directories. +# +# @param wsgi_python_optimize +# Enables basic Python optimisation features. +# +# @param wsgi_application_group +# Sets which application group WSGI application belongs to. +# +# @param package_name +# Names of package that installs mod_wsgi. +# +# @param mod_path +# Defines the path to the mod_wsgi shared object (.so) file. +# +# @see https://github.com/GrahamDumpleton/mod_wsgi for additional documentation. +# @note Unsupported platforms: SLES: all; RedHat: all; CentOS: all; OracleLinux: all; Scientific: all +class apache::mod::wsgi ( + $wsgi_restrict_embedded = undef, + $wsgi_socket_prefix = $apache::params::wsgi_socket_prefix, + $wsgi_python_path = undef, + $wsgi_python_home = undef, + $wsgi_python_optimize = undef, + $wsgi_application_group = undef, + $package_name = undef, + $mod_path = undef, +) inherits ::apache::params { + include apache + if ($package_name != undef and $mod_path == undef) or ($package_name == undef and $mod_path != undef) { + fail('apache::mod::wsgi - both package_name and mod_path must be specified!') + } + + if $package_name != undef { + if $mod_path =~ /\// { + $_mod_path = $mod_path + } else { + $_mod_path = "${apache::lib_path}/${mod_path}" + } + ::apache::mod { 'wsgi': + package => $package_name, + path => $_mod_path, + } + } + else { + ::apache::mod { 'wsgi': } + } + + # Template uses: + # - $wsgi_restrict_embedded + # - $wsgi_socket_prefix + # - $wsgi_python_path + # - $wsgi_python_home + file { 'wsgi.conf': + ensure => file, + path => "${apache::mod_dir}/wsgi.conf", + mode => $apache::file_mode, + content => template('apache/mod/wsgi.conf.erb'), + require => Exec["mkdir ${apache::mod_dir}"], + before => File[$apache::mod_dir], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/xsendfile.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/xsendfile.pp new file mode 100644 index 000000000..955488461 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mod/xsendfile.pp @@ -0,0 +1,9 @@ +# @summary +# Installs `mod_xsendfile`. +# +# @see https://tn123.org/mod_xsendfile/ for additional documentation. +# +class apache::mod::xsendfile { + include apache::params + ::apache::mod { 'xsendfile': } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/mpm.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mpm.pp new file mode 100644 index 000000000..b76772eaf --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mpm.pp @@ -0,0 +1,160 @@ +# @summary Enables the use of Apache MPMs. +# +# @api private +define apache::mpm ( + $lib_path = $apache::lib_path, + $apache_version = $apache::apache_version, +) { + if ! defined(Class['apache']) { + fail('You must include the apache base class before using any apache defined resources') + } + + $mpm = $name + $mod_dir = $apache::mod_dir + + $_lib = "mod_mpm_${mpm}.so" + $_path = "${lib_path}/${_lib}" + $_id = "mpm_${mpm}_module" + + if $::osfamily == 'Suse' { + #mpms on Suse 12 don't use .so libraries so create a placeholder load file + if versioncmp($apache_version, '2.4') >= 0 { + file { "${mod_dir}/${mpm}.load": + ensure => file, + path => "${mod_dir}/${mpm}.load", + content => '', + require => [ + Package['httpd'], + Exec["mkdir ${mod_dir}"], + ], + before => File[$mod_dir], + notify => Class['apache::service'], + } + } + } else { + if versioncmp($apache_version, '2.4') >= 0 { + file { "${mod_dir}/${mpm}.load": + ensure => file, + path => "${mod_dir}/${mpm}.load", + content => "LoadModule ${_id} ${_path}\n", + require => [ + Package['httpd'], + Exec["mkdir ${mod_dir}"], + ], + before => File[$mod_dir], + notify => Class['apache::service'], + } + } + } + + case $::osfamily { + 'debian': { + file { "${apache::mod_enable_dir}/${mpm}.conf": + ensure => link, + target => "${apache::mod_dir}/${mpm}.conf", + require => Exec["mkdir ${apache::mod_enable_dir}"], + before => File[$apache::mod_enable_dir], + notify => Class['apache::service'], + } + + if versioncmp($apache_version, '2.4') >= 0 { + file { "${apache::mod_enable_dir}/${mpm}.load": + ensure => link, + target => "${apache::mod_dir}/${mpm}.load", + require => Exec["mkdir ${apache::mod_enable_dir}"], + before => File[$apache::mod_enable_dir], + notify => Class['apache::service'], + } + + if $mpm == 'itk' { + file { "${lib_path}/mod_mpm_itk.so": + ensure => link, + target => "${lib_path}/mpm_itk.so", + require => Package['httpd'], + before => Class['apache::service'], + } + } + } else { + package { "apache2-mpm-${mpm}": + ensure => present, + before => [ + Class['apache::service'], + File[$apache::mod_enable_dir], + ], + } + } + + if $mpm == 'itk' { + include apache::mpm::disable_mpm_event + include apache::mpm::disable_mpm_worker + + package { 'libapache2-mpm-itk': + ensure => present, + before => [ + Class['apache::service'], + File[$apache::mod_enable_dir], + ], + } + } + + if $mpm == 'prefork' { + if ( ( $::operatingsystem == 'Ubuntu' and versioncmp($::operatingsystemrelease,'18.04') >= 0 ) or $::operatingsystem == 'Debian' ) { + include apache::mpm::disable_mpm_event + include apache::mpm::disable_mpm_worker + } + } + + if $mpm == 'worker' { + if ( ( $::operatingsystem == 'Ubuntu' and versioncmp($::operatingsystemrelease,'18.04') >= 0 ) or $::operatingsystem == 'Debian' ) { + include apache::mpm::disable_mpm_event + include apache::mpm::disable_mpm_prefork + } + } + } + + 'freebsd': { + class { 'apache::package': + mpm_module => $mpm, + } + } + 'gentoo': { + # so we don't fail + } + 'redhat': { + # so we don't fail + } + 'Suse': { + file { "${apache::mod_enable_dir}/${mpm}.conf": + ensure => link, + target => "${apache::mod_dir}/${mpm}.conf", + require => Exec["mkdir ${apache::mod_enable_dir}"], + before => File[$apache::mod_enable_dir], + notify => Class['apache::service'], + } + + if versioncmp($apache_version, '2.4') >= 0 { + file { "${apache::mod_enable_dir}/${mpm}.load": + ensure => link, + target => "${apache::mod_dir}/${mpm}.load", + require => Exec["mkdir ${apache::mod_enable_dir}"], + before => File[$apache::mod_enable_dir], + notify => Class['apache::service'], + } + + if $mpm == 'itk' { + file { "${lib_path}/mod_mpm_itk.so": + ensure => link, + target => "${lib_path}/mpm_itk.so", + } + } + } + + package { "apache2-${mpm}": + ensure => present, + } + } + default: { + fail("Unsupported osfamily ${::osfamily}") + } + } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mpm/disable_mpm_event.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mpm/disable_mpm_event.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mpm/disable_mpm_event.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mpm/disable_mpm_event.pp diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mpm/disable_mpm_prefork.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mpm/disable_mpm_prefork.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mpm/disable_mpm_prefork.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mpm/disable_mpm_prefork.pp diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/mpm/disable_mpm_worker.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/mpm/disable_mpm_worker.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/mpm/disable_mpm_worker.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/mpm/disable_mpm_worker.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/namevirtualhost.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/namevirtualhost.pp new file mode 100644 index 000000000..246df53dd --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/namevirtualhost.pp @@ -0,0 +1,15 @@ +# @summary +# Enables name-based virtual hosts +# +# Adds all related directives to the `ports.conf` file in the Apache HTTPD configuration +# directory. Titles can take the forms `\*`, `\*:\`, `\_default\_:\`, +# `\`, or `\:\`. +define apache::namevirtualhost { + $addr_port = $name + + # Template uses: $addr_port + concat::fragment { "NameVirtualHost ${addr_port}": + target => $apache::ports_file, + content => template('apache/namevirtualhost.erb'), + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/package.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/package.pp new file mode 100644 index 000000000..684995ea3 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/package.pp @@ -0,0 +1,40 @@ +# @summary +# Installs an Apache MPM. +# +# @api private +class apache::package ( + $ensure = 'present', + $mpm_module = $apache::params::mpm_module, +) inherits ::apache::params { + # The base class must be included first because it is used by parameter defaults + if ! defined(Class['apache']) { + fail('You must include the apache base class before using any apache defined resources') + } + + case $::osfamily { + 'FreeBSD': { + case $mpm_module { + 'prefork': { + } + 'worker': { + } + 'event': { + } + 'itk': { + package { 'www/mod_mpm_itk': + ensure => installed, + } + } + default: { fail("MPM module ${mpm_module} not supported on FreeBSD") } + } + } + default: { + } + } + + package { 'httpd': + ensure => $ensure, + name => $apache::apache_name, + notify => Class['Apache::Service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/params.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/params.pp new file mode 100644 index 000000000..79313de8b --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/params.pp @@ -0,0 +1,789 @@ +# @summary +# This class manages Apache parameters +# +# @api private +class apache::params inherits ::apache::version { + if($::fqdn) { + $servername = $::fqdn + } else { + $servername = $::hostname + } + + # The default error log level + $log_level = 'warn' + $use_optional_includes = false + + # Default mime types settings + $mime_types_additional = { + 'AddHandler' => { 'type-map' => 'var', }, + 'AddType' => { 'text/html' => '.shtml', }, + 'AddOutputFilter' => { 'INCLUDES' => '.shtml', }, + } + + # should we use systemd module? + $use_systemd = true + + # Default mode for files + $file_mode = '0644' + + # The default value for host hame lookup + $hostname_lookups = 'Off' + + # Default options for / directory + $root_directory_options = ['FollowSymLinks'] + + $vhost_include_pattern = '*' + + $modsec_audit_log_parts = 'ABIJDEFHZ' + $modsec_audit_log_type = 'Serial' + $modsec_custom_rules = false + $modsec_custom_rules_set = undef + + # no client certs should be trusted for auth by default. + $ssl_certs_dir = undef + + # Allow overriding the autoindex alias location + $icons_prefix = 'icons' + + if ($apache::version::scl_httpd_version) { + if $apache::version::scl_php_version == undef { + fail('If you define apache::version::scl_httpd_version, you also need to specify apache::version::scl_php_version') + } + $_scl_httpd_version_nodot = regsubst($apache::version::scl_httpd_version, '\.', '') + $_scl_httpd_name = "httpd${_scl_httpd_version_nodot}" + + $_scl_php_version_no_dot = regsubst($apache::version::scl_php_version, '\.', '') + $user = 'apache' + $group = 'apache' + $root_group = 'root' + $apache_name = "${_scl_httpd_name}-httpd" + $service_name = "${_scl_httpd_name}-httpd" + $httpd_root = "/opt/rh/${_scl_httpd_name}/root" + $httpd_dir = "${httpd_root}/etc/httpd" + $server_root = "${httpd_root}/etc/httpd" + $conf_dir = "${httpd_dir}/conf" + $confd_dir = "${httpd_dir}/conf.d" + $puppet_ssl_dir = "${httpd_dir}/puppet_ssl" + $mod_dir = $facts['operatingsystemmajrelease'] ? { + '7' => "${httpd_dir}/conf.modules.d", + default => "${httpd_dir}/conf.d", + } + $mod_enable_dir = undef + $vhost_dir = "${httpd_dir}/conf.d" + $vhost_enable_dir = undef + $conf_file = 'httpd.conf' + $conf_enabled = undef + $ports_file = "${conf_dir}/ports.conf" + $pidfile = 'run/httpd.pid' + $logroot = "/var/log/${_scl_httpd_name}" + $logroot_mode = undef + $lib_path = 'modules' + $mpm_module = 'prefork' + $dev_packages = "${_scl_httpd_name}-httpd-devel" + $default_ssl_cert = '/etc/pki/tls/certs/localhost.crt' + $default_ssl_key = '/etc/pki/tls/private/localhost.key' + $ssl_sessioncache = '/var/cache/mod_ssl/scache(512000)' + $passenger_conf_file = 'passenger_extra.conf' + $passenger_conf_package_file = 'passenger.conf' + $passenger_root = undef + $passenger_ruby = undef + $passenger_default_ruby = undef + $suphp_addhandler = 'php5-script' + $suphp_engine = 'off' + $suphp_configpath = undef + $php_version = $apache::version::scl_php_version + $mod_packages = { + 'authnz_ldap' => "${_scl_httpd_name}-mod_ldap", + 'ldap' => "${_scl_httpd_name}-mod_ldap", + "php${apache::version::scl_php_version}" => "rh-php${_scl_php_version_no_dot}-php", + 'ssl' => "${_scl_httpd_name}-mod_ssl", + } + $mod_libs = { + 'nss' => 'libmodnss.so', + } + $conf_template = 'apache/httpd.conf.erb' + $http_protocol_options = undef + $keepalive = 'On' + $keepalive_timeout = 15 + $max_keepalive_requests = 100 + $fastcgi_lib_path = undef + $mime_support_package = 'mailcap' + $mime_types_config = '/etc/mime.types' + $docroot = "${httpd_root}/var/www/html" + $alias_icons_path = $facts['operatingsystemmajrelease'] ? { + '7' => "${httpd_root}/usr/share/httpd/icons", + default => '/var/www/icons', + } + $error_documents_path = $facts['operatingsystemmajrelease'] ? { + '7' => "${httpd_root}/usr/share/httpd/error", + default => '/var/www/error' + } + if $::osfamily == 'RedHat' { + $wsgi_socket_prefix = '/var/run/wsgi' + } else { + $wsgi_socket_prefix = undef + } + $cas_cookie_path = '/var/cache/mod_auth_cas/' + $mellon_lock_file = '/run/mod_auth_mellon/lock' + $mellon_cache_size = 100 + $mellon_post_directory = undef + $modsec_version = 1 + $modsec_crs_package = 'mod_security_crs' + $modsec_crs_path = '/usr/lib/modsecurity.d' + $modsec_dir = '/etc/httpd/modsecurity.d' + $secpcrematchlimit = 1500 + $secpcrematchlimitrecursion = 1500 + $modsec_secruleengine = 'On' + $modsec_default_rules = [ + 'base_rules/modsecurity_35_bad_robots.data', + 'base_rules/modsecurity_35_scanners.data', + 'base_rules/modsecurity_40_generic_attacks.data', + 'base_rules/modsecurity_50_outbound.data', + 'base_rules/modsecurity_50_outbound_malware.data', + 'base_rules/modsecurity_crs_20_protocol_violations.conf', + 'base_rules/modsecurity_crs_21_protocol_anomalies.conf', + 'base_rules/modsecurity_crs_23_request_limits.conf', + 'base_rules/modsecurity_crs_30_http_policy.conf', + 'base_rules/modsecurity_crs_35_bad_robots.conf', + 'base_rules/modsecurity_crs_40_generic_attacks.conf', + 'base_rules/modsecurity_crs_41_sql_injection_attacks.conf', + 'base_rules/modsecurity_crs_41_xss_attacks.conf', + 'base_rules/modsecurity_crs_42_tight_security.conf', + 'base_rules/modsecurity_crs_45_trojans.conf', + 'base_rules/modsecurity_crs_47_common_exceptions.conf', + 'base_rules/modsecurity_crs_49_inbound_blocking.conf', + 'base_rules/modsecurity_crs_50_outbound.conf', + 'base_rules/modsecurity_crs_59_outbound_blocking.conf', + 'base_rules/modsecurity_crs_60_correlation.conf', + ] + $error_log = 'error_log' + $scriptalias = "${httpd_root}/var/www/cgi-bin" + $access_log_file = 'access_log' + } + elsif $::osfamily == 'RedHat' or $::operatingsystem =~ /^[Aa]mazon$/ { + $user = 'apache' + $group = 'apache' + $root_group = 'root' + $apache_name = 'httpd' + $service_name = 'httpd' + $httpd_dir = '/etc/httpd' + $server_root = '/etc/httpd' + $conf_dir = "${httpd_dir}/conf" + $confd_dir = "${httpd_dir}/conf.d" + $puppet_ssl_dir = "${httpd_dir}/puppet_ssl" + $conf_enabled = undef + if $::operatingsystem =~ /^[Aa]mazon$/ and $::operatingsystemmajrelease == '2' { + # Amazon Linux 2 uses the /conf.modules.d/ dir + $mod_dir = "${httpd_dir}/conf.modules.d" + } else { + $mod_dir = $facts['operatingsystemmajrelease'] ? { + '6' => "${httpd_dir}/conf.d", + default => "${httpd_dir}/conf.modules.d", + } + } + $mod_enable_dir = undef + $vhost_dir = "${httpd_dir}/conf.d" + $vhost_enable_dir = undef + $conf_file = 'httpd.conf' + $ports_file = "${conf_dir}/ports.conf" + $pidfile = 'run/httpd.pid' + $logroot = '/var/log/httpd' + $logroot_mode = undef + $lib_path = 'modules' + $mpm_module = 'prefork' + $dev_packages = 'httpd-devel' + $default_ssl_cert = '/etc/pki/tls/certs/localhost.crt' + $default_ssl_key = '/etc/pki/tls/private/localhost.key' + $ssl_sessioncache = '/var/cache/mod_ssl/scache(512000)' + $passenger_conf_file = 'passenger_extra.conf' + $passenger_conf_package_file = 'passenger.conf' + $passenger_root = undef + $passenger_ruby = undef + $passenger_default_ruby = undef + $suphp_addhandler = 'php5-script' + $suphp_engine = 'off' + $suphp_configpath = undef + $php_version = $facts['operatingsystemmajrelease'] ? { + '8' => '7', # RedHat8 + default => '5', # RedHat5, RedHat6, RedHat7 + } + $mod_packages = { + # NOTE: The auth_cas module isn't available on RH/CentOS without providing dependency packages provided by EPEL. + 'auth_cas' => 'mod_auth_cas', + 'auth_kerb' => 'mod_auth_kerb', + 'auth_gssapi' => 'mod_auth_gssapi', + 'auth_mellon' => 'mod_auth_mellon', + 'auth_openidc' => 'mod_auth_openidc', + 'authnz_ldap' => $facts['operatingsystemmajrelease'] ? { + '6' => 'mod_authz_ldap', + default => 'mod_ldap', + }, + 'authnz_pam' => 'mod_authnz_pam', + 'fastcgi' => $facts['operatingsystemmajrelease'] ? { + '5' => 'mod_fastcgi', + '6' => 'mod_fastcgi', + default => undef, + }, + 'fcgid' => 'mod_fcgid', + 'geoip' => 'mod_geoip', + 'intercept_form_submit' => 'mod_intercept_form_submit', + 'ldap' => $facts['operatingsystemmajrelease'] ? { + '5' => undef, + '6' => undef, + default => 'mod_ldap', + }, + 'lookup_identity' => 'mod_lookup_identity', + 'md' => 'mod_md', + 'pagespeed' => 'mod-pagespeed-stable', + # NOTE: The passenger module isn't available on RH/CentOS without + # providing dependency packages provided by EPEL and passenger + # repositories. See + # https://www.phusionpassenger.com/library/install/apache/install/oss/el7/ + 'passenger' => 'mod_passenger', + 'perl' => 'mod_perl', + 'php5' => $facts['operatingsystemmajrelease'] ? { + '5' => 'php53', + default => 'php', + }, + 'phpXXX' => 'php', + 'proxy_html' => 'mod_proxy_html', + 'python' => 'mod_python', + 'security' => 'mod_security', + # NOTE: The module for Shibboleth is not available on RH/CentOS without + # providing dependency packages provided by Shibboleth's repositories. + # See http://wiki.aaf.edu.au/tech-info/sp-install-guide + 'shibboleth' => 'shibboleth', + 'ssl' => 'mod_ssl', + 'wsgi' => $facts['operatingsystemmajrelease'] ? { + '6' => 'mod_wsgi', # RedHat6 + '7' => 'mod_wsgi', # RedHat7 + default => 'python3-mod_wsgi', # RedHat8+ + }, + 'dav_svn' => 'mod_dav_svn', + 'suphp' => 'mod_suphp', + 'xsendfile' => 'mod_xsendfile', + 'nss' => 'mod_nss', + 'shib2' => 'shibboleth', + } + $mod_libs = { + 'nss' => 'libmodnss.so', + 'wsgi' => $facts['operatingsystemmajrelease'] ? { + '6' => 'mod_wsgi.so', + '7' => 'mod_wsgi.so', + default => 'mod_wsgi_python3.so', + }, + } + $conf_template = 'apache/httpd.conf.erb' + $http_protocol_options = undef + $keepalive = 'On' + $keepalive_timeout = 15 + $max_keepalive_requests = 100 + $fastcgi_lib_path = undef + $mime_support_package = 'mailcap' + $mime_types_config = '/etc/mime.types' + $docroot = '/var/www/html' + $alias_icons_path = $facts['operatingsystemmajrelease'] ? { + '6' => '/var/www/icons', + default => '/usr/share/httpd/icons', + } + $error_documents_path = $facts['operatingsystemmajrelease'] ? { + '6' => '/var/www/error', + default => '/usr/share/httpd/error', + } + if $::osfamily == 'RedHat' { + $wsgi_socket_prefix = '/var/run/wsgi' + } else { + $wsgi_socket_prefix = undef + } + $cas_cookie_path = '/var/cache/mod_auth_cas/' + $mellon_lock_file = '/run/mod_auth_mellon/lock' + $mellon_cache_size = 100 + $mellon_post_directory = undef + $modsec_version = 1 + $modsec_crs_package = 'mod_security_crs' + $modsec_crs_path = '/usr/lib/modsecurity.d' + $modsec_dir = '/etc/httpd/modsecurity.d' + $secpcrematchlimit = 1500 + $secpcrematchlimitrecursion = 1500 + $modsec_secruleengine = 'On' + $modsec_default_rules = [ + 'base_rules/modsecurity_35_bad_robots.data', + 'base_rules/modsecurity_35_scanners.data', + 'base_rules/modsecurity_40_generic_attacks.data', + 'base_rules/modsecurity_50_outbound.data', + 'base_rules/modsecurity_50_outbound_malware.data', + 'base_rules/modsecurity_crs_20_protocol_violations.conf', + 'base_rules/modsecurity_crs_21_protocol_anomalies.conf', + 'base_rules/modsecurity_crs_23_request_limits.conf', + 'base_rules/modsecurity_crs_30_http_policy.conf', + 'base_rules/modsecurity_crs_35_bad_robots.conf', + 'base_rules/modsecurity_crs_40_generic_attacks.conf', + 'base_rules/modsecurity_crs_41_sql_injection_attacks.conf', + 'base_rules/modsecurity_crs_41_xss_attacks.conf', + 'base_rules/modsecurity_crs_42_tight_security.conf', + 'base_rules/modsecurity_crs_45_trojans.conf', + 'base_rules/modsecurity_crs_47_common_exceptions.conf', + 'base_rules/modsecurity_crs_49_inbound_blocking.conf', + 'base_rules/modsecurity_crs_50_outbound.conf', + 'base_rules/modsecurity_crs_59_outbound_blocking.conf', + 'base_rules/modsecurity_crs_60_correlation.conf', + ] + $error_log = 'error_log' + $scriptalias = '/var/www/cgi-bin' + $access_log_file = 'access_log' + } elsif $::osfamily == 'Debian' { + $user = 'www-data' + $group = 'www-data' + $root_group = 'root' + $apache_name = 'apache2' + $service_name = 'apache2' + $httpd_dir = '/etc/apache2' + $server_root = '/etc/apache2' + $conf_dir = $httpd_dir + $confd_dir = "${httpd_dir}/conf.d" + # Overwrite conf_enabled causes errors with Shibboleth when enabled on Ubuntu 18.04 + $conf_enabled = undef #"${httpd_dir}/conf-enabled.d" + $puppet_ssl_dir = "${httpd_dir}/puppet_ssl" + $mod_dir = "${httpd_dir}/mods-available" + $mod_enable_dir = "${httpd_dir}/mods-enabled" + $vhost_dir = "${httpd_dir}/sites-available" + $vhost_enable_dir = "${httpd_dir}/sites-enabled" + $conf_file = 'apache2.conf' + $ports_file = "${conf_dir}/ports.conf" + $pidfile = "\${APACHE_PID_FILE}" + $logroot = '/var/log/apache2' + $logroot_mode = undef + $lib_path = '/usr/lib/apache2/modules' + $mpm_module = 'worker' + $default_ssl_cert = '/etc/ssl/certs/ssl-cert-snakeoil.pem' + $default_ssl_key = '/etc/ssl/private/ssl-cert-snakeoil.key' + $ssl_sessioncache = "\${APACHE_RUN_DIR}/ssl_scache(512000)" + $suphp_addhandler = 'x-httpd-php' + $suphp_engine = 'off' + $suphp_configpath = '/etc/php5/apache2' + if ($::operatingsystem == 'Ubuntu') or ($::operatingsystem == 'Debian' and versioncmp($::operatingsystemmajrelease, '11') < 0) { + $php_version = $facts['operatingsystemmajrelease'] ? { + '9' => '7.0', # Debian Stretch + '16.04' => '7.0', # Ubuntu Xenial + '10' => '7.3', # Debian Buster + '20.04' => '7.4', # Ubuntu Foccal Fossal + default => '7.2', # Ubuntu Bionic, Cosmic and Disco + } + $mod_packages = { + 'apreq2' => 'libapache2-mod-apreq2', + 'auth_cas' => 'libapache2-mod-auth-cas', + 'auth_kerb' => 'libapache2-mod-auth-kerb', + 'auth_openidc' => 'libapache2-mod-auth-openidc', + 'auth_gssapi' => 'libapache2-mod-auth-gssapi', + 'auth_mellon' => 'libapache2-mod-auth-mellon', + 'authnz_pam' => 'libapache2-mod-authnz-pam', + 'dav_svn' => 'libapache2-mod-svn', + 'fastcgi' => 'libapache2-mod-fastcgi', + 'fcgid' => 'libapache2-mod-fcgid', + 'geoip' => 'libapache2-mod-geoip', + 'intercept_form_submit' => 'libapache2-mod-intercept-form-submit', + 'jk' => 'libapache2-mod-jk', + 'lookup_identity' => 'libapache2-mod-lookup-identity', + 'nss' => 'libapache2-mod-nss', + 'pagespeed' => 'mod-pagespeed-stable', + 'passenger' => 'libapache2-mod-passenger', + 'perl' => 'libapache2-mod-perl2', + 'phpXXX' => 'libapache2-mod-phpXXX', + 'python' => 'libapache2-mod-python', + 'rpaf' => 'libapache2-mod-rpaf', + 'security' => 'libapache2-mod-security2', + 'shib2' => 'libapache2-mod-shib2', + 'wsgi' => 'libapache2-mod-wsgi', + 'xsendfile' => 'libapache2-mod-xsendfile', + } + } else { + $php_version = $facts['operatingsystemmajrelease'] ? { + default => '7.4', # Debian Bullseye + } + $mod_packages = { + 'apreq2' => 'libapache2-mod-apreq2', + 'auth_cas' => 'libapache2-mod-auth-cas', + 'auth_kerb' => 'libapache2-mod-auth-kerb', + 'auth_openidc' => 'libapache2-mod-auth-openidc', + 'auth_gssapi' => 'libapache2-mod-auth-gssapi', + 'auth_mellon' => 'libapache2-mod-auth-mellon', + 'authnz_pam' => 'libapache2-mod-authnz-pam', + 'dav_svn' => 'libapache2-mod-svn', + 'fastcgi' => 'libapache2-mod-fastcgi', + 'fcgid' => 'libapache2-mod-fcgid', + 'geoip' => 'libapache2-mod-geoip', + 'intercept_form_submit' => 'libapache2-mod-intercept-form-submit', + 'jk' => 'libapache2-mod-jk', + 'lookup_identity' => 'libapache2-mod-lookup-identity', + 'nss' => 'libapache2-mod-nss', + 'pagespeed' => 'mod-pagespeed-stable', + 'passenger' => 'libapache2-mod-passenger', + 'perl' => 'libapache2-mod-perl2', + 'phpXXX' => 'libapache2-mod-phpXXX', + 'python' => 'libapache2-mod-python', + 'rpaf' => 'libapache2-mod-rpaf', + 'security' => 'libapache2-mod-security2', + 'shib2' => 'libapache2-mod-shib', + 'wsgi' => 'libapache2-mod-wsgi-py3', + 'xsendfile' => 'libapache2-mod-xsendfile', + } + } + + $error_log = 'error.log' + $scriptalias = '/usr/lib/cgi-bin' + $access_log_file = 'access.log' + if ($::operatingsystem == 'Ubuntu' and versioncmp($::operatingsystemrelease, '19.04') < 0) or ($::operatingsystem == 'Debian' and versioncmp($::operatingsystemrelease, '10') < 0) { + $shib2_lib = 'mod_shib2.so' + } else { + $shib2_lib = 'mod_shib.so' + } + $mod_libs = { + 'shib2' => $shib2_lib, + } + $conf_template = 'apache/httpd.conf.erb' + $http_protocol_options = undef + $keepalive = 'On' + $keepalive_timeout = 15 + $max_keepalive_requests = 100 + $fastcgi_lib_path = '/var/lib/apache2/fastcgi' + $mime_support_package = 'mime-support' + $mime_types_config = '/etc/mime.types' + $docroot = '/var/www/html' + $cas_cookie_path = '/var/cache/apache2/mod_auth_cas/' + $mellon_lock_file = undef + $mellon_cache_size = undef + $mellon_post_directory = '/var/cache/apache2/mod_auth_mellon/' + $modsec_version = 1 + $modsec_crs_package = 'modsecurity-crs' + $modsec_crs_path = '/usr/share/modsecurity-crs' + $modsec_dir = '/etc/modsecurity' + $secpcrematchlimit = 1500 + $secpcrematchlimitrecursion = 1500 + $modsec_secruleengine = 'On' + if ($::operatingsystem == 'Debian' and versioncmp($::operatingsystemrelease, '9') >= 0) or ($::operatingsystem == 'Ubuntu' and versioncmp($::operatingsystemrelease, '18.04') >= 0) { + $modsec_default_rules = [ + 'crawlers-user-agents.data', + 'iis-errors.data', + 'java-code-leakages.data', + 'java-errors.data', + 'lfi-os-files.data', + 'php-config-directives.data', + 'php-errors.data', + 'php-function-names-933150.data', + 'php-function-names-933151.data', + 'php-variables.data', + 'restricted-files.data', + 'scanners-headers.data', + 'scanners-urls.data', + 'scanners-user-agents.data', + 'scripting-user-agents.data', + 'sql-errors.data', + 'sql-function-names.data', + 'unix-shell.data', + 'windows-powershell-commands.data', + ] + } else { + $modsec_default_rules = [ + 'base_rules/modsecurity_35_bad_robots.data', + 'base_rules/modsecurity_35_scanners.data', + 'base_rules/modsecurity_40_generic_attacks.data', + 'base_rules/modsecurity_50_outbound.data', + 'base_rules/modsecurity_50_outbound_malware.data', + 'base_rules/modsecurity_crs_20_protocol_violations.conf', + 'base_rules/modsecurity_crs_21_protocol_anomalies.conf', + 'base_rules/modsecurity_crs_23_request_limits.conf', + 'base_rules/modsecurity_crs_30_http_policy.conf', + 'base_rules/modsecurity_crs_35_bad_robots.conf', + 'base_rules/modsecurity_crs_40_generic_attacks.conf', + 'base_rules/modsecurity_crs_41_sql_injection_attacks.conf', + 'base_rules/modsecurity_crs_41_xss_attacks.conf', + 'base_rules/modsecurity_crs_42_tight_security.conf', + 'base_rules/modsecurity_crs_45_trojans.conf', + 'base_rules/modsecurity_crs_47_common_exceptions.conf', + 'base_rules/modsecurity_crs_49_inbound_blocking.conf', + 'base_rules/modsecurity_crs_50_outbound.conf', + 'base_rules/modsecurity_crs_59_outbound_blocking.conf', + 'base_rules/modsecurity_crs_60_correlation.conf', + ] + } + $alias_icons_path = '/usr/share/apache2/icons' + $error_documents_path = '/usr/share/apache2/error' + $dev_packages = ['libaprutil1-dev', 'libapr1-dev', 'apache2-dev'] + + # + # Passenger-specific settings + # + + $passenger_conf_file = 'passenger.conf' + $passenger_conf_package_file = undef + $passenger_root = '/usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini' + $passenger_ruby = undef + $passenger_default_ruby = '/usr/bin/ruby' + $wsgi_socket_prefix = undef + } elsif $::osfamily == 'FreeBSD' { + $user = 'www' + $group = 'www' + $root_group = 'wheel' + $apache_name = 'apache24' + $service_name = 'apache24' + $httpd_dir = '/usr/local/etc/apache24' + $server_root = '/usr/local' + $conf_dir = $httpd_dir + $confd_dir = "${httpd_dir}/Includes" + $conf_enabled = undef + $puppet_ssl_dir = "${httpd_dir}/puppet_ssl" + $mod_dir = "${httpd_dir}/Modules" + $mod_enable_dir = undef + $vhost_dir = "${httpd_dir}/Vhosts" + $vhost_enable_dir = undef + $conf_file = 'httpd.conf' + $ports_file = "${conf_dir}/ports.conf" + $pidfile = '/var/run/httpd.pid' + $logroot = '/var/log/apache24' + $logroot_mode = undef + $lib_path = '/usr/local/libexec/apache24' + $mpm_module = 'prefork' + $dev_packages = undef + $default_ssl_cert = '/usr/local/etc/apache24/server.crt' + $default_ssl_key = '/usr/local/etc/apache24/server.key' + $ssl_sessioncache = '/var/run/ssl_scache(512000)' + $passenger_conf_file = 'passenger.conf' + $passenger_conf_package_file = undef + $passenger_root = '/usr/local/lib/ruby/gems/2.0/gems/passenger-4.0.58' + $passenger_ruby = '/usr/local/bin/ruby' + $passenger_default_ruby = undef + $suphp_addhandler = 'php5-script' + $suphp_engine = 'off' + $suphp_configpath = undef + $php_version = '5' + $mod_packages = { + # NOTE: I list here only modules that are not included in www/apache24 + # NOTE: 'passenger' needs to enable APACHE_SUPPORT in make config + # NOTE: 'php' needs to enable APACHE option in make config + # NOTE: 'dav_svn' needs to enable MOD_DAV_SVN make config + # NOTE: not sure where the shibboleth should come from + 'auth_kerb' => 'www/mod_auth_kerb2', + 'auth_gssapi' => 'www/mod_auth_gssapi', + 'auth_openidc'=> 'www/mod_auth_openidc', + 'fcgid' => 'www/mod_fcgid', + 'passenger' => 'www/rubygem-passenger', + 'perl' => 'www/mod_perl2', + 'phpXXX' => 'www/mod_phpXXX', + 'proxy_html' => 'www/mod_proxy_html', + 'python' => 'www/mod_python3', + 'wsgi' => 'www/mod_wsgi', + 'dav_svn' => 'devel/subversion', + 'xsendfile' => 'www/mod_xsendfile', + 'rpaf' => 'www/mod_rpaf2', + 'shib2' => 'security/shibboleth2-sp', + } + $mod_libs = { + } + $conf_template = 'apache/httpd.conf.erb' + $http_protocol_options = undef + $keepalive = 'On' + $keepalive_timeout = 15 + $max_keepalive_requests = 100 + $fastcgi_lib_path = undef # TODO: revisit + $mime_support_package = 'misc/mime-support' + $mime_types_config = '/usr/local/etc/mime.types' + $wsgi_socket_prefix = undef + $docroot = '/usr/local/www/apache24/data' + $alias_icons_path = '/usr/local/www/apache24/icons' + $error_documents_path = '/usr/local/www/apache24/error' + $error_log = 'httpd-error.log' + $scriptalias = '/usr/local/www/apache24/cgi-bin' + $access_log_file = 'httpd-access.log' + } elsif $::osfamily == 'Gentoo' { + $user = 'apache' + $group = 'apache' + $root_group = 'wheel' + $apache_name = 'www-servers/apache' + $service_name = 'apache2' + $httpd_dir = '/etc/apache2' + $server_root = '/var/www' + $conf_dir = $httpd_dir + $confd_dir = "${httpd_dir}/conf.d" + $conf_enabled = undef + $puppet_ssl_dir = "${httpd_dir}/puppet_ssl" + $mod_dir = "${httpd_dir}/modules.d" + $mod_enable_dir = undef + $vhost_dir = "${httpd_dir}/vhosts.d" + $vhost_enable_dir = undef + $conf_file = 'httpd.conf' + $ports_file = "${conf_dir}/ports.conf" + $logroot = '/var/log/apache2' + $logroot_mode = undef + $lib_path = '/usr/lib/apache2/modules' + $mpm_module = 'prefork' + $dev_packages = undef + $default_ssl_cert = '/etc/ssl/apache2/server.crt' + $default_ssl_key = '/etc/ssl/apache2/server.key' + $ssl_sessioncache = '/var/run/ssl_scache(512000)' + $passenger_root = '/usr' + $passenger_ruby = '/usr/bin/ruby' + $passenger_conf_file = 'passenger.conf' + $passenger_conf_package_file = undef + $passenger_default_ruby = undef + $suphp_addhandler = 'x-httpd-php' + $suphp_engine = 'off' + $suphp_configpath = '/etc/php5/apache2' + $php_version = '5' + $mod_packages = { + # NOTE: I list here only modules that are not included in www-servers/apache + 'auth_kerb' => 'www-apache/mod_auth_kerb', + 'auth_gssapi' => 'www-apache/mod_auth_gssapi', + 'authnz_external' => 'www-apache/mod_authnz_external', + 'fcgid' => 'www-apache/mod_fcgid', + 'passenger' => 'www-apache/passenger', + 'perl' => 'www-apache/mod_perl', + 'phpXXX' => 'dev-lang/php', + 'proxy_html' => 'www-apache/mod_proxy_html', + 'proxy_fcgi' => 'www-apache/mod_proxy_fcgi', + 'python' => 'www-apache/mod_python', + 'wsgi' => 'www-apache/mod_wsgi', + 'dav_svn' => 'dev-vcs/subversion', + 'xsendfile' => 'www-apache/mod_xsendfile', + 'rpaf' => 'www-apache/mod_rpaf', + 'xml2enc' => 'www-apache/mod_xml2enc', + } + $mod_libs = { + } + $conf_template = 'apache/httpd.conf.erb' + $http_protocol_options = undef + $keepalive = 'On' + $keepalive_timeout = 15 + $max_keepalive_requests = 100 + $fastcgi_lib_path = undef # TODO: revisit + $mime_support_package = 'app-misc/mime-types' + $mime_types_config = '/etc/mime.types' + $wsgi_socket_prefix = undef + $docroot = '/var/www/localhost/htdocs' + $alias_icons_path = '/usr/share/apache2/icons' + $error_documents_path = '/usr/share/apache2/error' + $pidfile = '/var/run/apache2.pid' + $error_log = 'error.log' + $scriptalias = '/var/www/localhost/cgi-bin' + $access_log_file = 'access.log' + } elsif $::osfamily == 'Suse' { + $user = 'wwwrun' + $group = 'www' + $root_group = 'root' + $apache_name = 'apache2' + $service_name = 'apache2' + $httpd_dir = '/etc/apache2' + $server_root = '/etc/apache2' + $conf_dir = $httpd_dir + $confd_dir = "${httpd_dir}/conf.d" + $conf_enabled = undef + $puppet_ssl_dir = "${httpd_dir}/puppet_ssl" + $mod_dir = "${httpd_dir}/mods-available" + $mod_enable_dir = "${httpd_dir}/mods-enabled" + $vhost_dir = "${httpd_dir}/sites-available" + $vhost_enable_dir = "${httpd_dir}/sites-enabled" + $conf_file = 'httpd.conf' + $ports_file = "${conf_dir}/ports.conf" + $pidfile = '/var/run/httpd2.pid' + $logroot = '/var/log/apache2' + $logroot_mode = undef + $lib_path = '/usr/lib64/apache2' #changes for some modules based on mpm + $mpm_module = 'prefork' + if versioncmp($::operatingsystemrelease, '15') < 0 { + $default_ssl_cert = '/etc/apache2/ssl.crt/server.crt' + $default_ssl_key = '/etc/apache2/ssl.key/server.key' + $php_version = '5' + } else { + $default_ssl_cert = '/etc/apache2/ssl.crt/default-server.crt' + $default_ssl_key = '/etc/apache2/ssl.key/default-server.key' + $php_version = '7' + } + $suphp_configpath = "/etc/php${php_version}/apache2" + $ssl_sessioncache = '/var/lib/apache2/ssl_scache(512000)' + $suphp_addhandler = 'x-httpd-php' + $suphp_engine = 'off' + if versioncmp($::operatingsystemrelease, '11') < 0 or versioncmp($::operatingsystemrelease, '12') >= 0 { + $mod_packages = { + 'auth_kerb' => 'apache2-mod_auth_kerb', + 'auth_gssapi' => 'apache2-mod_auth_gssapi', + 'dav_svn' => 'subversion-server', + 'perl' => 'apache2-mod_perl', + 'php5' => 'apache2-mod_php5', + 'php7' => 'apache2-mod_php7', + 'python' => 'apache2-mod_python', + 'security' => 'apache2-mod_security2', + 'worker' => 'apache2-worker', + } + } else { + $mod_packages = { + 'auth_kerb' => 'apache2-mod_auth_kerb', + 'auth_gssapi' => 'apache2-mod_auth_gssapi', + 'dav_svn' => 'subversion-server', + 'perl' => 'apache2-mod_perl', + 'php5' => 'apache2-mod_php53', + 'python' => 'apache2-mod_python', + 'security' => 'apache2-mod_security2', + } + } + $mod_libs = { + 'security' => '/usr/lib64/apache2/mod_security2.so', + 'php53' => '/usr/lib64/apache2/mod_php5.so', + } + $conf_template = 'apache/httpd.conf.erb' + $http_protocol_options = undef + $keepalive = 'On' + $keepalive_timeout = 15 + $max_keepalive_requests = 100 + $fastcgi_lib_path = '/var/lib/apache2/fastcgi' + $mime_support_package = 'aaa_base' + $mime_types_config = '/etc/mime.types' + $docroot = '/srv/www' + $cas_cookie_path = '/var/cache/apache2/mod_auth_cas/' + $mellon_lock_file = undef + $mellon_cache_size = undef + $mellon_post_directory = undef + $alias_icons_path = '/usr/share/apache2/icons' + $error_documents_path = '/usr/share/apache2/error' + $dev_packages = ['libapr-util1-devel', 'libapr1-devel', 'libcurl-devel'] + $modsec_version = 1 + $modsec_crs_package = undef + $modsec_crs_path = undef + $modsec_default_rules = undef + $modsec_dir = '/etc/apache2/modsecurity' + $secpcrematchlimit = 1500 + $secpcrematchlimitrecursion = 1500 + $modsec_secruleengine = 'On' + $error_log = 'error.log' + $scriptalias = '/usr/lib/cgi-bin' + $access_log_file = 'access.log' + + # + # Passenger-specific settings + # + + $passenger_conf_file = 'passenger.conf' + $passenger_conf_package_file = undef + + $passenger_root = '/usr/lib64/ruby/gems/1.8/gems/passenger-5.0.30' + $passenger_ruby = '/usr/bin/ruby' + $passenger_default_ruby = '/usr/bin/ruby' + $wsgi_socket_prefix = undef + } else { + fail("Class['apache::params']: Unsupported osfamily: ${::osfamily}") + } + + if $::operatingsystem == 'SLES' { + $verify_command = '/usr/sbin/apache2ctl -t' + } elsif $::operatingsystem == 'FreeBSD' { + $verify_command = '/usr/local/sbin/apachectl -t' + } elsif ($apache::version::scl_httpd_version) { + $verify_command = "/opt/rh/${_scl_httpd_name}/root/usr/sbin/apachectl -t" + } else { + $verify_command = '/usr/sbin/apachectl -t' + } + + if $::osfamily == 'RedHat' and versioncmp($facts['operatingsystemmajrelease'], '8') >= 0 { + $ssl_protocol = ['all'] # Implementations of the SSLv2 and SSLv3 protocol versions have been removed from OpenSSL (and hence mod_ssl) because these are no longer considered secure. For additional documentation https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/deploying_different_types_of_servers/setting-apache-web-server_deploying-different-types-of-servers + } else { + $ssl_protocol = ['all', '-SSLv2', '-SSLv3'] + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/peruser/multiplexer.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/peruser/multiplexer.pp new file mode 100644 index 000000000..5001090c4 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/peruser/multiplexer.pp @@ -0,0 +1,23 @@ +# @summary +# Checks if an Apache module has a class. +# +# If Apache has a class, it includes that class. If it does not, it passes the module name to the `apache::mod` defined type. +# +# @api private +define apache::peruser::multiplexer ( + $user = $apache::user, + $group = $apache::group, + $file = undef, +) { + if ! $file { + $filename = "${name}.conf" + } else { + $filename = $file + } + file { "${apache::mod_dir}/peruser/multiplexers/${filename}": + ensure => file, + content => "Multiplexer ${user} ${group}\n", + require => File["${apache::mod_dir}/peruser/multiplexers"], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/peruser/processor.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/peruser/processor.pp new file mode 100644 index 000000000..57c26fa9f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/peruser/processor.pp @@ -0,0 +1,21 @@ +# @summary +# Enables the `Peruser` module for FreeBSD only. +# +# @api private +define apache::peruser::processor ( + $user, + $group, + $file = undef, +) { + if ! $file { + $filename = "${name}.conf" + } else { + $filename = $file + } + file { "${apache::mod_dir}/peruser/processors/${filename}": + ensure => file, + content => "Processor ${user} ${group}\n", + require => File["${apache::mod_dir}/peruser/processors"], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/php.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/php.pp new file mode 100644 index 000000000..32999a929 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/php.pp @@ -0,0 +1,11 @@ +# @summary +# This class installs PHP for Apache. +# +# @note +# This class is deprecated. +# +# @api private +class apache::php { + warning('apache::php is deprecated; please use apache::mod::php') + include apache::mod::php +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/proxy.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/proxy.pp new file mode 100644 index 000000000..9df41958c --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/proxy.pp @@ -0,0 +1,11 @@ +# @summary +# This class enabled the proxy module for Apache. +# +# @note +# This class is deprecated. +# +# @api private +class apache::proxy { + warning('apache::proxy is deprecated; please use apache::mod::proxy') + include apache::mod::proxy +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/python.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/python.pp new file mode 100644 index 000000000..586ed9e81 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/python.pp @@ -0,0 +1,18 @@ +# @summary +# This class installs Python for Apache +# +# Parameters: +# - $php_package +# +# Actions: +# - Install Apache Python package +# +# Requires: +# +# Sample Usage: +# +# @api private +class apache::python { + warning('apache::python is deprecated; please use apache::mod::python') + include apache::mod::python +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/security/rule_link.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/security/rule_link.pp new file mode 100644 index 000000000..a3f70b109 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/security/rule_link.pp @@ -0,0 +1,21 @@ +# @summary +# Links the activated_rules from `apache::mod::security` to the respective CRS rules on disk. +# +# @api private +define apache::security::rule_link () { + $parts = split($title, '/') + $filename = $parts[-1] + + $target = $title ? { + /^\// => $title, + default => "${apache::params::modsec_crs_path}/${title}", + } + + file { $filename: + ensure => 'link', + path => "${apache::mod::security::modsec_dir}/activated_rules/${filename}", + target => $target , + require => File["${apache::mod::security::modsec_dir}/activated_rules"], + notify => Class['apache::service'], + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/service.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/service.pp new file mode 100644 index 000000000..7366e5fd3 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/service.pp @@ -0,0 +1,36 @@ +# @summary +# Installs and configures Apache service. +# +# @api private +class apache::service ( + $service_name = $apache::params::service_name, + Boolean $service_enable = true, + $service_ensure = 'running', + Boolean $service_manage = true, + $service_restart = undef +) { + # The base class must be included first because parameter defaults depend on it + if ! defined(Class['apache::params']) { + fail('You must include the apache::params class before using any apache defined resources') + } + case $service_ensure { + true, false, 'running', 'stopped': { + $_service_ensure = $service_ensure + } + default: { + $_service_ensure = undef + } + } + + $service_hasrestart = $service_restart == undef + + if $service_manage { + service { 'httpd': + ensure => $_service_ensure, + name => $service_name, + enable => $service_enable, + restart => $service_restart, + hasrestart => $service_hasrestart, + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/ssl.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/ssl.pp new file mode 100644 index 000000000..a241a98a2 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/ssl.pp @@ -0,0 +1,11 @@ +# @summary +# This class installs Apache SSL capabilities +# +# @note +# This class is deprecated. +# +# @api private +class apache::ssl { + warning('apache::ssl is deprecated; please use apache::mod::ssl') + include apache::mod::ssl +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/version.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/version.pp new file mode 100644 index 000000000..f799db73b --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/version.pp @@ -0,0 +1,42 @@ +# @summary +# Try to automatically detect the version by OS +# +# @api private +class apache::version ( + Optional[String] $scl_httpd_version = undef, + Optional[String] $scl_php_version = undef, +) { + case $::osfamily { + 'RedHat': { + if $scl_httpd_version { + $default = $scl_httpd_version + } + elsif ($::operatingsystem == 'Amazon' and $::operatingsystemmajrelease == '2') { + $default = '2.4' + } elsif ($::operatingsystem == 'Fedora' and versioncmp($facts['operatingsystemmajrelease'], '18') >= 0) or ($::operatingsystem != 'Fedora' and versioncmp($facts['operatingsystemmajrelease'], '7') >= 0) { + $default = '2.4' + } else { + $default = '2.2' + } + } + 'Debian': { + $default = '2.4' + } + 'FreeBSD': { + $default = '2.4' + } + 'Gentoo': { + $default = '2.4' + } + 'Suse': { + if ($::operatingsystem == 'SLES' and versioncmp($facts['operatingsystemmajrelease'], '12') >= 0) or ($::operatingsystem == 'OpenSuSE' and versioncmp($facts['operatingsystemmajrelease'], '42') >= 0) { + $default = '2.4' + } else { + $default = '2.2' + } + } + default: { + fail("Class['apache::version']: Unsupported osfamily: ${::osfamily}") + } + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/vhost.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/vhost.pp new file mode 100644 index 000000000..b5604dd26 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/vhost.pp @@ -0,0 +1,3041 @@ +# @summary +# Allows specialised configurations for virtual hosts that possess requirements +# outside of the defaults. +# +# The apache module allows a lot of flexibility in the setup and configuration of virtual hosts. +# This flexibility is due, in part, to `vhost` being a defined resource type, which allows Apache +# to evaluate it multiple times with different parameters.
+# The `apache::vhost` defined type allows you to have specialized configurations for virtual hosts +# that have requirements outside the defaults. You can set up a default virtual host within +# the base `::apache` class, as well as set a customized virtual host as the default. +# Customized virtual hosts have a lower numeric `priority` than the base class's, causing +# Apache to process the customized virtual host first.
+# The `apache::vhost` defined type uses `concat::fragment` to build the configuration file. To +# inject custom fragments for pieces of the configuration that the defined type doesn't +# inherently support, add a custom fragment.
+# For the custom fragment's `order` parameter, the `apache::vhost` defined type uses multiples +# of 10, so any `order` that isn't a multiple of 10 should work.
+# > **Note:** When creating an `apache::vhost`, it cannot be named `default` or `default-ssl`, +# because vhosts with these titles are always managed by the module. This means that you cannot +# override `Apache::Vhost['default']` or `Apache::Vhost['default-ssl]` resources. An optional +# workaround is to create a vhost named something else, such as `my default`, and ensure that the +# `default` and `default_ssl` vhosts are set to `false`: +# +# @example +# class { 'apache': +# default_vhost => false, +# default_ssl_vhost => false, +# } +# +# @param apache_version +# Apache's version number as a string, such as '2.2' or '2.4'. +# +# @param access_log +# Determines whether to configure `*_access.log` directives (`*_file`,`*_pipe`, or `*_syslog`). +# +# @param access_log_env_var +# Specifies that only requests with particular environment variables be logged. +# +# @param access_log_file +# Sets the filename of the `*_access.log` placed in `logroot`. Given a virtual host ---for +# instance, example.com--- it defaults to 'example.com_ssl.log' for +# [SSL-encrypted](https://httpd.apache.org/docs/current/ssl/index.html) virtual hosts and +# `example.com_access.log` for unencrypted virtual hosts. +# +# @param access_log_format +# Specifies the use of either a `LogFormat` nickname or a custom-formatted string for the +# access log. +# +# @param access_log_pipe +# Specifies a pipe where Apache sends access log messages. +# +# @param access_log_syslog +# Sends all access log messages to syslog. +# +# @param access_logs +# Allows you to give a hash that specifies the state of each of the `access_log_*` +# directives shown above, i.e. `access_log_pipe` and `access_log_syslog`. +# +# @param add_default_charset +# Sets a default media charset value for the `AddDefaultCharset` directive, which is +# added to `text/plain` and `text/html` responses. +# +# @param add_listen +# Determines whether the virtual host creates a `Listen` statement.
+# Setting `add_listen` to `false` prevents the virtual host from creating a `Listen` +# statement. This is important when combining virtual hosts that aren't passed an `ip` +# parameter with those that are. +# +# @param use_optional_includes +# Specifies whether Apache uses the `IncludeOptional` directive instead of `Include` for +# `additional_includes` in Apache 2.4 or newer. +# +# @param additional_includes +# Specifies paths to additional static, virtual host-specific Apache configuration files. +# You can use this parameter to implement a unique, custom configuration not supported by +# this module. +# +# @param aliases +# Passes a list of [hashes][hash] to the virtual host to create `Alias`, `AliasMatch`, +# `ScriptAlias` or `ScriptAliasMatch` directives as per the `mod_alias` documentation.
+# For example: +# ``` puppet +# aliases => [ +# { aliasmatch => '^/image/(.*)\.jpg$', +# path => '/files/jpg.images/$1.jpg', +# }, +# { alias => '/image', +# path => '/ftp/pub/image', +# }, +# { scriptaliasmatch => '^/cgi-bin(.*)', +# path => '/usr/local/share/cgi-bin$1', +# }, +# { scriptalias => '/nagios/cgi-bin/', +# path => '/usr/lib/nagios/cgi-bin/', +# }, +# { alias => '/nagios', +# path => '/usr/share/nagios/html', +# }, +# ], +# ``` +# For the `alias`, `aliasmatch`, `scriptalias` and `scriptaliasmatch` keys to work, each needs +# a corresponding context, such as `` or +# ``. Puppet creates the directives in the order specified in +# the `aliases` parameter. As described in the `mod_alias` documentation, add more specific +# `alias`, `aliasmatch`, `scriptalias` or `scriptaliasmatch` parameters before the more +# general ones to avoid shadowing.
+# > **Note**: Use the `aliases` parameter instead of the `scriptaliases` parameter because +# you can precisely control the order of various alias directives. Defining `ScriptAliases` +# using the `scriptaliases` parameter means *all* `ScriptAlias` directives will come after +# *all* `Alias` directives, which can lead to `Alias` directives shadowing `ScriptAlias` +# directives. This often causes problems; for example, this could cause problems with Nagios.
+# If `apache::mod::passenger` is loaded and `PassengerHighPerformance` is `true`, the `Alias` +# directive might not be able to honor the `PassengerEnabled => off` statement. See +# [this article](http://www.conandalton.net/2010/06/passengerenabled-off-not-working.html) for details. +# +# @param allow_encoded_slashes +# Sets the `AllowEncodedSlashes` declaration for the virtual host, overriding the server +# default. This modifies the virtual host responses to URLs with `\` and `/` characters. The +# default setting omits the declaration from the server configuration and selects the +# Apache default setting of `Off`. +# +# @param block +# Specifies the list of things to which Apache blocks access. Valid options are: `scm` (which +# blocks web access to `.svn`), `.git`, and `.bzr` directories. +# +# @param cas_attribute_prefix +# Adds a header with the value of this header being the attribute values when SAML +# validation is enabled. +# +# @param cas_attribute_delimiter +# Sets the delimiter between attribute values in the header created by `cas_attribute_prefix`. +# +# @param cas_login_url +# Sets the URL to which the module redirects users when they attempt to access a +# CAS-protected resource and don't have an active session. +# +# @param cas_root_proxied_as +# Sets the URL end users see when access to this Apache server is proxied per vhost. +# This URL should not include a trailing slash. +# +# @param cas_scrub_request_headers +# Remove inbound request headers that may have special meaning within mod_auth_cas. +# +# @param cas_sso_enabled +# Enables experimental support for single sign out (may mangle POST data). +# +# @param cas_validate_saml +# Parse response from CAS server for SAML. +# +# @param cas_validate_url +# Sets the URL to use when validating a client-presented ticket in an HTTP query string. +# +# @param cas_cookie_path +# Sets the location where information on the current session should be stored. This should +# be writable by the web server only. +# +# @param comment +# Adds comments to the header of the configuration file. Pass as string or an array of strings. +# For example: +# ``` puppet +# comment => "Account number: 123B", +# ``` +# Or: +# ``` puppet +# comment => [ +# "Customer: X", +# "Frontend domain: x.example.org", +# ] +# ``` +# +# @param custom_fragment +# Passes a string of custom configuration directives to place at the end of the virtual +# host configuration. +# +# @param default_vhost +# Sets a given `apache::vhost` defined type as the default to serve requests that do not +# match any other `apache::vhost` defined types. +# +# @param directoryindex +# Sets the list of resources to look for when a client requests an index of the directory +# by specifying a '/' at the end of the directory name. See the `DirectoryIndex` directive +# documentation for details. +# +# @param docroot +# **Required**.
+# Sets the `DocumentRoot` location, from which Apache serves files.
+# If `docroot` and `manage_docroot` are both set to `false`, no `DocumentRoot` will be set +# and the accompanying `` block will not be created. +# +# @param docroot_group +# Sets group access to the `docroot` directory. +# +# @param docroot_owner +# Sets individual user access to the `docroot` directory. +# +# @param docroot_mode +# Sets access permissions for the `docroot` directory, in numeric notation. +# +# @param manage_docroot +# Determines whether Puppet manages the `docroot` directory. +# +# @param error_log +# Specifies whether `*_error.log` directives should be configured. +# +# @param error_log_file +# Points the virtual host's error logs to a `*_error.log` file. If this parameter is +# undefined, Puppet checks for values in `error_log_pipe`, then `error_log_syslog`.
+# If none of these parameters is set, given a virtual host `example.com`, Puppet defaults +# to `$logroot/example.com_error_ssl.log` for SSL virtual hosts and +# `$logroot/example.com_error.log` for non-SSL virtual hosts. +# +# @param error_log_pipe +# Specifies a pipe to send error log messages to.
+# This parameter has no effect if the `error_log_file` parameter has a value. If neither +# this parameter nor `error_log_file` has a value, Puppet then checks `error_log_syslog`. +# +# @param error_log_syslog +# Determines whether to send all error log messages to syslog. +# This parameter has no effect if either of the `error_log_file` or `error_log_pipe` +# parameters has a value. If none of these parameters has a value, given a virtual host +# `example.com`, Puppet defaults to `$logroot/example.com_error_ssl.log` for SSL virtual +# hosts and `$logroot/example.com_error.log` for non-SSL virtual hosts. +# +# @param error_log_format +# Sets the [ErrorLogFormat](https://httpd.apache.org/docs/current/mod/core.html#errorlogformat) +# format specification for error log entries inside virtual host +# For example: +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# error_log_format => [ +# '[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M', +# { '[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T' => 'request' }, +# { "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'" => 'request' }, +# { "[%{uc}t] [R:%L] Referer:'%+{Referer}i'" => 'request' }, +# { '[%{uc}t] [C:%{c}L] local\ %a remote\ %A' => 'connection' }, +# ], +# } +# ``` +# +# @param error_documents +# A list of hashes which can be used to override the +# [ErrorDocument](https://httpd.apache.org/docs/current/mod/core.html#errordocument) +# settings for this virtual host.
+# For example: +# ``` puppet +# apache::vhost { 'sample.example.net': +# error_documents => [ +# { 'error_code' => '503', 'document' => '/service-unavail' }, +# { 'error_code' => '407', 'document' => 'https://example.com/proxy/login' }, +# ], +# } +# ``` +# +# @param ensure +# Specifies if the virtual host is present or absent.
+# +# @param fallbackresource +# Sets the [FallbackResource](https://httpd.apache.org/docs/current/mod/mod_dir.html#fallbackresource) +# directive, which specifies an action to take for any URL that doesn't map to anything in +# your filesystem and would otherwise return 'HTTP 404 (Not Found)'. Values must either begin +# with a `/` or be `disabled`. +# +# @param fastcgi_server +# Specify an external FastCGI server to manage a connection to. +# +# @param fastcgi_socket +# Specify the socket that will be used to communicate with an external FastCGI server. +# +# @param fastcgi_idle_timeout +# If using fastcgi, this option sets the timeout for the server to respond. +# +# @param fastcgi_dir +# Specify an internal FastCGI directory that is to be managed. +# +# @param filters +# [Filters](https://httpd.apache.org/docs/current/mod/mod_filter.html) enable smart, +# context-sensitive configuration of output content filters. +# ``` puppet +# apache::vhost { "$::fqdn": +# filters => [ +# 'FilterDeclare COMPRESS', +# 'FilterProvider COMPRESS DEFLATE resp=Content-Type $text/html', +# 'FilterChain COMPRESS', +# 'FilterProtocol COMPRESS DEFLATE change=yes;byteranges=no', +# ], +# } +# ``` +# +# @param h2_copy_files +# Sets the [H2CopyFiles](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2copyfiles) +# directive which influences how the requestion process pass files to the main connection. +# +# @param h2_direct +# Sets the [H2Direct](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2direct) +# directive which toggles the usage of the HTTP/2 Direct Mode. +# +# @param h2_early_hints +# Sets the [H2EarlyHints](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2earlyhints) +# directive which controls if HTTP status 103 interim responses are forwarded to +# the client or not. +# +# @param h2_max_session_streams +# Sets the [H2MaxSessionStreams](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2maxsessionstreams) +# directive which sets the maximum number of active streams per HTTP/2 session +# that the server allows. +# +# @param h2_modern_tls_only +# Sets the [H2ModernTLSOnly](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2moderntlsonly) +# directive which toggles the security checks on HTTP/2 connections in TLS mode. +# +# @param h2_push +# Sets the [H2Push](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2push) +# directive which toggles the usage of the HTTP/2 server push protocol feature. +# +# @param h2_push_diary_size +# Sets the [H2PushDiarySize](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2pushdiarysize) +# directive which toggles the maximum number of HTTP/2 server pushes that are +# remembered per HTTP/2 connection. +# +# @param h2_push_priority +# Sets the [H2PushPriority](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2pushpriority) +# directive which defines the priority handling of pushed responses based on the +# content-type of the response. +# +# @param h2_push_resource +# Sets the [H2PushResource](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2pushresource) +# directive which declares resources for early pushing to the client. +# +# @param h2_serialize_headers +# Sets the [H2SerializeHeaders](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2serializeheaders) +# directive which toggles if HTTP/2 requests are serialized in HTTP/1.1 +# format for processing by httpd core. +# +# @param h2_stream_max_mem_size +# Sets the [H2StreamMaxMemSize](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2streammaxmemsize) +# directive which sets the maximum number of outgoing data bytes buffered in +# memory for an active stream. +# +# @param h2_tls_cool_down_secs +# Sets the [H2TLSCoolDownSecs](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2tlscooldownsecs) +# directive which sets the number of seconds of idle time on a TLS connection +# before the TLS write size falls back to a small (~1300 bytes) length. +# +# @param h2_tls_warm_up_size +# Sets the [H2TLSWarmUpSize](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2tlswarmupsize) +# directive which sets the number of bytes to be sent in small TLS records (~1300 +# bytes) until doing maximum sized writes (16k) on https: HTTP/2 connections. +# +# @param h2_upgrade +# Sets the [H2Upgrade](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2upgrade) +# directive which toggles the usage of the HTTP/1.1 Upgrade method for switching +# to HTTP/2. +# +# @param h2_window_size +# Sets the [H2WindowSize](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2windowsize) +# directive which sets the size of the window that is used for flow control from +# client to server and limits the amount of data the server has to buffer. +# +# @param headers +# Adds lines to replace, merge, or remove response headers. See +# [Apache's mod_headers documentation](https://httpd.apache.org/docs/current/mod/mod_headers.html#header) for more information. +# +# @param ip +# Sets the IP address the virtual host listens on. By default, uses Apache's default behavior +# of listening on all IPs. +# +# @param ip_based +# Enables an [IP-based](https://httpd.apache.org/docs/current/vhosts/ip-based.html) virtual +# host. This parameter inhibits the creation of a NameVirtualHost directive, since those are +# used to funnel requests to name-based virtual hosts. +# +# @param itk +# Configures [ITK](http://mpm-itk.sesse.net/) in a hash.
+# Usage typically looks something like: +# ``` puppet +# apache::vhost { 'sample.example.net': +# docroot => '/path/to/directory', +# itk => { +# user => 'someuser', +# group => 'somegroup', +# }, +# } +# ``` +# Valid values are: a hash, which can include the keys: +# * `user` + `group` +# * `assignuseridexpr` +# * `assigngroupidexpr` +# * `maxclientvhost` +# * `nice` +# * `limituidrange` (Linux 3.5.0 or newer) +# * `limitgidrange` (Linux 3.5.0 or newer) +# +# @param action +# Specifies whether you wish to configure mod_actions action directive which will +# activate cgi-script when triggered by a request. +# +# @param jk_mounts +# Sets up a virtual host with `JkMount` and `JkUnMount` directives to handle the paths +# for URL mapping between Tomcat and Apache.
+# The parameter must be an array of hashes where each hash must contain the `worker` +# and either the `mount` or `unmount` keys.
+# Usage typically looks like: +# ``` puppet +# apache::vhost { 'sample.example.net': +# jk_mounts => [ +# { mount => '/*', worker => 'tcnode1', }, +# { unmount => '/*.jpg', worker => 'tcnode1', }, +# ], +# } +# ``` +# +# @param http_protocol_options +# Specifies the strictness of HTTP protocol checks. +# +# @param keepalive +# Determines whether to enable persistent HTTP connections with the `KeepAlive` directive +# for the virtual host. By default, the global, server-wide `KeepAlive` setting is in effect.
+# Use the `keepalive_timeout` and `max_keepalive_requests` parameters to set relevant options +# for the virtual host. +# +# @param keepalive_timeout +# Sets the `KeepAliveTimeout` directive for the virtual host, which determines the amount +# of time to wait for subsequent requests on a persistent HTTP connection. By default, the +# global, server-wide `KeepAlive` setting is in effect.
+# This parameter is only relevant if either the global, server-wide `keepalive` parameter or +# the per-vhost `keepalive` parameter is enabled. +# +# @param max_keepalive_requests +# Limits the number of requests allowed per connection to the virtual host. By default, +# the global, server-wide `KeepAlive` setting is in effect.
+# This parameter is only relevant if either the global, server-wide `keepalive` parameter or +# the per-vhost `keepalive` parameter is enabled. +# +# @param auth_kerb +# Enable `mod_auth_kerb` parameters for a virtual host.
+# Usage typically looks like: +# ``` puppet +# apache::vhost { 'sample.example.net': +# auth_kerb => `true`, +# krb_method_negotiate => 'on', +# krb_auth_realms => ['EXAMPLE.ORG'], +# krb_local_user_mapping => 'on', +# directories => { +# path => '/var/www/html', +# auth_name => 'Kerberos Login', +# auth_type => 'Kerberos', +# auth_require => 'valid-user', +# }, +# } +# ``` +# +# @param krb_method_negotiate +# Determines whether to use the Negotiate method. +# +# @param krb_method_k5passwd +# Determines whether to use password-based authentication for Kerberos v5. +# +# @param krb_authoritative +# If set to `off`, authentication controls can be passed on to another module. +# +# @param krb_auth_realms +# Specifies an array of Kerberos realms to use for authentication. +# +# @param krb_5keytab +# Specifies the Kerberos v5 keytab file's location. +# +# @param krb_local_user_mapping +# Strips @REALM from usernames for further use. +# +# @param krb_verify_kdc +# This option can be used to disable the verification tickets against local keytab to prevent +# KDC spoofing attacks. +# +# @param krb_servicename +# Specifies the service name that will be used by Apache for authentication. Corresponding +# key of this name must be stored in the keytab. +# +# @param krb_save_credentials +# This option enables credential saving functionality. +# +# @param logroot +# Specifies the location of the virtual host's logfiles. +# +# @param logroot_ensure +# Determines whether or not to remove the logroot directory for a virtual host. +# +# @param logroot_mode +# Overrides the mode the logroot directory is set to. Do *not* grant write access to the +# directory the logs are stored in without being aware of the consequences; for more +# information, see [Apache's log security documentation](https://httpd.apache.org/docs/2.4/logs.html#security). +# +# @param logroot_owner +# Sets individual user access to the logroot directory. +# +# @param logroot_group +# Sets group access to the `logroot` directory. +# +# @param log_level +# Specifies the verbosity of the error log. +# +# @param modsec_body_limit +# Configures the maximum request body size (in bytes) ModSecurity accepts for buffering. +# +# @param modsec_disable_vhost +# Disables `mod_security` on a virtual host. Only valid if `apache::mod::security` is included. +# +# @param modsec_disable_ids +# Removes `mod_security` IDs from the virtual host.
+# Also takes a hash allowing removal of an ID from a specific location. +# ``` puppet +# apache::vhost { 'sample.example.net': +# modsec_disable_ids => [ 90015, 90016 ], +# } +# ``` +# +# ``` puppet +# apache::vhost { 'sample.example.net': +# modsec_disable_ids => { '/location1' => [ 90015, 90016 ] }, +# } +# ``` +# +# @param modsec_disable_ips +# Specifies an array of IP addresses to exclude from `mod_security` rule matching. +# +# @param modsec_disable_msgs +# Array of mod_security Msgs to remove from the virtual host. Also takes a hash allowing +# removal of an Msg from a specific location. +# ``` puppet +# apache::vhost { 'sample.example.net': +# modsec_disable_msgs => ['Blind SQL Injection Attack', 'Session Fixation Attack'], +# } +# ``` +# ``` puppet +# apache::vhost { 'sample.example.net': +# modsec_disable_msgs => { '/location1' => ['Blind SQL Injection Attack', 'Session Fixation Attack'] }, +# } +# ``` +# +# @param modsec_disable_tags +# Array of mod_security Tags to remove from the virtual host. Also takes a hash allowing +# removal of an Tag from a specific location. +# ``` puppet +# apache::vhost { 'sample.example.net': +# modsec_disable_tags => ['WEB_ATTACK/SQL_INJECTION', 'WEB_ATTACK/XSS'], +# } +# ``` +# ``` puppet +# apache::vhost { 'sample.example.net': +# modsec_disable_tags => { '/location1' => ['WEB_ATTACK/SQL_INJECTION', 'WEB_ATTACK/XSS'] }, +# } +# ``` +# +# @param modsec_audit_log_file +# If set, it is relative to `logroot`.
+# One of the parameters that determines how to send `mod_security` audit +# log ([SecAuditLog](https://github.com/SpiderLabs/ModSecurity/wiki/Reference-Manual#SecAuditLog)). +# If none of those parameters are set, the global audit log is used +# (`/var/log/httpd/modsec\_audit.log`; Debian and derivatives: `/var/log/apache2/modsec\_audit.log`; others: ). +# +# @param modsec_audit_log_pipe +# If `modsec_audit_log_pipe` is set, it should start with a pipe. Example +# `|/path/to/mlogc /path/to/mlogc.conf`.
+# One of the parameters that determines how to send `mod_security` audit +# log ([SecAuditLog](https://github.com/SpiderLabs/ModSecurity/wiki/Reference-Manual#SecAuditLog)). +# If none of those parameters are set, the global audit log is used +# (`/var/log/httpd/modsec\_audit.log`; Debian and derivatives: `/var/log/apache2/modsec\_audit.log`; others: ). +# +# @param modsec_audit_log +# If `modsec_audit_log` is `true`, given a virtual host ---for instance, example.com--- it +# defaults to `example.com\_security\_ssl.log` for SSL-encrypted virtual hosts +# and `example.com\_security.log` for unencrypted virtual hosts.
+# One of the parameters that determines how to send `mod_security` audit +# log ([SecAuditLog](https://github.com/SpiderLabs/ModSecurity/wiki/Reference-Manual#SecAuditLog)).
+# If none of those parameters are set, the global audit log is used +# (`/var/log/httpd/modsec\_audit.log`; Debian and derivatives: `/var/log/apache2/modsec\_audit.log`; others: ). +# +# @param no_proxy_uris +# Specifies URLs you do not want to proxy. This parameter is meant to be used in combination +# with [`proxy_dest`](#proxy_dest). +# +# @param no_proxy_uris_match +# This directive is equivalent to `no_proxy_uris`, but takes regular expressions. +# +# @param proxy_preserve_host +# Sets the [ProxyPreserveHost Directive](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxypreservehost).
+# Setting this parameter to `true` enables the `Host:` line from an incoming request to be +# proxied to the host instead of hostname. Setting it to `false` sets this directive to 'Off'. +# +# @param proxy_add_headers +# Sets the [ProxyAddHeaders Directive](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxyaddheaders).
+# This parameter controlls whether proxy-related HTTP headers (X-Forwarded-For, +# X-Forwarded-Host and X-Forwarded-Server) get sent to the backend server. +# +# @param proxy_error_override +# Sets the [ProxyErrorOverride Directive](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxyerroroverride). +# This directive controls whether Apache should override error pages for proxied content. +# +# @param options +# Sets the `Options` for the specified virtual host. For example: +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# options => ['Indexes','FollowSymLinks','MultiViews'], +# } +# ``` +# > **Note**: If you use the `directories` parameter of `apache::vhost`, 'Options', +# 'Override', and 'DirectoryIndex' are ignored because they are parameters within `directories`. +# +# @param override +# Sets the overrides for the specified virtual host. Accepts an array of +# [AllowOverride](https://httpd.apache.org/docs/current/mod/core.html#allowoverride) arguments. +# +# @param passenger_enabled +# Sets the value for the [PassengerEnabled](http://www.modrails.com/documentation/Users%20guide%20Apache.html#PassengerEnabled) +# directive to `on` or `off`. Requires `apache::mod::passenger` to be included. +# ``` puppet +# apache::vhost { 'sample.example.net': +# docroot => '/path/to/directory', +# directories => [ +# { path => '/path/to/directory', +# passenger_enabled => 'on', +# }, +# ], +# } +# ``` +# > **Note:** There is an [issue](http://www.conandalton.net/2010/06/passengerenabled-off-not-working.html) +# using the PassengerEnabled directive with the PassengerHighPerformance directive. +# +# @param passenger_base_uri +# Sets [PassengerBaseURI](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerbase_rui), +# to specify that the given URI is a distinct application served by Passenger. +# +# @param passenger_ruby +# Sets [PassengerRuby](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerruby), +# specifying the Ruby interpreter to use when serving the relevant web applications. +# +# @param passenger_python +# Sets [PassengerPython](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerpython), +# specifying the Python interpreter to use when serving the relevant web applications. +# +# @param passenger_nodejs +# Sets the [`PassengerNodejs`](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengernodejs), +# specifying Node.js command to use when serving the relevant web applications. +# +# @param passenger_meteor_app_settings +# Sets [PassengerMeteorAppSettings](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengermeteorappsettings), +# specifying a JSON file with settings for the application when using a Meteor +# application in non-bundled mode. +# +# @param passenger_app_env +# Sets [PassengerAppEnv](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerappenv), +# the environment for the Passenger application. If not specified, defaults to the global +# setting or 'production'. +# +# @param passenger_app_root +# Sets [PassengerRoot](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerapproot), +# the location of the Passenger application root if different from the DocumentRoot. +# +# @param passenger_app_group_name +# Sets [PassengerAppGroupName](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerappgroupname), +# the name of the application group that the current application should belong to. +# +# @param passenger_app_start_command +# Sets [PassengerAppStartCommand](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerappstartcommand), +# how Passenger should start your app on a specific port. +# +# @param passenger_app_type +# Sets [PassengerAppType](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerapptype), +# to force Passenger to recognize the application as a specific type. +# +# @param passenger_startup_file +# Sets the [PassengerStartupFile](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerstartupfile), +# path. This path is relative to the application root. +# +# @param passenger_restart_dir +# Sets the [PassengerRestartDir](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerrestartdir), +# to customize the directory in which `restart.txt` is searched for. +# +# @param passenger_spawn_method +# Sets [PassengerSpawnMethod](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerspawnmethod), +# whether Passenger spawns applications directly, or using a prefork copy-on-write mechanism. +# +# @param passenger_load_shell_envvars +# Sets [PassengerLoadShellEnvvars](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerloadshellenvvars), +# to enable or disable the loading of shell environment variables before spawning the application. +# +# @param passenger_rolling_restarts +# Sets [PassengerRollingRestarts](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerrollingrestarts), +# to enable or disable support for zero-downtime application restarts through `restart.txt`. +# +# @param passenger_resist_deployment_errors +# Sets [PassengerResistDeploymentErrors](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerresistdeploymenterrors), +# to enable or disable resistance against deployment errors. +# +# @param passenger_user +# Sets [PassengerUser](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengeruser), +# the running user for sandboxing applications. +# +# @param passenger_group +# Sets [PassengerGroup](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengergroup), +# the running group for sandboxing applications. +# +# @param passenger_friendly_error_pages +# Sets [PassengerFriendlyErrorPages](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerfriendlyerrorpages), +# which can display friendly error pages whenever an application fails to start. This +# friendly error page presents the startup error message, some suggestions for solving +# the problem, a backtrace and a dump of the environment variables. +# +# @param passenger_min_instances +# Sets [PassengerMinInstances](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengermininstances), +# the minimum number of application processes to run. +# +# @param passenger_max_instances +# Sets [PassengerMaxInstances](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengermaxinstances), +# the maximum number of application processes to run. +# +# @param passenger_max_preloader_idle_time +# Sets [PassengerMaxPreloaderIdleTime](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengermaxpreloaderidletime), +# the maximum amount of time the preloader waits before shutting down an idle process. +# +# @param passenger_force_max_concurrent_requests_per_process +# Sets [PassengerForceMaxConcurrentRequestsPerProcess](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerforcemaxconcurrentrequestsperprocess), +# the maximum amount of concurrent requests the application can handle per process. +# +# @param passenger_start_timeout +# Sets [PassengerStartTimeout](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerstarttimeout), +# the timeout for the application startup. +# +# @param passenger_concurrency_model +# Sets [PassengerConcurrencyModel](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerconcurrencyodel), +# to specify the I/O concurrency model that should be used for Ruby application processes. +# Passenger supports two concurrency models:
+# * `process` - single-threaded, multi-processed I/O concurrency. +# * `thread` - multi-threaded, multi-processed I/O concurrency. +# +# @param passenger_thread_count +# Sets [PassengerThreadCount](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerthreadcount), +# the number of threads that Passenger should spawn per Ruby application process.
+# This option only has effect if PassengerConcurrencyModel is `thread`. +# +# @param passenger_max_requests +# Sets [PassengerMaxRequests](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengermaxrequests), +# the maximum number of requests an application process will process. +# +# @param passenger_max_request_time +# Sets [PassengerMaxRequestTime](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengermaxrequesttime), +# the maximum amount of time, in seconds, that an application process may take to +# process a request. +# +# @param passenger_memory_limit +# Sets [PassengerMemoryLimit](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengermemorylimit), +# the maximum amount of memory that an application process may use, in megabytes. +# +# @param passenger_stat_throttle_rate +# Sets [PassengerStatThrottleRate](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerstatthrottlerate), +# to set a limit, in seconds, on how often Passenger will perform it's filesystem checks. +# +# @param passenger_pre_start +# Sets [PassengerPreStart](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerprestart), +# the URL of the application if pre-starting is required. +# +# @param passenger_high_performance +# Sets [PassengerHighPerformance](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerhighperformance), +# to enhance performance in return for reduced compatibility. +# +# @param passenger_buffer_upload +# Sets [PassengerBufferUpload](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerbufferupload), +# to buffer HTTP client request bodies before they are sent to the application. +# +# @param passenger_buffer_response +# Sets [PassengerBufferResponse](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerbufferresponse), +# to buffer Happlication-generated responses. +# +# @param passenger_error_override +# Sets [PassengerErrorOverride](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengererroroverride), +# to specify whether Apache will intercept and handle response with HTTP status codes of +# 400 and higher. +# +# @param passenger_max_request_queue_size +# Sets [PassengerMaxRequestQueueSize](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengermaxrequestqueuesize), +# to specify the maximum amount of requests that are allowed to queue whenever the maximum +# concurrent request limit is reached. If the queue is already at this specified limit, then +# Passenger immediately sends a "503 Service Unavailable" error to any incoming requests.
+# A value of 0 means that the queue size is unbounded. +# +# @param passenger_max_request_queue_time +# Sets [PassengerMaxRequestQueueTime](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengermaxrequestqueuetime), +# to specify the maximum amount of time that requests are allowed to stay in the queue +# whenever the maximum concurrent request limit is reached. If a request reaches this specified +# limit, then Passenger immeaditly sends a "504 Gateway Timeout" error for that request.
+# A value of 0 means that the queue time is unbounded. +# +# @param passenger_sticky_sessions +# Sets [PassengerStickySessions](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerstickysessions), +# to specify that, whenever possible, all requests sent by a client will be routed to the same +# originating application process. +# +# @param passenger_sticky_sessions_cookie_name +# Sets [PassengerStickySessionsCookieName](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerstickysessionscookiename), +# to specify the name of the sticky sessions cookie. +# +# @param passenger_sticky_sessions_cookie_attributes +# Sets [PassengerStickySessionsCookieAttributes](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerstickysessionscookieattributes), +# the attributes of the sticky sessions cookie. +# +# @param passenger_allow_encoded_slashes +# Sets [PassengerAllowEncodedSlashes](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerallowencodedslashes), +# to allow URLs with encoded slashes. Please note that this feature will not work properly +# unless Apache's `AllowEncodedSlashes` is also enabled. +# +# @param passenger_app_log_file +# Sets [PassengerAppLogFile](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerapplogfile), +# app specific messages logged to a different file in addition to Passenger log file. +# +# @param passenger_debugger +# Sets [PassengerDebugger](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerdebugger), +# to turn support for Ruby application debugging on or off. +# +# @param passenger_lve_min_uid +# Sets [PassengerLveMinUid](https://www.phusionpassenger.com/docs/references/config_reference/apache/#passengerlveminuid), +# to only allow the spawning of application processes with UIDs equal to, or higher than, this +# specified value on LVE-enabled kernels. +# +# @param php_values +# Allows per-virtual host setting [`php_value`s](http://php.net/manual/en/configuration.changes.php). +# These flags or values can be overwritten by a user or an application. +# Within a vhost declaration: +# ``` puppet +# php_values => [ 'include_path ".:/usr/local/example-app/include"' ], +# ``` +# +# @param php_flags +# Allows per-virtual host setting [`php_flags\``](http://php.net/manual/en/configuration.changes.php). +# These flags or values can be overwritten by a user or an application. +# +# @param php_admin_values +# Allows per-virtual host setting [`php_admin_value`](http://php.net/manual/en/configuration.changes.php). +# These flags or values cannot be overwritten by a user or an application. +# +# @param php_admin_flags +# Allows per-virtual host setting [`php_admin_flag`](http://php.net/manual/en/configuration.changes.php). +# These flags or values cannot be overwritten by a user or an application. +# +# @param port +# Sets the port the host is configured on. The module's defaults ensure the host listens +# on port 80 for non-SSL virtual hosts and port 443 for SSL virtual hosts. The host only +# listens on the port set in this parameter. +# +# @param priority +# Sets the relative load-order for Apache HTTPD VirtualHost configuration files.
+# If nothing matches the priority, the first name-based virtual host is used. Likewise, +# passing a higher priority causes the alphabetically first name-based virtual host to be +# used if no other names match.
+# > **Note:** You should not need to use this parameter. However, if you do use it, be +# aware that the `default_vhost` parameter for `apache::vhost` passes a priority of '15'.
+# To omit the priority prefix in file names, pass a priority of `false`. +# +# @param protocols +# Sets the [Protocols](https://httpd.apache.org/docs/current/en/mod/core.html#protocols) +# directive, which lists available protocols for the virutal host. +# +# @param protocols_honor_order +# Sets the [ProtocolsHonorOrder](https://httpd.apache.org/docs/current/en/mod/core.html#protocolshonororder) +# directive which determines wether the order of Protocols sets precedence during negotiation. +# +# @param proxy_dest +# Specifies the destination address of a [ProxyPass](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxypass) configuration. +# +# @param proxy_pass +# Specifies an array of `path => URI` values for a [ProxyPass](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxypass) +# configuration. Optionally, parameters can be added as an array. +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# proxy_pass => [ +# { 'path' => '/a', 'url' => 'http://backend-a/' }, +# { 'path' => '/b', 'url' => 'http://backend-b/' }, +# { 'path' => '/c', 'url' => 'http://backend-a/c', 'params' => {'max'=>20, 'ttl'=>120, 'retry'=>300}}, +# { 'path' => '/l', 'url' => 'http://backend-xy', +# 'reverse_urls' => ['http://backend-x', 'http://backend-y'] }, +# { 'path' => '/d', 'url' => 'http://backend-a/d', +# 'params' => { 'retry' => '0', 'timeout' => '5' }, }, +# { 'path' => '/e', 'url' => 'http://backend-a/e', +# 'keywords' => ['nocanon', 'interpolate'] }, +# { 'path' => '/f', 'url' => 'http://backend-f/', +# 'setenv' => ['proxy-nokeepalive 1','force-proxy-request-1.0 1']}, +# { 'path' => '/g', 'url' => 'http://backend-g/', +# 'reverse_cookies' => [{'path' => '/g', 'url' => 'http://backend-g/',}, {'domain' => 'http://backend-g', 'url' => 'http:://backend-g',},], }, +# { 'path' => '/h', 'url' => 'http://backend-h/h', +# 'no_proxy_uris' => ['/h/admin', '/h/server-status'] }, +# ], +# } +# ``` +# * `reverse_urls`. *Optional.* This setting is useful when used with `mod_proxy_balancer`. Values: an array or string. +# * `reverse_cookies`. *Optional.* Sets `ProxyPassReverseCookiePath` and `ProxyPassReverseCookieDomain`. +# * `params`. *Optional.* Allows for ProxyPass key-value parameters, such as connection settings. +# * `setenv`. *Optional.* Sets [environment variables](https://httpd.apache.org/docs/current/mod/mod_proxy.html#envsettings) for the proxy directive. Values: array. +# +# @param proxy_dest_match +# This directive is equivalent to `proxy_dest`, but takes regular expressions, see +# [ProxyPassMatch](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxypassmatch) +# for details. +# +# @param proxy_dest_reverse_match +# Allows you to pass a ProxyPassReverse if `proxy_dest_match` is specified. See +# [ProxyPassReverse](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxypassreverse) +# for details. +# +# @param proxy_pass_match +# This directive is equivalent to `proxy_pass`, but takes regular expressions, see +# [ProxyPassMatch](https://httpd.apache.org/docs/current/mod/mod_proxy.html#proxypassmatch) +# for details. +# +# @param redirect_dest +# Specifies the address to redirect to. +# +# @param redirect_source +# Specifies the source URIs that redirect to the destination specified in `redirect_dest`. +# If more than one item for redirect is supplied, the source and destination must be the same +# length, and the items are order-dependent. +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# redirect_source => ['/images','/downloads'], +# redirect_dest => ['http://img.example.com/','http://downloads.example.com/'], +# } +# ``` +# +# @param redirect_status +# Specifies the status to append to the redirect. +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# redirect_status => ['temp','permanent'], +# } +# ``` +# +# @param redirectmatch_regexp +# Determines which server status should be raised for a given regular expression +# and where to forward the user to. Entered as an array alongside redirectmatch_status +# and redirectmatch_dest. +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# redirectmatch_status => ['404','404'], +# redirectmatch_regexp => ['\.git(/.*|$)/','\.svn(/.*|$)'], +# redirectmatch_dest => ['http://www.example.com/$1','http://www.example.com/$2'], +# } +# ``` +# +# @param redirectmatch_status +# Determines which server status should be raised for a given regular expression +# and where to forward the user to. Entered as an array alongside redirectmatch_regexp +# and redirectmatch_dest. +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# redirectmatch_status => ['404','404'], +# redirectmatch_regexp => ['\.git(/.*|$)/','\.svn(/.*|$)'], +# redirectmatch_dest => ['http://www.example.com/$1','http://www.example.com/$2'], +# } +# ``` +# +# @param redirectmatch_dest +# Determines which server status should be raised for a given regular expression +# and where to forward the user to. Entered as an array alongside redirectmatch_status +# and redirectmatch_regexp. +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# redirectmatch_status => ['404','404'], +# redirectmatch_regexp => ['\.git(/.*|$)/','\.svn(/.*|$)'], +# redirectmatch_dest => ['http://www.example.com/$1','http://www.example.com/$2'], +# } +# ``` +# +# @param request_headers +# Modifies collected [request headers](https://httpd.apache.org/docs/current/mod/mod_headers.html#requestheader) +# in various ways, including adding additional request headers, removing request headers, +# and so on. +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# request_headers => [ +# 'append MirrorID "mirror 12"', +# 'unset MirrorID', +# ], +# } +# ``` +# +# @param rewrites +# Creates URL rewrite rules. Expects an array of hashes.
+# Valid Hash keys include `comment`, `rewrite_base`, `rewrite_cond`, `rewrite_rule` +# or `rewrite_map`.
+# For example, you can specify that anyone trying to access index.html is served welcome.html +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# rewrites => [ { rewrite_rule => ['^index\.html$ welcome.html'] } ] +# } +# ``` +# The parameter allows rewrite conditions that, when `true`, execute the associated rule. +# For instance, if you wanted to rewrite URLs only if the visitor is using IE +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# rewrites => [ +# { +# comment => 'redirect IE', +# rewrite_cond => ['%{HTTP_USER_AGENT} ^MSIE'], +# rewrite_rule => ['^index\.html$ welcome.html'], +# }, +# ], +# } +# ``` +# You can also apply multiple conditions. For instance, rewrite index.html to welcome.html +# only when the browser is Lynx or Mozilla (version 1 or 2) +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# rewrites => [ +# { +# comment => 'Lynx or Mozilla v1/2', +# rewrite_cond => ['%{HTTP_USER_AGENT} ^Lynx/ [OR]', '%{HTTP_USER_AGENT} ^Mozilla/[12]'], +# rewrite_rule => ['^index\.html$ welcome.html'], +# }, +# ], +# } +# ``` +# Multiple rewrites and conditions are also possible +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# rewrites => [ +# { +# comment => 'Lynx or Mozilla v1/2', +# rewrite_cond => ['%{HTTP_USER_AGENT} ^Lynx/ [OR]', '%{HTTP_USER_AGENT} ^Mozilla/[12]'], +# rewrite_rule => ['^index\.html$ welcome.html'], +# }, +# { +# comment => 'Internet Explorer', +# rewrite_cond => ['%{HTTP_USER_AGENT} ^MSIE'], +# rewrite_rule => ['^index\.html$ /index.IE.html [L]'], +# }, +# { +# rewrite_base => /apps/, +# rewrite_rule => ['^index\.cgi$ index.php', '^index\.html$ index.php', '^index\.asp$ index.html'], +# }, +# { comment => 'Rewrite to lower case', +# rewrite_cond => ['%{REQUEST_URI} [A-Z]'], +# rewrite_map => ['lc int:tolower'], +# rewrite_rule => ['(.*) ${lc:$1} [R=301,L]'], +# }, +# ], +# } +# ``` +# Refer to the [`mod_rewrite` documentation](https://httpd.apache.org/docs/2.4/mod/mod_rewrite.html) +# for more details on what is possible with rewrite rules and conditions.
+# > **Note**: If you include rewrites in your directories, also include `apache::mod::rewrite` +# and consider setting the rewrites using the `rewrites` parameter in `apache::vhost` rather +# than setting the rewrites in the virtual host's directories. +# +# @param rewrite_base +# The parameter [`rewrite_base`](https://httpd.apache.org/docs/current/mod/mod_rewrite.html#rewritebase) +# specifies the URL prefix to be used for per-directory (htaccess) RewriteRule directives +# that substitue a relative path. +# +# @param rewrite_rule +# The parameter [`rewrite_rile`](https://httpd.apache.org/docs/current/mod/mod_rewrite.html#rewriterule) +# allows the user to define the rules that will be used by the rewrite engine. +# +# @param rewrite_cond +# The parameter [`rewrite_cond`](https://httpd.apache.org/docs/current/mod/mod_rewrite.html#rewritecond) +# defines a rule condition, that when satisfied will implement that rule within the +# rewrite engine. +# +# @param rewrite_inherit +# Determines whether the virtual host inherits global rewrite rules.
+# Rewrite rules may be specified globally (in `$conf_file` or `$confd_dir`) or +# inside the virtual host `.conf` file. By default, virtual hosts do not inherit +# global settings. To activate inheritance, specify the `rewrites` parameter and set +# `rewrite_inherit` parameter to `true`: +# ``` puppet +# apache::vhost { 'site.name.fdqn': +# ... +# rewrites => [ +# , +# ], +# rewrite_inherit => `true`, +# } +# ``` +# > **Note**: The `rewrites` parameter is **required** for this to have effect
+# Apache activates global `Rewrite` rules inheritance if the virtual host files contains +# the following directives: +# ``` ApacheConf +# RewriteEngine On +# RewriteOptions Inherit +# ``` +# Refer to the official [`mod_rewrite`](https://httpd.apache.org/docs/2.2/mod/mod_rewrite.html) +# documentation, section "Rewriting in Virtual Hosts". +# +# @param scriptalias +# Defines a directory of CGI scripts to be aliased to the path '/cgi-bin', such as +# '/usr/scripts'. +# +# @param scriptaliases +# > **Note**: This parameter is deprecated in favor of the `aliases` parameter.
+# Passes an array of hashes to the virtual host to create either ScriptAlias or +# ScriptAliasMatch statements per the `mod_alias` documentation. +# ``` puppet +# scriptaliases => [ +# { +# alias => '/myscript', +# path => '/usr/share/myscript', +# }, +# { +# aliasmatch => '^/foo(.*)', +# path => '/usr/share/fooscripts$1', +# }, +# { +# aliasmatch => '^/bar/(.*)', +# path => '/usr/share/bar/wrapper.sh/$1', +# }, +# { +# alias => '/neatscript', +# path => '/usr/share/neatscript', +# }, +# ] +# ``` +# The ScriptAlias and ScriptAliasMatch directives are created in the order specified. +# As with [Alias and AliasMatch](#aliases) directives, specify more specific aliases +# before more general ones to avoid shadowing. +# +# @param serveradmin +# Specifies the email address Apache displays when it renders one of its error pages. +# +# @param serveraliases +# Sets the [ServerAliases](https://httpd.apache.org/docs/current/mod/core.html#serveralias) +# of the site. +# +# @param servername +# Sets the servername corresponding to the hostname you connect to the virtual host at. +# +# @param setenv +# Used by HTTPD to set environment variables for virtual hosts.
+# Example: +# ``` puppet +# apache::vhost { 'setenv.example.com': +# setenv => ['SPECIAL_PATH /foo/bin'], +# } +# ``` +# +# @param setenvif +# Used by HTTPD to conditionally set environment variables for virtual hosts. +# +# @param setenvifnocase +# Used by HTTPD to conditionally set environment variables for virtual hosts (caseless matching). +# +# @param suexec_user_group +# Allows the spcification of user and group execution privileges for CGI programs through +# inclusion of the `mod_suexec` module. +# +# @param suphp_addhandler +# Sets up a virtual host with [suPHP](http://suphp.org/DocumentationView.html?file=apache/CONFIG) +# working together with suphp_configpath and suphp_engine.
+# An example virtual host configuration with suPHP: +# ``` puppet +# apache::vhost { 'suphp.example.com': +# port => '80', +# docroot => '/home/appuser/myphpapp', +# suphp_addhandler => 'x-httpd-php', +# suphp_engine => 'on', +# suphp_configpath => '/etc/php5/apache2', +# directories => { path => '/home/appuser/myphpapp', +# 'suphp' => { user => 'myappuser', group => 'myappgroup' }, +# } +# } +# ``` +# +# @param suphp_configpath +# Sets up a virtual host with [suPHP](http://suphp.org/DocumentationView.html?file=apache/CONFIG) +# working together with suphp_addhandler and suphp_engine.
+# An example virtual host configuration with suPHP: +# ``` puppet +# apache::vhost { 'suphp.example.com': +# port => '80', +# docroot => '/home/appuser/myphpapp', +# suphp_addhandler => 'x-httpd-php', +# suphp_engine => 'on', +# suphp_configpath => '/etc/php5/apache2', +# directories => { path => '/home/appuser/myphpapp', +# 'suphp' => { user => 'myappuser', group => 'myappgroup' }, +# } +# } +# ``` +# +# @param suphp_engine +# Sets up a virtual host with [suPHP](http://suphp.org/DocumentationView.html?file=apache/CONFIG) +# working together with suphp_configpath and suphp_addhandler.
+# An example virtual host configuration with suPHP: +# ``` puppet +# apache::vhost { 'suphp.example.com': +# port => '80', +# docroot => '/home/appuser/myphpapp', +# suphp_addhandler => 'x-httpd-php', +# suphp_engine => 'on', +# suphp_configpath => '/etc/php5/apache2', +# directories => { path => '/home/appuser/myphpapp', +# 'suphp' => { user => 'myappuser', group => 'myappgroup' }, +# } +# } +# ``` +# +# @param vhost_name +# Enables name-based virtual hosting. If no IP is passed to the virtual host, but the +# virtual host is assigned a port, then the virtual host name is `vhost_name:port`. +# If the virtual host has no assigned IP or port, the virtual host name is set to the +# title of the resource. +# +# @param virtual_docroot +# Sets up a virtual host with a wildcard alias subdomain mapped to a directory with the +# same name. For example, `http://example.com` would map to `/var/www/example.com`. +# Note that the `DocumentRoot` directive will not be present even though there is a value +# set for `docroot` in the manifest. See [`virtual_use_default_docroot`](#virtual_use_default_docroot) to change this behavior. +# ``` puppet +# apache::vhost { 'subdomain.loc': +# vhost_name => '*', +# port => '80', +# virtual_docroot => '/var/www/%-2+', +# docroot => '/var/www', +# serveraliases => ['*.loc',], +# } +# ``` +# +# @param virtual_use_default_docroot +# By default, when using `virtual_docroot`, the value of `docroot` is ignored. Setting this +# to `true` will mean both directives will be added to the configuration. +# ``` puppet +# apache::vhost { 'subdomain.loc': +# vhost_name => '*', +# port => '80', +# virtual_docroot => '/var/www/%-2+', +# docroot => '/var/www', +# virtual_use_default_docroot => true, +# serveraliases => ['*.loc',], +# } +# ``` +# +# @param wsgi_daemon_process +# Sets up a virtual host with [WSGI](https://github.com/GrahamDumpleton/mod_wsgi) alongside +# wsgi_daemon_process_options, wsgi_process_group, +# wsgi_script_aliases and wsgi_pass_authorization.
+# A hash that sets the name of the WSGI daemon, accepting +# [certain keys](http://modwsgi.readthedocs.org/en/latest/configuration-directives/WSGIDaemonProcess.html).
+# An example virtual host configuration with WSGI: +# ``` puppet +# apache::vhost { 'wsgi.example.com': +# port => '80', +# docroot => '/var/www/pythonapp', +# wsgi_daemon_process => 'wsgi', +# wsgi_daemon_process_options => +# { processes => '2', +# threads => '15', +# display-name => '%{GROUP}', +# }, +# wsgi_process_group => 'wsgi', +# wsgi_script_aliases => { '/' => '/var/www/demo.wsgi' }, +# wsgi_chunked_request => 'On', +# } +# ``` +# +# @param wsgi_daemon_process_options +# Sets up a virtual host with [WSGI](https://github.com/GrahamDumpleton/mod_wsgi) alongside +# wsgi_daemon_process, wsgi_process_group, +# wsgi_script_aliases and wsgi_pass_authorization.
+# Sets the group ID that the virtual host runs under. +# +# @param wsgi_application_group +# Sets up a virtual host with [WSGI](https://github.com/GrahamDumpleton/mod_wsgi) alongside +# wsgi_daemon_process, wsgi_daemon_process_options, wsgi_process_group, +# and wsgi_pass_authorization.
+# This parameter defines the [`WSGIApplicationGroup directive`](https://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIApplicationGroup.html), +# thus allowing you to specify which application group the WSGI application belongs to, +# with all WSGI applications within the same group executing within the context of the +# same Python sub interpreter. +# +# @param wsgi_import_script +# Sets up a virtual host with [WSGI](https://github.com/GrahamDumpleton/mod_wsgi) alongside +# wsgi_daemon_process, wsgi_daemon_process_options, wsgi_process_group, +# and wsgi_pass_authorization.
+# This parameter defines the [`WSGIImportScript directive`](https://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIImportScript.html), +# which can be used in order to specify a script file to be loaded upon a process starting. +# +# @param wsgi_import_script_options +# Sets up a virtual host with [WSGI](https://github.com/GrahamDumpleton/mod_wsgi) alongside +# wsgi_daemon_process, wsgi_daemon_process_options, wsgi_process_group, +# and wsgi_pass_authorization.
+# This parameter defines the [`WSGIImportScript directive`](https://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIImportScript.html), +# which can be used in order to specify a script file to be loaded upon a process starting.
+# Specifies the process and aplication groups of the script. +# +# @param wsgi_chunked_request +# Sets up a virtual host with [WSGI](https://github.com/GrahamDumpleton/mod_wsgi) alongside +# wsgi_daemon_process, wsgi_daemon_process_options, wsgi_process_group, +# and wsgi_pass_authorization.
+# This parameter defines the [`WSGIChunkedRequest directive`](https://modwsgi.readthedocs.io/en/develop/configuration-directives/WSGIChunkedRequest.html), +# allowing you to enable support for chunked request content.
+# WSGI is technically incapable of supporting chunked request content without all chunked +# request content having first been read in and buffered. +# +# @param wsgi_process_group +# Sets up a virtual host with [WSGI](https://github.com/GrahamDumpleton/mod_wsgi) alongside +# wsgi_daemon_process, wsgi_daemon_process_options, +# wsgi_script_aliases and wsgi_pass_authorization.
+# Requires a hash of web paths to filesystem `.wsgi paths/`. +# +# @param wsgi_script_aliases +# Sets up a virtual host with [WSGI](https://github.com/GrahamDumpleton/mod_wsgi) alongside +# wsgi_daemon_process, wsgi_daemon_process_options, wsgi_process_group, +# and wsgi_pass_authorization.
+# Uses the WSGI application to handle authorization instead of Apache when set to `On`.
+# For more information, see mod_wsgi's [WSGIPassAuthorization documentation](https://modwsgi.readthedocs.org/en/latest/configuration-directives/WSGIPassAuthorization.html). +# +# @param wsgi_script_aliases_match +# Sets up a virtual host with [WSGI](https://github.com/GrahamDumpleton/mod_wsgi) alongside +# wsgi_daemon_process, wsgi_daemon_process_options, wsgi_process_group, +# and wsgi_pass_authorization.
+# Uses the WSGI application to handle authorization instead of Apache when set to `On`.
+# This directive is similar to `wsgi_script_aliases`, but makes use of regular expressions +# in place of simple prefix matching.
+# For more information, see mod_wsgi's [WSGIPassAuthorization documentation](https://modwsgi.readthedocs.org/en/latest/configuration-directives/WSGIPassAuthorization.html). +# +# @param wsgi_pass_authorization +# Sets up a virtual host with [WSGI](https://github.com/GrahamDumpleton/mod_wsgi) alongside +# wsgi_daemon_process, wsgi_daemon_process_options, wsgi_process_group and +# wsgi_script_aliases.
+# Enables support for chunked requests. +# +# @param directories +# The `directories` parameter within the `apache::vhost` class passes an array of hashes +# to the virtual host to create [Directory](https://httpd.apache.org/docs/current/mod/core.html#directory), +# [File](https://httpd.apache.org/docs/current/mod/core.html#files), and +# [Location](https://httpd.apache.org/docs/current/mod/core.html#location) directive blocks. +# These blocks take the form, `< Directory /path/to/directory>...< /Directory>`.
+# The `path` key sets the path for the directory, files, and location blocks. Its value +# must be a path for the `directory`, `files`, and `location` providers, or a regex for +# the `directorymatch`, `filesmatch`, or `locationmatch` providers. Each hash passed to +# `directories` **must** contain `path` as one of the keys.
+# The `provider` key is optional. If missing, this key defaults to `directory`. +# Values: `directory`, `files`, `proxy`, `location`, `directorymatch`, `filesmatch`, +# `proxymatch` or `locationmatch`. If you set `provider` to `directorymatch`, it +# uses the keyword `DirectoryMatch` in the Apache config file.
+# An example use of `directories`: +# ``` puppet +# apache::vhost { 'files.example.net': +# docroot => '/var/www/files', +# directories => [ +# { 'path' => '/var/www/files', +# 'provider' => 'files', +# 'deny' => 'from all', +# }, +# ], +# } +# ``` +# > **Note:** At least one directory should match the `docroot` parameter. After you +# start declaring directories, `apache::vhost` assumes that all required Directory blocks +# will be declared. If not defined, a single default Directory block is created that matches +# the `docroot` parameter.
+# Available handlers, represented as keys, should be placed within the `directory`, +# `files`, or `location` hashes. This looks like +# ``` puppet +# apache::vhost { 'sample.example.net': +# docroot => '/path/to/directory', +# directories => [ { path => '/path/to/directory', handler => value } ], +# } +# ``` +# Any handlers you do not set in these hashes are considered `undefined` within Puppet and +# are not added to the virtual host, resulting in the module using their default values. +# +# @param custom_fragment +# Pass a string of custom configuration directives to be placed at the end of the directory +# configuration. +# ``` puppet +# apache::vhost { 'monitor': +# ... +# directories => [ +# { +# path => '/path/to/directory', +# custom_fragment => ' +# +# SetHandler balancer-manager +# Order allow,deny +# Allow from all +# +# +# SetHandler server-status +# Order allow,deny +# Allow from all +# +# ProxyStatus On', +# }, +# ] +# } +# ``` +# +# @param error_documents +# An array of hashes used to override the [ErrorDocument](https://httpd.apache.org/docs/current/mod/core.html#errordocument) +# settings for the directory. +# ``` puppet +# apache::vhost { 'sample.example.net': +# directories => [ +# { path => '/srv/www', +# error_documents => [ +# { 'error_code' => '503', +# 'document' => '/service-unavail', +# }, +# ], +# }, +# ], +# } +# ``` +# +# @param h2_copy_files +# Sets the [H2CopyFiles](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2copyfiles) directive.
+# Note that you must declare `class {'apache::mod::http2': }` before using this directive. +# +# @param h2_push_resource +# Sets the [H2PushResource](https://httpd.apache.org/docs/current/mod/mod_http2.html#h2pushresource) directive.
+# Note that you must declare `class {'apache::mod::http2': }` before using this directive. +# +# @param headers +# Adds lines for [Header](https://httpd.apache.org/docs/current/mod/mod_headers.html#header) directives. +# ``` puppet +# apache::vhost { 'sample.example.net': +# docroot => '/path/to/directory', +# directories => { +# path => '/path/to/directory', +# headers => 'Set X-Robots-Tag "noindex, noarchive, nosnippet"', +# }, +# } +# ``` +# +# @param options +# Lists the [Options](https://httpd.apache.org/docs/current/mod/core.html#options) for the +# given Directory block. +# ``` puppet +# apache::vhost { 'sample.example.net': +# docroot => '/path/to/directory', +# directories => [ +# { path => '/path/to/directory', +# options => ['Indexes','FollowSymLinks','MultiViews'], +# }, +# ], +# } +# ``` +# +# @param shib_compat_valid_user +# Default is Off, matching the behavior prior to this command's existence. Addresses a conflict +# when using Shibboleth in conjunction with other auth/auth modules by restoring `standard` +# Apache behavior when processing the `valid-user` and `user` Require rules. See the +# [`mod_shib`documentation](https://wiki.shibboleth.net/confluence/display/SHIB2/NativeSPApacheConfig#NativeSPApacheConfig-Server/VirtualHostOptions), +# and [NativeSPhtaccess](https://wiki.shibboleth.net/confluence/display/SHIB2/NativeSPhtaccess) +# topic for more details. This key is disabled if `apache::mod::shib` is not defined. +# +# @param ssl_options +# String or list of [SSLOptions](https://httpd.apache.org/docs/current/mod/mod_ssl.html#ssloptions), +# which configure SSL engine run-time options. This handler takes precedence over SSLOptions +# set in the parent block of the virtual host. +# ``` puppet +# apache::vhost { 'secure.example.net': +# docroot => '/path/to/directory', +# directories => [ +# { path => '/path/to/directory', +# ssl_options => '+ExportCertData', +# }, +# { path => '/path/to/different/dir', +# ssl_options => ['-StdEnvVars', '+ExportCertData'], +# }, +# ], +# } +# ``` +# +# @param additional_includes +# Specifies paths to additional static, specific Apache configuration files in virtual +# host directories. +# ``` puppet +# apache::vhost { 'sample.example.net': +# docroot => '/path/to/directory', +# directories => [ +# { path => '/path/to/different/dir', +# additional_includes => ['/custom/path/includes', '/custom/path/another_includes',], +# }, +# ], +# } +# ``` +# +# @param gssapi +# Specfies mod_auth_gssapi parameters for particular directories in a virtual host directory +# ```puppet +# include apache::mod::auth_gssapi +# apache::vhost { 'sample.example.net': +# docroot => '/path/to/directory', +# directories => [ +# { path => '/path/to/different/dir', +# gssapi => { +# credstore => 'keytab:/foo/bar.keytab', +# localname => 'Off', +# sslonly => 'On', +# } +# }, +# ], +# } +# ``` +# +# @param ssl +# Enables SSL for the virtual host. SSL virtual hosts only respond to HTTPS queries. +# +# @param ssl_ca +# Specifies the SSL certificate authority to be used to verify client certificates used +# for authentication. +# +# @param ssl_cert +# Specifies the SSL certification. +# +# @param ssl_protocol +# Specifies [SSLProtocol](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslprotocol). +# Expects an array or space separated string of accepted protocols. +# +# @param ssl_cipher +# Specifies [SSLCipherSuite](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslciphersuite). +# +# @param ssl_honorcipherorder +# Sets [SSLHonorCipherOrder](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslhonorcipherorder), +# to cause Apache to use the server's preferred order of ciphers rather than the client's +# preferred order. +# +# @param ssl_certs_dir +# Specifies the location of the SSL certification directory to verify client certs. +# +# @param ssl_chain +# Specifies the SSL chain. This default works out of the box, but it must be updated in +# the base `apache` class with your specific certificate information before being used in +# production. +# +# @param ssl_crl +# Specifies the certificate revocation list to use. (This default works out of the box but +# must be updated in the base `apache` class with your specific certificate information +# before being used in production.) +# +# @param ssl_crl_path +# Specifies the location of the certificate revocation list to verify certificates for +# client authentication with. (This default works out of the box but must be updated in +# the base `apache` class with your specific certificate information before being used in +# production.) +# +# @param ssl_crl_check +# Sets the certificate revocation check level via the [SSLCARevocationCheck directive](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslcarevocationcheck) +# for ssl client authentication. The default works out of the box but must be specified when +# using CRLs in production. Only applicable to Apache 2.4 or higher; the value is ignored on +# older versions. +# +# @param ssl_key +# Specifies the SSL key.
+# Defaults are based on your operating system. Default work out of the box but must be +# updated in the base `apache` class with your specific certificate information before +# being used in production. +# +# @param ssl_verify_client +# Sets the [SSLVerifyClient](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslverifyclient) +# directive, which sets the certificate verification level for client authentication. +# ``` puppet +# apache::vhost { 'sample.example.net': +# ... +# ssl_verify_client => 'optional', +# } +# ``` +# +# @param ssl_verify_depth +# Sets the [SSLVerifyDepth](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslverifydepth) +# directive, which specifies the maximum depth of CA certificates in client certificate +# verification. You must set `ssl_verify_client` for it to take effect. +# ``` puppet +# apache::vhost { 'sample.example.net': +# ... +# ssl_verify_client => 'require', +# ssl_verify_depth => 1, +# } +# ``` +# +# @param ssl_proxy_protocol +# Sets the [SSLProxyProtocol](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxyprotocol) +# directive, which controls which SSL protocol flavors `mod_ssl` should use when establishing +# its server environment for proxy. It connects to servers using only one of the provided +# protocols. +# +# @param ssl_proxy_verify +# Sets the [SSLProxyVerify](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxyverify) +# directive, which configures certificate verification of the remote server when a proxy is +# configured to forward requests to a remote SSL server. +# +# @param ssl_proxy_verify_depth +# Sets the [SSLProxyVerifyDepth](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxyverifydepth) +# directive, which configures how deeply mod_ssl should verify before deciding that the +# remote server does not have a valid certificate.
+# A depth of 0 means that only self-signed remote server certificates are accepted, +# the default depth of 1 means the remote server certificate can be self-signed or +# signed by a CA that is directly known to the server. +# +# @param ssl_proxy_cipher_suite +# Sets the [SSLProxyCipherSuite](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxyciphersuite) +# directive, which controls cipher suites supported for ssl proxy traffic. +# +# @param ssl_proxy_ca_cert +# Sets the [SSLProxyCACertificateFile](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxycacertificatefile) +# directive, which specifies an all-in-one file where you can assemble the Certificates +# of Certification Authorities (CA) whose remote servers you deal with. These are used +# for Remote Server Authentication. This file should be a concatenation of the PEM-encoded +# certificate files in order of preference. +# +# @param ssl_proxy_machine_cert +# Sets the [SSLProxyMachineCertificateFile](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxymachinecertificatefile) +# directive, which specifies an all-in-one file where you keep the certs and keys used +# for this server to authenticate itself to remote servers. This file should be a +# concatenation of the PEM-encoded certificate files in order of preference. +# ``` puppet +# apache::vhost { 'sample.example.net': +# ... +# ssl_proxy_machine_cert => '/etc/httpd/ssl/client_certificate.pem', +# } +# ``` +# @param ssl_proxy_machine_cert_chain +# Sets the [SSLProxyMachineCertificateChainFile](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxymachinecertificatechainfile) +# directive, which specifies an all-in-one file where you keep the certificate chain for +# all of the client certs in use. This directive will be needed if the remote server +# presents a list of CA certificates that are not direct signers of one of the configured +# client certificates. This referenced file is simply the concatenation of the various +# PEM-encoded certificate files. Upon startup, each client certificate configured will be +# examined and a chain of trust will be constructed. +# +# @param ssl_proxy_check_peer_cn +# Sets the [SSLProxyCheckPeerCN](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxycheckpeercn) +# directive, which specifies whether the remote server certificate's CN field is compared +# against the hostname of the request URL. +# +# @param ssl_proxy_check_peer_name +# Sets the [SSLProxyCheckPeerName](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxycheckpeername) +# directive, which specifies whether the remote server certificate's CN field is compared +# against the hostname of the request URL. +# +# @param ssl_proxy_check_peer_expire +# Sets the [SSLProxyCheckPeerExpire](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxycheckpeerexpire) +# directive, which specifies whether the remote server certificate is checked for expiration +# or not. +# +# @param ssl_options +# Sets the [SSLOptions](https://httpd.apache.org/docs/current/mod/mod_ssl.html#ssloptions) +# directive, which configures various SSL engine run-time options. This is the global +# setting for the given virtual host and can be a string or an array.
+# A string: +# ``` puppet +# apache::vhost { 'sample.example.net': +# ... +# ssl_options => '+ExportCertData', +# } +# ``` +# An array: +# ``` puppet +# apache::vhost { 'sample.example.net': +# ... +# ssl_options => ['+StrictRequire', '+ExportCertData'], +# } +# ``` +# +# @param ssl_openssl_conf_cmd +# Sets the [SSLOpenSSLConfCmd](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslopensslconfcmd) +# directive, which provides direct configuration of OpenSSL parameters. +# +# @param ssl_proxyengine +# Specifies whether or not to use [SSLProxyEngine](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslproxyengine). +# +# @param ssl_stapling +# Specifies whether or not to use [SSLUseStapling](http://httpd.apache.org/docs/current/mod/mod_ssl.html#sslusestapling). +# By default, uses what is set globally.
+# This parameter only applies to Apache 2.4 or higher and is ignored on older versions. +# +# @param ssl_stapling_timeout +# Can be used to set the [SSLStaplingResponderTimeout](http://httpd.apache.org/docs/current/mod/mod_ssl.html#sslstaplingrespondertimeout) directive.
+# This parameter only applies to Apache 2.4 or higher and is ignored on older versions. +# +# @param ssl_stapling_return_errors +# Can be used to set the [SSLStaplingReturnResponderErrors](http://httpd.apache.org/docs/current/mod/mod_ssl.html#sslstaplingreturnrespondererrors) directive.
+# This parameter only applies to Apache 2.4 or higher and is ignored on older versions. +# +# @param ssl_user_name +# Sets the [SSLUserName](https://httpd.apache.org/docs/current/mod/mod_ssl.html#sslusername) directive. +# +# @param ssl_reload_on_change +# Enable reloading of apache if the content of ssl files have changed. +# +# @param use_canonical_name +# Specifies whether to use the [`UseCanonicalName directive`](https://httpd.apache.org/docs/2.4/mod/core.html#usecanonicalname), +# which allows you to configure how the server determines it's own name and port. +# +# @param define +# this lets you define configuration variables inside a vhost using [`Define`](https://httpd.apache.org/docs/2.4/mod/core.html#define), +# these can then be used to replace configuration values. All Defines are Undefined at the end of the VirtualHost. +# +# @param auth_oidc +# Enable `mod_auth_openidc` parameters for OpenID Connect authentication. +# +# @param oidc_settings +# An Apache::OIDCSettings Struct containing (mod_auth_openidc settings)[https://github.com/zmartzone/mod_auth_openidc/blob/master/auth_openidc.conf]. +# +# @param limitreqfields +# The `limitreqfields` parameter sets the maximum number of request header fields in +# an HTTP request. This directive gives the server administrator greater control over +# abnormal client request behavior, which may be useful for avoiding some forms of +# denial-of-service attacks. The value should be increased if normal clients see an error +# response from the server that indicates too many fields were sent in the request. +# +# @param limitreqfieldsize +# The `limitreqfieldsize` parameter sets the maximum ammount of _bytes_ that will +# be allowed within a request header. +# +# @param limitreqline +# Limit the size of the HTTP request line that will be accepted from the client +# This directive sets the number of bytes that will be allowed on the HTTP +# request-line. The LimitRequestLine directive allows the server administrator +# to set the limit on the allowed size of a client's HTTP request-line. Since +# the request-line consists of the HTTP method, URI, and protocol version, the +# LimitRequestLine directive places a restriction on the length of a request-URI +# allowed for a request on the server. A server needs this value to be large +# enough to hold any of its resource names, including any information that might +# be passed in the query part of a GET request. +# +# @param limitreqbody +# Restricts the total size of the HTTP request body sent from the client +# The LimitRequestBody directive allows the user to set a limit on the allowed +# size of an HTTP request message body within the context in which the +# directive is given (server, per-directory, per-file or per-location). If the +# client request exceeds that limit, the server will return an error response +# instead of servicing the request. +# +# @param $use_servername_for_filenames +# When set to true, default log / config file names will be derived from the sanitized +# value of the $servername parameter. +# When set to false (default), the existing behaviour of using the $name parameter +# will remain. +# +# @param $use_port_for_filenames +# When set to true and use_servername_for_filenames is also set to true, default log / +# config file names will be derived from the sanitized value of both the $servername and +# $port parameters. +# When set to false (default), the port is not included in the file names and may lead to +# duplicate declarations if two virtual hosts use the same domain. +# +# @param $mdomain +# All the names in the list are managed as one Managed Domain (MD). mod_md will request +# one single certificate that is valid for all these names. +define apache::vhost ( + Variant[Boolean,String] $docroot, + $manage_docroot = true, + $virtual_docroot = false, + $virtual_use_default_docroot = false, + $port = undef, + $ip = undef, + Boolean $ip_based = false, + $add_listen = true, + $docroot_owner = 'root', + $docroot_group = $apache::params::root_group, + $docroot_mode = undef, + Array[Enum['h2', 'h2c', 'http/1.1']] $protocols = [], + Optional[Boolean] $protocols_honor_order = undef, + $serveradmin = undef, + Boolean $ssl = false, + $ssl_cert = $apache::default_ssl_cert, + $ssl_key = $apache::default_ssl_key, + $ssl_chain = $apache::default_ssl_chain, + $ssl_ca = $apache::default_ssl_ca, + $ssl_crl_path = $apache::default_ssl_crl_path, + $ssl_crl = $apache::default_ssl_crl, + $ssl_crl_check = $apache::default_ssl_crl_check, + $ssl_certs_dir = $apache::params::ssl_certs_dir, + Boolean $ssl_reload_on_change = $apache::default_ssl_reload_on_change, + $ssl_protocol = undef, + $ssl_cipher = undef, + Variant[Boolean, Enum['on', 'On', 'off', 'Off'], Undef] $ssl_honorcipherorder = undef, + Optional[Enum['none', 'optional', 'require', 'optional_no_ca']] $ssl_verify_client = undef, + $ssl_verify_depth = undef, + Optional[Enum['none', 'optional', 'require', 'optional_no_ca']] $ssl_proxy_verify = undef, + Optional[Integer[0]] $ssl_proxy_verify_depth = undef, + $ssl_proxy_ca_cert = undef, + Optional[Enum['on', 'off']] $ssl_proxy_check_peer_cn = undef, + Optional[Enum['on', 'off']] $ssl_proxy_check_peer_name = undef, + Optional[Enum['on', 'off']] $ssl_proxy_check_peer_expire = undef, + $ssl_proxy_machine_cert = undef, + $ssl_proxy_machine_cert_chain = undef, + $ssl_proxy_cipher_suite = undef, + $ssl_proxy_protocol = undef, + $ssl_options = undef, + $ssl_openssl_conf_cmd = undef, + Boolean $ssl_proxyengine = false, + Optional[Boolean] $ssl_stapling = undef, + $ssl_stapling_timeout = undef, + $ssl_stapling_return_errors = undef, + Optional[String] $ssl_user_name = undef, + $priority = undef, + Boolean $default_vhost = false, + $servername = $name, + $serveraliases = [], + $options = ['Indexes','FollowSymLinks','MultiViews'], + $override = ['None'], + $directoryindex = '', + $vhost_name = '*', + $logroot = $apache::logroot, + Enum['directory', 'absent'] $logroot_ensure = 'directory', + $logroot_mode = undef, + $logroot_owner = undef, + $logroot_group = undef, + Optional[Apache::LogLevel] $log_level = undef, + Boolean $access_log = true, + $access_log_file = false, + $access_log_pipe = false, + $access_log_syslog = false, + $access_log_format = false, + $access_log_env_var = false, + Optional[Array] $access_logs = undef, + Optional[Boolean] $use_servername_for_filenames = false, + Optional[Boolean] $use_port_for_filenames = false, + $aliases = undef, + Optional[Variant[Hash, Array[Variant[Array,Hash]]]] $directories = undef, + Boolean $error_log = true, + $error_log_file = undef, + $error_log_pipe = undef, + $error_log_syslog = undef, + Optional[ + Array[ + Variant[ + String, + Hash[String, Enum['connection', 'request']] + ] + ] + ] $error_log_format = undef, + Optional[Pattern[/^((Strict|Unsafe)?\s*(\b(Registered|Lenient)Methods)?\s*(\b(Allow0\.9|Require1\.0))?)$/]] $http_protocol_options = undef, + $modsec_audit_log = undef, + $modsec_audit_log_file = undef, + $modsec_audit_log_pipe = undef, + $error_documents = [], + Optional[Variant[Stdlib::Absolutepath, Enum['disabled']]] $fallbackresource = undef, + $scriptalias = undef, + $scriptaliases = [], + Optional[Integer] $limitreqfieldsize = undef, + Optional[Integer] $limitreqfields = undef, + Optional[Integer] $limitreqline = undef, + Optional[Integer] $limitreqbody = undef, + $proxy_dest = undef, + $proxy_dest_match = undef, + $proxy_dest_reverse_match = undef, + $proxy_pass = undef, + $proxy_pass_match = undef, + Boolean $proxy_requests = false, + $suphp_addhandler = $apache::params::suphp_addhandler, + Enum['on', 'off'] $suphp_engine = $apache::params::suphp_engine, + $suphp_configpath = $apache::params::suphp_configpath, + $php_flags = {}, + $php_values = {}, + $php_admin_flags = {}, + $php_admin_values = {}, + $no_proxy_uris = [], + $no_proxy_uris_match = [], + $proxy_preserve_host = false, + $proxy_add_headers = undef, + $proxy_error_override = false, + $redirect_source = '/', + $redirect_dest = undef, + $redirect_status = undef, + $redirectmatch_status = undef, + $redirectmatch_regexp = undef, + $redirectmatch_dest = undef, + $headers = undef, + $request_headers = undef, + $filters = undef, + Optional[Array] $rewrites = undef, + $rewrite_base = undef, + $rewrite_rule = undef, + $rewrite_cond = undef, + $rewrite_inherit = false, + $setenv = [], + $setenvif = [], + $setenvifnocase = [], + $block = [], + Enum['absent', 'present'] $ensure = 'present', + $wsgi_application_group = undef, + Optional[Variant[String,Hash]] $wsgi_daemon_process = undef, + Optional[Hash] $wsgi_daemon_process_options = undef, + $wsgi_import_script = undef, + Optional[Hash] $wsgi_import_script_options = undef, + $wsgi_process_group = undef, + Optional[Hash] $wsgi_script_aliases_match = undef, + Optional[Hash] $wsgi_script_aliases = undef, + Optional[Enum['on', 'off', 'On', 'Off']] $wsgi_pass_authorization = undef, + $wsgi_chunked_request = undef, + Optional[String] $custom_fragment = undef, + Optional[Hash] $itk = undef, + $action = undef, + $fastcgi_server = undef, + $fastcgi_socket = undef, + $fastcgi_dir = undef, + $fastcgi_idle_timeout = undef, + $additional_includes = [], + $use_optional_includes = $apache::use_optional_includes, + $apache_version = $apache::apache_version, + Optional[Enum['on', 'off', 'nodecode']] $allow_encoded_slashes = undef, + Optional[Pattern[/^[\w-]+ [\w-]+$/]] $suexec_user_group = undef, + + Optional[Boolean] $h2_copy_files = undef, + Optional[Boolean] $h2_direct = undef, + Optional[Boolean] $h2_early_hints = undef, + Optional[Integer] $h2_max_session_streams = undef, + Optional[Boolean] $h2_modern_tls_only = undef, + Optional[Boolean] $h2_push = undef, + Optional[Integer] $h2_push_diary_size = undef, + Array[String] $h2_push_priority = [], + Array[String] $h2_push_resource = [], + Optional[Boolean] $h2_serialize_headers = undef, + Optional[Integer] $h2_stream_max_mem_size = undef, + Optional[Integer] $h2_tls_cool_down_secs = undef, + Optional[Integer] $h2_tls_warm_up_size = undef, + Optional[Boolean] $h2_upgrade = undef, + Optional[Integer] $h2_window_size = undef, + + Optional[Boolean] $passenger_enabled = undef, + Optional[String] $passenger_base_uri = undef, + Optional[Stdlib::Absolutepath] $passenger_ruby = undef, + Optional[Stdlib::Absolutepath] $passenger_python = undef, + Optional[Stdlib::Absolutepath] $passenger_nodejs = undef, + Optional[String] $passenger_meteor_app_settings = undef, + Optional[String] $passenger_app_env = undef, + Optional[Stdlib::Absolutepath] $passenger_app_root = undef, + Optional[String] $passenger_app_group_name = undef, + Optional[String] $passenger_app_start_command = undef, + Optional[Enum['meteor', 'node', 'rack', 'wsgi']] $passenger_app_type = undef, + Optional[String] $passenger_startup_file = undef, + Optional[String] $passenger_restart_dir = undef, + Optional[Enum['direct', 'smart']] $passenger_spawn_method = undef, + Optional[Boolean] $passenger_load_shell_envvars = undef, + Optional[Boolean] $passenger_rolling_restarts = undef, + Optional[Boolean] $passenger_resist_deployment_errors = undef, + Optional[String] $passenger_user = undef, + Optional[String] $passenger_group = undef, + Optional[Boolean] $passenger_friendly_error_pages = undef, + Optional[Integer] $passenger_min_instances = undef, + Optional[Integer] $passenger_max_instances = undef, + Optional[Integer] $passenger_max_preloader_idle_time = undef, + Optional[Integer] $passenger_force_max_concurrent_requests_per_process = undef, + Optional[Integer] $passenger_start_timeout = undef, + Optional[Enum['process', 'thread']] $passenger_concurrency_model = undef, + Optional[Integer] $passenger_thread_count = undef, + Optional[Integer] $passenger_max_requests = undef, + Optional[Integer] $passenger_max_request_time = undef, + Optional[Integer] $passenger_memory_limit = undef, + Optional[Integer] $passenger_stat_throttle_rate = undef, + Optional[Variant[String,Array[String]]] $passenger_pre_start = undef, + Optional[Boolean] $passenger_high_performance = undef, + Optional[Boolean] $passenger_buffer_upload = undef, + Optional[Boolean] $passenger_buffer_response = undef, + Optional[Boolean] $passenger_error_override = undef, + Optional[Integer] $passenger_max_request_queue_size = undef, + Optional[Integer] $passenger_max_request_queue_time = undef, + Optional[Boolean] $passenger_sticky_sessions = undef, + Optional[String] $passenger_sticky_sessions_cookie_name = undef, + Optional[String] $passenger_sticky_sessions_cookie_attributes = undef, + Optional[Boolean] $passenger_allow_encoded_slashes = undef, + Optional[String] $passenger_app_log_file = undef, + Optional[Boolean] $passenger_debugger = undef, + Optional[Integer] $passenger_lve_min_uid = undef, + $add_default_charset = undef, + $modsec_disable_vhost = undef, + Optional[Variant[Hash, Array]] $modsec_disable_ids = undef, + $modsec_disable_ips = undef, + Optional[Variant[Hash, Array]] $modsec_disable_msgs = undef, + Optional[Variant[Hash, Array]] $modsec_disable_tags = undef, + $modsec_body_limit = undef, + $jk_mounts = undef, + Boolean $auth_kerb = false, + $krb_method_negotiate = 'on', + $krb_method_k5passwd = 'on', + $krb_authoritative = 'on', + $krb_auth_realms = [], + $krb_5keytab = undef, + $krb_local_user_mapping = undef, + $krb_verify_kdc = 'on', + $krb_servicename = 'HTTP', + $krb_save_credentials = 'off', + Optional[Enum['on', 'off']] $keepalive = undef, + $keepalive_timeout = undef, + $max_keepalive_requests = undef, + $cas_attribute_prefix = undef, + $cas_attribute_delimiter = undef, + $cas_root_proxied_as = undef, + $cas_scrub_request_headers = undef, + $cas_sso_enabled = undef, + $cas_login_url = undef, + $cas_validate_url = undef, + $cas_validate_saml = undef, + $cas_cookie_path = undef, + Optional[String] $shib_compat_valid_user = undef, + Optional[Enum['On', 'on', 'Off', 'off', 'DNS', 'dns']] $use_canonical_name = undef, + Optional[Variant[String,Array[String]]] $comment = undef, + Hash $define = {}, + Boolean $auth_oidc = false, + Optional[Apache::OIDCSettings] $oidc_settings = undef, + Optional[Variant[Boolean,String]] $mdomain = undef, +) { + # The base class must be included first because it is used by parameter defaults + if ! defined(Class['apache']) { + fail('You must include the apache base class before using any apache defined resources') + } + + $apache_name = $apache::apache_name + + if $rewrites { + unless empty($rewrites) { + $rewrites_flattened = delete_undef_values(flatten([$rewrites])) + assert_type(Array[Hash], $rewrites_flattened) + } + } + + # Input validation begins + + if $access_log_file and $access_log_pipe { + fail("Apache::Vhost[${name}]: 'access_log_file' and 'access_log_pipe' cannot be defined at the same time") + } + + if $error_log_file and $error_log_pipe { + fail("Apache::Vhost[${name}]: 'error_log_file' and 'error_log_pipe' cannot be defined at the same time") + } + + if $modsec_audit_log_file and $modsec_audit_log_pipe { + fail("Apache::Vhost[${name}]: 'modsec_audit_log_file' and 'modsec_audit_log_pipe' cannot be defined at the same time") + } + + # Input validation ends + + if $ssl and $ensure == 'present' { + include apache::mod::ssl + # Required for the AddType lines. + include apache::mod::mime + } + + if $ssl_honorcipherorder =~ Boolean or $ssl_honorcipherorder == undef { + $_ssl_honorcipherorder = $ssl_honorcipherorder + } else { + $_ssl_honorcipherorder = $ssl_honorcipherorder ? { + 'on' => true, + 'On' => true, + 'off' => false, + 'Off' => false, + default => true, + } + } + + if $auth_kerb and $ensure == 'present' { + include apache::mod::auth_kerb + } + + if $auth_oidc and $ensure == 'present' { + include apache::mod::auth_openidc + } + + if $virtual_docroot { + include apache::mod::vhost_alias + } + + if $wsgi_application_group or $wsgi_daemon_process or ($wsgi_import_script and $wsgi_import_script_options) or $wsgi_process_group or ($wsgi_script_aliases and ! empty($wsgi_script_aliases)) or $wsgi_pass_authorization { + include apache::mod::wsgi + } + + if $suexec_user_group { + include apache::mod::suexec + } + + if $passenger_enabled != undef or $passenger_start_timeout != undef or $passenger_ruby != undef or $passenger_python != undef or $passenger_nodejs != undef or $passenger_meteor_app_settings != undef or $passenger_app_env != undef or $passenger_app_root != undef or $passenger_app_group_name != undef or $passenger_app_start_command != undef or $passenger_app_type != undef or $passenger_startup_file != undef or $passenger_restart_dir != undef or $passenger_spawn_method != undef or $passenger_load_shell_envvars != undef or $passenger_rolling_restarts != undef or $passenger_resist_deployment_errors != undef or $passenger_min_instances != undef or $passenger_max_instances != undef or $passenger_max_preloader_idle_time != undef or $passenger_force_max_concurrent_requests_per_process != undef or $passenger_concurrency_model != undef or $passenger_thread_count != undef or $passenger_high_performance != undef or $passenger_max_request_queue_size != undef or $passenger_max_request_queue_time != undef or $passenger_user != undef or $passenger_group != undef or $passenger_friendly_error_pages != undef or $passenger_buffer_upload != undef or $passenger_buffer_response != undef or $passenger_allow_encoded_slashes != undef or $passenger_lve_min_uid != undef or $passenger_base_uri != undef or $passenger_error_override != undef or $passenger_sticky_sessions != undef or $passenger_sticky_sessions_cookie_name != undef or $passenger_sticky_sessions_cookie_attributes != undef or $passenger_app_log_file != undef or $passenger_debugger != undef or $passenger_max_requests != undef or $passenger_max_request_time != undef or $passenger_memory_limit != undef { + include apache::mod::passenger + } + + # Configure the defaultness of a vhost + if $priority { + $priority_real = "${priority}-" + } elsif $priority == false { + $priority_real = '' + } elsif $default_vhost { + $priority_real = '10-' + } else { + $priority_real = '25-' + } + + # https://httpd.apache.org/docs/2.4/fr/mod/core.html#servername + # Syntax: ServerName [scheme://]domain-name|ip-address[:port] + # Sometimes, the server runs behind a device that processes SSL, such as a reverse proxy, load balancer or SSL offload + # appliance. + # When this is the case, specify the https:// scheme and the port number to which the clients connect in the ServerName + # directive to make sure that the server generates the correct self-referential URLs. + $normalized_servername = regsubst($servername, '(https?:\/\/)?([a-z0-9\/%_+.,#?!@&=-]+)(:?\d+)?', '\2', 'G') + + # IAC-1186: A number of configuration and log file names are generated using the $name parameter. It is possible for + # the $name parameter to contain spaces, which could then be transferred to the log / config filenames. Although + # POSIX compliant, this can be cumbersome. + # + # It seems more appropriate to use the $servername parameter to derive default log / config filenames from. We should + # also perform some sanitiation on the $servername parameter to strip spaces from it, as it defaults to the value of + # $name, should $servername NOT be defined. + # + # Because a single hostname may be use by multiple virtual hosts listening on different ports, the $port paramter can + # optionaly be used to avoid duplicate resources. + # + # We will retain the default behaviour for filenames but allow the use of a sanitized version of $servername to be + # used, using the new $use_servername_for_filenames and $use_port_for_filenames parameters. + # + # This will default to false until the next major release (v7.0.0), at which point, we will default this to true and + # warn about it's imminent deprecation in the subsequent major release (v8.0.0) + # + # In v8.0.0, we will deprecate the $use_servername_for_filenames and $use_port_for_filenames parameters altogether + # and use the sanitized value of $servername for default log / config filenames. + $filename = $use_servername_for_filenames ? { + true => $use_port_for_filenames ? { + true => regsubst("${normalized_servername}-${port}", ' ', '_', 'G'), + false => regsubst($normalized_servername, ' ', '_', 'G'), + }, + false => $name, + } + + if ! $use_servername_for_filenames and $name != $normalized_servername { + $use_servername_for_filenames_warn_msg = ' + It is possible for the $name parameter to be defined with spaces in it. Although supported on POSIX systems, this + can lead to cumbersome file names. The $servername attribute has stricter conditions from Apache (i.e. no spaces) + When $use_servername_for_filenames = true, the $servername parameter, sanitized, is used to construct log and config + file names. + + From version v7.0.0 of the puppetlabs-apache module, this parameter will default to true. From version v8.0.0 of the + module, the $use_servername_for_filenames will be removed and log/config file names will be derived from the + sanitized $servername parameter when not explicitly defined.' + warning($use_servername_for_filenames_warn_msg) + } elsif ! $use_port_for_filenames { + $use_port_for_filenames_warn_msg = ' + It is possible for multiple virtual hosts to be configured using the same $servername but a different port. When + using $use_servername_for_filenames, this can lead to duplicate resource declarations. + When $use_port_for_filenames = true, the $servername and $port parameters, sanitized, are used to construct log and + config file names. + + From version v7.0.0 of the puppetlabs-apache module, this parameter will default to true. From version v8.0.0 of the + module, the $use_port_for_filenames will be removed and log/config file names will be derived from the + sanitized $servername parameter when not explicitly defined.' + warning($use_port_for_filenames_warn_msg) + } + + # This ensures that the docroot exists + # But enables it to be specified across multiple vhost resources + if $manage_docroot and $docroot and ! defined(File[$docroot]) { + file { $docroot: + ensure => directory, + owner => $docroot_owner, + group => $docroot_group, + mode => $docroot_mode, + require => Package['httpd'], + before => Concat["${priority_real}${filename}.conf"], + } + } + + # Same as above, but for logroot + if ! defined(File[$logroot]) { + file { $logroot: + ensure => $logroot_ensure, + owner => $logroot_owner, + group => $logroot_group, + mode => $logroot_mode, + require => Package['httpd'], + before => Concat["${priority_real}${filename}.conf"], + notify => Class['Apache::Service'], + } + } + + # Is apache::mod::shib enabled (or apache::mod['shib2']) + $shibboleth_enabled = defined(Apache::Mod['shib2']) + + # Is apache::mod::cas enabled (or apache::mod['cas']) + $cas_enabled = defined(Apache::Mod['auth_cas']) + + if $access_log and !$access_logs { + $_access_logs = [{ + 'file' => $access_log_file, + 'pipe' => $access_log_pipe, + 'syslog' => $access_log_syslog, + 'format' => $access_log_format, + 'env' => $access_log_env_var + }] + } elsif $access_logs { + $_access_logs = $access_logs + } + + if $error_log_file { + if $error_log_file =~ /^\// { + # Absolute path provided - don't prepend $logroot + $error_log_destination = $error_log_file + } else { + $error_log_destination = "${logroot}/${error_log_file}" + } + } elsif $error_log_pipe { + $error_log_destination = $error_log_pipe + } elsif $error_log_syslog { + $error_log_destination = $error_log_syslog + } else { + if $ssl { + $error_log_destination = "${logroot}/${filename}_error_ssl.log" + } else { + $error_log_destination = "${logroot}/${filename}_error.log" + } + } + + if versioncmp($apache_version, '2.4') >= 0 { + $error_log_format24 = $error_log_format + } + else { + $error_log_format24 = undef + } + + if $modsec_audit_log == false { + $modsec_audit_log_destination = undef + } elsif $modsec_audit_log_file { + $modsec_audit_log_destination = "${logroot}/${modsec_audit_log_file}" + } elsif $modsec_audit_log_pipe { + $modsec_audit_log_destination = $modsec_audit_log_pipe + } elsif $modsec_audit_log { + if $ssl { + $modsec_audit_log_destination = "${logroot}/${filename}_security_ssl.log" + } else { + $modsec_audit_log_destination = "${logroot}/${filename}_security.log" + } + } else { + $modsec_audit_log_destination = undef + } + + if $ip { + $_ip = any2array(enclose_ipv6($ip)) + if $port { + $_port = any2array($port) + $listen_addr_port = split(inline_template("<%= @_ip.product(@_port).map {|x| x.join(':') }.join(',')%>"), ',') + $nvh_addr_port = split(inline_template("<%= @_ip.product(@_port).map {|x| x.join(':') }.join(',')%>"), ',') + } else { + $listen_addr_port = undef + $nvh_addr_port = $_ip + if ! $servername and ! $ip_based { + fail("Apache::Vhost[${name}]: must pass 'ip' and/or 'port' parameters for name-based vhosts") + } + } + } else { + if $port { + $listen_addr_port = $port + $nvh_addr_port = prefix(any2array($port),"${vhost_name}:") + } else { + $listen_addr_port = undef + $nvh_addr_port = $name + if ! $servername and $servername != '' { + fail("Apache::Vhost[${name}]: must pass 'ip' and/or 'port' parameters, and/or 'servername' parameter") + } + } + } + + if $add_listen { + if $ip and defined(Apache::Listen[String($port)]) { + fail("Apache::Vhost[${name}]: Mixing IP and non-IP Listen directives is not possible; check the add_listen parameter of the apache::vhost define to disable this") + } + if $listen_addr_port and $ensure == 'present' { + ensure_resource('apache::listen', $listen_addr_port) + } + } + if ! $ip_based { + if $ensure == 'present' and (versioncmp($apache_version, '2.4') < 0) { + ensure_resource('apache::namevirtualhost', $nvh_addr_port) + } + } + + # Load mod_rewrite if needed and not yet loaded + if $rewrites or $rewrite_cond { + if ! defined(Class['apache::mod::rewrite']) { + include apache::mod::rewrite + } + } + + # Load mod_alias if needed and not yet loaded + if ($scriptalias or $scriptaliases != []) + or ($aliases and $aliases != []) + or ($redirect_source and $redirect_dest) + or ($redirectmatch_regexp or $redirectmatch_status or $redirectmatch_dest) { + if ! defined(Class['apache::mod::alias']) and ($ensure == 'present') { + include apache::mod::alias + } + } + + # Load mod_proxy if needed and not yet loaded + if ($proxy_dest or $proxy_pass or $proxy_pass_match or $proxy_dest_match) { + if ! defined(Class['apache::mod::proxy']) { + include apache::mod::proxy + } + if ! defined(Class['apache::mod::proxy_http']) { + include apache::mod::proxy_http + } + } + + # Load mod_fastcgi if needed and not yet loaded + if $fastcgi_server and $fastcgi_socket { + if ! defined(Class['apache::mod::fastcgi']) { + include apache::mod::fastcgi + } + } + + # Check if mod_headers is required to process $headers/$request_headers + if $headers or $request_headers { + if ! defined(Class['apache::mod::headers']) { + include apache::mod::headers + } + } + + # Check if mod_filter is required to process $filters + if $filters { + if ! defined(Class['apache::mod::filter']) { + include apache::mod::filter + } + } + + # Check if mod_env is required and not yet loaded. + # create an expression to simplify the conditional check + $use_env_mod = $setenv and ! empty($setenv) + if ($use_env_mod) { + if ! defined(Class['apache::mod::env']) { + include apache::mod::env + } + } + # Check if mod_setenvif is required and not yet loaded. + # create an expression to simplify the conditional check + $use_setenvif_mod = ($setenvif and ! empty($setenvif)) or ($setenvifnocase and ! empty($setenvifnocase)) + + if ($use_setenvif_mod) { + if ! defined(Class['apache::mod::setenvif']) { + include apache::mod::setenvif + } + } + + ## Create a default directory list if none defined + if $directories { + $_directories = $directories + } elsif $docroot { + $_directory = { + provider => 'directory', + path => $docroot, + options => $options, + allow_override => $override, + directoryindex => $directoryindex, + } + + if versioncmp($apache_version, '2.4') >= 0 { + $_directory_version = { + require => 'all granted', + } + } else { + $_directory_version = { + order => 'allow,deny', + allow => 'from all', + } + } + + $_directories = [merge($_directory, $_directory_version)] + } else { + $_directories = undef + } + + ## Create a global LocationMatch if locations aren't defined + if $modsec_disable_ids { + if $modsec_disable_ids =~ Array { + $_modsec_disable_ids = { '.*' => $modsec_disable_ids } + } else { + $_modsec_disable_ids = $modsec_disable_ids + } + } + + if $modsec_disable_msgs { + if $modsec_disable_msgs =~ Array { + $_modsec_disable_msgs = { '.*' => $modsec_disable_msgs } + } else { + $_modsec_disable_msgs = $modsec_disable_msgs + } + } + + if $modsec_disable_tags { + if $modsec_disable_tags =~ Array { + $_modsec_disable_tags = { '.*' => $modsec_disable_tags } + } else { + $_modsec_disable_tags = $modsec_disable_tags + } + } + + concat { "${priority_real}${filename}.conf": + ensure => $ensure, + path => "${apache::vhost_dir}/${priority_real}${filename}.conf", + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + order => 'numeric', + require => Package['httpd'], + notify => Class['apache::service'], + } + # NOTE(pabelanger): This code is duplicated in ::apache::vhost::custom and + # needs to be converted into something generic. + if $apache::vhost_enable_dir { + $vhost_enable_dir = $apache::vhost_enable_dir + $vhost_symlink_ensure = $ensure ? { + 'present' => link, + default => $ensure, + } + file { "${priority_real}${filename}.conf symlink": + ensure => $vhost_symlink_ensure, + path => "${vhost_enable_dir}/${priority_real}${filename}.conf", + target => "${apache::vhost_dir}/${priority_real}${filename}.conf", + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + require => Concat["${priority_real}${filename}.conf"], + notify => Class['apache::service'], + } + } + + # Template uses: + # - $comment + # - $nvh_addr_port + # - $servername + # - $serveradmin + # - $protocols + # - $protocols_honor_order + # - $apache_version + concat::fragment { "${name}-apache-header": + target => "${priority_real}${filename}.conf", + order => 0, + content => template('apache/vhost/_file_header.erb'), + } + + # Template uses: + # - $virtual_docroot + # - $virtual_use_default_docroot + # - $docroot + if $docroot { + concat::fragment { "${name}-docroot": + target => "${priority_real}${filename}.conf", + order => 10, + content => template('apache/vhost/_docroot.erb'), + } + } + + # Template uses: + # - $aliases + if $aliases and ! empty($aliases) { + concat::fragment { "${name}-aliases": + target => "${priority_real}${filename}.conf", + order => 20, + content => template('apache/vhost/_aliases.erb'), + } + } + + # Template uses: + # - $itk + # - $::kernelversion + if $itk and ! empty($itk) { + concat::fragment { "${name}-itk": + target => "${priority_real}${filename}.conf", + order => 30, + content => template('apache/vhost/_itk.erb'), + } + } + + # Template uses: + # - $fallbackresource + if $fallbackresource { + concat::fragment { "${name}-fallbackresource": + target => "${priority_real}${filename}.conf", + order => 40, + content => template('apache/vhost/_fallbackresource.erb'), + } + } + + # Template uses: + # - $allow_encoded_slashes + if $allow_encoded_slashes { + concat::fragment { "${name}-allow_encoded_slashes": + target => "${priority_real}${filename}.conf", + order => 50, + content => template('apache/vhost/_allow_encoded_slashes.erb'), + } + } + + # Template uses: + # - $_directories + # - $docroot + # - $apache_version + # - $suphp_engine + # - $shibboleth_enabled + if $_directories and ! empty($_directories) { + concat::fragment { "${name}-directories": + target => "${priority_real}${filename}.conf", + order => 60, + content => template('apache/vhost/_directories.erb'), + } + } + + # Template uses: + # - $additional_includes + if $additional_includes and ! empty($additional_includes) { + concat::fragment { "${name}-additional_includes": + target => "${priority_real}${filename}.conf", + order => 70, + content => template('apache/vhost/_additional_includes.erb'), + } + } + + # Template uses: + # - $error_log + # - $error_log_format24 + # - $log_level + # - $error_log_destination + # - $log_level + if $error_log or $log_level { + concat::fragment { "${name}-logging": + target => "${priority_real}${filename}.conf", + order => 80, + content => template('apache/vhost/_logging.erb'), + } + } + + # Template uses no variables + concat::fragment { "${name}-serversignature": + target => "${priority_real}${filename}.conf", + order => 90, + content => template('apache/vhost/_serversignature.erb'), + } + + # Template uses: + # - $access_log + # - $_access_log_env_var + # - $access_log_destination + # - $_access_log_format + # - $_access_log_env_var + # - $access_logs + if $access_log or $access_logs { + concat::fragment { "${name}-access_log": + target => "${priority_real}${filename}.conf", + order => 100, + content => template('apache/vhost/_access_log.erb'), + } + } + + # Template uses: + # - $action + if $action { + concat::fragment { "${name}-action": + target => "${priority_real}${filename}.conf", + order => 110, + content => template('apache/vhost/_action.erb'), + } + } + + # Template uses: + # - $block + # - $apache_version + if $block and ! empty($block) { + concat::fragment { "${name}-block": + target => "${priority_real}${filename}.conf", + order => 120, + content => template('apache/vhost/_block.erb'), + } + } + + # Template uses: + # - $error_documents + if $error_documents and ! empty($error_documents) { + concat::fragment { "${name}-error_document": + target => "${priority_real}${filename}.conf", + order => 130, + content => template('apache/vhost/_error_document.erb'), + } + } + + # Template uses: + # - $headers + if $headers and ! empty($headers) { + concat::fragment { "${name}-header": + target => "${priority_real}${filename}.conf", + order => 140, + content => template('apache/vhost/_header.erb'), + } + } + + # Template uses: + # - $request_headers + if $request_headers and ! empty($request_headers) { + concat::fragment { "${name}-requestheader": + target => "${priority_real}${filename}.conf", + order => 150, + content => template('apache/vhost/_requestheader.erb'), + } + } + + # Template uses: + # - $ssl_proxyengine + # - $ssl_proxy_verify + # - $ssl_proxy_verify_depth + # - $ssl_proxy_ca_cert + # - $ssl_proxy_check_peer_cn + # - $ssl_proxy_check_peer_name + # - $ssl_proxy_check_peer_expire + # - $ssl_proxy_machine_cert + # - $ssl_proxy_machine_cert_chain + # - $ssl_proxy_protocol + if $ssl_proxyengine { + concat::fragment { "${name}-sslproxy": + target => "${priority_real}${filename}.conf", + order => 160, + content => template('apache/vhost/_sslproxy.erb'), + } + } + + # Template uses: + # - $proxy_dest + # - $proxy_pass + # - $proxy_pass_match + # - $proxy_preserve_host + # - $proxy_add_headers + # - $no_proxy_uris + if $proxy_dest or $proxy_pass or $proxy_pass_match or $proxy_dest_match or $proxy_preserve_host { + concat::fragment { "${name}-proxy": + target => "${priority_real}${filename}.conf", + order => 170, + content => template('apache/vhost/_proxy.erb'), + } + } + + # Template uses: + # - $redirect_source + # - $redirect_dest + # - $redirect_status + # - $redirect_dest_a + # - $redirect_source_a + # - $redirect_status_a + # - $redirectmatch_status + # - $redirectmatch_regexp + # - $redirectmatch_dest + # - $redirectmatch_status_a + # - $redirectmatch_regexp_a + # - $redirectmatch_dest + if ($redirect_source and $redirect_dest) or ($redirectmatch_regexp and $redirectmatch_dest) { + concat::fragment { "${name}-redirect": + target => "${priority_real}${filename}.conf", + order => 180, + content => template('apache/vhost/_redirect.erb'), + } + } + + # Template uses: + # - $rewrites + # - $rewrite_base + # - $rewrite_rule + # - $rewrite_cond + # - $rewrite_map + if $rewrites or $rewrite_rule { + concat::fragment { "${name}-rewrite": + target => "${priority_real}${filename}.conf", + order => 190, + content => template('apache/vhost/_rewrite.erb'), + } + } + + # Template uses: + # - $scriptaliases + # - $scriptalias + if ( $scriptalias or $scriptaliases != []) { + concat::fragment { "${name}-scriptalias": + target => "${priority_real}${filename}.conf", + order => 200, + content => template('apache/vhost/_scriptalias.erb'), + } + } + + # Template uses: + # - $serveraliases + if $serveraliases and ! empty($serveraliases) { + concat::fragment { "${name}-serveralias": + target => "${priority_real}${filename}.conf", + order => 210, + content => template('apache/vhost/_serveralias.erb'), + } + } + + # Template uses: + # - $setenv + # - $setenvif + if ($use_env_mod or $use_setenvif_mod) { + concat::fragment { "${name}-setenv": + target => "${priority_real}${filename}.conf", + order => 220, + content => template('apache/vhost/_setenv.erb'), + } + } + + # Template uses: + # - $ssl + # - $ssl_cert + # - $ssl_key + # - $ssl_chain + # - $ssl_certs_dir + # - $ssl_ca + # - $ssl_crl_path + # - $ssl_crl + # - $ssl_crl_check + # - $ssl_protocol + # - $ssl_cipher + # - $_ssl_honorcipherorder + # - $ssl_verify_client + # - $ssl_verify_depth + # - $ssl_options + # - $ssl_openssl_conf_cmd + # - $ssl_stapling + # - $apache_version + if $ssl and $ensure == 'present' { + concat::fragment { "${name}-ssl": + target => "${priority_real}${filename}.conf", + order => 230, + content => template('apache/vhost/_ssl.erb'), + } + + if $ssl_reload_on_change { + [$ssl_cert, $ssl_key, $ssl_ca, $ssl_chain, $ssl_crl].each |$ssl_file| { + if $ssl_file { + include apache::mod::ssl::reload + $_ssl_file_copy = regsubst($ssl_file, '/', '_', 'G') + file { "${filename}${_ssl_file_copy}": + path => "${apache::params::puppet_ssl_dir}/${filename}${_ssl_file_copy}", + source => "file://${ssl_file}", + owner => 'root', + group => $apache::params::root_group, + mode => '0640', + seltype => 'cert_t', + notify => Class['apache::service'], + } + } + } + } + } + + # Template uses: + # - $auth_kerb + # - $krb_method_negotiate + # - $krb_method_k5passwd + # - $krb_authoritative + # - $krb_auth_realms + # - $krb_5keytab + # - $krb_local_user_mapping + if $auth_kerb { + concat::fragment { "${name}-auth_kerb": + target => "${priority_real}${filename}.conf", + order => 230, + content => template('apache/vhost/_auth_kerb.erb'), + } + } + + # Template uses: + # - $suphp_engine + # - $suphp_addhandler + # - $suphp_configpath + if $suphp_engine == 'on' { + concat::fragment { "${name}-suphp": + target => "${priority_real}${filename}.conf", + order => 240, + content => template('apache/vhost/_suphp.erb'), + } + } + + # Template uses: + # - $php_values + # - $php_flags + if ($php_values and ! empty($php_values)) or ($php_flags and ! empty($php_flags)) { + concat::fragment { "${name}-php": + target => "${priority_real}${filename}.conf", + order => 240, + content => template('apache/vhost/_php.erb'), + } + } + + # Template uses: + # - $php_admin_values + # - $php_admin_flags + if ($php_admin_values and ! empty($php_admin_values)) or ($php_admin_flags and ! empty($php_admin_flags)) { + concat::fragment { "${name}-php_admin": + target => "${priority_real}${filename}.conf", + order => 250, + content => template('apache/vhost/_php_admin.erb'), + } + } + + # Template uses: + # - $wsgi_application_group + # - $wsgi_daemon_process + # - $wsgi_daemon_process_options + # - $wsgi_import_script + # - $wsgi_import_script_options + # - $wsgi_process_group + # - $wsgi_script_aliases + # - $wsgi_pass_authorization + if $wsgi_daemon_process_options { + deprecation('apache::vhost::wsgi_daemon_process_options', 'This parameter is deprecated. Please add values inside Hash `wsgi_daemon_process`.') + } + if $wsgi_application_group or $wsgi_daemon_process or ($wsgi_import_script and $wsgi_import_script_options) or $wsgi_process_group or ($wsgi_script_aliases and ! empty($wsgi_script_aliases)) or $wsgi_pass_authorization { + concat::fragment { "${name}-wsgi": + target => "${priority_real}${filename}.conf", + order => 260, + content => template('apache/vhost/_wsgi.erb'), + } + } + + # Template uses: + # - $custom_fragment + if $custom_fragment { + concat::fragment { "${name}-custom_fragment": + target => "${priority_real}${filename}.conf", + order => 270, + content => template('apache/vhost/_custom_fragment.erb'), + } + } + + # Template uses: + # - $fastcgi_server + # - $fastcgi_socket + # - $fastcgi_dir + # - $fastcgi_idle_timeout + # - $apache_version + if $fastcgi_server or $fastcgi_dir { + concat::fragment { "${name}-fastcgi": + target => "${priority_real}${filename}.conf", + order => 280, + content => template('apache/vhost/_fastcgi.erb'), + } + } + + # Template uses: + # - $suexec_user_group + if $suexec_user_group { + concat::fragment { "${name}-suexec": + target => "${priority_real}${filename}.conf", + order => 290, + content => template('apache/vhost/_suexec.erb'), + } + } + + if $h2_copy_files != undef or $h2_direct != undef or $h2_early_hints != undef or $h2_max_session_streams != undef or $h2_modern_tls_only != undef or $h2_push != undef or $h2_push_diary_size != undef or $h2_push_priority != [] or $h2_push_resource != [] or $h2_serialize_headers != undef or $h2_stream_max_mem_size != undef or $h2_tls_cool_down_secs != undef or $h2_tls_warm_up_size != undef or $h2_upgrade != undef or $h2_window_size != undef { + include apache::mod::http2 + + concat::fragment { "${name}-http2": + target => "${priority_real}${filename}.conf", + order => 300, + content => template('apache/vhost/_http2.erb'), + } + } + + if $mdomain { + include apache::mod::md + } + + # Template uses: + # - $passenger_enabled + # - $passenger_start_timeout + # - $passenger_ruby + # - $passenger_python + # - $passenger_nodejs + # - $passenger_meteor_app_settings + # - $passenger_app_env + # - $passenger_app_root + # - $passenger_app_group_name + # - $passenger_app_start_command + # - $passenger_app_type + # - $passenger_startup_file + # - $passenger_restart_dir + # - $passenger_spawn_method + # - $passenger_load_shell_envvars + # - $passenger_rolling_restarts + # - $passenger_resist_deployment_errors + # - $passenger_min_instances + # - $passenger_max_instances + # - $passenger_max_preloader_idle_time + # - $passenger_force_max_concurrent_requests_per_process + # - $passenger_concurrency_model + # - $passenger_thread_count + # - $passenger_high_performance + # - $passenger_max_request_queue_size + # - $passenger_max_request_queue_time + # - $passenger_user + # - $passenger_group + # - $passenger_friendly_error_pages + # - $passenger_buffer_upload + # - $passenger_buffer_response + # - $passenger_allow_encoded_slashes + # - $passenger_lve_min_uid + # - $passenger_base_uri + # - $passenger_error_override + # - $passenger_sticky_sessions + # - $passenger_sticky_sessions_cookie_name + # - $passenger_sticky_sessions_cookie_attributes + # - $passenger_app_log_file + # - $passenger_debugger + # - $passenger_max_requests + # - $passenger_max_request_time + # - $passenger_memory_limit + if $passenger_enabled != undef or $passenger_start_timeout != undef or $passenger_ruby != undef or $passenger_python != undef or $passenger_nodejs != undef or $passenger_meteor_app_settings != undef or $passenger_app_env != undef or $passenger_app_root != undef or $passenger_app_group_name != undef or $passenger_app_start_command != undef or $passenger_app_type != undef or $passenger_startup_file != undef or $passenger_restart_dir != undef or $passenger_spawn_method != undef or $passenger_load_shell_envvars != undef or $passenger_rolling_restarts != undef or $passenger_resist_deployment_errors != undef or $passenger_min_instances != undef or $passenger_max_instances != undef or $passenger_max_preloader_idle_time != undef or $passenger_force_max_concurrent_requests_per_process != undef or $passenger_concurrency_model != undef or $passenger_thread_count != undef or $passenger_high_performance != undef or $passenger_max_request_queue_size != undef or $passenger_max_request_queue_time != undef or $passenger_user != undef or $passenger_group != undef or $passenger_friendly_error_pages != undef or $passenger_buffer_upload != undef or $passenger_buffer_response != undef or $passenger_allow_encoded_slashes != undef or $passenger_lve_min_uid != undef or $passenger_base_uri != undef or $passenger_error_override != undef or $passenger_sticky_sessions != undef or $passenger_sticky_sessions_cookie_name != undef or $passenger_sticky_sessions_cookie_attributes != undef or $passenger_app_log_file != undef or $passenger_debugger != undef or $passenger_max_requests != undef or $passenger_max_request_time != undef or $passenger_memory_limit != undef { + concat::fragment { "${name}-passenger": + target => "${priority_real}${filename}.conf", + order => 300, + content => template('apache/vhost/_passenger.erb'), + } + } + + # Template uses: + # - $add_default_charset + if $add_default_charset { + concat::fragment { "${name}-charsets": + target => "${priority_real}${filename}.conf", + order => 310, + content => template('apache/vhost/_charsets.erb'), + } + } + + # Template uses: + # - $modsec_disable_vhost + # - $modsec_disable_ids + # - $modsec_disable_ips + # - $modsec_disable_msgs + # - $modsec_disable_tags + # - $modsec_body_limit + # - $modsec_audit_log_destination + if $modsec_disable_vhost or $modsec_disable_ids or $modsec_disable_ips or $modsec_disable_msgs or $modsec_disable_tags or $modsec_audit_log_destination { + concat::fragment { "${name}-security": + target => "${priority_real}${filename}.conf", + order => 320, + content => template('apache/vhost/_security.erb'), + } + } + + # Template uses: + # - $filters + if $filters and ! empty($filters) { + concat::fragment { "${name}-filters": + target => "${priority_real}${filename}.conf", + order => 330, + content => template('apache/vhost/_filters.erb'), + } + } + + # Template uses: + # - $jk_mounts + if $jk_mounts and ! empty($jk_mounts) { + concat::fragment { "${name}-jk_mounts": + target => "${priority_real}${filename}.conf", + order => 340, + content => template('apache/vhost/_jk_mounts.erb'), + } + } + + # Template uses: + # - $keepalive + # - $keepalive_timeout + # - $max_keepalive_requests + if $keepalive or $keepalive_timeout or $max_keepalive_requests { + concat::fragment { "${name}-keepalive_options": + target => "${priority_real}${filename}.conf", + order => 350, + content => template('apache/vhost/_keepalive_options.erb'), + } + } + + # Template uses: + # - $cas_* + if $cas_enabled { + concat::fragment { "${name}-auth_cas": + target => "${priority_real}${filename}.conf", + order => 350, + content => template('apache/vhost/_auth_cas.erb'), + } + } + + # Template uses: + # - $http_protocol_options + if $http_protocol_options { + concat::fragment { "${name}-http_protocol_options": + target => "${priority_real}${filename}.conf", + order => 350, + content => template('apache/vhost/_http_protocol_options.erb'), + } + } + + # Template uses: + # - $auth_oidc + # - $oidc_settings + if $auth_oidc { + concat::fragment { "${name}-auth_oidc": + target => "${priority_real}${filename}.conf", + order => 360, + content => template('apache/vhost/_auth_oidc.erb'), + } + } + + # Template uses: + # - $shib_compat_valid_user + if $shibboleth_enabled { + concat::fragment { "${name}-shibboleth": + target => "${priority_real}${filename}.conf", + order => 370, + content => template('apache/vhost/_shib.erb'), + } + } + + # - $use_canonical_name + if $use_canonical_name { + concat::fragment { "${name}-use_canonical_name": + target => "${priority_real}${filename}.conf", + order => 360, + content => template('apache/vhost/_use_canonical_name.erb'), + } + } + + # Template uses no variables + concat::fragment { "${name}-file_footer": + target => "${priority_real}${filename}.conf", + order => 999, + content => template('apache/vhost/_file_footer.erb'), + } +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/vhost/custom.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/vhost/custom.pp new file mode 100644 index 000000000..56e8b1258 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/vhost/custom.pp @@ -0,0 +1,56 @@ +# @summary +# A wrapper around the `apache::custom_config` defined type. +# +# The `apache::vhost::custom` defined type is a thin wrapper around the `apache::custom_config` defined type, and simply overrides some of its default settings specific to the virtual host directory in Apache. +# +# @param content +# Sets the configuration file's content. +# +# @param ensure +# Specifies if the virtual host file is present or absent. +# +# @param priority +# Sets the relative load order for Apache HTTPD VirtualHost configuration files. +# +# @param verify_config +# Specifies whether to validate the configuration file before notifying the Apache service. +# +define apache::vhost::custom ( + $content, + $ensure = 'present', + $priority = '25', + $verify_config = true, +) { + include apache + + ## Apache include does not always work with spaces in the filename + $filename = regsubst($name, ' ', '_', 'G') + + ::apache::custom_config { $filename: + ensure => $ensure, + confdir => $apache::vhost_dir, + content => $content, + priority => $priority, + verify_config => $verify_config, + } + + # NOTE(pabelanger): This code is duplicated in ::apache::vhost and needs to + # converted into something generic. + if $apache::vhost_enable_dir { + $vhost_symlink_ensure = $ensure ? { + 'present' => link, + default => $ensure, + } + + file { "${priority}-${filename}.conf symlink": + ensure => $vhost_symlink_ensure, + path => "${apache::vhost_enable_dir}/${priority}-${filename}.conf", + target => "${apache::vhost_dir}/${priority}-${filename}.conf", + owner => 'root', + group => $apache::params::root_group, + mode => $apache::file_mode, + require => Apache::Custom_config[$filename], + notify => Class['apache::service'], + } + } +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/manifests/vhost/fragment.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/vhost/fragment.pp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/manifests/vhost/fragment.pp rename to modules/services/unix/http/apache_kali_compatible/apache/manifests/vhost/fragment.pp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/manifests/vhosts.pp b/modules/services/unix/http/apache_kali_compatible/apache/manifests/vhosts.pp new file mode 100644 index 000000000..6d0fcf27f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/manifests/vhosts.pp @@ -0,0 +1,26 @@ +# @summary +# Creates `apache::vhost` defined types. +# +# @note See the `apache::vhost` defined type's reference for a list of all virtual +# host parameters or Configuring virtual hosts in the README section. +# +# @example To create a [name-based virtual host](https://httpd.apache.org/docs/current/vhosts/name-based.html) `custom_vhost_1` +# class { 'apache::vhosts': +# vhosts => { +# 'custom_vhost_1' => { +# 'docroot' => '/var/www/custom_vhost_1', +# 'port' => '81', +# }, +# }, +# } +# +# @param vhosts +# A hash, where the key represents the name and the value represents a hash of +# `apache::vhost` defined type's parameters. +# +class apache::vhosts ( + $vhosts = {}, +) { + include apache + create_resources('apache::vhost', $vhosts) +} diff --git a/modules/services/unix/http/apache_kali_compatible/apache/metadata.json b/modules/services/unix/http/apache_kali_compatible/apache/metadata.json new file mode 100644 index 000000000..29255598e --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/metadata.json @@ -0,0 +1,91 @@ +{ + "name": "puppetlabs-apache", + "version": "7.0.0", + "author": "puppetlabs", + "summary": "Installs, configures, and manages Apache virtual hosts, web services, and modules.", + "license": "Apache-2.0", + "source": "https://github.com/puppetlabs/puppetlabs-apache", + "project_page": "https://github.com/puppetlabs/puppetlabs-apache", + "issues_url": "https://tickets.puppetlabs.com/browse/MODULES", + "dependencies": [ + { + "name": "puppetlabs/stdlib", + "version_requirement": ">= 4.13.1 < 9.0.0" + }, + { + "name": "puppetlabs/concat", + "version_requirement": ">= 2.2.1 < 8.0.0" + } + ], + "operatingsystem_support": [ + { + "operatingsystem": "RedHat", + "operatingsystemrelease": [ + "6", + "7", + "8" + ] + }, + { + "operatingsystem": "CentOS", + "operatingsystemrelease": [ + "6", + "7", + "8" + ] + }, + { + "operatingsystem": "OracleLinux", + "operatingsystemrelease": [ + "6", + "7" + ] + }, + { + "operatingsystem": "Scientific", + "operatingsystemrelease": [ + "6", + "7" + ] + }, + { + "operatingsystem": "Debian", + "operatingsystemrelease": [ + "9", + "10", + "11" + ] + }, + { + "operatingsystem": "SLES", + "operatingsystemrelease": [ + "12", + "15" + ] + }, + { + "operatingsystem": "Ubuntu", + "operatingsystemrelease": [ + "16.04", + "18.04", + "20.04" + ] + }, + { + "operatingsystem": "Rocky", + "operatingsystemrelease": [ + "8" + ] + } + ], + "requirements": [ + { + "name": "puppet", + "version_requirement": ">= 6.0.0 < 8.0.0" + } + ], + "description": "Module for Apache configuration", + "pdk-version": "2.1.0", + "template-url": "https://github.com/puppetlabs/pdk-templates.git#main", + "template-ref": "heads/main-0-g03daa92" +} diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/pdk.yaml b/modules/services/unix/http/apache_kali_compatible/apache/pdk.yaml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/pdk.yaml rename to modules/services/unix/http/apache_kali_compatible/apache/pdk.yaml diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/provision.yaml b/modules/services/unix/http/apache_kali_compatible/apache/provision.yaml similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/provision.yaml rename to modules/services/unix/http/apache_kali_compatible/apache/provision.yaml diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/readmes/README_ja_JP.md b/modules/services/unix/http/apache_kali_compatible/apache/readmes/README_ja_JP.md similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/readmes/README_ja_JP.md rename to modules/services/unix/http/apache_kali_compatible/apache/readmes/README_ja_JP.md diff --git a/modules/services/unix/http/apache_kali_compatible/apache/secgen_metadata.xml b/modules/services/unix/http/apache_kali_compatible/apache/secgen_metadata.xml new file mode 100644 index 000000000..50049ab44 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/secgen_metadata.xml @@ -0,0 +1,38 @@ + + + + Apache HTTP Server - Stretch/Kali Compatible + Z. Cliffe Schreuders + Connor Wilson + Puppet Labs + Apache v2 + An installation of Apache + + httpd + linux + + + https://httpd.apache.org/ + https://forge.puppet.com/puppetlabs/apache + apache + Apache v2 + + + + apache + + + .*Stretch.* + + + .*Buster.* + + + .*Wheezy.* + + + update + + diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/tasks/init.json b/modules/services/unix/http/apache_kali_compatible/apache/tasks/init.json similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/tasks/init.json rename to modules/services/unix/http/apache_kali_compatible/apache/tasks/init.json diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/tasks/init.rb b/modules/services/unix/http/apache_kali_compatible/apache/tasks/init.rb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/tasks/init.rb rename to modules/services/unix/http/apache_kali_compatible/apache/tasks/init.rb diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/confd/no-accf.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/confd/no-accf.conf.erb new file mode 100644 index 000000000..10e51644c --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/confd/no-accf.conf.erb @@ -0,0 +1,4 @@ + + AcceptFilter http none + AcceptFilter https none + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/fastcgi/server.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/fastcgi/server.erb new file mode 100644 index 000000000..bae56d48e --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/fastcgi/server.erb @@ -0,0 +1,22 @@ +<% + timeout = " -idle-timeout #{@timeout}" + flush = "" + if @flush + flush = " -flush" + end + if @socket + host_or_socket = " -socket #{@socket}" + else + host_or_socket = " -host #{@host}" + end + + pass_header = "" + if @pass_header and ! @pass_header.empty? + pass_header = " -pass-header #{@pass_header}" + end + + options = timeout + flush + host_or_socket + pass_header +-%> +FastCGIExternalServer <%= @faux_path %><%= options %> +Alias <%= @fcgi_alias %> <%= @faux_path %> +Action <%= @file_type %> <%= @fcgi_alias %> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/httpd.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/httpd.conf.erb new file mode 100755 index 000000000..b19d8da81 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/httpd.conf.erb @@ -0,0 +1,180 @@ +# Security +ServerTokens <%= @server_tokens %> +ServerSignature <%= scope.call_function('apache::bool2httpd', [@server_signature]) %> +TraceEnable <%= scope.call_function('apache::bool2httpd', [@trace_enable]) %> + +ServerName "<%= @servername %>" +ServerRoot "<%= @server_root %>" +PidFile <%= @pidfile %> +Timeout <%= @timeout %> +KeepAlive <%= @keepalive %> +MaxKeepAliveRequests <%= @max_keepalive_requests %> +KeepAliveTimeout <%= @keepalive_timeout %> +LimitRequestFieldSize <%= @limitreqfieldsize %> +LimitRequestFields <%= @limitreqfields %> +<%# Actually >= 2.4.24, but the minor version is not provided -%> +<%- if @http_protocol_options and scope.function_versioncmp([@apache_version, '2.4']) >= 0 -%> +HttpProtocolOptions <%= @http_protocol_options %> +<%- end -%> + +<%# Actually >= 2.4.17, but the minor version is not provided -%> +<%- if scope.function_versioncmp([@apache_version, '2.4']) >= 0 -%> + <%- unless @protocols.empty? -%> +Protocols <%= @protocols.join(' ') %> + <%- end -%> + <%- unless @protocols_honor_order.nil? -%> +ProtocolsHonorOrder <%= scope.call_function('apache::bool2httpd', [@protocols_honor_order]) %> + <%- end -%> +<%- end -%> + +<%- if @rewrite_lock and scope.function_versioncmp([@apache_version, '2.2']) <= 0 -%> +RewriteLock <%= @rewrite_lock %> +<%- end -%> + +User <%= @user %> +Group <%= @group %> + +AccessFileName .htaccess + +<%- if scope.function_versioncmp([@apache_version, '2.4']) >= 0 -%> + Require all denied +<%- else -%> + Order allow,deny + Deny from all + Satisfy all +<%- end -%> + + + + Options <%= Array(@root_directory_options).join(' ') %> + AllowOverride None +<%- if @root_directory_secured -%> +<%- if scope.function_versioncmp([@apache_version, '2.4']) >= 0 -%> + Require all denied +<%- else -%> + Order deny,allow + Deny from all +<%- end -%> +<%- end -%> + + +<% if @default_charset -%> +AddDefaultCharset <%= @default_charset %> +<% end -%> + +<%- if scope.function_versioncmp([@apache_version, '2.4']) < 0 -%> +DefaultType <%= @default_type %> +<%- end -%> +HostnameLookups <%= @hostname_lookups %> +<%- if /^[|\/]/.match(@error_log) || /^syslog:/.match(@error_log) -%> +ErrorLog "<%= @error_log %>" +<%- else -%> +ErrorLog "<%= @logroot %>/<%= @error_log %>" +<%- end -%> +LogLevel <%= @log_level %> +EnableSendfile <%= @sendfile %> +<%- if @allow_encoded_slashes -%> +AllowEncodedSlashes <%= @allow_encoded_slashes %> +<%- end -%> +<%- if @file_e_tag -%> +FileETag <%= @file_e_tag %> +<%- end -%> +<%- if @use_canonical_name -%> +UseCanonicalName <%= @use_canonical_name %> +<%- end -%> + +#Listen 80 + +<% if @apxs_workaround -%> +# Workaround: without this hack apxs would be confused about where to put +# LoadModule directives and fail entire procedure of apache package +# installation/reinstallation. This problem was observed on FreeBSD (apache22). +#LoadModule fake_module libexec/apache22/mod_fake.so +<% end -%> + +Include "<%= @mod_load_dir %>/*.load" +<% if @mod_load_dir != @confd_dir and @mod_load_dir != @vhost_load_dir -%> +Include "<%= @mod_load_dir %>/*.conf" +<% end -%> +Include "<%= @ports_file %>" + +<% unless @log_formats.has_key?('combined') -%> +LogFormat "%a %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined +<% end -%> +<% unless @log_formats.has_key?('common') -%> +LogFormat "%a %l %u %t \"%r\" %>s %b" common +<% end -%> +<% unless @log_formats.has_key?('referer') -%> +LogFormat "%{Referer}i -> %U" referer +<% end -%> +<% unless @log_formats.has_key?('agent') -%> +LogFormat "%{User-agent}i" agent +<% end -%> +<% unless @log_formats.has_key?('forwarded') -%> +LogFormat "%{X-Forwarded-For}i %l %u %t \"%r\" %s %b \"%{Referer}i\" \"%{User-agent}i\"" forwarded +<% end -%> +<% if @log_formats and !@log_formats.empty? -%> + <%- @log_formats.sort.each do |nickname,format| -%> +LogFormat "<%= format -%>" <%= nickname %> + <%- end -%> +<% end -%> + +<%- if @conf_enabled and scope.function_versioncmp([@apache_version, '2.4']) >= 0 -%> +IncludeOptional "<%= @conf_enabled %>/*.conf" +<%- end -%> +<%- if scope.function_versioncmp([@apache_version, '2.4']) >= 0 -%> +IncludeOptional "<%= @confd_dir %>/*.conf" +<%- else -%> +Include "<%= @confd_dir %>/*.conf" +<%- end -%> +<% if @vhost_load_dir != @confd_dir -%> +<%- if scope.function_versioncmp([@apache_version, '2.4']) >= 0 -%> +IncludeOptional "<%= @vhost_load_dir %>/<%= @vhost_include_pattern %>" +<%- else -%> +Include "<%= @vhost_load_dir %>/<%= @vhost_include_pattern %>" +<%- end -%> +<% end -%> +<% if @ldap_verify_server_cert -%> +LDAPVerifyServerCert <%= @ldap_verify_server_cert %> +<% end -%> +<% if @ldap_trusted_mode -%> +LDAPTrustedMode <%= @ldap_trusted_mode %> +<% end -%> + +<% if @error_documents -%> +# /usr/share/apache2/error on debian +Alias /error/ "<%= @error_documents_path %>/" + +"> + AllowOverride None + Options IncludesNoExec + AddOutputFilter Includes html + AddHandler type-map var +<%- if scope.function_versioncmp([@apache_version, '2.4']) >= 0 -%> + Require all granted +<%- else -%> + Order allow,deny + Allow from all +<%- end -%> + LanguagePriority en cs de es fr it nl sv pt-br ro + ForceLanguagePriority Prefer Fallback + + +ErrorDocument 400 /error/HTTP_BAD_REQUEST.html.var +ErrorDocument 401 /error/HTTP_UNAUTHORIZED.html.var +ErrorDocument 403 /error/HTTP_FORBIDDEN.html.var +ErrorDocument 404 /error/HTTP_NOT_FOUND.html.var +ErrorDocument 405 /error/HTTP_METHOD_NOT_ALLOWED.html.var +ErrorDocument 408 /error/HTTP_REQUEST_TIME_OUT.html.var +ErrorDocument 410 /error/HTTP_GONE.html.var +ErrorDocument 411 /error/HTTP_LENGTH_REQUIRED.html.var +ErrorDocument 412 /error/HTTP_PRECONDITION_FAILED.html.var +ErrorDocument 413 /error/HTTP_REQUEST_ENTITY_TOO_LARGE.html.var +ErrorDocument 414 /error/HTTP_REQUEST_URI_TOO_LARGE.html.var +ErrorDocument 415 /error/HTTP_UNSUPPORTED_MEDIA_TYPE.html.var +ErrorDocument 500 /error/HTTP_INTERNAL_SERVER_ERROR.html.var +ErrorDocument 501 /error/HTTP_NOT_IMPLEMENTED.html.var +ErrorDocument 502 /error/HTTP_BAD_GATEWAY.html.var +ErrorDocument 503 /error/HTTP_SERVICE_UNAVAILABLE.html.var +ErrorDocument 506 /error/HTTP_VARIANT_ALSO_VARIES.html.var +<% end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/listen.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/listen.erb new file mode 100644 index 000000000..8fc871b0a --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/listen.erb @@ -0,0 +1,6 @@ +<%# Listen should always be one of: + - + - : + - [ +-%> +Listen <%= @listen_addr_port %> diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/_allow.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/_allow.erb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/_allow.erb rename to modules/services/unix/http/apache_kali_compatible/apache/templates/mod/_allow.erb diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/_require.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/_require.erb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/_require.erb rename to modules/services/unix/http/apache_kali_compatible/apache/templates/mod/_require.erb diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/alias.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/alias.conf.erb new file mode 100644 index 000000000..313fdf9d1 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/alias.conf.erb @@ -0,0 +1,13 @@ + +Alias /<%= @icons_prefix %>/ "<%= @icons_path %>/" +"> + Options <%= @icons_options %> + AllowOverride None +<%- if scope.function_versioncmp([@_apache_version, '2.4']) >= 0 -%> + Require all granted +<%- else -%> + Order allow,deny + Allow from all +<%- end -%> + + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/auth_cas.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/auth_cas.conf.erb new file mode 100644 index 000000000..b59c5357f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/auth_cas.conf.erb @@ -0,0 +1,58 @@ +CASCookiePath <%= @cas_cookie_path %> +CASLoginURL <%= @cas_login_url %> +CASValidateURL <%= @cas_validate_url %> + +CASVersion <%= @cas_version %> +CASDebug <%= @cas_debug %> + +<% if @cas_certificate_path -%> +CASCertificatePath <%= @cas_certificate_path %> +<% end -%> +<% if @cas_proxy_validate_url -%> +CASProxyValidateURL <%= @cas_proxy_validate_url %> +<% end -%> +<% if @cas_validate_server -%> +CASValidateServer <%= @cas_validate_server %> +<% end -%> +<% if @cas_validate_depth -%> +CASValidateDepth <%= @cas_validate_depth %> +<% end -%> +<% if @cas_root_proxied_as -%> +CASRootProxiedAs <%= @cas_root_proxied_as %> +<% end -%> +<% if @cas_cookie_entropy -%> +CASCookieEntropy <%= @cas_cookie_entropy %> +<% end -%> +<% if @cas_timeout -%> +CASTimeout <%= @cas_timeout %> +<% end -%> +<% if @cas_idle_timeout -%> +CASIdleTimeout <%= @cas_idle_timeout %> +<% end -%> +<% if @cas_cache_clean_interval -%> +CASCacheCleanInterval <%= @cas_cache_clean_interval %> +<% end -%> +<% if @cas_cookie_domain -%> +CASCookieDomain <%= @cas_cookie_domain %> +<% end -%> +<% if @cas_cookie_http_only -%> +CASCookieHttpOnly <%= @cas_cookie_http_only %> +<% end -%> +<% if @cas_authoritative -%> +CASAuthoritative <%= @cas_authoritative %> +<% end -%> +<%- if @cas_sso_enabled -%> +CASSSOEnabled On +<%- end -%> +<%- if @cas_validate_saml -%> +CASValidateSAML On +<%- end -%> +<%- if @cas_attribute_prefix -%> +CASAttributePrefix <%= @cas_attribute_prefix %> +<%- end -%> +<%- if @cas_attribute_delimiter -%> +CASAttributeDelimiter <%= @cas_attribute_delimiter %> +<%- end -%> +<%- if @cas_scrub_request_headers -%> +CASAttributeDelimiter On +<%- end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/auth_mellon.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/auth_mellon.conf.erb new file mode 100644 index 000000000..e36a73390 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/auth_mellon.conf.erb @@ -0,0 +1,21 @@ +<%- if @mellon_cache_size -%> +MellonCacheSize <%= @mellon_cache_size %> +<%- end -%> +<%- if @mellon_cache_entry_size -%> +MellonCacheEntrySize <%= @mellon_cache_entry_size %> +<%- end -%> +<%- if @mellon_lock_file -%> +MellonLockFile "<%= @mellon_lock_file %>" +<%- end -%> +<%- if @mellon_post_directory -%> +MellonPostDirectory "<%= @mellon_post_directory %>" +<%- end -%> +<%- if @mellon_post_ttl -%> +MellonPostTTL <%= @mellon_post_ttl %> +<%- end -%> +<%- if @mellon_post_size -%> +MellonPostSize <%= @mellon_post_size %> +<%- end -%> +<%- if @mellon_post_count -%> +MellonPostCount <%= @mellon_post_count %> +<%- end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/authn_dbd.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/authn_dbd.conf.erb new file mode 100644 index 000000000..e04fb3ec4 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/authn_dbd.conf.erb @@ -0,0 +1,17 @@ +#Database Management +DBDriver <%= @authn_dbd_dbdriver %> + +#Connection string: database name and login credentials +DBDParams "<%= @authn_dbd_params %>" + +#Parameters for Connection Pool Management +DBDMin <%= @authn_dbd_min %> +DBDMax <%= @authn_dbd_max %> +DBDKeep <%= @authn_dbd_keep %> +DBDExptime <%= @authn_dbd_exptime %> + +<%- if @authn_dbd_alias -%> +> + AuthDBDUserPWQuery "<%= @authn_dbd_query %>" + +<%- end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/authnz_ldap.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/authnz_ldap.conf.erb new file mode 100644 index 000000000..ed1334ec2 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/authnz_ldap.conf.erb @@ -0,0 +1,5 @@ +<% if @verify_server_cert == true -%> +LDAPVerifyServerCert On +<% else -%> +LDAPVerifyServerCert Off +<% end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/autoindex.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/autoindex.conf.erb new file mode 100644 index 000000000..e097f9c9b --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/autoindex.conf.erb @@ -0,0 +1,56 @@ +IndexOptions FancyIndexing VersionSort HTMLTable NameWidth=* DescriptionWidth=* Charset=UTF-8 +AddIconByEncoding (CMP,/<%= @icons_prefix %>/compressed.gif) x-compress x-gzip x-bzip2 + +AddIconByType (TXT,/<%= @icons_prefix %>/text.gif) text/* +AddIconByType (IMG,/<%= @icons_prefix %>/image2.gif) image/* +AddIconByType (SND,/<%= @icons_prefix %>/sound2.gif) audio/* +AddIconByType (VID,/<%= @icons_prefix %>/movie.gif) video/* + +AddIcon /<%= @icons_prefix %>/binary.gif .bin .exe +AddIcon /<%= @icons_prefix %>/binhex.gif .hqx +AddIcon /<%= @icons_prefix %>/tar.gif .tar +AddIcon /<%= @icons_prefix %>/world2.gif .wrl .wrl.gz .vrml .vrm .iv +AddIcon /<%= @icons_prefix %>/compressed.gif .Z .z .tgz .gz .zip +AddIcon /<%= @icons_prefix %>/a.gif .ps .ai .eps +AddIcon /<%= @icons_prefix %>/layout.gif .html .shtml .htm .pdf +AddIcon /<%= @icons_prefix %>/text.gif .txt +AddIcon /<%= @icons_prefix %>/c.gif .c +AddIcon /<%= @icons_prefix %>/p.gif .pl .py +AddIcon /<%= @icons_prefix %>/f.gif .for +AddIcon /<%= @icons_prefix %>/dvi.gif .dvi +AddIcon /<%= @icons_prefix %>/uuencoded.gif .uu +AddIcon /<%= @icons_prefix %>/script.gif .conf .sh .shar .csh .ksh .tcl +AddIcon /<%= @icons_prefix %>/tex.gif .tex +AddIcon /<%= @icons_prefix %>/bomb.gif /core +AddIcon (SND,/<%= @icons_prefix %>/sound2.gif) .ogg +AddIcon (VID,/<%= @icons_prefix %>/movie.gif) .ogm + +AddIcon /<%= @icons_prefix %>/back.gif .. +AddIcon /<%= @icons_prefix %>/hand.right.gif README +AddIcon /<%= @icons_prefix %>/folder.gif ^^DIRECTORY^^ +AddIcon /<%= @icons_prefix %>/blank.gif ^^BLANKICON^^ + +AddIcon /<%= @icons_prefix %>/odf6odt<%= @icon_suffix %>.png .odt +AddIcon /<%= @icons_prefix %>/odf6ods<%= @icon_suffix %>.png .ods +AddIcon /<%= @icons_prefix %>/odf6odp<%= @icon_suffix %>.png .odp +AddIcon /<%= @icons_prefix %>/odf6odg<%= @icon_suffix %>.png .odg +AddIcon /<%= @icons_prefix %>/odf6odc<%= @icon_suffix %>.png .odc +AddIcon /<%= @icons_prefix %>/odf6odf<%= @icon_suffix %>.png .odf +AddIcon /<%= @icons_prefix %>/odf6odb<%= @icon_suffix %>.png .odb +AddIcon /<%= @icons_prefix %>/odf6odi<%= @icon_suffix %>.png .odi +AddIcon /<%= @icons_prefix %>/odf6odm<%= @icon_suffix %>.png .odm + +AddIcon /<%= @icons_prefix %>/odf6ott<%= @icon_suffix %>.png .ott +AddIcon /<%= @icons_prefix %>/odf6ots<%= @icon_suffix %>.png .ots +AddIcon /<%= @icons_prefix %>/odf6otp<%= @icon_suffix %>.png .otp +AddIcon /<%= @icons_prefix %>/odf6otg<%= @icon_suffix %>.png .otg +AddIcon /<%= @icons_prefix %>/odf6otc<%= @icon_suffix %>.png .otc +AddIcon /<%= @icons_prefix %>/odf6otf<%= @icon_suffix %>.png .otf +AddIcon /<%= @icons_prefix %>/odf6oti<%= @icon_suffix %>.png .oti +AddIcon /<%= @icons_prefix %>/odf6oth<%= @icon_suffix %>.png .oth + +DefaultIcon /<%= @icons_prefix %>/unknown.gif +ReadmeName README.html +HeaderName HEADER.html + +IndexIgnore .??* *~ *# HEADER.html README.html RCS CVS *,v *,t diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/cgid.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/cgid.conf.erb new file mode 100644 index 000000000..5f82d7424 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/cgid.conf.erb @@ -0,0 +1 @@ +ScriptSock "<%= @cgisock_path %>" diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/cluster.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/cluster.conf.erb new file mode 100644 index 000000000..d2f9d52e4 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/cluster.conf.erb @@ -0,0 +1,26 @@ +Listen <%= @ip %>:<%= @port %> +:<%= @port %>> + + Order deny,allow + Deny from all + Allow from <%= @allowed_network %> + + + KeepAliveTimeout <%= @keep_alive_timeout %> + MaxKeepAliveRequests <%= @max_keep_alive_requests %> + EnableMCPMReceive <%= scope.call_function('apache::bool2httpd', [@enable_mcpm_receive]) %> + + ManagerBalancerName <%= @balancer_name %> + ServerAdvertise <%= scope.call_function('apache::bool2httpd', [@server_advertise]) %> + <%- if @server_advertise == true and @advertise_frequency != nil -%> + AdvertiseFrequency <%= @advertise_frequency %> + <%- end -%> + + + SetHandler mod_cluster-manager + Order deny,allow + Deny from all + Allow from <%= @manager_allowed_network %> + + + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/dav_fs.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/dav_fs.conf.erb new file mode 100644 index 000000000..3c53e9e14 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/dav_fs.conf.erb @@ -0,0 +1 @@ +DAVLockDB "<%= @dav_lock %>" diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/deflate.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/deflate.conf.erb new file mode 100644 index 000000000..ede8b2e76 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/deflate.conf.erb @@ -0,0 +1,7 @@ +<%- @types.sort.each do |type| -%> +AddOutputFilterByType DEFLATE <%= type %> +<%- end -%> + +<%- @notes.sort.each do |type,note| -%> +DeflateFilterNote <%= type %> <%=note %> +<%- end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/dir.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/dir.conf.erb new file mode 100644 index 000000000..741f6ae03 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/dir.conf.erb @@ -0,0 +1 @@ +DirectoryIndex <%= @indexes.join(' ') %> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/disk_cache.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/disk_cache.conf.erb new file mode 100644 index 000000000..c97ee7662 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/disk_cache.conf.erb @@ -0,0 +1,9 @@ +<% if @default_cache_enable -%> +CacheEnable disk / +<% end -%> +CacheRoot "<%= @_cache_root %>" +CacheDirLevels 2 +CacheDirLength 1 +<% if @cache_ignore_headers -%> +CacheIgnoreHeaders <%= @cache_ignore_headers -%> +<% end -%> \ No newline at end of file diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/dumpio.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/dumpio.conf.erb new file mode 100644 index 000000000..29c34e2a5 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/dumpio.conf.erb @@ -0,0 +1,3 @@ +# https://httpd.apache.org/docs/2.4/mod/mod_dumpio.html +DumpIOInput "<%= @dump_io_input %>" +DumpIOOutput "<%= @dump_io_output %>" diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/event.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/event.conf.erb new file mode 100644 index 000000000..bca707c93 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/event.conf.erb @@ -0,0 +1,33 @@ + + <%- if @serverlimit -%> + ServerLimit <%= @serverlimit %> + <%- end -%> + <%- if @startservers -%> + StartServers <%= @startservers %> + <%- end -%> + <%- if @maxrequestworkers -%> + MaxRequestWorkers <%= @maxrequestworkers %> + <%- elsif @maxclients -%> + MaxClients <%= @maxclients %> + <%- end -%> + <%- if @minsparethreads -%> + MinSpareThreads <%= @minsparethreads %> + <%- end -%> + <%- if @maxsparethreads -%> + MaxSpareThreads <%= @maxsparethreads %> + <%- end -%> + <%- if @threadsperchild -%> + ThreadsPerChild <%= @threadsperchild %> + <%- end -%> + <%- if @maxconnectionsperchild -%> + MaxConnectionsPerChild <%= @maxconnectionsperchild %> + <%- elsif @maxrequestsperchild -%> + MaxRequestsPerChild <%= @maxrequestsperchild %> + <%- end -%> + <%- if @threadlimit -%> + ThreadLimit <%= @threadlimit %> + <%- end -%> + <%- if @listenbacklog -%> + ListenBacklog <%= @listenbacklog %> + <%- end -%> + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/expires.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/expires.conf.erb new file mode 100644 index 000000000..a864c6ca1 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/expires.conf.erb @@ -0,0 +1,11 @@ +ExpiresActive <%= scope.call_function('apache::bool2httpd', [@expires_active]) %> +<%- if ! @expires_default.nil? and ! @expires_default.empty? -%> +ExpiresDefault "<%= @expires_default %>" +<%- end -%> +<%- if ! @expires_by_type.nil? and ! @expires_by_type.empty? -%> +<%- [@expires_by_type].flatten.each do |line| -%> +<%- line.map do |type, seconds| -%> +ExpiresByType <%= type %> "<%= seconds -%>" +<%- end -%> +<%- end -%> +<%- end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/ext_filter.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/ext_filter.conf.erb new file mode 100644 index 000000000..67f98fd4c --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/ext_filter.conf.erb @@ -0,0 +1,6 @@ +# mod_ext_filter definitions +<%- if @ext_filter_define.length >= 1 -%> +<%- @ext_filter_define.keys.sort.each do |name| -%> +ExtFilterDefine <%= name %> <%= @ext_filter_define[name] %> +<%- end -%> +<%- end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/fastcgi.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/fastcgi.conf.erb new file mode 100644 index 000000000..93c8d86ab --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/fastcgi.conf.erb @@ -0,0 +1,8 @@ +# The Fastcgi Apache module configuration file is being +# managed by Puppet and changes will be overwritten. + + + SetHandler fastcgi-script + + FastCgiIpcDir "<%= @fastcgi_lib_path %>" + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/fcgid.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/fcgid.conf.erb new file mode 100644 index 000000000..a82bc30df --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/fcgid.conf.erb @@ -0,0 +1,5 @@ + +<% @options.sort_by {|key, value| key}.each do |key, value| -%> + <%= key %> <%= value %> +<% end -%> + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/geoip.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/geoip.conf.erb new file mode 100644 index 000000000..a99bee048 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/geoip.conf.erb @@ -0,0 +1,25 @@ +GeoIPEnable <%= scope.call_function('apache::bool2httpd', [@enable]) %> + +<%- if @db_file and ! [ false, 'false', '' ].include?(@db_file) -%> + <%- if @db_file.kind_of?(Array) -%> + <%- Array(@db_file).each do |file| -%> +GeoIPDBFile <%= file %> <%= @flag %> + <%- end -%> + <%- else -%> +GeoIPDBFile <%= @db_file %> <%= @flag %> + <%- end -%> +<%- end -%> +GeoIPOutput <%= @output %> +<% if ! @enable_utf8.nil? -%> +GeoIPEnableUTF8 <%= scope.call_function('apache::bool2httpd', [@enable_utf8]) %> +<% end -%> +<% if ! @scan_proxy_headers.nil? -%> +GeoIPScanProxyHeaders <%= scope.call_function('apache::bool2httpd', [@scan_proxy_headers]) %> +<% end -%> +<% if ! @scan_proxy_header_field.nil? -%> +GeoIPScanProxyHeaderField <%= @scan_proxy_header_field %> +<% end -%> +<% if ! @use_last_xforwarededfor_ip.nil? -%> +GeoIPUseLastXForwardedForIP <%= scope.call_function('apache::bool2httpd', [@use_last_xforwarededfor_ip]) %> +<% end -%> + diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/http2.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/http2.conf.erb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/http2.conf.erb rename to modules/services/unix/http/apache_kali_compatible/apache/templates/mod/http2.conf.erb diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/info.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/info.conf.erb new file mode 100644 index 000000000..c661a23ab --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/info.conf.erb @@ -0,0 +1,19 @@ +> + SetHandler server-info +<%- if @restrict_access -%> + <%- if scope.function_versioncmp([@_apache_version, '2.4']) >= 0 -%> + Require ip <%= Array(@allow_from).join(" ") %> + <%- else -%> + Order deny,allow + Deny from all + <%- if @allow_from and ! @allow_from.empty? -%> + <%- @allow_from.each do |allowed| -%> + Allow from <%= allowed %> + <%- end -%> + <%- else -%> + Allow from 127.0.0.1 + Allow from ::1 + <%- end -%> + <%- end -%> +<%- end -%> + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/itk.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/itk.conf.erb new file mode 100644 index 000000000..4abade8fb --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/itk.conf.erb @@ -0,0 +1,11 @@ + + StartServers <%= @startservers %> + MinSpareServers <%= @minspareservers %> + MaxSpareServers <%= @maxspareservers %> + ServerLimit <%= @serverlimit %> + MaxClients <%= @maxclients %> + MaxRequestsPerChild <%= @maxrequestsperchild %> + <%- if (not @enablecapabilities.nil?) && (scope.function_versioncmp([@_apache_version, '2.4']) >= 0) -%> + EnableCapabilities <%= scope.call_function('apache::bool2httpd', [@enablecapabilities]) %> + <%- end -%> + diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/jk.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/jk.conf.erb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/jk.conf.erb rename to modules/services/unix/http/apache_kali_compatible/apache/templates/mod/jk.conf.erb diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/jk/uriworkermap.properties.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/jk/uriworkermap.properties.erb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/jk/uriworkermap.properties.erb rename to modules/services/unix/http/apache_kali_compatible/apache/templates/mod/jk/uriworkermap.properties.erb diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/jk/workers.properties.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/jk/workers.properties.erb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/jk/workers.properties.erb rename to modules/services/unix/http/apache_kali_compatible/apache/templates/mod/jk/workers.properties.erb diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/ldap.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/ldap.conf.erb new file mode 100644 index 000000000..7c2dac5e9 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/ldap.conf.erb @@ -0,0 +1,32 @@ +> + SetHandler ldap-status + <%- if scope.function_versioncmp([@_apache_version, '2.4']) >= 0 -%> + Require ip 127.0.0.1 ::1 + <%- else -%> + Order deny,allow + Deny from all + Allow from 127.0.0.1 ::1 + Satisfy all + <%- end -%> + +<% if @ldap_trusted_global_cert_file -%> +LDAPTrustedGlobalCert <%= @ldap_trusted_global_cert_type %> <%= @ldap_trusted_global_cert_file %> +<% end -%> +<% if @ldap_trusted_mode -%> +LDAPTrustedMode <%= @ldap_trusted_mode %> +<% end -%> +<%- if @ldap_shared_cache_size -%> +LDAPSharedCacheSize <%= @ldap_shared_cache_size %> +<%- end -%> +<%- if @ldap_cache_entries -%> +LDAPCacheEntries <%= @ldap_cache_entries %> +<%- end -%> +<%- if @ldap_cache_ttl -%> +LDAPCacheTTL <%= @ldap_cache_ttl %> +<%- end -%> +<%- if @ldap_opcache_entries -%> +LDAPOpCacheEntries <%= @ldap_opcache_entries %> +<%- end -%> +<%- if @ldap_opcache_ttl -%> +LDAPOpCacheTTL <%= @ldap_opcache_ttl %> +<%- end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/load.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/load.erb new file mode 100644 index 000000000..51f45edb2 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/load.erb @@ -0,0 +1,7 @@ +<% if @loadfiles -%> +<% Array(@loadfiles).each do |loadfile| -%> +LoadFile <%= loadfile %> +<% end -%> + +<% end -%> +LoadModule <%= @_id %> <%= @_path %> diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/md.conf.epp b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/md.conf.epp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/md.conf.epp rename to modules/services/unix/http/apache_kali_compatible/apache/templates/mod/md.conf.epp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/mime.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/mime.conf.erb new file mode 100644 index 000000000..46d021c21 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/mime.conf.erb @@ -0,0 +1,38 @@ +TypesConfig <%= @mime_types_config %> + +AddType application/x-compress .Z +AddType application/x-gzip .gz .tgz +AddType application/x-bzip2 .bz2 + +AddLanguage ca .ca +AddLanguage cs .cz .cs +AddLanguage da .dk +AddLanguage de .de +AddLanguage el .el +AddLanguage en .en +AddLanguage eo .eo +AddLanguage es .es +AddLanguage et .et +AddLanguage fr .fr +AddLanguage he .he +AddLanguage hr .hr +AddLanguage it .it +AddLanguage ja .ja +AddLanguage ko .ko +AddLanguage ltz .ltz +AddLanguage nl .nl +AddLanguage nn .nn +AddLanguage no .no +AddLanguage pl .po +AddLanguage pt .pt +AddLanguage pt-BR .pt-br +AddLanguage ru .ru +AddLanguage sv .sv +AddLanguage zh-CN .zh-cn +AddLanguage zh-TW .zh-tw + +<%- @_mime_types_additional.sort.each do |add_mime, config| -%> + <%- config.each do |type, extension| %> +<%= add_mime %> <%= type %> <%= extension%> + <%- end -%> +<% end %> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/mime_magic.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/mime_magic.conf.erb new file mode 100644 index 000000000..cbc173deb --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/mime_magic.conf.erb @@ -0,0 +1 @@ +MIMEMagicFile "<%= @_magic_file %>" diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/mpm_event.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/mpm_event.conf.erb new file mode 100644 index 000000000..eb6f1ff5f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/mpm_event.conf.erb @@ -0,0 +1,9 @@ + + StartServers 2 + MinSpareThreads 25 + MaxSpareThreads 75 + ThreadLimit 64 + ThreadsPerChild 25 + MaxClients 150 + MaxRequestsPerChild 0 + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/negotiation.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/negotiation.conf.erb new file mode 100644 index 000000000..2fb4700d6 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/negotiation.conf.erb @@ -0,0 +1,2 @@ +LanguagePriority <%= Array(@language_priority).join(' ') %> +ForceLanguagePriority <%= Array(@force_language_priority).join(' ') %> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/nss.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/nss.conf.erb new file mode 100644 index 000000000..36f83d865 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/nss.conf.erb @@ -0,0 +1,228 @@ +# +# This is the Apache server configuration file providing SSL support using. +# the mod_nss plugin. It contains the configuration directives to instruct +# the server how to serve pages over an https connection. +# +# Do NOT simply read the instructions in here without understanding +# what they do. They're here only as hints or reminders. If you are unsure +# consult the online docs. You have been warned. +# + +#LoadModule nss_module modules/libmodnss.so + +# +# When we also provide SSL we have to listen to the +# standard HTTP port (see above) and to the HTTPS port +# +# Note: Configurations that use IPv6 but not IPv4-mapped addresses need two +# Listen directives: "Listen [::]:8443" and "Listen 0.0.0.0:443" +# +Listen <%= @port %> + +## +## SSL Global Context +## +## All SSL configuration in this context applies both to +## the main server and all SSL-enabled virtual hosts. +## + +# +# Some MIME-types for downloading Certificates and CRLs +# +AddType application/x-x509-ca-cert .crt +AddType application/x-pkcs7-crl .crl + +# Pass Phrase Dialog: +# Configure the pass phrase gathering process. +# The filtering dialog program (`builtin' is a internal +# terminal dialog) has to provide the pass phrase on stdout. +<% if @passwd_file -%> +NSSPassPhraseDialog "file:<%= @passwd_file %>" +<% else -%> +NSSPassPhraseDialog builtin +<% end -%> + +# Pass Phrase Helper: +# This helper program stores the token password pins between +# restarts of Apache. +NSSPassPhraseHelper /usr/sbin/nss_pcache + +# Configure the SSL Session Cache. +# NSSSessionCacheSize is the number of entries in the cache. +# NSSSessionCacheTimeout is the SSL2 session timeout (in seconds). +# NSSSession3CacheTimeout is the SSL3/TLS session timeout (in seconds). +NSSSessionCacheSize 10000 +NSSSessionCacheTimeout 100 +NSSSession3CacheTimeout 86400 + +# +# Pseudo Random Number Generator (PRNG): +# Configure one or more sources to seed the PRNG of the SSL library. +# The seed data should be of good random quality. +# WARNING! On some platforms /dev/random blocks if not enough entropy +# is available. Those platforms usually also provide a non-blocking +# device, /dev/urandom, which may be used instead. +# +# This does not support seeding the RNG with each connection. + +NSSRandomSeed startup builtin +#NSSRandomSeed startup file:/dev/random 512 +#NSSRandomSeed startup file:/dev/urandom 512 + +# +# TLS Negotiation configuration under RFC 5746 +# +# Only renegotiate if the peer's hello bears the TLS renegotiation_info +# extension. Default off. +NSSRenegotiation off + +# Peer must send Signaling Cipher Suite Value (SCSV) or +# Renegotiation Info (RI) extension in ALL handshakes. Default: off +NSSRequireSafeNegotiation off + +## +## SSL Virtual Host Context +## + +> + +# General setup for the virtual host +#DocumentRoot "/etc/httpd/htdocs" +#ServerName www.example.com:8443 +#ServerAdmin you@example.com + +# mod_nss can log to separate log files, you can choose to do that if you'd like +# LogLevel is not inherited from httpd.conf. +ErrorLog "<%= @error_log %>" +TransferLog "<%= @transfer_log %>" +LogLevel warn + +# SSL Engine Switch: +# Enable/Disable SSL for this virtual host. +NSSEngine on + +# SSL Cipher Suite: +# List the ciphers that the client is permitted to negotiate. +# See the mod_nss documentation for a complete list. + +# SSL 3 ciphers. SSL 2 is disabled by default. +NSSCipherSuite +rsa_rc4_128_md5,+rsa_rc4_128_sha,+rsa_3des_sha,-rsa_des_sha,-rsa_rc4_40_md5,-rsa_rc2_40_md5,-rsa_null_md5,-rsa_null_sha,+fips_3des_sha,-fips_des_sha,-fortezza,-fortezza_rc4_128_sha,-fortezza_null,-rsa_des_56_sha,-rsa_rc4_56_sha,+rsa_aes_128_sha,+rsa_aes_256_sha + +# SSL 3 ciphers + ECC ciphers. SSL 2 is disabled by default. +# +# Comment out the NSSCipherSuite line above and use the one below if you have +# ECC enabled NSS and mod_nss and want to use Elliptical Curve Cryptography +#NSSCipherSuite +rsa_rc4_128_md5,+rsa_rc4_128_sha,+rsa_3des_sha,-rsa_des_sha,-rsa_rc4_40_md5,-rsa_rc2_40_md5,-rsa_null_md5,-rsa_null_sha,+fips_3des_sha,-fips_des_sha,-fortezza,-fortezza_rc4_128_sha,-fortezza_null,-rsa_des_56_sha,-rsa_rc4_56_sha,+rsa_aes_128_sha,+rsa_aes_256_sha,-ecdh_ecdsa_null_sha,+ecdh_ecdsa_rc4_128_sha,+ecdh_ecdsa_3des_sha,+ecdh_ecdsa_aes_128_sha,+ecdh_ecdsa_aes_256_sha,-ecdhe_ecdsa_null_sha,+ecdhe_ecdsa_rc4_128_sha,+ecdhe_ecdsa_3des_sha,+ecdhe_ecdsa_aes_128_sha,+ecdhe_ecdsa_aes_256_sha,-ecdh_rsa_null_sha,+ecdh_rsa_128_sha,+ecdh_rsa_3des_sha,+ecdh_rsa_aes_128_sha,+ecdh_rsa_aes_256_sha,-echde_rsa_null,+ecdhe_rsa_rc4_128_sha,+ecdhe_rsa_3des_sha,+ecdhe_rsa_aes_128_sha,+ecdhe_rsa_aes_256_sha + +# SSL Protocol: +# Cryptographic protocols that provide communication security. +# NSS handles the specified protocols as "ranges", and automatically +# negotiates the use of the strongest protocol for a connection starting +# with the maximum specified protocol and downgrading as necessary to the +# minimum specified protocol that can be used between two processes. +# Since all protocol ranges are completely inclusive, and no protocol in the +# middle of a range may be excluded, the entry "NSSProtocol TLSv1.0,TLSv1.2" +# is identical to the entry "NSSProtocol TLSv1.0,TLSv1.1,TLSv1.2". +NSSProtocol TLSv1.0,TLSv1.1 + +# SSL Certificate Nickname: +# The nickname of the RSA server certificate you are going to use. +NSSNickname Server-Cert + +# SSL Certificate Nickname: +# The nickname of the ECC server certificate you are going to use, if you +# have an ECC-enabled version of NSS and mod_nss +#NSSECCNickname Server-Cert-ecc + +# Server Certificate Database: +# The NSS security database directory that holds the certificates and +# keys. The database consists of 3 files: cert8.db, key3.db and secmod.db. +# Provide the directory that these files exist. +NSSCertificateDatabase "<%= @httpd_dir -%>/alias" + +# Database Prefix: +# In order to be able to store multiple NSS databases in one directory +# they need unique names. This option sets the database prefix used for +# cert8.db and key3.db. +#NSSDBPrefix my-prefix- + +# Client Authentication (Type): +# Client certificate verification type. Types are none, optional and +# require. +#NSSVerifyClient none + +# +# Online Certificate Status Protocol (OCSP). +# Verify that certificates have not been revoked before accepting them. +#NSSOCSP off + +# +# Use a default OCSP responder. If enabled this will be used regardless +# of whether one is included in a client certificate. Note that the +# server certificate is verified during startup. +# +# NSSOCSPDefaultURL defines the service URL of the OCSP responder +# NSSOCSPDefaultName is the nickname of the certificate to trust to +# sign the OCSP responses. +#NSSOCSPDefaultResponder on +#NSSOCSPDefaultURL http://example.com/ocsp/status +#NSSOCSPDefaultName ocsp-nickname + +# Access Control: +# With SSLRequire you can do per-directory access control based +# on arbitrary complex boolean expressions containing server +# variable checks and other lookup directives. The syntax is a +# mixture between C and Perl. See the mod_nss documentation +# for more details. +# +#NSSRequire ( %{SSL_CIPHER} !~ m/^(EXP|NULL)/ \ +# and %{SSL_CLIENT_S_DN_O} eq "Snake Oil, Ltd." \ +# and %{SSL_CLIENT_S_DN_OU} in {"Staff", "CA", "Dev"} \ +# and %{TIME_WDAY} >= 1 and %{TIME_WDAY} <= 5 \ +# and %{TIME_HOUR} >= 8 and %{TIME_HOUR} <= 20 ) \ +# or %{REMOTE_ADDR} =~ m/^192\.76\.162\.[0-9]+$/ +# + +# SSL Engine Options: +# Set various options for the SSL engine. +# o FakeBasicAuth: +# Translate the client X.509 into a Basic Authorisation. This means that +# the standard Auth/DBMAuth methods can be used for access control. The +# user name is the `one line' version of the client's X.509 certificate. +# Note that no password is obtained from the user. Every entry in the user +# file needs this password: `xxj31ZMTZzkVA'. +# o ExportCertData: +# This exports two additional environment variables: SSL_CLIENT_CERT and +# SSL_SERVER_CERT. These contain the PEM-encoded certificates of the +# server (always existing) and the client (only existing when client +# authentication is used). This can be used to import the certificates +# into CGI scripts. +# o StdEnvVars: +# This exports the standard SSL/TLS related `SSL_*' environment variables. +# Per default this exportation is switched off for performance reasons, +# because the extraction step is an expensive operation and is usually +# useless for serving static content. So one usually enables the +# exportation for CGI and SSI requests only. +# o StrictRequire: +# This denies access when "NSSRequireSSL" or "NSSRequire" applied even +# under a "Satisfy any" situation, i.e. when it applies access is denied +# and no other module can change it. +# o OptRenegotiate: +# This enables optimized SSL connection renegotiation handling when SSL +# directives are used in per-directory context. +#NSSOptions +FakeBasicAuth +ExportCertData +CompatEnvVars +StrictRequire + + NSSOptions +StdEnvVars + + + NSSOptions +StdEnvVars + + +# Per-Server Logging: +# The home of a custom SSL log file. Use this when you want a +# compact non-error SSL logfile on a virtual host basis. +#CustomLog /home/rcrit/redhat/apache/logs/ssl_request_log \ +# "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b" + + + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/pagespeed.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/pagespeed.conf.erb new file mode 100644 index 000000000..56e72fe29 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/pagespeed.conf.erb @@ -0,0 +1,102 @@ +ModPagespeed on + +ModPagespeedInheritVHostConfig <%= @inherit_vhost_config %> +AddOutputFilterByType MOD_PAGESPEED_OUTPUT_FILTER text/html +<% if @filter_xhtml -%> +AddOutputFilterByType MOD_PAGESPEED_OUTPUT_FILTER application/xhtml+xml +<% end -%> +ModPagespeedFileCachePath "<%= @cache_path %>" +ModPagespeedLogDir "<%= @log_dir %>" + +<% @memcache_servers.each do |server| -%> +ModPagespeedMemcachedServers <%= server %> +<% end -%> + +ModPagespeedRewriteLevel <%= @rewrite_level -%> + +<% @disable_filters.each do |filter| -%> +ModPagespeedDisableFilters <%= filter %> +<% end -%> + +<% @enable_filters.each do |filter| -%> +ModPagespeedEnableFilters <%= filter %> +<% end -%> + +<% @forbid_filters.each do |filter| -%> +ModPagespeedForbidFilters <%= filter %> +<% end -%> + +ModPagespeedRewriteDeadlinePerFlushMs <%= @rewrite_deadline_per_flush_ms %> + +<% if @additional_domains -%> +ModPagespeedDomain <%= @additional_domains -%> +<% end -%> + +ModPagespeedFileCacheSizeKb <%= @file_cache_size_kb %> +ModPagespeedFileCacheCleanIntervalMs <%= @file_cache_clean_interval_ms %> +ModPagespeedLRUCacheKbPerProcess <%= @lru_cache_per_process %> +ModPagespeedLRUCacheByteLimit <%= @lru_cache_byte_limit %> +ModPagespeedCssFlattenMaxBytes <%= @css_flatten_max_bytes %> +ModPagespeedCssInlineMaxBytes <%= @css_inline_max_bytes %> +ModPagespeedCssImageInlineMaxBytes <%= @css_image_inline_max_bytes %> +ModPagespeedImageInlineMaxBytes <%= @image_inline_max_bytes %> +ModPagespeedJsInlineMaxBytes <%= @js_inline_max_bytes %> +ModPagespeedCssOutlineMinBytes <%= @css_outline_min_bytes %> +ModPagespeedJsOutlineMinBytes <%= @js_outline_min_bytes %> + + +ModPagespeedFileCacheInodeLimit <%= @inode_limit %> +ModPagespeedImageMaxRewritesAtOnce <%= @image_max_rewrites_at_once %> + +ModPagespeedNumRewriteThreads <%= @num_rewrite_threads %> +ModPagespeedNumExpensiveRewriteThreads <%= @num_expensive_rewrite_threads %> + +ModPagespeedStatistics <%= @collect_statistics %> + + + # You may insert other "Allow from" lines to add hosts you want to + # allow to look at generated statistics. Another possibility is + # to comment out the "Order" and "Allow" options from the config + # file, to allow any client that can reach your server to examine + # statistics. This might be appropriate in an experimental setup or + # if the Apache server is protected by a reverse proxy that will + # filter URLs in some fashion. + <%- if scope.function_versioncmp([@_apache_version, '2.4']) >= 0 -%> + Require ip 127.0.0.1 ::1 <%= Array(@allow_view_stats).join(" ") %> + <%- else -%> + Order allow,deny + Allow from 127.0.0.1 ::1 <%= Array(@allow_view_stats).join(" ") %> + <%- end -%> + SetHandler mod_pagespeed_statistics + + +ModPagespeedStatisticsLogging <%= @statistics_logging %> + + <%- if scope.function_versioncmp([@_apache_version, '2.4']) >= 0 -%> + Require ip 127.0.0.1 ::1 <%= Array(@allow_pagespeed_console).join(" ") %> + <%- else -%> + Order allow,deny + Allow from 127.0.0.1 ::1 <%= Array(@allow_pagespeed_console).join(" ") %> + <%- end -%> + SetHandler pagespeed_console + + +ModPagespeedMessageBufferSize <%= @message_buffer_size %> + + + <%- if scope.function_versioncmp([@_apache_version, '2.4']) >= 0 -%> + Require ip 127.0.0.1 ::1 <%= Array(@allow_pagespeed_message).join(" ") %> + <%- else -%> + Order allow,deny + Allow from 127.0.0.1 ::1 <%= Array(@allow_pagespeed_message).join(" ") %> + <%- end -%> + SetHandler mod_pagespeed_message + + +<% if @additional_configuration.is_a? Array -%> +<%= @additional_configuration.join("\n") %> +<% else -%> +<% @additional_configuration.each_pair do |key, value| -%> +<%= key %> <%= value %> +<% end -%> +<% end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/passenger.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/passenger.conf.erb new file mode 100644 index 000000000..f7078db92 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/passenger.conf.erb @@ -0,0 +1,259 @@ +# The Passenger Apache module configuration file is being +# managed by Puppet and changes will be overwritten. + + <%- if @passenger_allow_encoded_slashes -%> + PassengerAllowEncodedSlashes <%= @passenger_allow_encoded_slashes %> + <%- end -%> + <%- if @passenger_anonymous_telemetry_proxy -%> + PassengerAnonymousTelemetryProxy <%= @passenger_anonymous_telemetry_proxy %> + <%- end -%> + <%- if @passenger_app_env -%> + PassengerAppEnv <%= @passenger_app_env %> + <%- end -%> + <%- if @passenger_app_group_name -%> + PassengerAppGroupName <%= @passenger_app_group_name %> + <%- end -%> + <%- if @passenger_app_root -%> + PassengerAppRoot "<%= @passenger_app_root %>" + <%- end -%> + <%- if @passenger_app_type -%> + PassengerAppType <%= @passenger_app_type %> + <%- end -%> + <%- if @passenger_base_uri -%> + PassengerBaseURI <%= @passenger_base_uri %> + <%- end -%> + <%- if @passenger_buffer_response -%> + PassengerBufferResponse <%= @passenger_buffer_response %> + <%- end -%> + <%- if @passenger_buffer_upload -%> + PassengerBufferUpload <%= @passenger_buffer_upload %> + <%- end -%> + <%- if @passenger_concurrency_model -%> + PassengerConcurrencyModel <%= @passenger_concurrency_model %> + <%- end -%> + <%- if @passenger_data_buffer_dir -%> + PassengerDataBufferDir "<%= @passenger_data_buffer_dir %>" + <%- end -%> + <%- if @passenger_debug_log_file -%> + PassengerDebugLogFile <%= @passenger_debug_log_file %> + <%- end -%> + <%- if @passenger_debugger -%> + PassengerDebugger <%= @passenger_debugger %> + <%- end -%> + <%- if @passenger_default_group -%> + PassengerDefaultGroup <%= @passenger_default_group %> + <%- end -%> + <%- if @passenger_default_ruby -%> + PassengerDefaultRuby "<%= @passenger_default_ruby %>" + <%- end -%> + <%- if @passenger_default_user -%> + PassengerDefaultUser <%= @passenger_default_user %> + <%- end -%> + <%- unless @passenger_disable_anonymous_telemetry.nil? -%> + PassengerDisableAnonymousTelemetry <%= scope.call_function('apache::bool2httpd', [@passenger_disable_anonymous_telemetry]) %> + <%- end -%> + <%- unless @passenger_disable_log_prefix.nil? -%> + PassengerDisableLogPrefix <%= scope.call_function('apache::bool2httpd', [@passenger_disable_log_prefix]) %> + <%- end -%> + <%- if @passenger_disable_security_update_check -%> + PassengerDisableSecurityUpdateCheck <%= @passenger_disable_security_update_check %> + <%- end -%> + <%- if @passenger_enabled -%> + PassengerEnabled <%= @passenger_enabled %> + <%- end -%> + <%- if @passenger_error_override -%> + PassengerErrorOverride <%= @passenger_error_override %> + <%- end -%> + <%- if @passenger_file_descriptor_log_file -%> + PassengerFileDescriptorLogFile "<%= @passenger_file_descriptor_log_file %>" + <%- end -%> + <%- if @passenger_fly_with -%> + PassengerFlyWith "<%= @passenger_fly_with %>" + <%- end -%> + <%- if @passenger_force_max_concurrent_requests_per_process -%> + PassengerForceMaxConcurrentRequestsPerProcess <%= @passenger_force_max_concurrent_requests_per_process %> + <%- end -%> + <%- if @passenger_friendly_error_pages -%> + PassengerFriendlyErrorPages <%= @passenger_friendly_error_pages %> + <%- end -%> + <%- if @passenger_group -%> + PassengerGroup <%= @passenger_group %> + <%- end -%> + <%- if @passenger_high_performance -%> + PassengerHighPerformance <%= @passenger_high_performance %> + <%- end -%> + <%- if @passenger_instance_registry_dir -%> + PassengerInstanceRegistryDir "<%= @passenger_instance_registry_dir %>" + <%- end -%> + <%- if @passenger_load_shell_envvars -%> + PassengerLoadShellEnvvars <%= @passenger_load_shell_envvars %> + <%- end -%> + <%- if @passenger_log_file -%> + PassengerLogFile "<%= @passenger_log_file %>" + <%- end -%> + <%- if @passenger_log_level -%> + PassengerLogLevel <%= @passenger_log_level %> + <%- end -%> + <%- if @passenger_lve_min_uid -%> + PassengerLveMinUid <%= @passenger_lve_min_uid %> + <%- end -%> + <%- if @passenger_max_instances -%> + PassengerMaxInstances <%= @passenger_max_instances %> + <%- end -%> + <%- if @passenger_max_instances_per_app -%> + PassengerMaxInstancesPerApp <%= @passenger_max_instances_per_app %> + <%- end -%> + <%- if @passenger_max_pool_size -%> + PassengerMaxPoolSize <%= @passenger_max_pool_size %> + <%- end -%> + <%- if @passenger_max_preloader_idle_time -%> + PassengerMaxPreloaderIdleTime <%= @passenger_max_preloader_idle_time %> + <%- end -%> + <%- if @passenger_max_request_queue_size -%> + PassengerMaxRequestQueueSize <%= @passenger_max_request_queue_size %> + <%- end -%> + <%- if @passenger_max_request_time -%> + PassengerMaxRequestTime <%= @passenger_max_request_time %> + <%- end -%> + <%- if @passenger_max_requests -%> + PassengerMaxRequests <%= @passenger_max_requests %> + <%- end -%> + <%- if @passenger_memory_limit -%> + PassengerMemoryLimit <%= @passenger_memory_limit %> + <%- end -%> + <%- if @passenger_meteor_app_settings -%> + PassengerMeteorAppSettings "<%= @passenger_meteor_app_settings %>" + <%- end -%> + <%- if @passenger_min_instances -%> + PassengerMinInstances <%= @passenger_min_instances %> + <%- end -%> + <%- if @passenger_nodejs -%> + PassengerNodejs "<%= @passenger_nodejs %>" + <%- end -%> + <%- if @passenger_pool_idle_time -%> + PassengerPoolIdleTime <%= @passenger_pool_idle_time %> + <%- end -%> + <%- if @passenger_pre_start -%> + <%- [@passenger_pre_start].flatten.compact.each do |passenger_pre_start| -%> + PassengerPreStart <%= passenger_pre_start %> + <%- end -%> + <%- end -%> + <%- if @passenger_python -%> + PassengerPython "<%= @passenger_python %>" + <%- end -%> + <%- if @passenger_resist_deployment_errors -%> + PassengerResistDeploymentErrors <%= @passenger_resist_deployment_errors %> + <%- end -%> + <%- if @passenger_resolve_symlinks_in_document_root -%> + PassengerResolveSymlinksInDocumentRoot <%= @passenger_resolve_symlinks_in_document_root %> + <%- end -%> + <%- if @passenger_response_buffer_high_watermark -%> + PassengerResponseBufferHighWatermark <%= @passenger_response_buffer_high_watermark %> + <%- end -%> + <%- if @passenger_restart_dir -%> + PassengerRestartDir "<%= @passenger_restart_dir %>" + <%- end -%> + <%- if @passenger_rolling_restarts -%> + PassengerRollingRestarts <%= @passenger_rolling_restarts %> + <%- end -%> + <%- if @passenger_root -%> + PassengerRoot "<%= @passenger_root %>" + <%- end -%> + <%- if @passenger_ruby -%> + PassengerRuby "<%= @passenger_ruby %>" + <%- end -%> + <%- if @passenger_security_update_check_proxy -%> + PassengerSecurityUpdateCheckProxy <%= @passenger_security_update_check_proxy %> + <%- end -%> + <%- if @passenger_show_version_in_header -%> + PassengerShowVersionInHeader <%= @passenger_show_version_in_header %> + <%- end -%> + <%- if @passenger_socket_backlog -%> + PassengerSocketBacklog <%= @passenger_socket_backlog %> + <%- end -%> + <%- if @passenger_spawn_dir -%> + PassengerSpawnDir "<%= @passenger_spawn_dir %>" + <%- end -%> + <%- if @passenger_spawn_method -%> + PassengerSpawnMethod <%= @passenger_spawn_method %> + <%- end -%> + <%- if @passenger_start_timeout -%> + PassengerStartTimeout <%= @passenger_start_timeout %> + <%- end -%> + <%- if @passenger_startup_file -%> + PassengerStartupFile "<%= @passenger_startup_file %>" + <%- end -%> + <%- if @passenger_stat_throttle_rate -%> + PassengerStatThrottleRate <%= @passenger_stat_throttle_rate %> + <%- end -%> + <%- if @passenger_sticky_sessions -%> + PassengerStickySessions <%= @passenger_sticky_sessions %> + <%- end -%> + <%- if @passenger_sticky_sessions_cookie_name -%> + PassengerStickySessionsCookieName <%= @passenger_sticky_sessions_cookie_name %> + <%- end -%> + <%- if @passenger_sticky_sessions_cookie_attributes -%> + PassengerStickySessionsCookieAttributes "<%= @passenger_sticky_sessions_cookie_attributes %>" + <%- end -%> + <%- if @passenger_thread_count -%> + PassengerThreadCount <%= @passenger_thread_count %> + <%- end -%> + <%- if @passenger_use_global_queue -%> + PassengerUseGlobalQueue <%= @passenger_use_global_queue %> + <%- end -%> + <%- if @passenger_user -%> + PassengerUser <%= @passenger_user %> + <%- end -%> + <%- if @passenger_user_switching -%> + PassengerUserSwitching <%= @passenger_user_switching %> + <%- end -%> + <%- if @rack_auto_detect -%> + RackAutoDetect <%= @rack_auto_detect %> + <%- end -%> + <%- if @rack_base_uri -%> + RackBaseURI <%= @rack_base_uri %> + <%- end -%> + <%- if @rack_env -%> + RackEnv <%= @rack_env %> + <%- end -%> + <%- if @rails_allow_mod_rewrite -%> + RailsAllowModRewrite <%= @rails_allow_mod_rewrite %> + <%- end -%> + <%- if @rails_app_spawner_idle_time -%> + RailsAppSpawnerIdleTime <%= @rails_app_spawner_idle_time %> + <%- end -%> + <%- if @rails_auto_detect -%> + RailsAutoDetect <%= @rails_auto_detect %> + <%- end -%> + <%- if @rails_base_uri -%> + RailsBaseURI <%= @rails_base_uri %> + <%- end -%> + <%- if @rails_default_user -%> + RailsDefaultUser <%= @rails_default_user %> + <%- end -%> + <%- if @rails_env -%> + RailsEnv <%= @rails_env %> + <%- end -%> + <%- if @rails_framework_spawner_idle_time -%> + RailsFrameworkSpawnerIdleTime <%= @rails_framework_spawner_idle_time %> + <%- end -%> + <%- if @rails_ruby -%> + RailsRuby <%= @rails_ruby %> + <%- end -%> + <%- if @rails_spawn_method -%> + RailsSpawnMethod <%= @rails_spawn_method %> + <%- end -%> + <%- if @rails_user_switching -%> + RailsUserSwitching <%= @rails_user_switching %> + <%- end -%> + <%- if @wsgi_auto_detect -%> + WsgiAutoDetect <%= @wsgi_auto_detect %> + <%- end -%> + <%- if @rails_autodetect -%> + RailsAutoDetect <%= @rails_autodetect %> + <%- end -%> + <%- if @rack_autodetect -%> + RackAutoDetect <%= @rack_autodetect %> + <%- end -%> + + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/peruser.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/peruser.conf.erb new file mode 100644 index 000000000..13c8d708d --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/peruser.conf.erb @@ -0,0 +1,12 @@ + + MinSpareProcessors <%= @minspareprocessors %> + MinProcessors <%= @minprocessors %> + MaxProcessors <%= @maxprocessors %> + MaxClients <%= @maxclients %> + MaxRequestsPerChild <%= @maxrequestsperchild %> + IdleTimeout <%= @idletimeout %> + ExpireTimeout <%= @expiretimeout %> + KeepAlive <%= @keepalive %> + Include "<%= @mod_dir %>/peruser/multiplexers/*.conf" + Include "<%= @mod_dir %>/peruser/processors/*.conf" + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/php.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/php.conf.erb new file mode 100644 index 000000000..9e684fe6d --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/php.conf.erb @@ -0,0 +1,23 @@ +# +# PHP is an HTML-embedded scripting language which attempts to make it +# easy for developers to write dynamically generated webpages. +# + +# +# Cause the PHP interpreter to handle files with a .php extension. +# +)$"> + SetHandler application/x-httpd-php + + +# +# Add index.php to the list of files that will be served as directory +# indexes. +# +DirectoryIndex index.php + +# +# Uncomment the following line to allow PHP to pretty-print .phps +# files as PHP source code: +# +#AddType application/x-httpd-php-source .phps diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/prefork.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/prefork.conf.erb new file mode 100644 index 000000000..01f0b84f8 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/prefork.conf.erb @@ -0,0 +1,17 @@ + + StartServers <%= @startservers %> + MinSpareServers <%= @minspareservers %> + MaxSpareServers <%= @maxspareservers %> + ServerLimit <%= @serverlimit %> + <%- if @maxrequestworkers -%> + MaxRequestWorkers <%= @maxrequestworkers %> + <%- elsif @maxclients -%> + MaxClients <%= @maxclients %> + <%- end -%> + <%- if @maxconnectionsperchild -%> + MaxConnectionsPerChild <%= @maxconnectionsperchild %> + <%- elsif @maxrequestsperchild -%> + MaxRequestsPerChild <%= @maxrequestsperchild %> + <%- end -%> + ListenBacklog <%= @listenbacklog %> + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/proxy.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/proxy.conf.erb new file mode 100644 index 000000000..76968cb6f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/proxy.conf.erb @@ -0,0 +1,34 @@ +# +# Proxy Server directives. Uncomment the following lines to +# enable the proxy server: +# + + # Do not enable proxying with ProxyRequests until you have secured your + # server. Open proxy servers are dangerous both to your network and to the + # Internet at large. + ProxyRequests <%= @proxy_requests %> + + <% if @proxy_requests != 'Off' or ( @allow_from and ! @allow_from.empty? ) -%> + + <%- if scope.function_versioncmp([@_apache_version, '2.4']) >= 0 -%> + Require ip <%= Array(@allow_from).join(" ") %> + <%- else -%> + Order deny,allow + Deny from all + Allow from <%= Array(@allow_from).join(" ") %> + <%- end -%> + + <% end -%> + + # Enable/disable the handling of HTTP/1.1 "Via:" headers. + # ("Full" adds the server version; "Block" removes all outgoing Via: headers) + # Set to one of: Off | On | Full | Block + ProxyVia <%= @proxy_via %> + + <%- if @proxy_timeout -%> + ProxyTimeout <%= @proxy_timeout %> + <%- end -%> + <%- if @proxy_iobuffersize -%> + ProxyIOBufferSize <%= @proxy_iobuffersize %> + <%- end -%> + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/proxy_balancer.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/proxy_balancer.conf.erb new file mode 100644 index 000000000..c1f37be8e --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/proxy_balancer.conf.erb @@ -0,0 +1,10 @@ +> + SetHandler balancer-manager + <%- if scope.function_versioncmp([@apache_version, '2.4']) >= 0 -%> + Require ip <%= Array(@allow_from).join(" ") %> + <%- else -%> + Order deny,allow + Deny from all + Allow from <%= Array(@allow_from).join(" ") %> + <%- end -%> + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/proxy_html.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/proxy_html.conf.erb new file mode 100644 index 000000000..3cb8eca62 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/proxy_html.conf.erb @@ -0,0 +1,20 @@ +ProxyHTMLLinks a href +ProxyHTMLLinks area href +ProxyHTMLLinks link href +ProxyHTMLLinks img src longdesc usemap +ProxyHTMLLinks object classid codebase data usemap +ProxyHTMLLinks q cite +ProxyHTMLLinks blockquote cite +ProxyHTMLLinks ins cite +ProxyHTMLLinks del cite +ProxyHTMLLinks form action +ProxyHTMLLinks input src usemap +ProxyHTMLLinks head profile +ProxyHTMLLinks base href +ProxyHTMLLinks script src for +ProxyHTMLLinks meta content + +ProxyHTMLEvents onclick ondblclick onmousedown onmouseup \ + onmouseover onmousemove onmouseout onkeypress \ + onkeydown onkeyup onfocus onblur onload \ + onunload onsubmit onreset onselect onchange diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/remoteip.conf.epp b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/remoteip.conf.epp similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/remoteip.conf.epp rename to modules/services/unix/http/apache_kali_compatible/apache/templates/mod/remoteip.conf.epp diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/reqtimeout.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/reqtimeout.conf.erb new file mode 100644 index 000000000..6ffc5ffe2 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/reqtimeout.conf.erb @@ -0,0 +1,3 @@ +<% Array(@timeouts).each do |timeout| -%> +RequestReadTimeout <%= timeout %> +<%- end -%> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/rpaf.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/rpaf.conf.erb new file mode 100644 index 000000000..56e2398b5 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/rpaf.conf.erb @@ -0,0 +1,15 @@ +# Enable reverse proxy add forward +RPAFenable On +# RPAFsethostname will, when enabled, take the incoming X-Host header and +# update the virtual host settings accordingly. This allows to have the same +# hostnames as in the "real" configuration for the forwarding proxy. +<% if @sethostname -%> +RPAFsethostname On +<% else -%> +RPAFsethostname Off +<% end -%> +# Which IPs are forwarding requests to us +RPAFproxy_ips <%= Array(@proxy_ips).join(" ") %> +# Setting RPAFheader allows you to change the header name to parse from the +# default X-Forwarded-For to something of your choice. +RPAFheader <%= @header %> diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/security.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/security.conf.erb new file mode 100644 index 000000000..0302cebf3 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/security.conf.erb @@ -0,0 +1,86 @@ + + # Default recommended configuration + SecRuleEngine <%= @modsec_secruleengine %> + SecRequestBodyAccess On + <%- if @custom_rules -%> + Include <%= @modsec_dir %>/custom_rules/*.conf + <%- end -%> + SecRule REQUEST_HEADERS:Content-Type "text/xml" \ + "id:'200000',phase:1,t:none,t:lowercase,pass,nolog,ctl:requestBodyProcessor=XML" + SecRequestBodyLimit <%= @secrequestbodylimit %> + SecRequestBodyNoFilesLimit <%= @secrequestbodynofileslimit %> + SecRequestBodyInMemoryLimit <%= @secrequestbodyinmemorylimit %> + SecRequestBodyLimitAction Reject + SecRule REQBODY_ERROR "!@eq 0" \ + "id:'200001', phase:2,t:none,log,deny,status:400,msg:'Failed to parse request body.',logdata:'%{reqbody_error_msg}',severity:2" + SecRule MULTIPART_STRICT_ERROR "!@eq 0" \ + "id:'200002',phase:2,t:none,log,deny,status:44,msg:'Multipart request body failed strict validation: \ + PE %{REQBODY_PROCESSOR_ERROR}, \ + BQ %{MULTIPART_BOUNDARY_QUOTED}, \ + BW %{MULTIPART_BOUNDARY_WHITESPACE}, \ + DB %{MULTIPART_DATA_BEFORE}, \ + DA %{MULTIPART_DATA_AFTER}, \ + HF %{MULTIPART_HEADER_FOLDING}, \ + LF %{MULTIPART_LF_LINE}, \ + SM %{MULTIPART_MISSING_SEMICOLON}, \ + IQ %{MULTIPART_INVALID_QUOTING}, \ + IP %{MULTIPART_INVALID_PART}, \ + IH %{MULTIPART_INVALID_HEADER_FOLDING}, \ + FL %{MULTIPART_FILE_LIMIT_EXCEEDED}'" + + SecRule &REQUEST_HEADERS:Proxy "@gt 0" "id:1000005,log,deny,msg:'httpoxy denied'" + + + SecRule MULTIPART_UNMATCHED_BOUNDARY "!@eq 0" \ + "id:'200003',phase:2,t:none,log,deny,status:44,msg:'Multipart parser detected a possible unmatched boundary.'" + + SecPcreMatchLimit <%= @secpcrematchlimit %> + SecPcreMatchLimitRecursion <%= @secpcrematchlimitrecursion %> + + SecRule TX:/^MSC_/ "!@streq 0" \ + "id:'200004',phase:2,t:none,deny,msg:'ModSecurity internal error flagged: %{MATCHED_VAR_NAME}'" + + SecResponseBodyAccess Off + SecResponseBodyMimeType text/plain text/html text/xml + SecResponseBodyLimit 524288 + SecResponseBodyLimitAction ProcessPartial + SecDebugLogLevel 0 + SecAuditEngine RelevantOnly + SecAuditLogRelevantStatus "<%= @audit_log_relevant_status %>" + SecAuditLogParts <%= @audit_log_parts %> + SecAuditLogType <%= @audit_log_type %> + <%- if @audit_log_storage_dir -%> + SecAuditLogStorageDir <%= @audit_log_storage_dir %> + <%- end -%> + SecArgumentSeparator & + SecCookieFormat 0 +<%- if scope.lookupvar('::osfamily') == 'Debian' -%> + SecDebugLog <%= @logroot %>/modsec_debug.log + SecAuditLog <%= @logroot %>/modsec_audit.log + SecTmpDir /var/cache/modsecurity + SecDataDir /var/cache/modsecurity + SecUploadDir /var/cache/modsecurity +<%- elsif scope.lookupvar('::osfamily') == 'Suse' -%> + SecDebugLog /var/log/apache2/modsec_debug.log + SecAuditLog /var/log/apache2/modsec_audit.log + SecTmpDir /var/lib/mod_security + SecDataDir /var/lib/mod_security + SecUploadDir /var/lib/mod_security +<% else -%> + SecDebugLog <%= @logroot %>/modsec_debug.log + SecAuditLog <%= @logroot %>/modsec_audit.log + SecTmpDir /var/lib/mod_security + SecDataDir /var/lib/mod_security + SecUploadDir /var/lib/mod_security +<% end -%> + SecUploadKeepFiles Off + + # ModSecurity Core Rules Set configuration +<%- if scope.function_versioncmp([scope.lookupvar('::apache::apache_version'), '2.4']) >= 0 -%> + IncludeOptional <%= @modsec_dir %>/*.conf + IncludeOptional <%= @modsec_dir %>/activated_rules/*.conf +<%- else -%> + Include <%= @modsec_dir %>/*.conf + Include <%= @modsec_dir %>/activated_rules/*.conf +<%- end -%> + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/security_crs.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/security_crs.conf.erb new file mode 100644 index 000000000..641daac3e --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/security_crs.conf.erb @@ -0,0 +1,436 @@ +# --------------------------------------------------------------- +# Core ModSecurity Rule Set ver.2.2.9 +# Copyright (C) 2006-2012 Trustwave All rights reserved. +# +# The OWASP ModSecurity Core Rule Set is distributed under +# Apache Software License (ASL) version 2 +# Please see the enclosed LICENCE file for full details. +# --------------------------------------------------------------- + + +# +# -- [[ Recommended Base Configuration ]] ------------------------------------------------- +# +# The configuration directives/settings in this file are used to control +# the OWASP ModSecurity CRS. These settings do **NOT** configure the main +# ModSecurity settings such as: +# +# - SecRuleEngine +# - SecRequestBodyAccess +# - SecAuditEngine +# - SecDebugLog +# +# You should use the modsecurity.conf-recommended file that comes with the +# ModSecurity source code archive. +# +# Ref: https://github.com/SpiderLabs/ModSecurity/blob/master/modsecurity.conf-recommended +# + + +# +# -- [[ Rule Version ]] ------------------------------------------------------------------- +# +# Rule version data is added to the "Producer" line of Section H of the Audit log: +# +# - Producer: ModSecurity for Apache/2.7.0-rc1 (http://www.modsecurity.org/); OWASP_CRS/2.2.4. +# +# Ref: https://github.com/SpiderLabs/ModSecurity/wiki/Reference-Manual#wiki-SecComponentSignature +# +SecComponentSignature "OWASP_CRS/2.2.9" + + +# +# -- [[ Modes of Operation: Self-Contained vs. Collaborative Detection ]] ----------------- +# +# Each detection rule uses the "block" action which will inherit the SecDefaultAction +# specified below. Your settings here will determine which mode of operation you use. +# +# -- [[ Self-Contained Mode ]] -- +# Rules inherit the "deny" disruptive action. The first rule that matches will block. +# +# -- [[ Collaborative Detection Mode ]] -- +# This is a "delayed blocking" mode of operation where each matching rule will inherit +# the "pass" action and will only contribute to anomaly scores. Transactional blocking +# can be applied +# +# -- [[ Alert Logging Control ]] -- +# You have three options - +# +# - To log to both the Apache error_log and ModSecurity audit_log file use: "log" +# - To log *only* to the ModSecurity audit_log file use: "nolog,auditlog" +# - To log *only* to the Apache error_log file use: "log,noauditlog" +# +# Ref: http://blog.spiderlabs.com/2010/11/advanced-topic-of-the-week-traditional-vs-anomaly-scoring-detection-modes.html +# Ref: https://github.com/SpiderLabs/ModSecurity/wiki/Reference-Manual#wiki-SecDefaultAction +# +SecDefaultAction "phase:1,<%= @_secdefaultaction -%>" +SecDefaultAction "phase:2,<%= @_secdefaultaction -%>" + +# +# -- [[ Collaborative Detection Severity Levels ]] ---------------------------------------- +# +# These are the default scoring points for each severity level. You may +# adjust these to you liking. These settings will be used in macro expansion +# in the rules to increment the anomaly scores when rules match. +# +# These are the default Severity ratings (with anomaly scores) of the individual rules - +# +# - 2: Critical - Anomaly Score of 5. +# Is the highest severity level possible without correlation. It is +# normally generated by the web attack rules (40 level files). +# - 3: Error - Anomaly Score of 4. +# Is generated mostly from outbound leakage rules (50 level files). +# - 4: Warning - Anomaly Score of 3. +# Is generated by malicious client rules (35 level files). +# - 5: Notice - Anomaly Score of 2. +# Is generated by the Protocol policy and anomaly files. +# +SecAction \ + "id:'900001', \ + phase:1, \ + t:none, \ + setvar:tx.critical_anomaly_score=<%= @critical_anomaly_score -%>, \ + setvar:tx.error_anomaly_score=<%= @error_anomaly_score -%>, \ + setvar:tx.warning_anomaly_score=<%= @warning_anomaly_score -%>, \ + setvar:tx.notice_anomaly_score=<%= @notice_anomaly_score -%>, \ + nolog, \ + pass" + + +# +# -- [[ Collaborative Detection Scoring Initialization and Threshold Levels ]] ------------------------------ +# +# These variables are used in macro expansion in the 49 inbound blocking and 59 +# outbound blocking files. +# +# **MUST HAVE** ModSecurity v2.5.12 or higher to use macro expansion in numeric +# operators. If you have an earlier version, edit the 49/59 files directly to +# set the appropriate anomaly score levels. +# +# You should set the score level (rule 900003) to the proper threshold you +# would prefer. If set to "5" it will work similarly to previous Mod CRS rules +# and will create an event in the error_log file if there are any rules that +# match. If you would like to lessen the number of events generated in the +# error_log file, you should increase the anomaly score threshold to something +# like "20". This would only generate an event in the error_log file if there +# are multiple lower severity rule matches or if any 1 higher severity item matches. +# +SecAction \ + "id:'900002', \ + phase:1, \ + t:none, \ + setvar:tx.anomaly_score=0, \ + setvar:tx.sql_injection_score=0, \ + setvar:tx.xss_score=0, \ + setvar:tx.inbound_anomaly_score=0, \ + setvar:tx.outbound_anomaly_score=0, \ + nolog, \ + pass" + + +SecAction \ + "id:'900003', \ + phase:1, \ + t:none, \ + setvar:tx.inbound_anomaly_score_level=<%= @inbound_anomaly_threshold -%>, \ + setvar:tx.outbound_anomaly_score_level=<%= @outbound_anomaly_threshold -%>, \ + nolog, \ + pass" + + +# +# -- [[ Collaborative Detection Blocking ]] ----------------------------------------------- +# +# This is a collaborative detection mode where each rule will increment an overall +# anomaly score for the transaction. The scores are then evaluated in the following files: +# +# Inbound anomaly score - checked in the modsecurity_crs_49_inbound_blocking.conf file +# Outbound anomaly score - checked in the modsecurity_crs_59_outbound_blocking.conf file +# +# If you want to use anomaly scoring mode, then uncomment this line. +# +SecAction \ + "id:'900004', \ + phase:1, \ + t:none, \ + setvar:tx.anomaly_score_blocking=<%= @anomaly_score_blocking -%>, \ + nolog, \ + pass" + + +# +# -- [[ GeoIP Database ]] ----------------------------------------------------------------- +# +# There are some rulesets that need to inspect the GEO data of the REMOTE_ADDR data. +# +# You must first download the MaxMind GeoIP Lite City DB - +# +# http://geolite.maxmind.com/download/geoip/database/GeoLiteCity.dat.gz +# +# You then need to define the proper path for the SecGeoLookupDb directive +# +# Ref: http://blog.spiderlabs.com/2010/10/detecting-malice-with-modsecurity-geolocation-data.html +# Ref: http://blog.spiderlabs.com/2010/11/detecting-malice-with-modsecurity-ip-forensics.html +# +#SecGeoLookupDb /opt/modsecurity/lib/GeoLiteCity.dat + +# +# -- [[ Regression Testing Mode ]] -------------------------------------------------------- +# +# If you are going to run the regression testing mode, you should uncomment the +# following rule. It will enable DetectionOnly mode for the SecRuleEngine and +# will enable Response Header tagging so that the client testing script can see +# which rule IDs have matched. +# +# You must specify the your source IP address where you will be running the tests +# from. +# +#SecRule REMOTE_ADDR "@ipMatch 192.168.1.100" \ + "id:'900005', \ + phase:1, \ + t:none, \ + ctl:ruleEngine=DetectionOnly, \ + setvar:tx.regression_testing=1, \ + nolog, \ + pass" + + +# +# -- [[ HTTP Policy Settings ]] ---------------------------------------------------------- +# +# Set the following policy settings here and they will be propagated to the 23 rules +# file (modsecurity_common_23_request_limits.conf) by using macro expansion. +# If you run into false positives, you can adjust the settings here. +# +# Only the max number of args is uncommented by default as there are a high rate +# of false positives. Uncomment the items you wish to set. +# +# +# -- Maximum number of arguments in request limited +SecAction \ + "id:'900006', \ + phase:1, \ + t:none, \ + setvar:tx.max_num_args=<%= @secrequestmaxnumargs %>, \ + nolog, \ + pass" + +# +# -- Limit argument name length +#SecAction \ + "id:'900007', \ + phase:1, \ + t:none, \ + setvar:tx.arg_name_length=100, \ + nolog, \ + pass" + +# +# -- Limit value name length +#SecAction \ + "id:'900008', \ + phase:1, \ + t:none, \ + setvar:tx.arg_length=400, \ + nolog, \ + pass" + +# +# -- Limit arguments total length +#SecAction \ + "id:'900009', \ + phase:1, \ + t:none, \ + setvar:tx.total_arg_length=64000, \ + nolog, \ + pass" + +# +# -- Individual file size is limited +#SecAction \ + "id:'900010', \ + phase:1, \ + t:none, \ + setvar:tx.max_file_size=1048576, \ + nolog, \ + pass" + +# +# -- Combined file size is limited +#SecAction \ + "id:'900011', \ + phase:1, \ + t:none, \ + setvar:tx.combined_file_sizes=1048576, \ + nolog, \ + pass" + + +# +# Set the following policy settings here and they will be propagated to the 30 rules +# file (modsecurity_crs_30_http_policy.conf) by using macro expansion. +# If you run into false positves, you can adjust the settings here. +# +SecAction \ + "id:'900012', \ + phase:1, \ + t:none, \ + setvar:'tx.allowed_methods=<%= @allowed_methods -%>', \ + setvar:'tx.allowed_request_content_type=<%= @content_types -%>', \ + setvar:'tx.allowed_http_versions=HTTP/0.9 HTTP/1.0 HTTP/1.1', \ + setvar:'tx.restricted_extensions=<%= @restricted_extensions -%>', \ + setvar:'tx.restricted_headers=<%= @restricted_headers -%>', \ + nolog, \ + pass" + + +# +# -- [[ Content Security Policy (CSP) Settings ]] ----------------------------------------- +# +# The purpose of these settings is to send CSP response headers to +# Mozilla FireFox users so that you can enforce how dynamic content +# is used. CSP usage helps to prevent XSS attacks against your users. +# +# Reference Link: +# +# https://developer.mozilla.org/en/Security/CSP +# +# Uncomment this SecAction line if you want use CSP enforcement. +# You need to set the appropriate directives and settings for your site/domain and +# and activate the CSP file in the experimental_rules directory. +# +# Ref: http://blog.spiderlabs.com/2011/04/modsecurity-advanced-topic-of-the-week-integrating-content-security-policy-csp.html +# +#SecAction \ + "id:'900013', \ + phase:1, \ + t:none, \ + setvar:tx.csp_report_only=1, \ + setvar:tx.csp_report_uri=/csp_violation_report, \ + setenv:'csp_policy=allow \'self\'; img-src *.yoursite.com; media-src *.yoursite.com; style-src *.yoursite.com; frame-ancestors *.yoursite.com; script-src *.yoursite.com; report-uri %{tx.csp_report_uri}', \ + nolog, \ + pass" + + +# +# -- [[ Brute Force Protection ]] --------------------------------------------------------- +# +# If you are using the Brute Force Protection rule set, then uncomment the following +# lines and set the following variables: +# - Protected URLs: resources to protect (e.g. login pages) - set to your login page +# - Burst Time Slice Interval: time interval window to monitor for bursts +# - Request Threshold: request # threshold to trigger a burst +# - Block Period: temporary block timeout +# +#SecAction \ + "id:'900014', \ + phase:1, \ + t:none, \ + setvar:'tx.brute_force_protected_urls=#/login.jsp# #/partner_login.php#', \ + setvar:'tx.brute_force_burst_time_slice=60', \ + setvar:'tx.brute_force_counter_threshold=10', \ + setvar:'tx.brute_force_block_timeout=300', \ + nolog, \ + pass" + + +# +# -- [[ DoS Protection ]] ---------------------------------------------------------------- +# +# If you are using the DoS Protection rule set, then uncomment the following +# lines and set the following variables: +# - Burst Time Slice Interval: time interval window to monitor for bursts +# - Request Threshold: request # threshold to trigger a burst +# - Block Period: temporary block timeout +# +SecAction \ + "id:'900015', \ + phase:1, \ + t:none, \ + setvar:'tx.dos_burst_time_slice=60', \ + setvar:'tx.dos_counter_threshold=100', \ + setvar:'tx.dos_block_timeout=600', \ + nolog, \ + pass" + + +# +# -- [[ Check UTF enconding ]] ----------------------------------------------------------- +# +# We only want to apply this check if UTF-8 encoding is actually used by the site, otherwise +# it will result in false positives. +# +# Uncomment this line if your site uses UTF8 encoding +#SecAction \ + "id:'900016', \ + phase:1, \ + t:none, \ + setvar:tx.crs_validate_utf8_encoding=1, \ + nolog, \ + pass" + + +# +# -- [[ Enable XML Body Parsing ]] ------------------------------------------------------- +# +# The rules in this file will trigger the XML parser upon an XML request +# +# Initiate XML Processor in case of xml content-type +# +SecRule REQUEST_HEADERS:Content-Type "text/xml" \ + "id:'900017', \ + phase:1, \ + t:none,t:lowercase, \ + nolog, \ + pass, \ + chain" + SecRule REQBODY_PROCESSOR "!@streq XML" \ + "ctl:requestBodyProcessor=XML" + + +# +# -- [[ Global and IP Collections ]] ----------------------------------------------------- +# +# Create both Global and IP collections for rules to use +# There are some CRS rules that assume that these two collections +# have already been initiated. +# +SecRule REQUEST_HEADERS:User-Agent "^(.*)$" \ + "id:'900018', \ + phase:1, \ + t:none,t:sha1,t:hexEncode, \ + setvar:tx.ua_hash=%{matched_var}, \ + nolog, \ + pass" + + +SecRule REQUEST_HEADERS:x-forwarded-for "^\b(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})\b" \ + "id:'900019', \ + phase:1, \ + t:none, \ + capture, \ + setvar:tx.real_ip=%{tx.1}, \ + nolog, \ + pass" + + +SecRule &TX:REAL_IP "!@eq 0" \ + "id:'900020', \ + phase:1, \ + t:none, \ + initcol:global=global, \ + initcol:ip=%{tx.real_ip}_%{tx.ua_hash}, \ + nolog, \ + pass" + + +SecRule &TX:REAL_IP "@eq 0" \ + "id:'900021', \ + phase:1, \ + t:none, \ + initcol:global=global, \ + initcol:ip=%{remote_addr}_%{tx.ua_hash}, \ + setvar:tx.real_ip=%{remote_addr}, \ + nolog, \ + pass" + diff --git a/modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/security_custom.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/security_custom.conf.erb similarity index 100% rename from modules/services/unix/http/apache_stretch_compatible/apache/templates/mod/security_custom.conf.erb rename to modules/services/unix/http/apache_kali_compatible/apache/templates/mod/security_custom.conf.erb diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/setenvif.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/setenvif.conf.erb new file mode 100644 index 000000000..d31c79fe5 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/setenvif.conf.erb @@ -0,0 +1,34 @@ +# +# The following directives modify normal HTTP response behavior to +# handle known problems with browser implementations. +# +BrowserMatch "Mozilla/2" nokeepalive +BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0 +BrowserMatch "RealPlayer 4\.0" force-response-1.0 +BrowserMatch "Java/1\.0" force-response-1.0 +BrowserMatch "JDK/1\.0" force-response-1.0 + +# +# The following directive disables redirects on non-GET requests for +# a directory that does not include the trailing slash. This fixes a +# problem with Microsoft WebFolders which does not appropriately handle +# redirects for folders with DAV methods. +# Same deal with Apple's DAV filesystem and Gnome VFS support for DAV. +# +BrowserMatch "Microsoft Data Access Internet Publishing Provider" redirect-carefully +BrowserMatch "MS FrontPage" redirect-carefully +BrowserMatch "^WebDrive" redirect-carefully +BrowserMatch "^WebDAVFS/1.[0123]" redirect-carefully +BrowserMatch "^gnome-vfs/1.0" redirect-carefully +BrowserMatch "^gvfs/1" redirect-carefully +BrowserMatch "^XML Spy" redirect-carefully +BrowserMatch "^Dreamweaver-WebDAV-SCM1" redirect-carefully +BrowserMatch " Konqueror/4" redirect-carefully + + + BrowserMatch "MSIE [2-6]" \ + nokeepalive ssl-unclean-shutdown \ + downgrade-1.0 force-response-1.0 + # MSIE 7 and newer should be able to use keepalive + BrowserMatch "MSIE [17-9]" ssl-unclean-shutdown + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/ssl.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/ssl.conf.erb new file mode 100644 index 000000000..94dc7bb82 --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/ssl.conf.erb @@ -0,0 +1,53 @@ + + SSLRandomSeed startup builtin + SSLRandomSeed startup file:/dev/urandom <%= @ssl_random_seed_bytes %> + SSLRandomSeed connect builtin + SSLRandomSeed connect file:/dev/urandom <%= @ssl_random_seed_bytes %> + + AddType application/x-x509-ca-cert .crt + AddType application/x-pkcs7-crl .crl + + SSLPassPhraseDialog <%= @ssl_pass_phrase_dialog %> + SSLSessionCache "shmcb:<%= @ssl_sessioncache %>" + SSLSessionCacheTimeout <%= @ssl_sessioncachetimeout %> + <%- if scope.function_versioncmp([@_apache_version, '2.4']) >= 0 -%> + Mutex <%= @_ssl_mutex %> + <%- if @ssl_compression -%> + SSLCompression <%= scope.call_function('apache::bool2httpd', [@ssl_compression]) %> + <%- end -%> + <%- unless @ssl_sessiontickets.nil? -%> + SSLSessionTickets <%= scope.call_function('apache::bool2httpd', [@ssl_sessiontickets]) %> + <%- end -%> + <%- else -%> + SSLMutex <%= @_ssl_mutex %> + <%- end -%> + SSLCryptoDevice <%= @ssl_cryptodevice %> + SSLHonorCipherOrder <%= scope.call_function('apache::bool2httpd', [@_ssl_honorcipherorder]) %> + <%- if @ssl_cert -%> + SSLCertificateFile "<%= @ssl_cert %>" + <%- end -%> + <%- if @ssl_key -%> + SSLCertificateKeyFile "<%= @ssl_key %>" + <%- end -%> + <%- if @ssl_ca -%> + SSLCACertificateFile "<%= @ssl_ca %>" + <%- end -%> +<% if scope.function_versioncmp([@_apache_version, '2.4']) >= 0 -%> + SSLUseStapling <%= scope.call_function('apache::bool2httpd', [@ssl_stapling]) %> + <%- if not @ssl_stapling_return_errors.nil? -%> + SSLStaplingReturnResponderErrors <%= scope.call_function('apache::bool2httpd', [@ssl_stapling_return_errors]) %> + <%- end -%> + SSLStaplingCache "shmcb:<%= @_stapling_cache %>" +<% end -%> + SSLCipherSuite <%= @ssl_cipher %> + SSLProtocol <%= @ssl_protocol.compact.join(' ') %> +<% if not @ssl_proxy_protocol.empty? -%> + SSLProxyProtocol <%= @ssl_proxy_protocol.compact.join(' ') %> +<% end -%> +<% if @ssl_options -%> + SSLOptions <%= @ssl_options.compact.join(' ') %> +<% end -%> +<%- if @ssl_openssl_conf_cmd -%> + SSLOpenSSLConfCmd <%= @ssl_openssl_conf_cmd %> +<%- end -%> + diff --git a/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/status.conf.erb b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/status.conf.erb new file mode 100644 index 000000000..28cc55b4f --- /dev/null +++ b/modules/services/unix/http/apache_kali_compatible/apache/templates/mod/status.conf.erb @@ -0,0 +1,18 @@ +> + SetHandler server-status + <%-# From Puppet 4.2 up, replace: -%> + <%-# "scope.function_template(["apache/mod/