Apache 2.x WebServer
Installation eines SSL Zertifikates für den Apache Webserver 2.x
Vorbereitungen
Für die Installation des Zertifikates benötigen Sie:
- den Private Key
- das Zertifikat
- das bzw. die Intermediate Zertifikat/-e
Wenn die Zwischenzertifikate von der CA nicht mit dem eigentlichen Zertifikat ausgeliefert wurden, bietet die jeweilige Zertifizierungsstelle eine Möglichkeit diese zu beziehen.
Bezugsquellen für Intermediate Zertifikate
Ablage von Zertifikaten und Schlüssel
Für die Ablage bietet sich die Verzeichnisstruktur unter /etc/ssl an.
<source lang=bash> /etc/ssl/private /etc/ssl/certs </source>
Im Verzeichnis private werden die privaten Schlüssel abgelegt. Im Verzeichnis certs werden die Zertifikate gespeichert.
Entscheidet man sich, die Intermediate Zertifikate auch unter /etc/ssl/certs abzulegen, müssen noch die Links in Form von Prüfsummen erzeugt werden, die eine Funktion mit dem Parameter SSLCACertificatePath erlauben.
Der einfachste Weg wäre der Aufruf des Scripts c_hash. Das Programm gehört zum Lieferumfang von OpenSSL. Sollte es sich nicht im Suchpfad finden lassen, liegt es häufig im Dokumentationsverzeichnis des OpenSSL Programmpaketes (zB /usr/share/doc/openssl/).
Anpassung der Konfiguration
Lage der Konfigurationsdateien
Die Önderungen an der Konfiguration werden in der Regel an der VHost Konfiguration vorgenommen.
- Debian basierenden Distributionen:
/etc/apache2/sites-available/oder verlinkt/etc/apache2/sites-enabled/
- Redhat, Fedora und Mandriva:
/etc/httpd
- FreeBSD:
/usr/local/etc/apache22/
- NetBSD:
/usr/pkg/etc/httpd/
- default Apache2 Installationen:
/usr/local/apache2/conf/
Vorbereitende Önderungen
Um SSL anzuschalten legen Sie eine Kopie des VHosts an, der auf Port 80 horcht.
<source lang=apache> <VirtualHost 10.0.0.1:80>
ServerName server1.example.org ServerAlias www.server1.example.org
DocumentRoot /var/www CustomLog /var/log/apache2/vh1_access_log combined ErrorLog /var/log/apache2/vh1_error_log
ServerAdmin webmaster@localhost
<Directory /var/www/>
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>
</VirtualHost>
<VirtualHost 10.0.0.1:443>
ServerName server1.example.org ServerAlias www.server1.example.org
DocumentRoot /var/www CustomLog /var/log/apache2/vh1_ssl_access_log combined ErrorLog /var/log/apache2/vh1_ssl_error_log
ServerAdmin webmaster@localhost
<Directory /var/www/>
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>
</VirtualHost> </source>
Fügen Sie hier folgende Parameter hinzu:
Alternative 1 (bis Apache 2.4.7)
<source lang=apache> <VirtualHost 10.0.0.1:443>
ServerName server1.example.org ServerAlias www.server1.example.org
DocumentRoot /var/www CustomLog /var/log/apache2/vh1_ssl_access_log combined ErrorLog /var/log/apache2/vh1_ssl_error_log
ServerAdmin webmaster@localhost
<Directory /var/www/>
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>
# SSL Config SSLEngine on SSLCertificateFile /etc/ssl/certs/meinzertifikat.crt SSLCertificateKeyFile /etc/ssl/certs/meinschluessel.key SSLCACertificateFile /etc/ssl/certs/certificate-chain.crt # SSL Config
</VirtualHost> </source>
Alternative 2
Da seit spätestens der Version 2.4.8 die Option SSLCACertificateFile nicht mehr unterstützt wird, muss man die Konfiguration der Intermediate Zertifikate mit anderen Parametern vornehmen.
Dabei bietet sich die Option an. Die Vorarbeit ist etwas umfangreicher, dafür können eventuelle spätere Zertifikatsinstallationen davon profitieren.
<source lang=apache> <VirtualHost 10.0.0.1:443>
ServerName server1.example.org ServerAlias www.server1.example.org
DocumentRoot /var/www CustomLog /var/log/apache2/vh1_ssl_access_log combined ErrorLog /var/log/apache2/vh1_ssl_error_log
ServerAdmin webmaster@localhost
<Directory /var/www/>
Options Indexes FollowSymLinks MultiViews
AllowOverride None
Order allow,deny
allow from all
</Directory>
# SSL Config
SSLEngine on
SSLCertificateFile /etc/ssl/certs/meinzertifikat.crt
SSLCertificateKeyFile /etc/ssl/certs/meinschluessel.key
SSLCACertificatePath /etc/ssl/certs/
# SSL Config
</VirtualHost> </source>
Alternative 3 (seit Apache 2.4)
In der Datei, die für SSLCertificateFile angegeben wird, kann seit Apache 2.4 auch die Kette der Intermediate Zertifikate hinterlegt werden. Dabei muss eine Sortierung von der Spitze bis zur Wurzel eingehalten werden. (vgl. ModSSL Dokumentation)
Dieses Vorgehen kann alternativ oder parallel zur Direktive SSLCACertificatePath gewählt werden.
<source lang=apache>
# SSL Config SSLEngine on SSLCertificateFile /etc/ssl/certs/meinzertifikat-mit-kette.crt SSLCertificateKeyFile /etc/ssl/certs/meinschluessel.key # SSL Config
</source>
Abschluss
Speichern Sie die Konfiguration und starten Sie den Webserver neu. Das kann auf Debian Linux basierten Systemen wie folgt geschehen:
service apache2 restart
oder
/etc/init.d/apache2 restart
Unter *BSD auch mit service apache22 start oder /usr/local/etc/rc.d/apache22 start.
Ausblick
Die Konfiguration läßt sich noch weiter verfeinern. Die Dokumentation von ModSSL für Apache ist umfangreich und gut verständlich.
Es bietet sich vor allem an, die Auswahl der unterstützten Protokolle einzugrenzen.
<source lang=apache> SSLProtocol All -SSLv2 -SSLv3 </source>
Es kann auch eine Auswahl unterstützter Verschlüsselungsmechanismen mitgegeben werden, die verhandelt werden dürfen:
<source lang=apache> SSLCipherSuite HIGH:!MEDIUM:!aNULL:!MD5:!LOW:!RC4:!EXP </source>
Wie stark die jeweilige Auswahl die zur Verfügung stehenden Mechanismen eingrenzt, kann mit dem Befehl:
<source lang=bash> openssl ciphers -v 'HIGH:!MEDIUM:!aNULL:!MD5:!LOW:!RC4:!EXP' </source>
