Wiki source code of RangeeOS - Smartcard-RFID-USB Easylogin
Last modified by Ulrich Mertz on 2024/07/10 10:09
Show last authors
author | version | line-number | content |
---|---|---|---|
1 | (% class="auto-cursor-target" %) | ||
2 | |||
3 | |||
4 | {{info}} | ||
5 | **Getestet mit:** | ||
6 | |||
7 | RangeeOS Firmware 11.00 build 178 | ||
8 | |||
9 | Rangee Smartcard Admin 11.00 build 010 | ||
10 | |||
11 | Rangee USB Drive Admin 11.00 build 007 | ||
12 | |||
13 | |||
14 | **Getestet mit:** | ||
15 | |||
16 | RangeeOS Firmware 12.00 build 146 | ||
17 | |||
18 | R[[angee Easylogin Smartcard Admin 1.2-x64-12.00 build 001>>url:http://builder10.rangee.local/custody?global_search=[rangee-easylogin-smartcard-admin_1.2-x64]-12.00#]] | ||
19 | |||
20 | R[[angee Easylogin USB Admin 1.0 12.00 build 003.xml>>url:http://builder10.rangee.local/custody?global_search=[rangee-easylogin-usb-admin_1.0]-12.00#]] | ||
21 | {{/info}} | ||
22 | |||
23 | RangeeOS kann Zugangsdaten für Benutzer sicher auf einem USB-Stick einer Smartcard oder RFID-Karte speichern und zur Anmeldung an verschiedenen Serverumgebungen nutzen. Zusätzlich kann auf die entsprechenden Login Medien auch noch der Server, zu dem sich der Benutzer verbinden soll, mit hinterlegt werden. | ||
24 | |||
25 | {{toc/}} | ||
26 | |||
27 | = Voraussetzungen = | ||
28 | |||
29 | Zur Nutzung von RangeeOS Easylogin benötigen Sie entweder: | ||
30 | |||
31 | * eine "Rangee Smartcard Easylogin" mit einem kompatiblen Smartcard Reader | ||
32 | * eine "Rangee RFID Easylogin Card" mit einem kompatiblen NFC Reader | ||
33 | * eine "Rangee USB Easylogin"-Lizenz und einen USB-Stick | ||
34 | |||
35 | = Funktionsweise = | ||
36 | |||
37 | Um die Rangee Easylogin Funktion nutzen zu können, muss das Anmeldemedium einmalig von einem Administrator auf einem beliebeigen RangeeOS-System erstellt werden. Hierzu wird auf dem entsprechenden System, je nach genutztem Medium, das **Rangee Smartcard Admin** oder **Rangee USB-Drive Admin **Modul benötigt. Auf den Endgeräten der Nutzer, werden diese Module nicht benötigt. Die Zugangsdaten werden in aktueller Version über einen Hash, bestehend aus mehreren Komponenten verschlüsselt auf dem jeweiligen Medium abgespeichert. | ||
38 | |||
39 | Bei Smartcard und RFID wird zur Verschlüsselung ein zufällig generiertes, per TCMS verteilbares Token und eine frei wählbare PIN (Optional - Empfohlen) verwendet. Bei USB-Sticks wird zusätzlich die Seriennummer des USB-Sticks genutzt. | ||
40 | |||
41 | {{info}} | ||
42 | Bei Verwendung von USB-Sticks sollte unbedingt ein USB-Stick mit Seriennummer verwendet werden. Wird ein Stick ohne Seriennummer genutzt, können die Login Daten Dateibasiert von einem auf einen anderen Stick übertragen werden. Bei Verwendung eines USB-Sticks ohne Seriennummer wird Ihnen ein entsprechender Warnhinweis beim Aufspielen der Nutzerdaten angezeigt. | ||
43 | {{/info}} | ||
44 | |||
45 | Die Anmeldemedien können anschließend für alle entsprechend konfigurierten Anwendungen an sämtlichen RangeeOS-Systemen genutzt werden, denen das Verschlüsselungstoken bekannt ist. | ||
46 | |||
47 | = Einrichtung = | ||
48 | |||
49 | == Generell == | ||
50 | |||
51 | Die erstellten Login-Tokens können nur auf Geräten genutzt werden, welche über das selbe Verschlüsselungstoken verfügen, welches bei Erstellung des Mediums verwendet wurde. Das aktuelle Token kann unter (% id="cke_bm_8775S" style="display:none" %) (%%) {{status title="Verbindungen & Anwendungen"/}} → {{status title="Verbindungsübersicht"/}} → {{status title="Globale Benutzerdaten"/}} ausgelesen werden. Das Token kann per **Konfiguration **(Manuell/TCMS), **Profil **(TCMS) oder komplett **händisch **auf andere Geräte übertragen werden. | ||
52 | |||
53 | {{lightbox image="Token.png" group="1" width="600px" title="Verschlüsselungstoken"/}} | ||
54 | |||
55 | Bei Verwendung eines TCMS mit unterschiedlichen Gruppen in denen die Login-Tokens an allen Geräten verwendet werden können sollen, empfiehlt sich die Nutzung eines [[TCMS-Profils>>doc:Handbuecher.TCMS11\.00.Kapitel 6 - Arbeiten mit dem TCMS.6\.G\. Profile.WebHome]] auf Gruppen Basis. | ||
56 | |||
57 | == Smartcard/RFID Easylogin == | ||
58 | |||
59 | === Smartcard-Unterstützung aktivieren === | ||
60 | |||
61 | Auf allen Geräten welche Easylogin per Smartcard oder RFID nutzen möchten, muss die Rangee Smartcard-Unterstützung aktiviert sein. | ||
62 | |||
63 | (% id="cke_bm_11331S" style="display:none" %) (%%)Öffnen Sie hierzu die Kommbox und navigieren Sie zu {{status title="PERIPHERIE"/}} → {{status title="SMARTCARD-KONFIGURATION"/}}. Falls nicht bereits entsprechend eingestellt aktivieren Sie die Smartcard-Unterstützung und {{status title="ÜBERNEHMEN"/}} Sie die Einstellung. Ihr am Thin Client angeschlossener Smartcard Reader wird nun aufgelistet. | ||
64 | |||
65 | {{lightbox image="1.PNG" group="1" width="600px" title="Smartcard Konfiguration"/}} | ||
66 | |||
67 | === Login Medium erstellen === | ||
68 | |||
69 | Installieren Sie sich auf einem Thin Client die aktuelle Version des **Rangee Smartcard Admin** Moduls inkl. aktueller RangeeOS Firmware Version. | ||
70 | |||
71 | {{lightbox image="sc-admin.png" group="1" width="600px" title="Smartcard Konfiguration"/}} | ||
72 | |||
73 | (% class="wikigeneratedid" %) | ||
74 | Navigieren Sie zu {{status title="VERBINDUNGEN"/}} → {{status title="RANGEE SMARTCARD ADMIN"/}} und stecken Sie die Rangee Smartcard in den Smartcard Reader. | ||
75 | |||
76 | ==== Smartcard lesen ==== | ||
77 | |||
78 | Drücken Sie in der Kommbox auf {{status title="KARTE LESEN"/}} – nun werden Ihnen die auf der Smartcard vorhandenen Daten angezeigt. | ||
79 | |||
80 | {{info}} | ||
81 | Da in aktueller Version sämtliche Zugangsdaten verschlüsselt abgespeichert werden, wird beim Lesen entsprechender Karten bei "Benutzername" und "Domäne" lediglich "<verschlüsselt>" angezeigt. | ||
82 | {{/info}} | ||
83 | |||
84 | {{lightbox image="2.PNG" group="1" title="Rangee Smartcard Admin"/}} | ||
85 | |||
86 | ==== Smartcard beschreiben ==== | ||
87 | |||
88 | Geben Sie bei Benutzername, Domäne, Passwort, Passwort wiederholen, PIN und PIN wiederholen die gewünschten Daten an. | ||
89 | |||
90 | Der PIN ist ein von Ihnen erdachtes Passwort für die Karte, welches nur Buchstaben und Zahlen (keine Sonder- oder Leerzeichen) enthalten darf. Die Angabe einer PIN ist nicht zwingend erforderlich. | ||
91 | |||
92 | Klicken Sie anschließend auf {{status title="KARTE SCHREIBEN"/}}. | ||
93 | |||
94 | Das Feld Server ist optional und muss nur ausgefüllt werden, wenn der Server an die Smartcard und nicht an die Verbindung gebunden werden soll. | ||
95 | |||
96 | {{lightbox image="3.PNG" group="1" title="Smartcard beschreiben"/}} | ||
97 | |||
98 | ==== Smartcard leeren ==== | ||
99 | |||
100 | Um die Daten auf der Smartcard zu löschen, klicken Sie auf den Button {{status title="KARTE LEEREN"/}}. | ||
101 | |||
102 | {{lightbox image="4.PNG" group="1" title="Smartcard leeren"/}} | ||
103 | |||
104 | === Login Medium nutzen === | ||
105 | |||
106 | Zur Verwendung der Smartcard setzen Sie in Ihrer Verbindung den "//Loginmodus//" auf "//Rangee Smartcard//". | ||
107 | |||
108 | Falls Sie den Server in der Smartcard hinterlegt haben, geben Sie als Server bitte %SMARTCARD% in das Serverfeld ein. | ||
109 | |||
110 | Mit der Option "(% style="color:#000000" %)//Beende Verbindung wenn Smartcard / Token entfernt wird//" können Sie vorgeben, ob die Sitzung beim Ziehen einer Smartcard (oder entfernen der NFC Variante vom Reader) die Sitzung automatisch geschlossen werden soll. | ||
111 | |||
112 | {{lightbox image="5.PNG" group="1" title="FreeRDP-Konfiguration"/}} | ||
113 | |||
114 | Beim Start einer entsprechenden Verbindung passiert nun folgendes: | ||
115 | |||
116 | (% style="list-style-type:square" %) | ||
117 | * Wenn keine Karte gesteckt ist, kommt eine Meldung „Bitte stecken Sie die Smartcard“ | ||
118 | * Wird eine Karte gesteckt oder ein NFC Token aufgelegt, wird nach der hinterlegten PIN gefragt (wenn eine PIN vergeben wurde) | ||
119 | ** Bei richtiger Eingabe werden Sie verbunden | ||
120 | ** Bei falscher PIN-Eingabe wird eine Fehlermeldung angezeigt | ||
121 | |||
122 | == USB Easylogin == | ||
123 | |||
124 | {{warning}} | ||
125 | Die USB Easylogin Funktion benötigt eine gültige **"Rangee USB Easylogin"** oder **"Demo"** Lizenz. Ist keine der beiden auf dem Gerät vorhanden erhalten Sie im Rangee USB-Stick Admin Modul oder beim Start einer entsprechenden Verbindung eine Warnung. | ||
126 | {{/warning}} | ||
127 | |||
128 | {{lightbox image="usb-license.png" group="1" width="600px" title="USB-Stick Admin Lizenz"/}} | ||
129 | |||
130 | === Login Medium erstellen === | ||
131 | |||
132 | Installieren Sie sich auf einem Thin Client die aktuelle Version des **Rangee USB-Drive Admin** Moduls inkl. aktueller RangeeOS Firmware Version. | ||
133 | |||
134 | {{lightbox image="usb-drive-admin.png" group="1" width="600px" title="Smartcard Konfiguration"/}} | ||
135 | |||
136 | (% class="wikigeneratedid" %) | ||
137 | Navigieren Sie zu {{status title="VERBINDUNGEN"/}} → {{status title="RANGEE USB-STICK ADMIN"/}} und stecken Sie einen zu verwendenden USB-Stick ins Gerät. | ||
138 | |||
139 | ==== USB-Stick lesen ==== | ||
140 | |||
141 | Drücken Sie in der Kommbox auf {{status title="USB-Stick LESEN"/}} – nun werden Ihnen die auf dem Stick vorhandenen Daten angezeigt. | ||
142 | |||
143 | {{info}} | ||
144 | "Benutzername" und "Domäne" werden lediglich "als <verschlüsselt>" angezeigt. | ||
145 | {{/info}} | ||
146 | |||
147 | {{lightbox image="usb-read.png" group="1" width="600px" title="USB-Stick lesen"/}} | ||
148 | |||
149 | ==== USB-Stick schreiben ==== | ||
150 | |||
151 | Geben Sie bei Benutzername, Domäne, Passwort, Passwort wiederholen, PIN und PIN wiederholen die gewünschten Daten an. | ||
152 | |||
153 | Der PIN ist ein von Ihnen erdachtes Passwort zur Verschlüsselung der Daten auf dem Stick, welches nur Buchstaben und Zahlen (keine Sonder- oder Leerzeichen) enthalten darf. Die Angabe einer PIN ist nicht zwingend erforderlich. | ||
154 | |||
155 | Das Feld Server ist optional und muss nur ausgefüllt werden, wenn der Server an die Smartcard und nicht an die Verbindung gebunden werden soll. | ||
156 | |||
157 | Klicken Sie anschließend auf {{status title="USB-STICK SCHREIBEN"/}}. | ||
158 | |||
159 | {{info}} | ||
160 | Die auf einem USB-Stick enthaltenen Daten werden hierbei **nicht **gelöscht. Es wird lediglich ein zusätzliches Verzeichnis ".rangee" auf dem Stick angelegt. Dieses darf nicht vom Stick entfernt werden. | ||
161 | {{/info}} | ||
162 | |||
163 | {{lightbox image="usb-write.png" group="1" width="600px" title="USB-Stick beschreiben"/}} | ||
164 | |||
165 | ==== USB-Stick leeren ==== | ||
166 | |||
167 | Um die Daten auf dem Stick zu löschen, klicken Sie auf den Button {{status title="USB-STICK LEEREN"/}}. | ||
168 | |||
169 | === Login Medium Nutzen === | ||
170 | |||
171 | Zur Verwendung des USB-Sticks setzen Sie in Ihrer Verbindung den "//Loginmodus//" auf "//Rangee USB Stick//". | ||
172 | |||
173 | Falls Sie den Server auf dem Stick hinterlegt haben, geben Sie als Server bitte %USBDRIVE% in das Serverfeld ein. | ||
174 | |||
175 | Mit der Option "(% style="color:#000000" %)//Beende Verbindung wenn Smartcard / Token entfernt wird//" können Sie vorgeben, ob die Sitzung beim ziehen des USB-Sticks die Sitzung automatisch geschlossen werden soll. | ||
176 | |||
177 | {{lightbox image="usb-connection.png" group="1" width="600px" title="FreeRDP-Konfiguration"/}} | ||
178 | |||
179 | Beim Start einer entsprechenden Verbindung passiert nun folgendes: | ||
180 | |||
181 | (% style="list-style-type:square" %) | ||
182 | * Wenn kein Rangee Easylogin Stick gesteckt ist, kommt eine Meldung „Bitte stecken Sie den USB-Stick“ | ||
183 | * Wird ein Stick gesteckt, wird nach der hinterlegten PIN gefragt (wenn eine PIN vergeben wurde) | ||
184 | ** Bei richtiger Eingabe werden Sie verbunden | ||
185 | ** Bei falscher PIN-Eingabe wird eine Fehlermeldung angezeigt |