Zum Inhalt springen
Zuletzt geändert von Tobias Wintrich am 2026/09/18 08:46
Zeige letzte Bearbeiter
1 (% class="box infomessage" %)
2 (((
3 Dieses HowTo wurde mit folgenden Versionen erstellt und getestet:
4 **Firmware**: **firmware x64 - 13.00 build 206**
5 )))
6
7 Das auf einem RangeeOS (mit oder ohne TCMS) verwendete Webserver-Zertifikat kann bei Bedarf ausgetauscht werden. Das Zertifikat kann hierzu Base64-codiert (PEM) oder im PFX-Format vorliegen.
8
9 {{toc/}}
10
11 = Zertifikatsanforderungsdatei erstellen (optional) =
12
13 (% class="box infomessage" %)
14 (((
15 Dieser Schritt ist optional. Das Zertifikat kann auch vollständig extern generiert werden.
16 \\~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-
17 Die in dieser Anleitung verwendeten "openssl"-Befehle können generell auf jedem PC mit installiertem openssl ausgeführt werden. Sie können, müssen aber nicht auf Thin-Client-Seite ausgeführt werden. Wenn Sie die Befehle direkt auf dem RangeeOS ausführen möchten, benötigen Sie entsprechenden Root-Zugriff sowie Tools für den Dateitransfer zum und vom Thin Client.
18
19 * [[Root-Terminal-Passwort>>doc:Handbuecher.Handbuch11.Kapitel 3 - Administration des Clients.3\.C Benutzereinstellungen.3\.C\.A\. Root-Terminal-Passwort]] | Es wird empfohlen, zur potenziellen Fehlerbehandlung ein eigenes, festes Passwort für den Benutzer zu setzen.
20 * Z. B.: [[WinSCP >>https://winscp.net/eng/download.php]] für den Dateitransfer von Windows zu RangeeOS.
21 In dieser Anleitung werden die Schritte für ein direktes Ausführen der Befehle auf RangeeOS-Seite beschrieben.
22 Melden Sie sich als Benutzer "[[admin>>doc:Handbuecher.Handbuch11.Kapitel 3 - Administration des Clients.3\.C Benutzereinstellungen.3\.C\.A\. Root-Terminal-Passwort]]" am Client über ein Terminal ({{status title="STRG"/}} + {{status title="SHIFT"/}} + {{status title="ALT"/}} + {{status title="T"/}}) oder eine SSH-Verbindung am RangeeOS an.
23 )))
24
25 1. Passen Sie die Parameter des folgenden Befehls nach Ihren Anforderungen an und führen Sie ihn auf dem Gerät aus:{{code language="bash"}}openssl req -newkey rsa:4096 -sha256 -keyout key.pem -out req.pem \
26 -subj "/C=DE/ST=Bundesland/L=Stadt/O=Einrichtung/OU=Abteilung/OU=Team/CN=<FQDN>" \
27 -addext "subjectAltName = DNS:<DNS>,IP:<IP>"{{/code}}
28 1*. **C/ST/L/O/OU**
29 Optional und frei wählbar
30 1*. **<FQDN>**:
31 Der Hostname, unter dem das RangeeOS später angesprochen werden soll
32 1*. **<DNS>:**
33 Hostname des TCMS, für den das Zertifikat gültig sein soll
34 1*. **<IP>:**
35 Optional. IP des TCMS, für die das Zertifikat gültig sein soll. Wenn die IP nicht Teil des Zertifikats sein soll, entfernen Sie den entsprechenden Bereich.
36 1*. Beispiel eines vollständigen Befehls:
37 {{code language="bash"}}openssl req -newkey rsa:4096 -sha256 -keyout key.pem -out req.pem \
38 -subj "/C=DE/ST=NRW/L=Aachen/O=Rangee/OU=Support/OU=Zertifikatstest/CN=tc-b0416f05c363.rangee.local" \
39 -addext "subjectAltName = DNS:tc-b0416f05c363.rangee.local,IP:192.168.50.29"{{/code}}
40 1. Vergeben Sie nach Absenden des Befehls ein Kennwort für Ihren Private Key (mindestens 4 Zeichen).
41 1. Da der Private Key für das Serverzertifikat ohne Passwort benötigt wird, müssen Sie das Passwort anschließend mit diesem Befehl entfernen:
42 {{code language="bash"}}openssl rsa -in key.pem -out key.pem{{/code}}
43 1. Verbinden Sie sich mit "WinSCP" und den "admin"-Zugangsdaten zum Client und laden Sie die Anforderungsdatei "///tmp/req.pem//" sowie "///tmp/key.pem//" herunter.
44 1. Reichen Sie die Datei req.pem bei einer beliebigen Zertifizierungsstelle ein. Wenn Sie die Möglichkeit haben, lassen Sie sich hier direkt ein Base64-codiertes Zertifikat erstellen. Sobald Sie das Zertifikat haben, fahren Sie mit dem nächsten Schritt fort.
45
46 = Importieren eines Zertifikats =
47
48 Ein fertiges Zertifikat können Sie über die Kommbox unter {{status title="Remote-Administration"/}} hochladen. Je nach Zertifikatsformat wählen Sie hier **Webserverzertifikat hochladen** (PEM/Base64) oder **PFX-Zertifikat hochladen**.
49
50 (% class="box infomessage" %)
51 (((
52 Ein Zertifikat im PEM-Format muss sowohl das Serverzertifikat als auch den passenden Private Key enthalten. Wenn Sie das Zertifikat mit einem Texteditor öffnen, sollte der Inhalt in dieser Form angezeigt werden:
53 //~-~-~-~--BEGIN RSA PRIVATE KEY~-~-~-~--
54 […]
55 ~-~-~-~--END RSA PRIVATE KEY~-~-~-~--
56 ~-~-~-~--BEGIN CERTIFICATE~-~-~-~--
57 […]
58 ~-~-~-~--END CERTIFICATE~-~-~-~--//
59 )))
60
61 [[image:1789713314582-112.png]]
62
63
64 Das PEM-Zertifikat wird mit einem Klick auf **Übernehmen** sofort installiert. Beim PFX-Zertifikat werden Sie zu einer Upload-Seite geleitet, auf der Sie noch ein eventuell vergebenes Kennwort eintragen können.
65
66
67 [[image:1789713455962-680.png]]
68
69
70 Anschließend ist ein Neustart des RangeeOS notwendig.
71 Nach dem Neustart wird Ihnen im Browser das Zertifikat als gültig angezeigt.
72
73
74 [[image:attach:zert01.png||height="321" width="600"]]
75 [[image:image-20221128112923-1.png||height="321" width="600"]]