Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision 61585bec

Von Jan Büren vor 10 Tagen hinzugefügt

  • ID 61585beccd35d8cab1327d3527d4ddd25d1d8975
  • Vorgänger 67e83af0

doku gebaut

Unterschiede anzeigen:

doc/html/ch02s07.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>2.7. Webserver-Konfiguration</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.9.1: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s06.html" title="2.6. Anpassung der PostgreSQL-Konfiguration"><link rel="next" href="ch02s08.html" title="2.8. Der Task-Server"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.7. Webserver-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s06.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s08.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.7. Webserver-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Apache-Konfiguration"></a>2.7. Webserver-Konfiguration</h2></div></div></div><div class="sect2" title="2.7.1. Grundkonfiguration mittels CGI"><div class="titlepage"><div><div><h3 class="title"><a name="d0e1295"></a>2.7.1. Grundkonfiguration mittels CGI</h3></div></div></div><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Für einen deutlichen Performanceschub sorgt die Ausführung
4
          mittels FastCGI/FCGI. Die Einrichtung wird ausführlich im Abschnitt
5
          <a class="xref" href="ch02s07.html#Apache-Konfiguration.FCGI" title="2.7.2. Konfiguration für FastCGI/FCGI">Konfiguration für FastCGI/FCGI</a> beschrieben.</p></td></tr></table></div><p>Der Zugriff auf das Programmverzeichnis muss in der Apache
6
        Webserverkonfigurationsdatei <code class="literal">000-default.conf</code> eingestellt
7
        werden. Fügen Sie den folgenden Abschnitt dieser Datei oder einer
8
        anderen Datei hinzu, die beim Starten des Webservers eingelesen
9
        wird:</p><pre class="programlisting">AliasMatch ^/kivitendo-erp/[^/]+\.pl /var/www/kivitendo-erp/dispatcher.pl
10
Alias /kivitendo-erp/ /var/www/kivitendo-erp/
11

  
12
&lt;Directory /var/www/kivitendo-erp&gt;
13
 AddHandler cgi-script .pl
14
 Options ExecCGI Includes FollowSymlinks
15
&lt;/Directory&gt;
16

  
17
&lt;Directory /var/www/kivitendo-erp/users&gt;
18
 Require all granted
19
&lt;/Directory&gt;</pre><p>Ersetzen Sie dabei die Pfade durch diejenigen, in die Sie vorher
20
        das kivitendo-Archiv entpacket haben.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>Vor den einzelnen Optionen muss bei einigen Distributionen ein
21
          Plus ‘<code class="literal">+</code>’ gesetzt werden.</p><p>Bei einigen Distribution (Ubuntu ab 14.04, Debian ab 8.2) muss
22
          noch explizit das cgi-Modul mittels </p><pre class="programlisting">a2enmod cgi</pre><p>
23
          aktiviert werden.</p></td></tr></table></div><p>Auf einigen Webservern werden manchmal die Grafiken und
24
        Style-Sheets nicht ausgeliefert. In solchen Fällen hat es oft
25
        geholfen, die folgende Option in die Konfiguration aufzunehmen:</p><pre class="programlisting">EnableSendfile Off</pre></div><div class="sect2" title="2.7.2. Konfiguration für FastCGI/FCGI"><div class="titlepage"><div><div><h3 class="title"><a name="Apache-Konfiguration.FCGI"></a>2.7.2. Konfiguration für FastCGI/FCGI</h3></div></div></div><div class="sect3" title="2.7.2.1. Was ist FastCGI?"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.WasIstEs"></a>2.7.2.1. Was ist FastCGI?</h4></div></div></div><p>Direkt aus <a class="ulink" href="http://de.wikipedia.org/wiki/FastCGI" target="_top">Wikipedia</a>
26
          kopiert:</p><p>
27
                  [<span class="citation"> FastCGI ist ein Standard für die Einbindung
28
          externer Software zur Generierung dynamischer Webseiten in einem
29
          Webserver. FastCGI ist vergleichbar zum Common Gateway Interface
30
          (CGI), wurde jedoch entwickelt, um dessen Performance-Probleme zu
31
          umgehen. </span>]
32
               </p></div><div class="sect3" title="2.7.2.2. Warum FastCGI?"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.Warum"></a>2.7.2.2. Warum FastCGI?</h4></div></div></div><p>Perl Programme (wie kivitendo eines ist) werden nicht statisch
33
          kompiliert. Stattdessen werden die Quelldateien bei jedem Start
34
          übersetzt, was bei kurzen Laufzeiten einen Großteil der Laufzeit
35
          ausmacht. Während SQL Ledger einen Großteil der Funktionalität in
36
          einzelne Module kapselt, um immer nur einen kleinen Teil laden zu
37
          müssen, ist die Funktionalität von kivitendo soweit gewachsen, dass
38
          immer mehr Module auf den Rest des Programms zugreifen. Zusätzlich
39
          benutzen wir umfangreiche Bibliotheken um Funktionaltät nicht selber
40
          entwickeln zu müssen, die zusätzliche Ladezeit kosten. All dies
41
          führt dazu dass ein kivitendo Aufruf der Kernmasken mittlerweile
42
          deutlich länger dauert als früher, und dass davon 90% für das Laden
43
          der Module verwendet wird.</p><p>Mit FastCGI werden nun die Module einmal geladen, und danach
44
          wird nur die eigentliche Programmlogik ausgeführt.</p></div><div class="sect3" title="2.7.2.3. Getestete Kombinationen aus Webservern und Plugin"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.WebserverUndPlugin"></a>2.7.2.3. Getestete Kombinationen aus Webservern und Plugin</h4></div></div></div><p>Folgende Kombinationen sind getestet:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Apache 2.4.7 (Ubuntu 14.04.2 LTS) und mod_fcgid.</p></li><li class="listitem"><p>Apache 2.4.18 (Ubuntu 16.04 LTS) und mod_fcgid</p></li><li class="listitem"><p>Apache 2.4.29 (Ubuntu 18.04 LTS) und mod_fcgid</p></li><li class="listitem"><p>Apache 2.4.41 (Ubuntu 20.04 LTS) und mod_fcgid</p></li></ul></div><p>Als Perl Backend wird das Modul <code class="filename">FCGI.pm</code>
45
          verwendet.</p><div class="warning" title="Warnung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warnung]" src="system/docbook-xsl/images/warning.png"></td><th align="left">Warnung</th></tr><tr><td align="left" valign="top"><p>FCGI-Versionen ab 0.69 und bis zu 0.71 inklusive sind extrem
46
            strict in der Behandlung von Unicode, und verweigern bestimmte
47
            Eingaben von kivitendo. Falls es Probleme mit Umlauten in Ihrer
48
            Installation gibt, muss zwingend Version 0.68 oder aber Version
49
            0.72 und neuer eingesetzt werden.</p><p>Mit <a class="ulink" href="http://www.cpan.org" target="_top">CPAN</a> lässt sie
50
            sich die Vorgängerversion wie folgt installieren:</p><pre class="programlisting">force install M/MS/MSTROUT/FCGI-0.68.tar.gz</pre></td></tr></table></div></div><div class="sect3" title="2.7.2.4. Konfiguration des Webservers"><div class="titlepage"><div><div><h4 class="title"><a name="Apache-Konfiguration.FCGI.Konfiguration"></a>2.7.2.4. Konfiguration des Webservers</h4></div></div></div><p>Bevor Sie versuchen, eine kivitendo Installation unter FCGI
51
          laufen zu lassen, empfiehlt es sich die Installation ersteinmal
52
          unter CGI aufzusetzen. FCGI macht es nicht einfach Fehler zu
53
          debuggen die beim ersten aufsetzen auftreten können. Sollte die
54
          Installation schon funktionieren, lesen Sie weiter.</p><p>Zuerst muss das FastCGI-Modul aktiviert werden. Dies kann
55
          unter Debian/Ubuntu z.B. mit folgendem Befehl geschehen:</p><pre class="programlisting">a2enmod fcgid</pre><p>Die Konfiguration für die Verwendung von kivitendo mit FastCGI
56
          erfolgt durch Anpassung der vorhandenen <code class="function">Alias</code>-
57
          und <code class="function">Directory</code>-Direktiven. Dabei wird zwischen
58
          dem Installationspfad von kivitendo im Dateisystem
59
          ("<code class="filename">/path/to/kivitendo-erp</code>") und der URL
60
          unterschieden, unter der kivitendo im Webbrowser erreichbar ist
61
          ("<code class="filename">/url/for/kivitendo-erp</code>").</p><p>Folgender Konfigurationsschnipsel funktioniert mit
62
          mod_fastcgi:</p><pre class="programlisting">AliasMatch ^/url/for/kivitendo-erp/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fcgi
63
Alias       /url/for/kivitendo-erp/          /path/to/kivitendo-erp/
64

  
65
&lt;Directory /path/to/kivitendo-erp&gt;
66
  AllowOverride All
67
  Options ExecCGI Includes FollowSymlinks
68
  Require all granted
69
&lt;/Directory&gt;
70

  
71
&lt;DirectoryMatch /path/to/kivitendo-erp/users&gt;
72
Require all denied
73
&lt;/DirectoryMatch&gt;</pre><div class="warning" title="Warnung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Warning"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Warnung]" src="system/docbook-xsl/images/warning.png"></td><th align="left">Warnung</th></tr><tr><td align="left" valign="top"><p>Wer einen älteren Apache als Version 2.4 im Einsatz hat,
74
            muss entsprechend die Syntax der Directorydirektiven verändert.
75
            Statt</p><pre class="programlisting">Require all granted</pre><p>muß man Folgendes einstellen:</p><pre class="programlisting">
76
  Order Allow,Deny
77
  Allow from All </pre><p>und statt</p><pre class="programlisting">Require all denied</pre><p>muss stehen:</p><pre class="programlisting">
78
  Order Deny,Allow
79
  Deny from All </pre></td></tr></table></div><p>Seit mod_fcgid-Version 2.3.6 gelten sehr kleine Grenzen für
80
          die maximale Größe eines Requests. Diese sollte wie folgt
81
          hochgesetzt werden:</p><pre class="programlisting">FcgidMaxRequestLen 10485760</pre><p>Das Ganze sollte dann so aussehen:</p><pre class="programlisting">AddHandler fcgid-script .fpl
82
AliasMatch ^/url/for/kivitendo-erp/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fpl
3
   <title>2.7. Webserver-Konfiguration</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.9.1: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s06.html" title="2.6. Anpassung der PostgreSQL-Konfiguration"><link rel="next" href="ch02s08.html" title="2.8. Der Task-Server"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.7. Webserver-Konfiguration</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s06.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s08.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.7. Webserver-Konfiguration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Apache-Konfiguration"></a>2.7. Webserver-Konfiguration</h2></div></div></div><p>In diesem Abschnitt wird die Konfiguration des Apache-Webservers
4
      beschrieben. kivitendo wird mittels FastCGI/FCGI ausgeführt.</p><p>Es ist empfehlenswert, SSL einzusetzen, um die Daten per HTTPS
5
      verschlüsselt zwischen Browser und Webserver über das Netzwerk zu
6
      übertragen. Eine Möglichkeit dazu ist das Erstellen eines self-signed
7
      SSL Zertifikates, was unter Debian/Ubuntu durch Installieren des Pakets
8
      <code class="literal">ssl-cert</code> geschehen kann.</p><p>Der Zugriff auf den Installationspfad von kivitendo im Dateisystem
9
      muss in der Apache Webserverkonfigurationsdatei eingestellt werden,
10
      welche beim Starten des Webservers eingelesen wird. Wird SSL/HTTPS
11
      eingesetzt, so ist dies die Datei <code class="literal">default-ssl.conf</code>,
12
      für unverschlüsseltes HTTP ist es die Datei
13
      <code class="literal">000-default.conf</code>.</p><p>Bitte konsultieren Sie die Dokumentation des Apache-Webservers und
14
      Ihres Betriebssystems. Es kann erforderlich sein, das SSL-Modul und die
15
      Webserverkonfigurationsdatei zu aktivieren:</p><pre class="programlisting">a2enmod ssl
16
a2ensite default-ssl</pre><p>Unter Fedora und openSUSE müssen weiterhin in der Firewall die
17
      Ports 80 (HTTP) bzw. 443 (HTTPS) geöffnet werden.</p><div class="sect2" title="2.7.1. Konfiguration für FastCGI/FCGI"><div class="titlepage"><div><div><h3 class="title"><a name="Apache-Konfiguration.FCGI"></a>2.7.1. Konfiguration für FastCGI/FCGI</h3></div></div></div><p>Mit FastCGI wird der kivitendo-Programmcode beim Start des
18
        Webservers einmal geladen und danach wird nur die eigentliche
19
        Programmlogik ausgeführt.</p><p>Zuerst muss das FastCGI-Modul aktiviert werden. Dies kann
20
        unter Debian/Ubuntu z.B. mit folgendem Befehl geschehen:</p><pre class="programlisting">a2enmod fcgid</pre><p>Die Konfiguration für die Verwendung von kivitendo mit FastCGI
21
        erfolgt durch Einfügen von <code class="function">Alias</code>-
22
        und <code class="function">Directory</code>-Direktiven. Dabei wird zwischen
23
        dem Installationspfad von kivitendo im Dateisystem
24
        ("<code class="filename">/path/to/kivitendo-erp</code>") und der URL
25
        unterschieden, unter der kivitendo im Webbrowser erreichbar ist
26
        ("<code class="filename">/url/for/kivitendo-erp</code>").</p><p>Folgender Konfigurationsschnipsel funktioniert mit
27
        mod_fcgid:</p><pre class="programlisting">AliasMatch ^/url/for/kivitendo-erp/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fcgi
83 28
Alias       /url/for/kivitendo-erp/          /path/to/kivitendo-erp/
84 29
FcgidMaxRequestLen 10485760
85 30

  
......
90 35
&lt;/Directory&gt;
91 36

  
92 37
&lt;DirectoryMatch /path/to/kivitendo-erp/users&gt;
93
Require all denied
38
  Require all denied
94 39
&lt;/DirectoryMatch&gt;</pre><p>Hierdurch wird nur ein zentraler Dispatcher gestartet. Alle
95
          Zugriffe auf die einzelnen Scripte werden auf diesen umgeleitet.
96
          Dadurch, dass zur Laufzeit öfter mal Scripte neu geladen werden,
97
          gibt es hier kleine Performance-Einbußen.</p><p>Es ist möglich, die gleiche kivitendo Version parallel unter
98
          CGI und FastCGI zu betreiben. Dafür bleiben die Directorydirektiven
99
          wie oben beschrieben, die URLs werden aber umgeleitet:</p><pre class="programlisting"># Zugriff über CGI
100
Alias       /url/for/kivitendo-erp                /path/to/kivitendo-erp
101

  
102
# Zugriff mit mod_fcgid:
103
AliasMatch ^/url/for/kivitendo-erp-fcgid/[^/]+\.pl /path/to/kivitendo-erp/dispatcher.fpl
104
Alias       /url/for/kivitendo-erp-fcgid/          /path/to/kivitendo-erp/</pre><p>Dann ist unter <code class="filename">/url/for/kivitendo-erp/</code>
105
          die normale Version erreichbar, und unter
106
          <code class="constant">/url/for/kivitendo-erp-fcgid/</code> die
107
          FastCGI-Version.</p></div></div><div class="sect2" title="2.7.3. Authentifizierung mittels HTTP Basic Authentication"><div class="titlepage"><div><div><h3 class="title"><a name="d0e1449"></a>2.7.3. Authentifizierung mittels HTTP Basic Authentication</h3></div></div></div><p>
40
        Zugriffe auf die einzelnen Scripte werden auf diesen umgeleitet.
41
        Dadurch, dass zur Laufzeit öfter mal Scripte neu geladen werden,
42
        gibt es hier kleine Performance-Einbußen.</p><p>Seit mod_fcgid-Version 2.3.6 gelten sehr kleine Grenzen für
43
        die maximale Größe eines Requests. Mit folgender Zeile wird diese
44
        Grenze hochgesetzt:</p><pre class="programlisting">FcgidMaxRequestLen 10485760</pre></div><div class="sect2" title="2.7.2. Authentifizierung mittels HTTP Basic Authentication"><div class="titlepage"><div><div><h3 class="title"><a name="d0e1347"></a>2.7.2. Authentifizierung mittels HTTP Basic Authentication</h3></div></div></div><p>
108 45
        Kivitendo unterstützt, dass Benutzerauthentifizierung über den Webserver mittels des »Basic«-HTTP-Authentifizierungs-Schema erfolgt
109 46
        (siehe <a class="ulink" href="https://tools.ietf.org/html/rfc7617" target="_top">RFC 7617</a>). Dazu ist es aber nötig, dass der dabei vom Client
110 47
        mitgeschickte Header <code class="constant">Authorization</code> vom Webserver an Kivitendo über die Umgebungsvariable
111 48
        <code class="constant">HTTP_AUTHORIZATION</code> weitergegeben wird, was standardmäßig nicht der Fall ist. Für Apache kann dies über die
112 49
        folgende Konfigurationsoption aktiviert werden:
113
       </p><pre class="programlisting">SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1</pre></div><div class="sect2" title="2.7.4. Aktivierung von mod_rewrite/directory_match für git basierte Installationen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e1465"></a>2.7.4. Aktivierung von mod_rewrite/directory_match für git basierte Installationen</h3></div></div></div><p>
50
       </p><pre class="programlisting">SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1</pre></div><div class="sect2" title="2.7.3. Aktivierung von mod_rewrite/directory_match für git basierte Installationen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e1363"></a>2.7.3. Aktivierung von mod_rewrite/directory_match für git basierte Installationen</h3></div></div></div><p>
114 51
        Aufgrund von aktuellen (Mitte 2020) Sicherheitswarnungen für git basierte Webanwendungen ist die mitausgelieferte .htaccess
115 52
        restriktiver geworden und verhindert somit das Auslesen von git basierten Daten.
116 53
        Für debian/ubuntu muss das Modul mod_rewrite einmalig so aktiviert werden:
......
125 62
          Require all denied
126 63
        &lt;/DirectoryMatch&gt;</pre><p>
127 64
       
128
            </p></div><div class="sect2" title="2.7.5. Weitergehende Konfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="d0e1479"></a>2.7.5. Weitergehende Konfiguration</h3></div></div></div><p>Für einen deutlichen Sicherheitsmehrwert sorgt die Ausführung
65
            </p></div><div class="sect2" title="2.7.4. Weitergehende Konfiguration"><div class="titlepage"><div><div><h3 class="title"><a name="d0e1377"></a>2.7.4. Weitergehende Konfiguration</h3></div></div></div><p>Für einen deutlichen Sicherheitsmehrwert sorgt die Ausführung
129 66
        von kivitendo nur über https-verschlüsselten Verbindungen, sowie
130 67
        weiteren Zusatzmassnahmen, wie beispielsweise Basic Authenticate. Die
131 68
        Konfigurationsmöglichkeiten sprengen allerdings den Rahmen dieser
132
        Anleitung, hier ein Hinweis auf einen entsprechenden <a class="ulink" href="http://redmine.kivitendo-premium.de/boards/1/topics/142" target="_top">Foreneintrag
69
        Anleitung, hier ein Hinweis auf einen entsprechenden <a class="ulink" href="https://www.kivitendo.de/redmine/boards/1/topics/142" target="_top">Foreneintrag
133 70
        (Stand Sept. 2015)</a> und einen aktuellen (Stand Mai 2017) <a class="ulink" href="https://mozilla.github.io/server-side-tls/ssl-config-generator/" target="_top">
134
        SSL-Konfigurations-Generator</a>.</p></div><div class="sect2" title="2.7.6. Aktivierung von Apache2 modsecurity"><div class="titlepage"><div><div><h3 class="title"><a name="d0e1490"></a>2.7.6. Aktivierung von Apache2 modsecurity</h3></div></div></div><p>Aufgrund des OpenSource Charakters ist kivitendo nicht "out of the box" sicher.
71
        SSL-Konfigurations-Generator</a>.</p></div><div class="sect2" title="2.7.5. Aktivierung von Apache2 modsecurity"><div class="titlepage"><div><div><h3 class="title"><a name="d0e1388"></a>2.7.5. Aktivierung von Apache2 modsecurity</h3></div></div></div><p>Aufgrund des OpenSource Charakters ist kivitendo nicht "out of the box" sicher.
135 72
  Organisatorisch empfehlen wir hier die enge Zusammenarbeit mit einem kivitendo Partner der auch in der
136 73
Lage ist weiterführende Fragen in Bezug auf Datenschutz und Datensicherheit zu beantworten.
137 74
Unabhängig davon empfehlen wir im Webserver Bereich die Aktivierung und Konfiguration des Moduls modsecurity für den Apache2, damit

Auch abrufbar als: Unified diff