Wiki-Quellcode von Bereitstellung über HTTPS

Zeige letzte Bearbeiter
1 ==Konfigurieren des HTTPS Connectors==
2
3 Um den Apache Tomcat über HTTPS bereitzustellen, sind Anpassungen an der Datei //server.xml// des Tomcats notwendig.
4
5 1. Öffnen Sie die Datei //server.xml// (Pfad = ///Pfad/Zum/Tomcat/conf/server.xml//) mit einem entsprechenden Texteditor
6 1. (((
7 Navigieren Sie zu der u.g. Zeile bzw. dem gesamten Eintrag/Block
8
9 {{code}}
10 <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" maxThreads="150" SSLEnabled="true">
11 <SSLHostConfig>
12 <Certificate certificateKeystoreFile="conf/localhost-rsa.jks"
13 type="RSA" ></Certificate>
14 </SSLHostConfig>
15 </Connector>
16 {{/code}}
17
18 Sollte der entsprechende Block kommentiert sein, so kommentieren Sie diesen aus!
19 )))
20 1. (((
21 Passen Sie den Inhalt des einkommentierten Connectors an Ihre Gegebenheiten (Pfade/Zertifikate/Port) an. Dies könnte zum Beispiel so aussehen:
22
23 {{code}}
24 <Connector port="443" protocol="HTTP/1.1" maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
25 URIEncoding="UTF-8"
26 maxHttpHeaderSize="65536"
27 maxPostSize="10485760"
28 relaxedQueryChars="[ \ ] ^ ` { | }">
29 <SSLHostConfig hostName="XX.XXXX.XX">
30 <Certificate certificateKeyFile="conf/private.key"
31 certificateFile="conf/zertifikat.crt"
32 certificateChainFile="conf/CHAIN.pem"
33 type="RSA" ></Certificate>
34 </SSLHostConfig>
35 </Connector>
36 {{/code}}
37
38 Weiterführende Informationen zur Konfiguration von der Eigenschaft //SSLHostConfig// finden Sie in der Dokumentation des Herstellers: [[https:~~/~~/tomcat.apache.org/tomcat-8.5-doc/config/http.html#SSL_Support_-_SSLHostConfig>>https://tomcat.apache.org/tomcat-8.5-doc/config/http.html#SSL_Support_-_SSLHostConfig]]
39 )))
40
41 ===Eine Zusammenfassung der wichtigsten Optionen===
42
43 {{table dataTypeAlpha="0" preSort="0-asc"}}
44 |=Attribut|=Wert|=Beschreibung
45 |port|443 (Standard)|Über diesen Port wird die Verbindung aufgebaut.
46 |URIEncoding|UTF-8|UTF-8 ist wichtig für eine durchgängig sauberes Encoding.
47 |maxHttpHeaderSize|65536|Dieser Wert sollte nicht verändert werden.
48 |maxPostSize|1100715200|Maximale Größe der Posts (Formulardaten inkl. Datei-Uploads) in Bytes. Der Wert in dem Beispiel ist 1GB.
49 |hostName|*|Name oder IP Adresse des Hosts.
50 |certificateKeyFile|*.key|Der private Schlüssel des Zertifikats.
51 |certificateFile|*.crt|Das eigentliche Zertifikat.
52 |certificateChainFile|*.*|Das übergeordnete Zertifikat (Certificate Authority (CA)), wenn nötig.
53 {{/table}}
54
55 ===Weitere Möglichkeiten ein Zertifikat im Tomcat am Connector zu konfigurieren===
56
57 Einbindung mittels KeyStore:
58
59 {{code}}
60 <Connector port="443" protocol="HTTP/1.1" maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
61 URIEncoding="UTF-8"
62 maxHttpHeaderSize="65536"
63 maxPostSize="10485760"
64 relaxedQueryChars="[ \ ] ^ ` { | }">
65 <SSLHostConfig>
66 <Certificate certificateKeystoreFile="conf/file.keystore"
67 certificateKeystorePassword="mypwd" ></Certificate>
68 </SSLHostConfig>
69 </Connector>
70 {{/code}}
71
72
73 Ist man im Besitz einer KeyPair-Datei (*.pfx, *.p12) kann man diese auch direkt einbinden:
74
75 {{code}}
76 <Connector port="443" protocol="HTTP/1.1" maxThreads="150" SSLEnabled="true" scheme="https" secure="true"
77 URIEncoding="UTF-8"
78 maxHttpHeaderSize="65536"
79 maxPostSize="10485760"
80 relaxedQueryChars="[ \ ] ^ ` { | }">
81 <SSLHostConfig>
82 <Certificate certificateKeystoreFile="conf/file.pfx"
83 certificateKeystorePassword="mypwd"
84 certificateKeystoreType="PKCS12" ></Certificate>
85 </SSLHostConfig>
86 </Connector>
87 {{/code}}
88
89 ==Erzwingen von HTTPS==
90
91 Sollte der komplette Server ausschließlich über HTTPS betrieben werden empfiehlt es sich den Standard HTTP-Connector zu entfernen bzw. auszukommentieren. Sollte dies keine Option sein gibt es zusätzlich die Möglichkeit sowohl für den ganzen Server, als auch für einzelne Anwendungen eine Kommunikation über HTTPS zu erzwingen. Hierfür kann in die Datei //web.xml// des Servers (///Pfad/Zum/Tomcat/conf/web.xml//) oder der Anwendung (///Pfad/Zum/Tomcat/webapps/formcycle/WEB-INF/web.xml//) innerhalb des Knotens //web-app// folgendes eingefügt werden:
92
93 {{code}}
94 <security-constraint>
95 <web-resource-collection>
96 <web-resource-name>Entire Application</web-resource-name>
97 <url-pattern>/*</url-pattern>
98 </web-resource-collection>
99
100 <user-data-constraint>
101 <transport-guarantee>CONFIDENTIAL</transport-guarantee>
102 </user-data-constraint>
103 </security-constraint>
104 {{/code}}