Zum Inhalt springen
Zuletzt geändert von Tobias Wintrich am 2026/09/18 08:46
Verstecke letzte Bearbeiter
Tobias Wintrich 15.1 1 (% class="box infomessage" %)
2 (((
Tobias Wintrich 16.1 3 Dieses HowTo wurde mit folgenden Versionen erstellt und getestet:
4 **Firmware**: **firmware x64 - 13.00 build 206**
Tobias Wintrich 15.1 5 )))
rangee rangee 5.1 6
Tobias Wintrich 16.1 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.
tobias 4.2 8
Tobias Wintrich 15.1 9 {{toc/}}
10
Tobias Wintrich 16.1 11 = Zertifikatsanforderungsdatei erstellen (optional) =
Tobias Wintrich 15.1 12
13 (% class="box infomessage" %)
14 (((
Tobias Wintrich 16.1 15 Dieser Schritt ist optional. Das Zertifikat kann auch vollständig extern generiert werden.
Tobias Wintrich 15.1 16 \\~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-
Tobias Wintrich 16.1 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.
Tobias Wintrich 15.1 18
Tobias Wintrich 16.1 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.
Tobias Wintrich 15.1 23 )))
tobias 4.2 24
Tobias Wintrich 16.1 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 \
Tobias Wintrich 8.1 26 -subj "/C=DE/ST=Bundesland/L=Stadt/O=Einrichtung/OU=Abteilung/OU=Team/CN=<FQDN>" \
27 -addext "subjectAltName = DNS:<DNS>,IP:<IP>"{{/code}}
Tobias Wintrich 7.1 28 1*. **C/ST/L/O/OU**
Tobias Wintrich 16.1 29 Optional und frei wählbar
Tobias Wintrich 7.1 30 1*. **<FQDN>**:
Tobias Wintrich 16.1 31 Der Hostname, unter dem das RangeeOS später angesprochen werden soll
Tobias Wintrich 8.1 32 1*. **<DNS>:**
Tobias Wintrich 16.1 33 Hostname des TCMS, für den das Zertifikat gültig sein soll
Tobias Wintrich 7.1 34 1*. **<IP>:**
Tobias Wintrich 16.1 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.
Tobias Wintrich 8.1 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}}
Tobias Wintrich 16.1 40 1. Vergeben Sie nach Absenden des Befehls ein Kennwort für Ihren Private Key (mindestens 4 Zeichen).
Tobias Wintrich 8.1 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}}
Tobias Wintrich 16.1 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.
rangee rangee 5.1 45
Tobias Wintrich 7.1 46 = Importieren eines Zertifikats =
tobias 4.2 47
Tobias Wintrich 16.1 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
Tobias Wintrich 15.1 61 [[image:1789713314582-112.png]]
tobias 4.2 62
Tobias Wintrich 16.1 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
Tobias Wintrich 15.1 67 [[image:1789713455962-680.png]]
tobias 4.2 68
Tobias Wintrich 16.1 69
Tobias Wintrich 15.1 70 Anschließend ist ein Neustart des RangeeOS notwendig.
Tobias Wintrich 8.1 71 Nach dem Neustart wird Ihnen im Browser das Zertifikat als gültig angezeigt.
72
Tobias Wintrich 16.1 73
Tobias Wintrich 12.1 74 [[image:attach:zert01.png||height="321" width="600"]]
75 [[image:image-20221128112923-1.png||height="321" width="600"]]