Allgemein - Kommbox- bzw. TCMS Webserver Zertifikat austauschen

1

(% class="box infomessage" %)

2

(((

3

Dieses Howto wurde mit folgenden Versionen erstellt und getestet:

4

5

**Firmware**: **firmware x64 - 13.00 build 233**

6

)))

7

8

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.

= Zertifikatsanforderungsdatei erstellen (Optional) =

13

14

(% class="box infomessage" %)

15

(((

16

Dieser Schritt ist Optional. Das Zertifikat kann auch vollständig extern generiert werden.

17

\\~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-

18

19

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 und Tools für den Dateitransfer zum und vom Thin Client.

20

21

* [[Root-Terminal-Passwort>>doc:Handbuecher.Handbuch11.Kapitel 3 - Administration des Clients.3\.C Benutzereinstellungen.3\.C\.A\. Root-Terminal-Passwort]] | Es wird empfohlen zur potentiellen Fehlerbehandlung ein eigenes, feste Passwort für den Benutzer zu setzen

22

* Z.B.: [[WinSCP >>https://winscp.net/eng/download.php]]für den Dateitransfer von Windows zu RangeeOS

23

24

In dieser Anleitung werden die Schritte für ein direktes Ausführen der Befehle auf RangeeOS Seite beschrieben.

25

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

26

)))

27

28

1. Passen Sie die Parameter des folgendes 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 \

29

-subj "/C=DE/ST=Bundesland/L=Stadt/O=Einrichtung/OU=Abteilung/OU=Team/CN=<FQDN>" \

30

-addext "subjectAltName = DNS:<DNS>,IP:<IP>"{{/code}}

31

1*. **C/ST/L/O/OU**

32

Optional und Frei wählbar

33

1*. **<FQDN>**:

34

der Hostname unter dem das RangeeOS später angesprochen werden soll

35

1*. **<DNS>:**

36

Hostname des TCMS für die das Zertifikat gültig sein soll.

37

1*. **<IP>:**

38

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

39

1*. Beispiel eines vollständigen Befehls:

40

{{code language="bash"}}openssl req -newkey rsa:4096 -sha256 -keyout key.pem -out req.pem \

41

-subj "/C=DE/ST=NRW/L=Aachen/O=Rangee/OU=Support/OU=Zertifikatstest/CN=tc-b0416f05c363.rangee.local" \

42

-addext "subjectAltName = DNS:tc-b0416f05c363.rangee.local,IP:192.168.50.29"{{/code}}

43

1. Vergeben Sie nach Absenden des Befehls ein Kennwort für Ihren Private Key (min. 4 Zeichen)

44

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:

45

{{code language="bash"}}openssl rsa -in key.pem -out key.pem{{/code}}

46

1. Verbinden Sie sich mit "WinSCP" und den "admin" Zugangsdaten zum Client und laden Sie die Anforderungsdatei "///tmp/req.pem//" und "///tmp/key.pem//" herunter.

47

1. Reichen Sie die Datei req.pem bei einer beliebigen Zertifizierungsstelle ein. Wenn Sie die Option haben, lassen Sie sich hier direkt ein Base64 codiertes Zertifikat erstellen. Sobald Sie das Zertifikat haben, fahren Sie mit dem nächsten Schritt fort.

48

49

= Importieren eines Zertifikats =

50

51

Das 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**.

52

[[image:1789713314582-112.png]]

53

54

Das PEM-Zertifikat wird mit einem Klick auf **Übernehmen** sofort installiert. Beim PFX-Zertifikat werden Sie zu einer Upload Seite geleitet bei der Sie noch ein eventuell vergebenes Kennwort eintragen können.

55

[[image:1789713455962-680.png]]

56

57

Anschließend ist ein Neustart des RangeeOS notwendig.

58

59

Nach dem Neustart wird Ihnen im Browser das Zertifikat als gültig angezeigt.

60

61

[[image:attach:zert01.png||height="321" width="600"]]

62