Lawsuit - Wiki - Benutzerbeiträge [de]

Fehlende Pakete nachladen - ubuntu

2026-01-02T19:16:31Z

87.123.95.19:

{{Ubuntu|
*[https://ubuntu.com/16-04 16.04]
|
*[https://wiki.ubuntuusers.de/Perl/ Perl]
|
*[https://innovativeinnovation.github.io/ubuntu-setup/perl/cpan.html Perl-Einrichtung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Weitere benötigte Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fcgid make libarchive-zip-perl libcgi-simple-perl libpdf-api2-perl libimage-magick-perl libyaml-perl libjpeg-dev libjpeg8-dev libjpeg-turbo8-dev zbar-tools libnet-whois-raw-perl libcrypt-rijndael-perl libgd-dev libdatetime-locale-perl libdatetime-timezone-systemv-perl}}

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[3]>install File::Tail cpan[4]>install ODF::lpOD cpan[5]>install URI::Encode cpan[6]>install JSON cpan[7]>install Imager::QRCode cpan[8]>install Imager::File::JPEG cpan[9]>install Image::Scale cpan[10]>install HTTP::Request cpan[11]>install LWP::UserAgent cpan[12]>install LWP::Simple::Post cpan[13]>install List::Util cpan[14]>install MIME::Words cpan[15]>install App::PDFUtils cpan[16]>install Data::ICal cpan[17]>install DateTime::Event::ICal cpan[18]>install Data::ICal::DateTime cpan[19]>install Net::Fritz::Box cpan[20]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[21]>install Spreadsheet::ParseXLSX cpan[22]>quit}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die wie folgt installiert wird
{{Shell|> sudo apt-get install pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo apt-get install exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
Die ''AusweisApp2'' ist bereits standardmäßig im Release enthalten, ansonsten kann man weitere Versionen unter
https://www.openecard.org/en/download/
finden.

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Fehlende Pakete nachladen - ubuntu

2026-01-02T18:55:31Z

87.123.95.19: /* Installation fehlender Perl-Module */

{{Ubuntu|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Perl Perl]
|
*[https://de.opensuse.org/Perl-Entwicklung Perl-Entwicklung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Multimediapaket per 1-Klick-Installation ==

Rufen Sie mit einem Browser die Seite
https://opensuse-community.org/
auf. Klicken Sie auf den zu Ihrer Desktopumgebung passenden Button und bestätigen Sie die Erweiterungen der von Ihnen akzeptierten Software-Repositories.

Sollte der österreichische Server nicht zu erreichen sein, hilft alternativ der Eintrag eines neuen Repositories
{{Shell|> sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.4/' packman}}

== Weitere benötigte RPM-Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fcgid make libarchive-zip-perl libcgi-simple-perl libpdf-api2-perl libimage-magick-perl libyaml-perl libjpeg-dev libjpeg8-dev libjpeg-turbo8-dev zbar-tools libnet-whois-raw-perl libcrypt-rijndael-perl libgd-dev libdatetime-locale-perl libdatetime-timezone-systemv-perl}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die sich hier findet
https://software.opensuse.org/package/pdfsandwich?search_term=pdfsandwich
oder alternativ wie folgt von Hand installiert werden kann:
{{Shell|> sudo zypper addrepo https://download.opensuse.org/repositories/home:/brassh/15.4/ pdfsandwich   sudo zypper in pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[3]>install File::Tail cpan[4]>install ODF::lpOD cpan[5]>install URI::Encode cpan[6]>install JSON cpan[7]>install Imager::QRCode cpan[8]>install Imager::File::JPEG cpan[9]>install Image::Scale cpan[10]>install HTTP::Request cpan[11]>install LWP::UserAgent cpan[12]>install LWP::Simple::Post cpan[13]>install List::Util cpan[14]>install MIME::Words cpan[15]>install App::PDFUtils cpan[16]>install Data::ICal cpan[17]>install DateTime::Event::ICal cpan[18]>install Data::ICal::DateTime cpan[19]>install Net::Fritz::Box cpan[20]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[21]>install Spreadsheet::ParseXLSX cpan[22]>quit}}

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo zypper in fuse-exfat exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
{{Shell|> wget "https://github.com/ecsec/open-ecard/releases/download/1.4.5/open-ecard-app-1.4.5-1.x86_64.rpm" > sudo zypper in open-ecard-app-1.4.5-1.x86_64.rpm
}}
Die aktuellen RPMs finden Sie ansonsten unter
https://www.openecard.org/en/download/pc/

== Unsignierte Pakete ==
Um Updates für selbst heruntergeladene RPM-Pakete automatisch installieren zu können, obwohl die ihm <tt>bin</tt>-Verzeichnis hinterlegten Softwarepakete in der Regel nicht signiert sind, geben sie anschließend nur für dieses Repository folgende Ausnahmeregelung für ''zypper'' ein:
{{Shell|> sudo zypper modifyrepo --gpgcheck-allow-unsigned-package bin}}

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Fehlende Pakete nachladen - ubuntu

2026-01-02T18:36:16Z

87.123.95.19: /* Installation fehlender Perl-Module */

{{Ubuntu|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Perl Perl]
|
*[https://de.opensuse.org/Perl-Entwicklung Perl-Entwicklung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Multimediapaket per 1-Klick-Installation ==

Rufen Sie mit einem Browser die Seite
https://opensuse-community.org/
auf. Klicken Sie auf den zu Ihrer Desktopumgebung passenden Button und bestätigen Sie die Erweiterungen der von Ihnen akzeptierten Software-Repositories.

Sollte der österreichische Server nicht zu erreichen sein, hilft alternativ der Eintrag eines neuen Repositories
{{Shell|> sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.4/' packman}}

== Weitere benötigte RPM-Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fcgid make libarchive-zip-perl libcgi-simple-perl libpdf-api2-perl libimage-magick-perl libyaml-perl libjpeg-dev libjpeg8-dev libjpeg-turbo8-dev zbar-tools libnet-whois-raw-perl libcrypt-rijndael-perl libgd-dev libdatetime-locale-perl libdatetime-timezone-systemv-perl}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die sich hier findet
https://software.opensuse.org/package/pdfsandwich?search_term=pdfsandwich
oder alternativ wie folgt von Hand installiert werden kann:
{{Shell|> sudo zypper addrepo https://download.opensuse.org/repositories/home:/brassh/15.4/ pdfsandwich   sudo zypper in pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[2]>install File::Tail cpan[3]>install ODF::lpOD cpan[4]>install URI::Encode cpan[5]>install JSON cpan[6]>install Imager::QRCode cpan[7]>install Imager::File::JPEG cpan[8]>install Image::Scale cpan[9]>install HTTP::Request cpan[10]>install LWP::UserAgent cpan[11]>install LWP::Simple::Post cpan[12]>install List::Util cpan[13]>install MIME::Words cpan[14]>install App::PDFUtils cpan[15]>install Data::ICal cpan[16]>install DateTime::Event::ICal cpan[17]>install Data::ICal::DateTime cpan[18]>install Net::Fritz::Box cpan[19]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[20]>install Spreadsheet::ParseXLSX cpan[21]>quit}}

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo zypper in fuse-exfat exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
{{Shell|> wget "https://github.com/ecsec/open-ecard/releases/download/1.4.5/open-ecard-app-1.4.5-1.x86_64.rpm" > sudo zypper in open-ecard-app-1.4.5-1.x86_64.rpm
}}
Die aktuellen RPMs finden Sie ansonsten unter
https://www.openecard.org/en/download/pc/

== Unsignierte Pakete ==
Um Updates für selbst heruntergeladene RPM-Pakete automatisch installieren zu können, obwohl die ihm <tt>bin</tt>-Verzeichnis hinterlegten Softwarepakete in der Regel nicht signiert sind, geben sie anschließend nur für dieses Repository folgende Ausnahmeregelung für ''zypper'' ein:
{{Shell|> sudo zypper modifyrepo --gpgcheck-allow-unsigned-package bin}}

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Fehlende Pakete nachladen - ubuntu

2026-01-02T18:35:36Z

87.123.95.19: /* Installation fehlender Perl-Module */

{{Ubuntu|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Perl Perl]
|
*[https://de.opensuse.org/Perl-Entwicklung Perl-Entwicklung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Multimediapaket per 1-Klick-Installation ==

Rufen Sie mit einem Browser die Seite
https://opensuse-community.org/
auf. Klicken Sie auf den zu Ihrer Desktopumgebung passenden Button und bestätigen Sie die Erweiterungen der von Ihnen akzeptierten Software-Repositories.

Sollte der österreichische Server nicht zu erreichen sein, hilft alternativ der Eintrag eines neuen Repositories
{{Shell|> sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.4/' packman}}

== Weitere benötigte RPM-Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fcgid make libarchive-zip-perl libcgi-simple-perl libpdf-api2-perl libimage-magick-perl libyaml-perl libjpeg62-dev libjpeg-dev libjpeg8-dev libjpeg-turbo8-dev zbar-tools libnet-whois-raw-perl libcrypt-rijndael-perl libgd-dev libdatetime-locale-perl libdatetime-timezone-systemv-perl}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die sich hier findet
https://software.opensuse.org/package/pdfsandwich?search_term=pdfsandwich
oder alternativ wie folgt von Hand installiert werden kann:
{{Shell|> sudo zypper addrepo https://download.opensuse.org/repositories/home:/brassh/15.4/ pdfsandwich   sudo zypper in pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[2]>install File::Tail cpan[3]>install ODF::lpOD cpan[4]>install URI::Encode cpan[5]>install JSON cpan[6]>install Imager::QRCode cpan[7]>install Imager::File::JPEG cpan[8]>install Image::Scale cpan[9]>install HTTP::Request cpan[10]>install LWP::UserAgent cpan[11]>install LWP::Simple::Post cpan[12]>install List::Util cpan[13]>install MIME::Words cpan[14]>install App::PDFUtils cpan[15]>install Data::ICal cpan[16]>install DateTime::Event::ICal cpan[17]>install Data::ICal::DateTime cpan[18]>install Net::Fritz::Box cpan[19]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[20]>install Spreadsheet::ParseXLSX cpan[21]>quit}}

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo zypper in fuse-exfat exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
{{Shell|> wget "https://github.com/ecsec/open-ecard/releases/download/1.4.5/open-ecard-app-1.4.5-1.x86_64.rpm" > sudo zypper in open-ecard-app-1.4.5-1.x86_64.rpm
}}
Die aktuellen RPMs finden Sie ansonsten unter
https://www.openecard.org/en/download/pc/

== Unsignierte Pakete ==
Um Updates für selbst heruntergeladene RPM-Pakete automatisch installieren zu können, obwohl die ihm <tt>bin</tt>-Verzeichnis hinterlegten Softwarepakete in der Regel nicht signiert sind, geben sie anschließend nur für dieses Repository folgende Ausnahmeregelung für ''zypper'' ein:
{{Shell|> sudo zypper modifyrepo --gpgcheck-allow-unsigned-package bin}}

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Fehlende Pakete nachladen - ubuntu

2026-01-02T18:34:34Z

87.123.95.19: /* Installation fehlender Perl-Module */

{{Ubuntu|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Perl Perl]
|
*[https://de.opensuse.org/Perl-Entwicklung Perl-Entwicklung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Multimediapaket per 1-Klick-Installation ==

Rufen Sie mit einem Browser die Seite
https://opensuse-community.org/
auf. Klicken Sie auf den zu Ihrer Desktopumgebung passenden Button und bestätigen Sie die Erweiterungen der von Ihnen akzeptierten Software-Repositories.

Sollte der österreichische Server nicht zu erreichen sein, hilft alternativ der Eintrag eines neuen Repositories
{{Shell|> sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.4/' packman}}

== Weitere benötigte RPM-Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fcgid make libarchive-zip-perl libcgi-simple-perl libpdf-api2-perl libimage-magick-perl libyaml-perl libjpeg62-dev libjpeg-dev libjpeg8-dev libjpeg-turbo8-dev zbarimg libnet-whois-raw-perl libcrypt-rijndael-perl libgd-dev libdatetime-locale-perl libdatetime-timezone-systemv-perl}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die sich hier findet
https://software.opensuse.org/package/pdfsandwich?search_term=pdfsandwich
oder alternativ wie folgt von Hand installiert werden kann:
{{Shell|> sudo zypper addrepo https://download.opensuse.org/repositories/home:/brassh/15.4/ pdfsandwich   sudo zypper in pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[2]>install File::Tail cpan[3]>install ODF::lpOD cpan[4]>install URI::Encode cpan[5]>install JSON cpan[6]>install Imager::QRCode cpan[7]>install Imager::File::JPEG cpan[8]>install Image::Scale cpan[9]>install HTTP::Request cpan[10]>install LWP::UserAgent cpan[11]>install LWP::Simple::Post cpan[12]>install List::Util cpan[13]>install MIME::Words cpan[14]>install App::PDFUtils cpan[15]>install Data::ICal cpan[16]>install DateTime::Event::ICal cpan[17]>install Data::ICal::DateTime cpan[18]>install Net::Fritz::Box cpan[19]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[20]>install Spreadsheet::ParseXLSX cpan[21]>quit}}

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo zypper in fuse-exfat exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
{{Shell|> wget "https://github.com/ecsec/open-ecard/releases/download/1.4.5/open-ecard-app-1.4.5-1.x86_64.rpm" > sudo zypper in open-ecard-app-1.4.5-1.x86_64.rpm
}}
Die aktuellen RPMs finden Sie ansonsten unter
https://www.openecard.org/en/download/pc/

== Unsignierte Pakete ==
Um Updates für selbst heruntergeladene RPM-Pakete automatisch installieren zu können, obwohl die ihm <tt>bin</tt>-Verzeichnis hinterlegten Softwarepakete in der Regel nicht signiert sind, geben sie anschließend nur für dieses Repository folgende Ausnahmeregelung für ''zypper'' ein:
{{Shell|> sudo zypper modifyrepo --gpgcheck-allow-unsigned-package bin}}

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Fehlende Pakete nachladen - ubuntu

2026-01-02T18:33:13Z

87.123.95.19: /* Installation fehlender Perl-Module */

{{Ubuntu|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Perl Perl]
|
*[https://de.opensuse.org/Perl-Entwicklung Perl-Entwicklung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Multimediapaket per 1-Klick-Installation ==

Rufen Sie mit einem Browser die Seite
https://opensuse-community.org/
auf. Klicken Sie auf den zu Ihrer Desktopumgebung passenden Button und bestätigen Sie die Erweiterungen der von Ihnen akzeptierten Software-Repositories.

Sollte der österreichische Server nicht zu erreichen sein, hilft alternativ der Eintrag eines neuen Repositories
{{Shell|> sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.4/' packman}}

== Weitere benötigte RPM-Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fcgid make libarchive-zip-perl libcgi-simple-perl libpdf-api2-perl libimage-magick-perl libyaml-perl libjpeg62-dev libjpeg-dev libjpeg8-dev libjpeg-turbo8-dev zbar libnet-whois-raw-perl libcrypt-rijndael-perl libgd-dev libdatetime-locale-perl libdatetime-timezone-systemv-perl}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die sich hier findet
https://software.opensuse.org/package/pdfsandwich?search_term=pdfsandwich
oder alternativ wie folgt von Hand installiert werden kann:
{{Shell|> sudo zypper addrepo https://download.opensuse.org/repositories/home:/brassh/15.4/ pdfsandwich   sudo zypper in pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[2]>install File::Tail cpan[3]>install ODF::lpOD cpan[4]>install URI::Encode cpan[5]>install JSON cpan[6]>install Imager::QRCode cpan[7]>install Imager::File::JPEG cpan[8]>install Image::Scale cpan[9]>install HTTP::Request cpan[10]>install LWP::UserAgent cpan[11]>install LWP::Simple::Post cpan[12]>install List::Util cpan[13]>install MIME::Words cpan[14]>install App::PDFUtils cpan[15]>install Data::ICal cpan[16]>install DateTime::Event::ICal cpan[17]>install Data::ICal::DateTime cpan[18]>install Net::Fritz::Box cpan[19]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[20]>install Spreadsheet::ParseXLSX cpan[21]>quit}}

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo zypper in fuse-exfat exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
{{Shell|> wget "https://github.com/ecsec/open-ecard/releases/download/1.4.5/open-ecard-app-1.4.5-1.x86_64.rpm" > sudo zypper in open-ecard-app-1.4.5-1.x86_64.rpm
}}
Die aktuellen RPMs finden Sie ansonsten unter
https://www.openecard.org/en/download/pc/

== Unsignierte Pakete ==
Um Updates für selbst heruntergeladene RPM-Pakete automatisch installieren zu können, obwohl die ihm <tt>bin</tt>-Verzeichnis hinterlegten Softwarepakete in der Regel nicht signiert sind, geben sie anschließend nur für dieses Repository folgende Ausnahmeregelung für ''zypper'' ein:
{{Shell|> sudo zypper modifyrepo --gpgcheck-allow-unsigned-package bin}}

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Fehlende Pakete nachladen - ubuntu

2026-01-02T18:30:28Z

87.123.95.19: /* Installation fehlender Perl-Module */

{{Ubuntu|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Perl Perl]
|
*[https://de.opensuse.org/Perl-Entwicklung Perl-Entwicklung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Multimediapaket per 1-Klick-Installation ==

Rufen Sie mit einem Browser die Seite
https://opensuse-community.org/
auf. Klicken Sie auf den zu Ihrer Desktopumgebung passenden Button und bestätigen Sie die Erweiterungen der von Ihnen akzeptierten Software-Repositories.

Sollte der österreichische Server nicht zu erreichen sein, hilft alternativ der Eintrag eines neuen Repositories
{{Shell|> sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.4/' packman}}

== Weitere benötigte RPM-Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fcgid make libarchive-zip-perl libcgi-simple-perl libpdf-api2-perl libimage-magick-perl libyaml-perl libjpeg-turbo libjpeg8-devel zbar libnet-whois-raw-perl libcrypt-rijndael-perl libgd-dev libdatetime-locale-perl libdatetime-timezone-systemv-perl}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die sich hier findet
https://software.opensuse.org/package/pdfsandwich?search_term=pdfsandwich
oder alternativ wie folgt von Hand installiert werden kann:
{{Shell|> sudo zypper addrepo https://download.opensuse.org/repositories/home:/brassh/15.4/ pdfsandwich   sudo zypper in pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[2]>install File::Tail cpan[3]>install ODF::lpOD cpan[4]>install URI::Encode cpan[5]>install JSON cpan[6]>install Imager::QRCode cpan[7]>install Imager::File::JPEG cpan[8]>install Image::Scale cpan[9]>install HTTP::Request cpan[10]>install LWP::UserAgent cpan[11]>install LWP::Simple::Post cpan[12]>install List::Util cpan[13]>install MIME::Words cpan[14]>install App::PDFUtils cpan[15]>install Data::ICal cpan[16]>install DateTime::Event::ICal cpan[17]>install Data::ICal::DateTime cpan[18]>install Net::Fritz::Box cpan[19]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[20]>install Spreadsheet::ParseXLSX cpan[21]>quit}}

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo zypper in fuse-exfat exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
{{Shell|> wget "https://github.com/ecsec/open-ecard/releases/download/1.4.5/open-ecard-app-1.4.5-1.x86_64.rpm" > sudo zypper in open-ecard-app-1.4.5-1.x86_64.rpm
}}
Die aktuellen RPMs finden Sie ansonsten unter
https://www.openecard.org/en/download/pc/

== Unsignierte Pakete ==
Um Updates für selbst heruntergeladene RPM-Pakete automatisch installieren zu können, obwohl die ihm <tt>bin</tt>-Verzeichnis hinterlegten Softwarepakete in der Regel nicht signiert sind, geben sie anschließend nur für dieses Repository folgende Ausnahmeregelung für ''zypper'' ein:
{{Shell|> sudo zypper modifyrepo --gpgcheck-allow-unsigned-package bin}}

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Fehlende Pakete nachladen - ubuntu

2026-01-02T18:28:59Z

87.123.95.19: /* Installation fehlender Perl-Module */

{{Ubuntu|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Perl Perl]
|
*[https://de.opensuse.org/Perl-Entwicklung Perl-Entwicklung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Multimediapaket per 1-Klick-Installation ==

Rufen Sie mit einem Browser die Seite
https://opensuse-community.org/
auf. Klicken Sie auf den zu Ihrer Desktopumgebung passenden Button und bestätigen Sie die Erweiterungen der von Ihnen akzeptierten Software-Repositories.

Sollte der österreichische Server nicht zu erreichen sein, hilft alternativ der Eintrag eines neuen Repositories
{{Shell|> sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.4/' packman}}

== Weitere benötigte RPM-Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fcgid make libarchive-zip-perl libcgi-simple-perl perl-PDF-API2 libimage-magick-perl libyaml-perl libjpeg-turbo libjpeg8-devel zbar libnet-whois-raw-perl libcrypt-rijndael-perl libgd-dev libdatetime-locale-perl libdatetime-timezone-systemv-perl}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die sich hier findet
https://software.opensuse.org/package/pdfsandwich?search_term=pdfsandwich
oder alternativ wie folgt von Hand installiert werden kann:
{{Shell|> sudo zypper addrepo https://download.opensuse.org/repositories/home:/brassh/15.4/ pdfsandwich   sudo zypper in pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[2]>install File::Tail cpan[3]>install ODF::lpOD cpan[4]>install URI::Encode cpan[5]>install JSON cpan[6]>install Imager::QRCode cpan[7]>install Imager::File::JPEG cpan[8]>install Image::Scale cpan[9]>install HTTP::Request cpan[10]>install LWP::UserAgent cpan[11]>install LWP::Simple::Post cpan[12]>install List::Util cpan[13]>install MIME::Words cpan[14]>install App::PDFUtils cpan[15]>install Data::ICal cpan[16]>install DateTime::Event::ICal cpan[17]>install Data::ICal::DateTime cpan[18]>install Net::Fritz::Box cpan[19]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[20]>install Spreadsheet::ParseXLSX cpan[21]>quit}}

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo zypper in fuse-exfat exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
{{Shell|> wget "https://github.com/ecsec/open-ecard/releases/download/1.4.5/open-ecard-app-1.4.5-1.x86_64.rpm" > sudo zypper in open-ecard-app-1.4.5-1.x86_64.rpm
}}
Die aktuellen RPMs finden Sie ansonsten unter
https://www.openecard.org/en/download/pc/

== Unsignierte Pakete ==
Um Updates für selbst heruntergeladene RPM-Pakete automatisch installieren zu können, obwohl die ihm <tt>bin</tt>-Verzeichnis hinterlegten Softwarepakete in der Regel nicht signiert sind, geben sie anschließend nur für dieses Repository folgende Ausnahmeregelung für ''zypper'' ein:
{{Shell|> sudo zypper modifyrepo --gpgcheck-allow-unsigned-package bin}}

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Fehlende Pakete nachladen - ubuntu

2026-01-02T18:16:26Z

87.123.95.19: /* Installation fehlender Perl-Module */

{{Ubuntu|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Perl Perl]
|
*[https://de.opensuse.org/Perl-Entwicklung Perl-Entwicklung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Multimediapaket per 1-Klick-Installation ==

Rufen Sie mit einem Browser die Seite
https://opensuse-community.org/
auf. Klicken Sie auf den zu Ihrer Desktopumgebung passenden Button und bestätigen Sie die Erweiterungen der von Ihnen akzeptierten Software-Repositories.

Sollte der österreichische Server nicht zu erreichen sein, hilft alternativ der Eintrag eines neuen Repositories
{{Shell|> sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.4/' packman}}

== Weitere benötigte RPM-Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fcgid make perl-Archive-Zip perl-CGI-Simple perl-File-Tail perl-PDF-API2 perl-PerlMagick perl-YAML libjpeg-turbo libjpeg8-devel zbar perl-Net-Whois-Raw perl-Crypt-Rijndael perl-GD perl-DateTime-Locale perl-DateTime-TimeZone}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die sich hier findet
https://software.opensuse.org/package/pdfsandwich?search_term=pdfsandwich
oder alternativ wie folgt von Hand installiert werden kann:
{{Shell|> sudo zypper addrepo https://download.opensuse.org/repositories/home:/brassh/15.4/ pdfsandwich   sudo zypper in pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[3]>install ODF::lpOD cpan[4]>install URI::Encode cpan[5]>install JSON cpan[6]>install Imager::QRCode cpan[7]>install Imager::File::JPEG cpan[8]>install Image::Scale cpan[9]>install HTTP::Request cpan[10]>install LWP::UserAgent cpan[11]>install LWP::Simple::Post cpan[12]>install List::Util cpan[13]>install MIME::Words cpan[14]>install App::PDFUtils cpan[15]>install Data::ICal cpan[16]>install DateTime::Event::ICal cpan[17]>install Data::ICal::DateTime cpan[18]>install Net::Fritz::Box cpan[19]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[20]>install Spreadsheet::ParseXLSX cpan[21]>quit}}

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo zypper in fuse-exfat exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
{{Shell|> wget "https://github.com/ecsec/open-ecard/releases/download/1.4.5/open-ecard-app-1.4.5-1.x86_64.rpm" > sudo zypper in open-ecard-app-1.4.5-1.x86_64.rpm
}}
Die aktuellen RPMs finden Sie ansonsten unter
https://www.openecard.org/en/download/pc/

== Unsignierte Pakete ==
Um Updates für selbst heruntergeladene RPM-Pakete automatisch installieren zu können, obwohl die ihm <tt>bin</tt>-Verzeichnis hinterlegten Softwarepakete in der Regel nicht signiert sind, geben sie anschließend nur für dieses Repository folgende Ausnahmeregelung für ''zypper'' ein:
{{Shell|> sudo zypper modifyrepo --gpgcheck-allow-unsigned-package bin}}

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T17:46:26Z

87.123.95.19: /* Vergabe einer Domain für den Rechner mit den Lawsuit-Daten */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-available/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen. Damit sie von Apache verwendet werden, müssen sie zudem vom Verzeichnis <tt>/etc/apache2/sites-enabled/</tt> verlinkt sein.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell|> sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-availabel/}}

und aktivieren sie durch Verlinkung auf <tt>/etc/apache2/sites-enabled</tt>:
{{Shell | > sudo a2ensite lawsuit-httpd.conf}}

Abschließend muss Apache mit der neuen Konfiguration geladen werden:
{{Shell | > sudo systemctl reload apache2}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts vorzunehmen, editieren Sie die Datei <tt>/etc/apache2/apache2.conf</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien finden sich dort ausführliche die Kommentierungen. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>etc/apache2/sites-enabled/000-default.conf</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Im Networkmanager ⚙ > Kabelgebuden ⚙ fügen Sie unter der Zeile "localhost" folgende Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
Zur besseren Übersichtlichkeit sollte ein mächtiges Textverarbeitungsprogramm wie ''kate'' verwendet werden.
{{Shell |>sudo apt install kate}}
Erzeugen Sie dann Unterverzeichnisse und legen eine Konfigurationsdatei an:
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nicht optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/sites_enabled/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen vom Browser angenommen werden, muss das Zertifkat fort eingetragen werden.
Gehen Sie dazu unter Firefox in das Menu und wählen die Unterpunkte > Datenschutz & Sicherheit oder rufen Sie den Unterpunkt direkt mit
about:preferences#privacy
auf. Gehen Sie zum Unterpunkt <tt>Sicherheit > Zertifikate</tt> und klicken Sie ''Zeertifikate anzeigen...'' an. Dort tragen Sie unter dem Reiter ''Server'' das eigene Zertifikate ein, indem Sie das eigene auf der Seite
https://k1
als Ausnahme bestätigen.
Laden Sie dazu das Zertifikat von der Seite ''https://k1'' herunter und bestätigen Sie mit dem Auswahlästchen, dass es sich um eine dauerhaft zu speichernde Ausnahme handelt. Drücken Sie den Button ''Sicherheitsausnahme bestätigen''.
[[Datei:Zertifikat_eintragen.png|thumb|600px|left|Importieren des Zertifikate als dauerhafte Sicherheitsausnahme]]
 

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten der Firewall unter Ubuntu]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T17:46:10Z

87.123.95.19: /* Vergabe einer Domain für den Rechner mit den Lawsuit-Daten */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-available/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen. Damit sie von Apache verwendet werden, müssen sie zudem vom Verzeichnis <tt>/etc/apache2/sites-enabled/</tt> verlinkt sein.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell|> sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-availabel/}}

und aktivieren sie durch Verlinkung auf <tt>/etc/apache2/sites-enabled</tt>:
{{Shell | > sudo a2ensite lawsuit-httpd.conf}}

Abschließend muss Apache mit der neuen Konfiguration geladen werden:
{{Shell | > sudo systemctl reload apache2}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts vorzunehmen, editieren Sie die Datei <tt>/etc/apache2/apache2.conf</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien finden sich dort ausführliche die Kommentierungen. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>etc/apache2/sites-enabled/000-default.conf</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Im Networkmanager ⚙ > Kabelgebuden ⚙ fügen Sie unter der Zeile "localhost" folgende Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
Zur besseren Übersichtlichkeit sollte ein mächtiges Textverarbeitungsprogramm wie ''kate'' verwendet werden.
{{Shell |>sudo apt install kate}}
Erzeugen Sie dann Unterverzeichnisse und legen eine Konfigurationsdatei an:
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nicht optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/sites_enabled/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen vom Browser angenommen werden, muss das Zertifkat fort eingetragen werden.
Gehen Sie dazu unter Firefox in das Menu und wählen die Unterpunkte > Datenschutz & Sicherheit oder rufen Sie den Unterpunkt direkt mit
about:preferences#privacy
auf. Gehen Sie zum Unterpunkt <tt>Sicherheit > Zertifikate</tt> und klicken Sie ''Zeertifikate anzeigen...'' an. Dort tragen Sie unter dem Reiter ''Server'' das eigene Zertifikate ein, indem Sie das eigene auf der Seite
https://k1
als Ausnahme bestätigen.
Laden Sie dazu das Zertifikat von der Seite ''https://k1'' herunter und bestätigen Sie mit dem Auswahlästchen, dass es sich um eine dauerhaft zu speichernde Ausnahme handelt. Drücken Sie den Button ''Sicherheitsausnahme bestätigen''.
[[Datei:Zertifikat_eintragen.png|thumb|600px|left|Importieren des Zertifikate als dauerhafte Sicherheitsausnahme]]
 

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten der Firewall unter Ubuntu]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T17:45:50Z

87.123.95.19: /* Vergabe einer Domain für den Rechner mit den Lawsuit-Daten */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-available/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen. Damit sie von Apache verwendet werden, müssen sie zudem vom Verzeichnis <tt>/etc/apache2/sites-enabled/</tt> verlinkt sein.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell|> sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-availabel/}}

und aktivieren sie durch Verlinkung auf <tt>/etc/apache2/sites-enabled</tt>:
{{Shell | > sudo a2ensite lawsuit-httpd.conf}}

Abschließend muss Apache mit der neuen Konfiguration geladen werden:
{{Shell | > sudo systemctl reload apache2}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts vorzunehmen, editieren Sie die Datei <tt>/etc/apache2/apache2.conf</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien finden sich dort ausführliche die Kommentierungen. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>etc/apache2/sites-enabled/000-default.conf</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Im Networkmanager ⚙ > Kabelgebuden ⚙ fügen Sie unter der Zeile "localhost" folgende Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
Zur besseren Übersichtlichkeit sollte ein mächtiges Textverarbeitungsprogramm wie ''kate'' verwendet werden.
{{Shell |>sudo apt install kate}}
Erzeugen Sie dann Unterverzeichnisse und legen eine Konfigurationsdatei an:
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nicht optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/sites_enabled/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen vom Browser angenommen werden, muss das Zertifkat fort eingetragen werden.
Gehen Sie dazu unter Firefox in das Menu und wählen die Unterpunkte > Datenschutz & Sicherheit oder rufen Sie den Unterpunkt direkt mit
about:preferences#privacy
auf. Gehen Sie zum Unterpunkt <tt>Sicherheit > Zertifikate</tt> und klicken Sie ''Zeertifikate anzeigen...'' an. Dort tragen Sie unter dem Reiter ''Server'' das eigene Zertifikate ein, indem Sie das eigene auf der Seite
https://k1
als Ausnahme bestätigen.
Laden Sie dazu das Zertifikat von der Seite ''https://k1'' herunter und bestätigen Sie mit dem Auswahlästchen, dass es sich um eine dauerhaft zu speichernde Ausnahme handelt. Drücken Sie den Button ''Sicherheitsausnahme bestätigen''.
[[Datei:Zertifikat_eintragen.png|thumb|600px|left|Importieren des Zertifikate als dauerhafte Sicherheitsausnahme]]
 

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten der Firewall unter Ubuntu]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T17:44:14Z

87.123.95.19: /* Vergabe einer Domain für den Rechner mit den Lawsuit-Daten */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-available/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen. Damit sie von Apache verwendet werden, müssen sie zudem vom Verzeichnis <tt>/etc/apache2/sites-enabled/</tt> verlinkt sein.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell|> sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-availabel/}}

und aktivieren sie durch Verlinkung auf <tt>/etc/apache2/sites-enabled</tt>:
{{Shell | > sudo a2ensite lawsuit-httpd.conf}}

Abschließend muss Apache mit der neuen Konfiguration geladen werden:
{{Shell | > sudo systemctl reload apache2}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts vorzunehmen, editieren Sie die Datei <tt>/etc/apache2/apache2.conf</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien finden sich dort ausführliche die Kommentierungen. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>etc/apache2/sites-enabled/000-default.conf</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Im Networkmanager ⚙ > Kabelgebuden ⚙ fügen Sie unter der Zeile "localhost" folgende Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
Zur besseren Übersichtlichkeit sollte ein mächtiges Textverarbeitungsprogramm wie ''kate'' verwendet werden.
{{Shell |>sudo apt install kate}}
Erzeugen Sie dann Unterverzeichnisse und legen eine Konfigurationsdatei an:
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nicht optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/sites_enabled/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen vom Browser angenommen werden, muss das Zertifkat fort eingetragen werden.
Gehen Sie dazu unter Firefox in das Menu und wählen die Unterpunkte > Datenschutz & Sicherheit oder rufen Sie den Unterpunkt direkt mit
about:preferences#privacy
auf. Gehen Sie zum Unterpunkt <tt>Sicherheit > Zertifikate</tt> und klicken Sie ''Zeertifikate anzeigen...'' an. Dort tragen Sie unter dem Reiter ''Server'' das eigene Zertifikate ein, indem Sie das eigene auf der Seite
https://k1
als Ausnahme bestätigen.
Laden Sie dazu das Zertifikat von der Seite ''https://k1'' herunter und bestätigen Sie mit dem Auswahlästchen, dass es sich um eine dauerhaft zu speichernde Ausnahme handelt. Drücken Sie den Button ''Sicherheitsausnahme bestätigen''.
[[Datei:Zertifikat_eintragen.png|thumb|600px|left|Importieren des Zertifikate als dauerhafte Sicherheitsausnahme]]
 

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten der Firewall unter Ubuntu]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T16:43:17Z

87.123.95.19: /* Einstellungen für Lawsuit */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-available/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen. Damit sie von Apache verwendet werden, müssen sie zudem vom Verzeichnis <tt>/etc/apache2/sites-enabled/</tt> verlinkt sein.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell|> sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-availabel/}}

und aktivieren sie durch Verlinkung auf <tt>/etc/apache2/sites-enabled</tt>:
{{Shell | > sudo a2ensite lawsuit-httpd.conf}}

Abschließend muss Apache mit der neuen Konfiguration geladen werden:
{{Shell | > sudo systemctl reload apache2}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts vorzunehmen, editieren Sie die Datei <tt>/etc/apache2/apache2.conf</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien finden sich dort ausführliche die Kommentierungen. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>etc/apache2/sites-enabled/000-default.conf</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
Zur besseren Übersichtlichkeit sollte ein mächtiges Textverarbeitungsprogramm wie ''kate'' verwendet werden.
{{Shell |>sudo apt install kate}}
Erzeugen Sie dann Unterverzeichnisse und legen eine Konfigurationsdatei an:
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nicht optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/sites_enabled/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen vom Browser angenommen werden, muss das Zertifkat fort eingetragen werden.
Gehen Sie dazu unter Firefox in das Menu und wählen die Unterpunkte > Datenschutz & Sicherheit oder rufen Sie den Unterpunkt direkt mit
about:preferences#privacy
auf. Gehen Sie zum Unterpunkt <tt>Sicherheit > Zertifikate</tt> und klicken Sie ''Zeertifikate anzeigen...'' an. Dort tragen Sie unter dem Reiter ''Server'' das eigene Zertifikate ein, indem Sie das eigene auf der Seite
https://k1
als Ausnahme bestätigen.
Laden Sie dazu das Zertifikat von der Seite ''https://k1'' herunter und bestätigen Sie mit dem Auswahlästchen, dass es sich um eine dauerhaft zu speichernde Ausnahme handelt. Drücken Sie den Button ''Sicherheitsausnahme bestätigen''.
[[Datei:Zertifikat_eintragen.png|thumb|600px|left|Importieren des Zertifikate als dauerhafte Sicherheitsausnahme]]
 

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten der Firewall unter Ubuntu]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T16:41:24Z

87.123.95.19: /* Einstellungen für Lawsuit */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-available/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen. Damit sie von Apache verwendet werden, müssen sie zudem vom Verzeichnis <tt>/etc/apache2/sites-enabled/</tt> verlinkt sein.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell|> sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-availabel/}}

und aktivieren sie durch Verlinkung auf <tt>/etc/apache2/sites-enabled</tt>:
{{Shell | > sudo a2ensite lawsuit-httpd.conf}}

Abschließend muss Apache mit der neuen Konfiguration geladen werden:
{{Shell | > systemctl reload apache2}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts vorzunehmen, editieren Sie die Datei <tt>/etc/apache2/apache2.conf</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien finden sich dort ausführliche die Kommentierungen. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>etc/apache2/sites-enabled/000-default.conf</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
Zur besseren Übersichtlichkeit sollte ein mächtiges Textverarbeitungsprogramm wie ''kate'' verwendet werden.
{{Shell |>sudo apt install kate}}
Erzeugen Sie dann Unterverzeichnisse und legen eine Konfigurationsdatei an:
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nicht optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/sites_enabled/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen vom Browser angenommen werden, muss das Zertifkat fort eingetragen werden.
Gehen Sie dazu unter Firefox in das Menu und wählen die Unterpunkte > Datenschutz & Sicherheit oder rufen Sie den Unterpunkt direkt mit
about:preferences#privacy
auf. Gehen Sie zum Unterpunkt <tt>Sicherheit > Zertifikate</tt> und klicken Sie ''Zeertifikate anzeigen...'' an. Dort tragen Sie unter dem Reiter ''Server'' das eigene Zertifikate ein, indem Sie das eigene auf der Seite
https://k1
als Ausnahme bestätigen.
Laden Sie dazu das Zertifikat von der Seite ''https://k1'' herunter und bestätigen Sie mit dem Auswahlästchen, dass es sich um eine dauerhaft zu speichernde Ausnahme handelt. Drücken Sie den Button ''Sicherheitsausnahme bestätigen''.
[[Datei:Zertifikat_eintragen.png|thumb|600px|left|Importieren des Zertifikate als dauerhafte Sicherheitsausnahme]]
 

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten der Firewall unter Ubuntu]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T16:36:25Z

87.123.95.19: /* Einstellungen für Lawsuit */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-available/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen. Damit sie von Apache verwendet werden, müssen sie zudem vom Verzeichnis <tt>/etc/apache2/sites-enabled/</tt> verlinkt sein.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell|> sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-availabel/}}

und aktivieren sie durch Verlinkung auf <tt>/etc/apache2/sites-enabled</tt>:

{{Shell | > sudo a2ensite lawsuit-httpd.conf}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts vorzunehmen, editieren Sie die Datei <tt>/etc/apache2/apache2.conf</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien finden sich dort ausführliche die Kommentierungen. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>etc/apache2/sites-enabled/000-default.conf</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
Zur besseren Übersichtlichkeit sollte ein mächtiges Textverarbeitungsprogramm wie ''kate'' verwendet werden.
{{Shell |>sudo apt install kate}}
Erzeugen Sie dann Unterverzeichnisse und legen eine Konfigurationsdatei an:
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nicht optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/sites_enabled/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen vom Browser angenommen werden, muss das Zertifkat fort eingetragen werden.
Gehen Sie dazu unter Firefox in das Menu und wählen die Unterpunkte > Datenschutz & Sicherheit oder rufen Sie den Unterpunkt direkt mit
about:preferences#privacy
auf. Gehen Sie zum Unterpunkt <tt>Sicherheit > Zertifikate</tt> und klicken Sie ''Zeertifikate anzeigen...'' an. Dort tragen Sie unter dem Reiter ''Server'' das eigene Zertifikate ein, indem Sie das eigene auf der Seite
https://k1
als Ausnahme bestätigen.
Laden Sie dazu das Zertifikat von der Seite ''https://k1'' herunter und bestätigen Sie mit dem Auswahlästchen, dass es sich um eine dauerhaft zu speichernde Ausnahme handelt. Drücken Sie den Button ''Sicherheitsausnahme bestätigen''.
[[Datei:Zertifikat_eintragen.png|thumb|600px|left|Importieren des Zertifikate als dauerhafte Sicherheitsausnahme]]
 

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten der Firewall unter Ubuntu]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T16:35:55Z

87.123.95.19: /* Einstellungen für Lawsuit */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-available/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen. Damit sie von Apache verwendet werden, müssen sie zudem vom Verzeichnis <tt>/etc/apache2/sites-enabled/</tt> verlinkt sein.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell|> sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-availabel/}}

und aktivieren sie durch Verlinkung auf <tt>/etc/apache2/sites-enabled</tt>:

{{Shell | > sudo a2ensite lwasuit-httpd.conf/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts vorzunehmen, editieren Sie die Datei <tt>/etc/apache2/apache2.conf</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien finden sich dort ausführliche die Kommentierungen. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>etc/apache2/sites-enabled/000-default.conf</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
Zur besseren Übersichtlichkeit sollte ein mächtiges Textverarbeitungsprogramm wie ''kate'' verwendet werden.
{{Shell |>sudo apt install kate}}
Erzeugen Sie dann Unterverzeichnisse und legen eine Konfigurationsdatei an:
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nicht optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/sites_enabled/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen vom Browser angenommen werden, muss das Zertifkat fort eingetragen werden.
Gehen Sie dazu unter Firefox in das Menu und wählen die Unterpunkte > Datenschutz & Sicherheit oder rufen Sie den Unterpunkt direkt mit
about:preferences#privacy
auf. Gehen Sie zum Unterpunkt <tt>Sicherheit > Zertifikate</tt> und klicken Sie ''Zeertifikate anzeigen...'' an. Dort tragen Sie unter dem Reiter ''Server'' das eigene Zertifikate ein, indem Sie das eigene auf der Seite
https://k1
als Ausnahme bestätigen.
Laden Sie dazu das Zertifikat von der Seite ''https://k1'' herunter und bestätigen Sie mit dem Auswahlästchen, dass es sich um eine dauerhaft zu speichernde Ausnahme handelt. Drücken Sie den Button ''Sicherheitsausnahme bestätigen''.
[[Datei:Zertifikat_eintragen.png|thumb|600px|left|Importieren des Zertifikate als dauerhafte Sicherheitsausnahme]]
 

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten der Firewall unter Ubuntu]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T16:33:30Z

87.123.95.19: /* Allgemeines */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-available/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen. Damit sie von Apache verwendet werden, müssen sie zudem vom Verzeichnis <tt>/etc/apache2/sites-enabled/</tt> verlinkt sein.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell|> sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-enabled/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts vorzunehmen, editieren Sie die Datei <tt>/etc/apache2/apache2.conf</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien finden sich dort ausführliche die Kommentierungen. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>etc/apache2/sites-enabled/000-default.conf</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
Zur besseren Übersichtlichkeit sollte ein mächtiges Textverarbeitungsprogramm wie ''kate'' verwendet werden.
{{Shell |>sudo apt install kate}}
Erzeugen Sie dann Unterverzeichnisse und legen eine Konfigurationsdatei an:
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nicht optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/sites_enabled/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen vom Browser angenommen werden, muss das Zertifkat fort eingetragen werden.
Gehen Sie dazu unter Firefox in das Menu und wählen die Unterpunkte > Datenschutz & Sicherheit oder rufen Sie den Unterpunkt direkt mit
about:preferences#privacy
auf. Gehen Sie zum Unterpunkt <tt>Sicherheit > Zertifikate</tt> und klicken Sie ''Zeertifikate anzeigen...'' an. Dort tragen Sie unter dem Reiter ''Server'' das eigene Zertifikate ein, indem Sie das eigene auf der Seite
https://k1
als Ausnahme bestätigen.
Laden Sie dazu das Zertifikat von der Seite ''https://k1'' herunter und bestätigen Sie mit dem Auswahlästchen, dass es sich um eine dauerhaft zu speichernde Ausnahme handelt. Drücken Sie den Button ''Sicherheitsausnahme bestätigen''.
[[Datei:Zertifikat_eintragen.png|thumb|600px|left|Importieren des Zertifikate als dauerhafte Sicherheitsausnahme]]
 

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten der Firewall unter Ubuntu]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Fehlende Pakete nachladen - ubuntu

2026-01-02T15:38:49Z

87.123.95.19: /* Themes anpassen */

{{Ubuntu|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Perl Perl]
|
*[https://de.opensuse.org/Perl-Entwicklung Perl-Entwicklung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Multimediapaket per 1-Klick-Installation ==

Rufen Sie mit einem Browser die Seite
https://opensuse-community.org/
auf. Klicken Sie auf den zu Ihrer Desktopumgebung passenden Button und bestätigen Sie die Erweiterungen der von Ihnen akzeptierten Software-Repositories.

Sollte der österreichische Server nicht zu erreichen sein, hilft alternativ der Eintrag eines neuen Repositories
{{Shell|> sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.4/' packman}}

== Weitere benötigte RPM-Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fastcgi make perl-Archive-Zip perl-CGI-Simple perl-File-Tail perl-PDF-API2 perl-PerlMagick perl-YAML libjpeg-turbo libjpeg8-devel zbar perl-Net-Whois-Raw perl-Crypt-Rijndael perl-GD perl-DateTime-Locale perl-DateTime-TimeZone}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die sich hier findet
https://software.opensuse.org/package/pdfsandwich?search_term=pdfsandwich
oder alternativ wie folgt von Hand installiert werden kann:
{{Shell|> sudo zypper addrepo https://download.opensuse.org/repositories/home:/brassh/15.4/ pdfsandwich   sudo zypper in pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[3]>install ODF::lpOD cpan[4]>install URI::Encode cpan[5]>install JSON cpan[6]>install Imager::QRCode cpan[7]>install Imager::File::JPEG cpan[8]>install Image::Scale cpan[9]>install HTTP::Request cpan[10]>install LWP::UserAgent cpan[11]>install LWP::Simple::Post cpan[12]>install List::Util cpan[13]>install MIME::Words cpan[14]>install App::PDFUtils cpan[15]>install Data::ICal cpan[16]>install DateTime::Event::ICal cpan[17]>install Data::ICal::DateTime cpan[18]>install Net::Fritz::Box cpan[19]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[20]>install Spreadsheet::ParseXLSX cpan[21]>quit}}

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo zypper in fuse-exfat exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
{{Shell|> wget "https://github.com/ecsec/open-ecard/releases/download/1.4.5/open-ecard-app-1.4.5-1.x86_64.rpm" > sudo zypper in open-ecard-app-1.4.5-1.x86_64.rpm
}}
Die aktuellen RPMs finden Sie ansonsten unter
https://www.openecard.org/en/download/pc/

== Unsignierte Pakete ==
Um Updates für selbst heruntergeladene RPM-Pakete automatisch installieren zu können, obwohl die ihm <tt>bin</tt>-Verzeichnis hinterlegten Softwarepakete in der Regel nicht signiert sind, geben sie anschließend nur für dieses Repository folgende Ausnahmeregelung für ''zypper'' ein:
{{Shell|> sudo zypper modifyrepo --gpgcheck-allow-unsigned-package bin}}

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Fehlende Pakete nachladen - ubuntu

2026-01-02T15:36:49Z

87.123.95.19: /* Themes anpassen */

{{Ubuntu|
*[https://de.opensuse.org/Portal:Tumbleweed Tumbleweed]
*[https://de.opensuse.org/Portal:42.3 Leap 42.3]
*[https://de.opensuse.org/Portal:42.2 Leap 42.2]
*[https://de.opensuse.org/Portal:42.1 Leap 42.1]
|
*[https://de.opensuse.org/Perl Perl]
|
*[https://de.opensuse.org/Perl-Entwicklung Perl-Entwicklung]
}}

== Einführung ==

Ubuntu liefert ein System, das aus aus Sicherheitsgründen viele notwendigen Pakete für ''Lawsuit'' noch nicht enthält.
Zudem sind für die Installation und Kompilierung von Perlmodulen nötigen Programme im Kernbestand nicht enthalten und sie müssen nachinstalliert werden.

----
== Themes anpassen ==
Installieren Sie die Themes-Erweiterung per
{{shell|> sudo apt-get install gnome-tweaks gnome-shell-extensions}}
Sofern noch nicht vorhanden, legen Sie den <tt>.themes</tt>-Ordner an:
{{shell|> sudo mkdir ~/.themes}}
Ermitteln Sie die von Ihnen verwendete ''Gnome''-version mit
{{shell|> gnome-shell --version}}
und folgen der Anleitung unter
https://drasite.com/flat-remix-gnome
insbesondere mit dem folgenden Befehl
{{shell|> sudo apt install git}}
und dann
{{shell|> git clone --branch 20231026 https://github.com/daniruiz/flat-remix-gnome   cd flat-remix-gnome   make && sudo make install}}

== Multimediapaket per 1-Klick-Installation ==

Rufen Sie mit einem Browser die Seite
https://opensuse-community.org/
auf. Klicken Sie auf den zu Ihrer Desktopumgebung passenden Button und bestätigen Sie die Erweiterungen der von Ihnen akzeptierten Software-Repositories.

Sollte der österreichische Server nicht zu erreichen sein, hilft alternativ der Eintrag eines neuen Repositories
{{Shell|> sudo zypper addrepo -cfp 90 'https://ftp.gwdg.de/pub/linux/misc/packman/suse/openSUSE_Leap_15.4/' packman}}

== Weitere benötigte RPM-Pakete ==
{{Shell|> sudo apt install libglib2.0-dev-bin imagemagick gcc gimp k3b kdiff3 kfind python3-img2pdf qrencode unoconv zip }}
Ferner
{{Shell|> sudo snap install tesseract }}

== Installation fehlender Perl-Module ==
Einige Perl-Module, die ''Lawsuit'' verwendet, sind teilweise in rpm-Paketen von openSUSE enthalten. Für deren Installation aus externen Quellen werden folgende Pakete zusätzlich benötigt:
{{Shell|> sudo apt install automake libapache2-mod-fastcgi make perl-Archive-Zip perl-CGI-Simple perl-File-Tail perl-PDF-API2 perl-PerlMagick perl-YAML libjpeg-turbo libjpeg8-devel zbar perl-Net-Whois-Raw perl-Crypt-Rijndael perl-GD perl-DateTime-Locale perl-DateTime-TimeZone}}

Daneben wird für das beA-Postfach grundsätzlich eine Texterkennung erwartet. Für sie verwendet ''Lawsuit'' die Erweiterung ''pdfsandwich'', die sich hier findet
https://software.opensuse.org/package/pdfsandwich?search_term=pdfsandwich
oder alternativ wie folgt von Hand installiert werden kann:
{{Shell|> sudo zypper addrepo https://download.opensuse.org/repositories/home:/brassh/15.4/ pdfsandwich   sudo zypper in pdfsandwich}}
Fügen Sie anschließend in der Datei <tt>/etc/ImageMagick-7-SUSE/policy.xml</tt> die folgende Zeile ein oder kommentieren Sie sie aus:
<policy domain="coder" rights="read|write" pattern="PDF" />

Als Superuser starten Sie die MCPAN-Shell:
{{Shell|> su # perl -e shell -MCPAN}}
und installieren Sie dann die folgenden Module:
{{Shell|cpan[1]>install CGI.pm cpan[2]>install CGI::Cookie cpan[3]>install ODF::lpOD cpan[4]>install URI::Encode cpan[5]>install JSON cpan[6]>install Imager::QRCode cpan[7]>install Imager::File::JPEG cpan[8]>install Image::Scale cpan[9]>install HTTP::Request cpan[10]>install LWP::UserAgent cpan[11]>install LWP::Simple::Post cpan[12]>install List::Util cpan[13]>install MIME::Words cpan[14]>install App::PDFUtils cpan[15]>install Data::ICal cpan[16]>install DateTime::Event::ICal cpan[17]>install Data::ICal::DateTime cpan[18]>install Net::Fritz::Box cpan[19]>install Net::Fritz::Phonebook # Wählen Sie hier Pretty Printing cpan[20]>install Spreadsheet::ParseXLSX cpan[21]>quit}}

== Zusatzprogramm für aktuelle USB-Sticks ==
{{Shell|> sudo zypper in fuse-exfat exfatprogs}}

== Zusatzprogramm für Ausweisfunktion ==
{{Shell|> wget "https://github.com/ecsec/open-ecard/releases/download/1.4.5/open-ecard-app-1.4.5-1.x86_64.rpm" > sudo zypper in open-ecard-app-1.4.5-1.x86_64.rpm
}}
Die aktuellen RPMs finden Sie ansonsten unter
https://www.openecard.org/en/download/pc/

== Unsignierte Pakete ==
Um Updates für selbst heruntergeladene RPM-Pakete automatisch installieren zu können, obwohl die ihm <tt>bin</tt>-Verzeichnis hinterlegten Softwarepakete in der Regel nicht signiert sind, geben sie anschließend nur für dieses Repository folgende Ausnahmeregelung für ''zypper'' ein:
{{Shell|> sudo zypper modifyrepo --gpgcheck-allow-unsigned-package bin}}

== Zusatzeinstellungen für die Fritz!Box ==
Sofern Sie eine Fritz!Box benutzten, können Sie sich die eingehenden Anrufe mit dem Skript ''fritzcall.pl'' direkt anzeigen lassen. Dafür sind allerdings zunächst Anpassungen in der Fritz!Box nötig. Unter
> Heimnetz > Netzwerk > Netzwerkeinstellungen
klicken Sie unter dem Zusatzpunkt ''weitere Einstellungen'' die Auswahlbox ''Zugriff für Anwendungen zulassen'' an, um Abrufe über die TR-064 API zuzulassen.
Ferner müssen Sie dem User, den Sie später in ''fritzcall.pl'' unter ''username'' mit seinem ''password'' eintragen wollen, zunächst unter
> System > Fritz!Box-Benutzer
den Zugang aus dem Internet erlauben.
Wenn diese Einstellungen richtig vorgenommen sind, sollte der im Rechner gestartete Browser-Aufruf
http://fritz.box:49000/tr64desc.xml
eine XML-Datei auswerfen.

===External links===
*[https://www.perl.org/ Perl-Community]
{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T12:54:22Z

87.123.95.19: /* Verwandte Artikel */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-enabled/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell | >sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-enabled/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten der Firewall unter Ubuntu]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T12:53:49Z

87.123.95.19:

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://wiki.ubuntuusers.de/Apache_2.4/]
*[https://wiki.ubuntuusers.de/Apache/Module/ Apache Module]
*[https://wiki.ubuntuusers.de/Apache/Virtual_Hosts/ Virtual Hosts]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-enabled/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell | >sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-enabled/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://documentation.ubuntu.com/server/how-to/security/firewalls/ Optionen für das Einrichten eienr Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://documentation.ubuntu.com/server/how-to/web-services/install-apache2/ Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T12:48:17Z

87.123.95.19: /* Einstellungen für Lawsuit */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-enabled/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Deaktivieren Sie zunächst die von Ubuntu bereitgestellte Vorlage
{{Shell | >sudo a2dissite 000-default.conf}}
Für ''Lawsuit'' wird die stattdessen benötigte Konfigurationsdatei im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/sites-enabled/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T12:44:36Z

87.123.95.19: /* Allgemeines */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host unter Ubuntu ist <tt>/etc/apache2/sites-enabled/</tt>. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T12:28:28Z

87.123.95.19: /* Hinzufügen von Apache-Modulen */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen.
Einige Programme müssen zunächst nachgeladen werden:
{{Shell|> sudo apt install libapache2-mod-perl2 libapache2-mod-dnssd libapache2-mod-python}}
Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod perl ssl dnssd rewrite actions python   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T12:05:34Z

87.123.95.19: /* Hinzufügen von Apache-Modulen */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|> sudo a2enmod mod_perl   sudo a2enmod mod_env   sudo a2enmod mod_ssl   sudo a2enmod mod_php5   sudo a2enmod mod_python   sudo a2enmod mod_wsgi   sudo a2enmod mod_cgi   sudo a2enmod -l   sudo systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T12:04:37Z

87.123.95.19: /* Aktivierung des Servers */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod mod_wsgi   a2enmod mod_cgi   a2enmod -l   systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T12:04:15Z

87.123.95.19: /* Einrichtung und Anpassung der Firewall */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die die Firewall ''ufd'' (Uncomplicated Firewall) vorinstalliert sein. Für unsere Zwecke zielführender ist ''firewalld''. Dies wird mit
{{Shell|> sudo apt install firewalld}}
installiert. Danach muss, um Systemkonflikte zu vermeiden ''ufd'' deaktiviert werden. Dies erfolgt per
{{Shell|> sudo ufw disable}}
Starten Sie nun ''firewalld'' mit
{{Shell|> sudo systemctl enable --now firewalld}}

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.

{{Shell|> sudo firewall-cmd --zone internal --permanent --add-interface=eth0   sudo firewall-cmd --zone internal --permanent --add-service=nfs   sudo firewall-cmd --zone internal --permanent --add-service=http   sudo firewall-cmd --zone internal --permanent --add-service=https   sudo firewall-cmd --reload}}

Weitere verfügbare Dienste lassen sich mit folgendem Befehl anzeigen
{{Shell|> sudo firewall-cmd --get-service}}
und ggf. nach obigem Muster ergänzen

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod mod_wsgi   a2enmod mod_cgi   a2enmod -l   systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T10:23:19Z

87.123.95.19: /* Anpassung der Firewall */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*[https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[Mehrplatzsysteme - ubuntu|weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]
 

=== Start des Servers ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Einrichtung und Anpassung der Firewall ===

Normalerweise sollte die firewall-cmd vorinstalliert sein. Ansonsten holen Sie dies bitte mit
{{Shell|> sudo apt firewalld}}
nach.
Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT http   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT https   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --zone internal --permanent --add-service=http   firewall-cmd --zone internal --permanent --add-service=https   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod mod_wsgi   a2enmod mod_cgi   a2enmod -l   systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T10:12:25Z

87.123.95.19: /* Installation der Apache-Pakete */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[ weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/
Es sollte folgende Ausgabe zuu sehen sein:
[[Datei:Apache_works.png|thumb|600px|left|Apache-Server Startausgabe]]

=== Start des Servers Yast ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Anpassung der Firewall ===

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT http   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT https   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --zone internal --permanent --add-service=http   firewall-cmd --zone internal --permanent --add-service=https   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod mod_wsgi   a2enmod mod_cgi   a2enmod -l   systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T10:08:29Z

87.123.95.19: /* Installation der Apache-Pakete */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[ weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie das Passwort ein.
Prüfen Sie die korrekte Funktionsweise des Apache-Servers, indem Sie in die Browser-Adresszeile die folgende Adresse eingeben:
http://localhost/

=== Start des Servers Yast ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Anpassung der Firewall ===

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT http   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT https   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --zone internal --permanent --add-service=http   firewall-cmd --zone internal --permanent --add-service=https   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod mod_wsgi   a2enmod mod_cgi   a2enmod -l   systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T10:02:20Z

87.123.95.19: /* Installation der Apache-Pakete */

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[ weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie nach der Passwortbestätigung den folgenden weiteren Befehl ein:
{{Shell|# sudo apt apache2-doc perl-Apache-DBI apache2-mod_perl firewalld-rpcbind-helper}}

=== Start des Servers Yast ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Anpassung der Firewall ===

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT http   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT https   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --zone internal --permanent --add-service=http   firewall-cmd --zone internal --permanent --add-service=https   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod mod_wsgi   a2enmod mod_cgi   a2enmod -l   systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]

Aufsetzen des Apache-Servers - ubuntu

2026-01-02T09:59:55Z

87.123.95.19: Die Seite wurde neu angelegt: „{{Ubuntu| *[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.] | *https://ubuntu.com/tutorials/install-and-configure-apache#2-installi…“

{{Ubuntu|
*[https://ubuntu.com/tutorials/install-ubuntu-desktop-1604#1-overview 16.04.]
|
*https://ubuntu.com/tutorials/install-and-configure-apache#2-installing-apache Apache Installation]
|
*[https://de.opensuse.org/SDB:LAMP_Einrichtung SDB:LAMP_Einrichtung]
*[https://de.opensuse.org/Apache2 Apache2]
*[https://de.opensuse.org/Portal:MySQL Portal:MySQL]
}}

== Einführung ==

Diese Dokument gibt eine rasche Einführung, wie ein Apache-Server auf dem lokalen Rechner aufgesetzt werden kann, der die Lawsuit-Programmteile bereitstellt.

----

{{Warnung| Die Kurzanleitung geht nicht vertieft auf mögliche Experten-Einstellungen des Servers ein. Insbesondere bleiben hier Sicherheitseinstellungen unberücksichtigt, die für den Betrieb als öffentlich zugänglicher Netzserver unumgänglich wären. Die nachfolgenden Schritte sind für Anwender gedacht, die Lawsuit intern auf dem Kanzleirechner hinter einer Firewall betreiben möchten.}}

----

== Allgemeine Rechner-Konfiguration ==

Die Software benötigt eine funktionierende Netzwerkumgebung. Diese wird jedoch bereits standardmäßig von Ubuntu eingereichtet. Achten Sie aber insbesondere bei der Nutzung von [https://de.wikipedia.org/wiki/Dynamic_Host_Configuration_Protocol DHCP] darauf, dass [[ weitere Rechner]] der Kanzlei vom Networkmanager tatsächlich im selben Nummernraum wie dieser PC eingetragen wurden, auf dem Apache nun installiert werden soll. Ansonsten können diese Rechner später nicht auf die Kanzleisoftware zugreifen.

Als Zweites sollte der PC auf dem aktuellen Softwarestand sein.
{{Shell|> sudo apt update}}

=== Installation der Apache-Pakete ===

Der Apache-Server und das optionale Perl-Modul können mit ''apt'' installiert werden. Öffnen Sie dazu ein Terminal-Fenster und wechseln Sie wie folgt in den Superuser-Modus:
{{Shell|> sudo apt install apache2}}
Geben Sie nach der Passwortbestätigung den folgenden weiteren Befehl ein:
{{Shell|# sudo apt apache2-doc perl-Apache-DBI apache2-mod_perl apache2-mod_php5 apache2-mod_python firewalld-rpcbind-helper}}

=== Start des Servers Yast ===
Mit folgenden zwei Befehlen wird der Apache-Server gestartet und auf Dauer im System aktiviert.
{{Shell|# systemctl start apache2   systemctl enable apache2}}

=== Anpassung der Firewall ===

Die Firewall ist so voreingestellt, dass sie über Port 80 auf den Rechner eingehende Daten grundsätzlich sperrt. Folglich müssen die Firewall-Einstellungen so angepasst werden, dass aus dem Lokalen Netzwerk über Port 80 eingehender Datenstrom akzeptiert wird.
Die folgenden Schritte müssen dazu weiterhin als Root ausgeführt werden.
* bis [http://de.opensuse.org/Portal:42.3 Leap 42.3]
{{Shell|# sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT apache2-ssl   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT http   sysconf_addword /etc/sysconfig/SuSEfirewall2 FW_CONFIGURATIONS_EXT https   rcSuSEfirewall2 restart }}
Die Einstellungen finden sich jedoch auch unter ''YaST'' und können dort im '''etc/sysconfig-Editor''' mit den Einträgen ''apache2'' und ''apache2-ssl'' aktiviert werden, indem sie diese durch Leerzeichen getrennt im Feld ''FW_CONFIGURATIONS_EXT'' in <tt>/etc/sysconfig/SuSEfirewall2 </tt> einsetzen. Diese Konfigurationsvariable findet sich unter:
Network > Firewall > SuSEfirewall2

* ab [http://de.opensuse.org/Portal:Tubmleweed Tumbleweed]
Die Variablen können per ''YaST'' unter
Networt > Firewall
unter der Listenauswahl ''Permanent'' wir folgt eingestellt werden:
[[Datei:Apache2_firewall.png|thumb|600px|left|Firewall-Einstellungen für den Apache-Server]]
 
Alternativ ist die Auswahl per Shell möglich:
{{Shell|# firewall-cmd --zone internal --permanent --add-interface=eth0   firewall-cmd --zone internal --permanent --add-service=apache2   firewall-cmd --zone internal --permanent --add-service=apache2-ssl   firewall-cmd --zone internal --permanent --add-service=nfs   firewall-cmd --zone internal --permanent --add-service=http   firewall-cmd --zone internal --permanent --add-service=https   firewall-cmd --reload}}

=== Aktivierung des Servers ===
Starten Sie den Server und aktivieren Sie ihn in einem Bootverzeichnis, damit er mit dem Rechner hochgefahren wird (s.o. ohne Yast):
{{Shell|# systemctl start apache2.service   systemctl enable apache2}}
Sie können diese Einstellungen jederzeit unter ''YaST'' ändern im Untermenü
YaST > Dienste-Verwaltung

=== Hinzufügen von Apache-Modulen===
Um benötigte Apache-Module zu laden, können wir die Konfigurationsvariable ''APACHE_MODULES'' in <tt>/etc/sysconfig/apache2</tt> editieren. Schneller geht es jedoch mit den nachfolgenden Befehlen. Nach der Änderung muss der Server neu gestartet werden. Auch für die folgenden Befehle sind wieder die Rechte eines Superusers vonnöten.
{{Shell|# a2enmod mod_perl   a2enmod mod_env   a2enmod mod_ssl   a2enmod mod_php5   a2enmod mod_python   a2enmod mod_wsgi   a2enmod mod_cgi   a2enmod -l   systemctl restart apache2}}

== Virtual Hosts ==
===Allgemeines===
Das Verzeichnis für alle Virtual Host ist <tt>/etc/apache2/vhosts.d/</tt>. Wie Sie sehen gibt es zwei Konfigurationsdateien - eine mit ssl, die andere ohne ssl. Wir benutzen die Vorlage ohne [https://de.wikipedia.org/wiki/Transport_Layer_Security Secure Sockets Layer]. Nur Dateien mit dem Suffix ".conf" werden automatisch in die Apachekonfiguration einbezogen.

{{Intro|Wenn Sie neben Lawsuit einen weiteren eigenen Virtual Host hinzufügen möchten, ersetzen Sie in den folgenden Zeilen bitte ''Domainname'' durch ihren Verzeichnisnamen oder Ihre IP-Adresse.}}

* Es gibt mehrere Varianten für die Struktur, mit welcher der eigenen Server auf dem Rechner aufgesetzt werden kann. Folgende Optionen bieten sich an:
:* [https://httpd.apache.org/docs/2.4/de/vhosts/name-based.html namensbasiert]
:* [https://httpd.apache.org/docs/2.4/de/vhosts/ip-based.html IP-basiert]
:* portbasiert

* Sei können für Ihre Verzeichnisse die Vorlage '''vhost.template''' kopieren und als Ihre '''{DOMAINNAME}.conf''' speichern. Hier hinein tragen Sie anschließend die Unterverzeichnisse für Ihren Virtual Host ein.

===Einstellungen für ''Lawsuit''===
Für ''Lawsuit'' wird die Konfigurationsdatei jedoch im Unterverzeichnis <tt>lawsuit/settings</tt> bereits fertig zur Verfügung gestellt. Sie müssen lediglich in der genannten Datei den Platzhalter durch den eigenen Nutzernamen ersetzen und die fertige Datei in das Vhosts-Verzeichnis verlinken. Wechseln Sie in das Unterverzeichnis <tt>lawsuit/settings</tt>. Wenn Sie ''Lawsuit'' in Ihrem Nutzerhauptverzeichnis installiert haben, gelangen Sie mit diesem Befehl dorthin:
{{Shell | > cd ~/lawsuit/settings}}
Erstellen Sie dort eine Konfigurationsdatei aus der Vorlage <tt>lawsuit-httpd.template</tt> und ersetzen Sie den darin enthaltenen Platzhalter ''meinpfad'' dabei durch Ihren Pfad zum aktuellen Verzeichnis. Dies erfolgt automatisiert durch diese Befehle:
{{Shell | > pfad=`pwd | sed 's/\/lawsuit.*//' | sed 's/\//\\\\\//g'` > sed "s/meinpfad/$pfad/g" lawsuit-httpd.template > lawsuit-httpd.conf}}
Falls Ihr Pfad zum Ordner <tt>Documents</tt> nicht mit dem soeben ermittelten Pfad für <tt>lawsuit</tt> identisch ist, passen Sie diese Einstellungen für das Verzeichnis <tt>Documents</tt> bitte in der <tt>lawsuit-httpd.conf</tt> mit einem Editor wie '''kate''' von Hand an.

Abschließend kopieren Sie die erstellte Konfigurationsdatei als ''Superuser'' in das Verzeichnis der Virtual Hosts von Apache:

{{Shell | > sudo cp lawsuit-httpd.conf /etc/apache2/vhosts.d/}}

* Neustart von Apache
{{Shell | > sudo service apache2 restart}}

=== Anpassen der Konfiguration ===
Um Ergänzungen oder Änderungen einheitlich für alle Virtual Hosts an der Datei <tt>/etc/apache2/default-server.conf</tt> vorzunehmen, editieren Sie die Konfigurationsvariable ''APACHE_CONF_INCLUDE_FILES'' mithilfe von
YaST > etc/sysconfig-Editor
oder arbeiten direkt in der Textdatei <tt>/etc/sysconfig/apache2</tt>. Zum Verständnis der Hierarchie und des Layouts um Dateien einzubeziehen, lesen Sie die Kommentierung im Kopf der <tt>httpd.conf</tt>. Die ursprüngliche, einfache Konfigurationsdatei mit nur 40K findet sich notfalls unter <tt>/usr/share/doc/packages/apache2/httpd-std.conf-prefork</tt>.

== Optional: Ein Zertifikat für localhost erstellen ==
Bei Mehrplatzsystemen funktionieren die Javascript-Voreintragungen bei Nutzung einer sicheren HTTPS-Verbindung nur, wenn ein eigenes Zertifikat erstellt wird, dessen Aussteller zudem noch aus vertrauenswürdig eingestuft werden muss.OpenSSL bringt umfassende Werkzeuge mit, um eine eigene, kleine Certificate Authority (CA) betreiben zu können.
=== Vergabe einer Domain für den Rechner mit den Lawsuit-Daten ===
Unter yast2 > Netzwerkdienste > Rechnernamen fügen Sie unter der Zeile "localhost" eine Zeile mit folgenden Daten ein:
IP-Adresse: 192.168.2.10
Hostnamen: k1.local
Aliasnamen: k1
[[Datei:Hostkonfiguration.png|thumb|600px|left|Eigenen Rechnernamen vergeben]]
 
Sie können statt "k1" eine beliebe andere Bezeichnung für den Hauptrechner wählen, müssen dann aber Ihre Domain in den folgenden Einstellungen beibehalten.

=== Certificate Authority (CA) erstellen ===
Zu Beginn wird die Certificate Authority generiert. Zunächst wird ein geheimer Private Key erzeugt:
{{Shell |> sudo openssl genrsa -aes256 -out /etc/ssl/private/rootCA.key 4096}}
Der Key trägt den Namen “rootCA.pem” und hat eine Länge von 4096 Bit. Die Option “-aes256” führt dazu, dass der Key mit einem Passwort geschützt wird. Die Key-Datei der CA muss tatsächlich besonders gut geschützt werden. Ein Angreifer, der den Key in die Hände bekommt, kann beliebig gefälschte Zertifikate im Namen der Kanzlei ausstellen, denen die Clients trauen. Die Verschlüsselung dieses Keys mit einem Passwort gibt zusätzlichen Schutz. Das gewünschte Passwort wird bei der Generierung abgefragt.
Einen geheimen Key für die CA gibt es damit also schon - es fehlt noch das Root-Zertifikat, das von den Clients später importiert werden muss, damit die von der CA ausgestellten Zertifikate im Browser als gültig erkannt werden. Das Root-Zertifikat “ca-root.pem” wird mit folgendem Befehl erzeugt:
{{Shell |> sudo openssl req -x509 -new -nodes -key /etc/ssl/private/rootCA.key -sha512 -days 5483 -out /etc/ssl/certs/rootCA.pem}}
In diesem Fall wird die CA 5483 Tage, also mit Schalttagen 15 Jahre lang gültig bleiben. Während der Generierung werden das Passwort für die CA und einige Attribute abgefragt (hier ein Beispiel):
Country Name (2 letter code) [AU]:DE
State or Province Name (full name) [Some-State]:Nordrhein-Westfalen
Locality Name (eg, city) []:Muenster
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Kanzlei Hermanns
Organizational Unit Name (eg, section) []:Rechtsanwalt
Common Name (e.g. server FQDN or YOUR name) []:RA Matthias Hermanns
Email Address []:hermanns@iustus.eu

===Erzeugen des Schlüssels===
Mit diesen Daten wird auch eine Konfiguratunsdatei mit Namen <tt>ssl.cnf</tt> befüllt, die die Schlüsselausgabe später vereinfacht.
{{Shell |> cd ~/bin   mkdir keys   cd keys   kate ssl.cnf}}
Die Datei kann beispielsweise den folgenden Inhalt haben
[req]
# Standard-Verschlüsselung
default_bits = 4096
# verhindere prompt für die Zertifikat-Erstellung
# (Daten kommen aus dieser Datei)
prompt = no
# Verschlüsselungsmethode
default_md = sha512
# Kryptographie abschalten
encrypt_key = no
# Sektion für Zertifizierer-Informationen:
distinguished_name = dn

# Zertifizierer-Informationen:
[dn]
# Länder-Code
C=DE
# Bundesland
ST=Nordrhein-Westfalen
# Stadt
L=Muenster
# Bezeichnung/Firmen-Name/Dein Name:
O=Kanzlei Hermanns
# Aussteller Name
OU=RA Matthias Hermanns
# E-Mail-Adresse
emailAddress=hermanns@iustus.eu
# Primärer Servername
CN = k1

[v3_ca]
keyUsage = digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.2.10, DNS:k1, DNS:k1.local

[ req_ext ]
subjectAltName = @alt_names

[alt_names]
# Primärer Server-Name
DNS.1 = k1
# Sekunärer Server-Name
DNS.2 = k1.local
# Wildcard Subdomains
DNS.3 = *.k1.local

Speichern Sie die so erstellte Datei <tt>ssl.cnf</tt> im <tt>bin</tt>-Verzeichnis ab. Mit folgendem Befehl erzeugen Sie nun als zertifizierter Aussteller die eigentlichen Schlüssel für die SSL-Verbindung.
Zunächst wird der RSA-Key mit 3072 Bit erzeugt (Asymmetrischer Schlüssel von Rivest, Shamir und Adleman, der einen privaten und einen öffentlichen Teil hat):
{{Shell |> openssl genrsa -out k1.key 3072}}
Nun folgt die Certificate Signing Request (CSR; deutsch Zertifikatsignierungsanforderung), ein digitaler Antrag, um mittels der soeben erzeugten digitalen Signatur und der zusätzlichen Identitätsangaben zum Antragstellers aus der <tt>ssl.cnf</tt> ein persönliches digitales Identitäts-Zertifikat (auch Public-Key-Zertifikat genannt) zu erstellen:
{{Shell |> openssl req -new -keyout ~/bin/keys/k1.key -out ~/bin/keys/k1.csr -config ~/bin/keys/ssl.cnf}}
Mithilfe des Wurzelzertifikats vom verifizierten Aussteller (uns selbst) wird nun der eigentliche Schlüssel erstellt, damit eine Rückverfolgung zum Wurzelzertifikat möglich ist.
{{Shell |> sudo openssl x509 -req \   -in ~/bin/keys/k1.csr \   -CA /etc/ssl/certs/rootCA.pem \   -CAkey /etc/ssl/private/rootCA.key \   -CAcreateserial \   -out ~/bin/keys/k1.crt \   -days 3653 \   -extfile ~/bin/keys/ssl.cnf \   -extensions v3_ca }}

Damit die Zertifkate in unsere regelmäßige Sicherungsspeicherung aufgenommen werden, können wir sie in das Schlüsselverzeichnis <tt>keys</tt> unter <tt>lawsuit</tt> kopieren. Dies ist jedoch nur optional, weil es ein Sicherheitsrisiko eröffnet:
{{Shell |> sudo chown matthias:users keys/k1.crt   chmod 640 ~/bin/keys/k1.*   cp ~/bin/keys/k1.* ~/lawsuit/keys/}}

=== Verbindung mit dem Server ===
Wenn Sie host-Datei <tt>lawsuit-httpd.conf</tt> automatisch wie oben vorgeschlagen generiert haben, sind die notwendigen Einstellungen schon voreingetragen und müssen nur auskommentiert werden. Ansonsten ergänzen Sie unter /etc/apache2/vhosts.d/
folgende Zeilen:
<VirtualHost *:80>
ServerName k1
ServerAlias k1.local
</VirtualHost>

<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerAdmin webmaster@localhost
DocumentRoot /home/BENUTZERNAME/lawsuit/
ServerName k1
ServerAlias k1.local
ErrorLog /var/log/apache2/error_log
SSLEngine on
SSLCertificateFile /home/BENUTZERNAME/bin/keys/k1.crt
SSLCertificateKeyFile /home/BENUTZERNAME/bin/keys/k1.key
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
<FilesMatch "\.(cgi|html|shtml|pl|phtml|php)$">
SSLOptions +StdEnvVars
</FilesMatch>
<Directory /home/BENUTZERNAME/lawsuit/cgi-bin>
SSLOptions +StdEnvVars
</Directory>
</VirtualHost>
</IfModule>

# configuration
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 -TLSv1.2
SSLHonorCipherOrder off
SSLSessionTickets off

Damit diese Einstellungen nicht der vom Linux-System vorgegebenen Konfiguration widersprechen, müssen in der Datei <tt>/usr/share/doc/packages/apache2/original/extra/httpd-ssl.conf</tt> noch folgende Zeilen auskommentiert und berichtigt werden
#ServerName www.example.com:443
ServerName k1:443
ferner
#SSLCertificateFile "/etc/apache2/server.crt"
SSLCertificateFile "/home/BENUTZERNAME/bin/keys/k1.crt"
und
#SSLCertificateKeyFile "/etc/apache2/server.key"
SSLCertificateKeyFile "/home/BENUTZERNAME/bin/keys/k1.key"

Unter Firefox kann das selbstgezeichnete Zertifikat nun verwendet werden. Bitte beachten Sie, dass für jede Apache-Konfigurrationsdatei ein anderer Port geöffnet werden muss, "443" also nur einmal verwendet werden kann. Sie können alternativ z.B. "4443" verwenden.

Abschließender Test und Neustart:
{{Shell |# sudo apache2ctl -t   sudo systemctl restart apache2}}

=== Registrierung als vertrauenswürdiger Aussteller für den Firefox-Browser ===
Damit der Firefox-Browser das Zertifikat tatsächlich verwendet und als vertrauenswürdig akzeptiert, muss es im Kleopatra-Schlüsseldienst eingetragen werden, auf den der Browser zugreift.
{{Shell |> kleopatra}}
Klicken Sie den Reiter Importieren an und fügen Sie nacheinander die folgenden Dateien ein:
 <tt>/home/BENUTZERNAME/bin/keys/k1.crt</tt>
 <tt>/etc/ssl/certs/rootCA.pem</tt> 
Bitte bestätigen Sie die erbetenen Beglaubigungen mit der Maustaste.
[[Datei:Kleopatra.png|thumb|600px|left|Importieren der Zertifikate in das Kleopatra-Schlüsselverwaltungsprogramm]]
 
Nun wechseln Sie in den Firefox-Browser und geben in die Adresszeile ein
about:config
Dort ändern Sie die Variable
security.enterprise_roots.enabled -> true
von "false" auf "true". Nun bezieht der Browser auch Ihre eigenen CA-Beglaubigungen des Unternehmens eine seine Bewertungen mit ein und vergibt ein grünes Schlüsselsymbol.

== Problembehebung ==
Lesen Sie wenn möglich die Fehlermeldungen nach dem Start des Servers. Versuchen Sie Fehler ggf. zu reproduzieren und vergleichen Sie die Einträge in den Log-Dateien. Den Einblick auf die dortigen Meldungen können Sie mit dem folgenden Befehl auf den neuesten Stand reduzieren::

{{Shell | # tail -F /var/log/apache2/*}}

Da die Error-Messages schnell sehr großen Umfang einnehmen, der am Ende sogar den Systemstart blockieren kann, empfiehlt es sich, mit Logrotate den Bestand unter Kontrolle zu halten. Installieren Sie dazu, falls noch nicht vom System geschehen:
{{Shell | # zypper in logrotate}}
Sie können die Einstellungen in der Konfigurationsdatei
/etc/logrotate.conf
ändern. Eine typische Konfiguration von <tt>logrotate.conf</tt> sieht z.B. wie folgt aus:
{{Shell |# see "man logrotate" for details
 # rotate log files weekly
 weekly
 # keep 4 weeks worth of backlogs
 rotate 4
 # remove rotated logs older than <count> days
 maxage 90 
 # create new (empty) log files after rotating old ones
 create
 # use date as a suffix of the rotated file
 dateext
 # uncomment this if you want your log files compressed
 compress
 # comment these to switch compression to use gzip or another
 # compression scheme
 compresscmd /usr/bin/xz
 uncompresscmd /usr/bin/xzdec
 # RPM packages drop log rotation information into this directory
 include /etc/logrotate.d
}}

Sollten Sie einen Fehler gefunden haben, [https://de.opensuse.org/SDB:Fehler_berichten berichten Sie ihn] bitte.

==Weiterführende Informationen==
=== Verwandte Artikel ===
*[https://de.opensuse.org/YaST_Module_Firewall#Firewall_Einrichten openSUSE Firewall]
* Package documentation and example configuration files in /usr/share/doc/packages/apache2/

===Externe Links===
* [https://doc.opensuse.org/documentation/leap/reference/html/book.opensuse.reference/cha.apache2.html openSUSE Apache Documentation]
* [http://httpd.apache.org/ The Apache Project]
* [http://www.apache.org/ Apache Software Foundation]

{{DEFAULTSORT:{{PAGENAME}}}}

[[Category:Linuxinstallation]]