Apache

These states install and configure the webserver of the Apache project.

macro

The macro.sls installs additional apache macro module.

The libapache2-mod-macro package is installed and enabled.

The file /etc/apache2/conf.d/TEMPLATE.VHost is created:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# this file is managed by salt

<Macro VHost $fqdn>
  ServerName $fqdn
  ServerAdmin webmaster@einsle.de
  DocumentRoot /srv/www/$fqdn/content
  ErrorLog /srv/www/$fqdn/logs/error.log
  CustomLog /srv/www/$fqdn/logs/access.log combined
  <IfModule mod_rewrite.c>
    RewriteEngine On
  </IfModule>
  <Directory "/srv/www/$fqdn/content">
    Order deny,allow
    Allow from all
  </Directory>
</Macro>

<Macro VHostTo $fqdn $dest>
  ServerName $fqdn
  ServerAdmin webmaster@einsle.de
  DocumentRoot /srv/www/$fqdn/content
  ErrorLog /srv/www/$fqdn/logs/error.log
  CustomLog /srv/www/$fqdn/logs/access.log combined
  <IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule (.*) $dest$1 [R=301,L]
  </IfModule>
</Macro>

<Macro VHostSSL $fqdn>
  ServerName $fqdn
  ServerAdmin webmaster@einsle.de
  DocumentRoot /srv/www/$fqdn/content
  SSLEngine On
  SSLCertificateFile      /srv/www/$fqdn/ssl/$fqdn.pem
  SSLCertificateKeyFile   /srv/www/$fqdn/ssl/$fqdn.pem
  ErrorLog /srv/www/$fqdn/logs/error.log
  CustomLog /srv/www/$fqdn/logs/access.log combined
  <IfModule mod_rewrite.c>
    RewriteEngine On
  </IfModule>
  <Directory "/srv/www/$fqdn/content">
    Order deny,allow
    Allow from all
  </Directory>
</Macro>

php

The php.sls installs additional files for php5 installation. It includes apache.sls, so apache is installed to.

server

The server.sls installs the needes apache modules and manages a base set of files to secure the Apache installation.

The apache package is intalled and the apache service is managed. An e-mail alias from www-data to root is created.

The file localized-error-pages is created:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
# this file is managed by salt

#
# Customizable error responses come in three flavors:
# 1) plain text 2) local redirects 3) external redirects
#
# Some examples:
#ErrorDocument 500 "The server made a boo boo."
#ErrorDocument 404 /missing.html
#ErrorDocument 404 "/cgi-bin/missing_handler.pl"
#ErrorDocument 402 http://www.example.com/subscription_info.html
#

#
# Putting this all together, we can internationalize error responses.
#
# We use Alias to redirect any /error/HTTP_<error>.html.var response to
# our collection of by-error message multi-language collections.  We use 
# includes to substitute the appropriate text.
#
# You can modify the messages' appearance without changing any of the
# default HTTP_<error>.html.var files by adding the line:
#
#   Alias /error/include/ "/your/include/path/"
#
# which allows you to create your own set of files by starting with the
# /usr/share/apache2/error/include/ files and copying them to /your/include/path/, 
# even on a per-VirtualHost basis.  If you include the Alias in the global server
# context, is has to come _before_ the 'Alias /error/ ...' line.
#
# The default include files will display your Apache version number and your
# ServerAdmin email address regardless of the setting of ServerSignature.
#
# WARNING: The configuration below will NOT work out of the box if you have a
#          SetHandler directive in a <Location /> context somewhere. Adding
#          the following three lines AFTER the <Location /> context should
#          make it work in most cases:
#          <Location /error/>
#             SetHandler none
#          </Location>
#
# The internationalized error documents require mod_alias, mod_include
# and mod_negotiation.  To activate them, uncomment the following 37 lines.

<IfModule mod_negotiation.c>
 <IfModule mod_include.c>
  <IfModule mod_alias.c>

    Alias /error/ "/usr/share/apache2/error/"

    <Directory "/usr/share/apache2/error">
        AllowOverride None
        Options -Indexes IncludesNoExec
        AddOutputFilter Includes html
        AddHandler type-map var
        Order allow,deny
        Allow from all
        LanguagePriority en cs de es fr it nl sv pt-br ro
        ForceLanguagePriority Prefer Fallback
    </Directory>

    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
  </IfModule>
 </IfModule>
</IfModule>

The file /var/www/index.html is removed.

The directory /srv/www is created.

The apache modules include, proxy_http, rewrite, ssl and expires are enabled.

In /etc/apache2/conf.d/security the following settings are changed:

  • ServerTokens is set to Prod
  • ServerSignature is set to Off

Indexing is disabled for mod_alias in /etc/apache2/mods-available/alias.conf

The file /etc/apache2/conf.d/z99-user is created:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
# this file is managed by salt

<Directory />
  Options -Indexes FollowSymLinks
  AllowOverride none
  Order deny,allow
  Deny from all
</Directory>

<Directory /var/www/>
  Options -Indexes MultiViews ExecCGI SymLinksIfOwnerMatch IncludesNoExec
  AllowOverride all
  Order deny,allow
  Deny from all
</Directory>

init

The init.sls includes server, so base apache-server installation is done.