Skip to Content
Last modified by Tobias Wintrich on 2024/10/25 14:16
From version 28.1
edited by Tobias Wintrich
on 2024/10/25 13:22
Change comment: There is no comment for this version
To version 32.1
edited by Tobias Wintrich
on 2024/10/25 13:46
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,6 +4,3 @@
1 -(% class="auto-cursor-target" %)
2 -
3 -
4 4  {{info}}
5 5  USBGuard ist ab der Firmware 10.00 amd64 build 155 im Basissystem von RangeeOS enthalten
6 6  {{/info}}
... ... @@ -7,6 +7,8 @@
7 7  
8 8  Mittels des USBGuard behalten Sie die Kontrolle über die am Gerät angeschlossenen USB-Geräte.
9 9  
7 +{{toc/}}
8 +
10 10  = USBGuard aktivieren =
11 11  
12 12  {{info}}
... ... @@ -15,7 +15,7 @@
15 15  
16 16  Der USBGuard ist in unserer Firmware standardmäßig ausgeschaltet. Zum aktivieren setzen Sie die Option "USBGuard verwenden" unter {{status title="Peripherie"/}} -> {{status title="USB-Geräte"/}} -> **USBGuard-Daemon-Konfiguration**
17 17  
18 -[[image:usb_guard_01.png||alt="USB Guard aktivieren" height="263" width="496"]]
17 +[[image:usb_guard_01.png||alt="USB Guard aktivieren" width="600"]]
19 19  
20 20  = Geräte Verwalten =
21 21  
... ... @@ -31,14 +31,13 @@
31 31  )))
32 32  
33 33  (% class="wikigeneratedid" %)
34 -[[image:usb_guard_02.png||alt="USB Guard konfigurieren" height="263" width="496"]]
33 +[[image:usb_guard_02.png||alt="USB Guard konfigurieren" width="800"]]
35 35  
36 -
37 37  = Verfügbare Geräte Berechtigungen =
38 38  
39 39  (% class="box warningmessage" %)
40 40  (((
41 -Die erstellten Geräteregeln gelten immer exakt für eine Kombination aus USB-Gerät + USB-Port. Wird das USB-Gerät an einen anderen Port gesteckt, kann eine andere Regel definiert werden bzw. wird die Standardregel für neue Geräte angewendet.
39 +Die automatisch erstellten Geräteregeln gelten immer exakt für eine Kombination aus USB-Gerät + USB-Port. Wird das USB-Gerät an einen anderen Port gesteckt, kann eine andere Regel definiert werden bzw. wird die Standardregel für neue Geräte angewendet.
42 42  )))
43 43  
44 44  Sowohl als Standardregel in der "USBGuard-Daemon-Konfiguration" als auch für einzelne Geräte über die "USBGuard-Geräteverwaltung" können folgende Regeln definiert werden:
... ... @@ -50,3 +50,54 @@
50 50  Unterbindet das laden der entsprechenden Gerätetreiber - das Gerät kann an diesem Port nicht verwendet.
51 51  * **Ablehnen**
52 52  Das Gerät taucht nicht in der Systemkonfiguration auf, neu angeschlossene Geräte können nicht konfiguriert werden.
51 +
52 += USB-Guard und TCMS / Expertenkonfiguration =
53 +
54 +Mit den Standardeinstellungen speichert generiert jedes Gerät individuelle Konfigurationsdateien für den USB Guard. Erhält ein Gerät per Gruppenkonfiguration die Aufforderung USB-Guard zu nutzen, so generiert es beim ersten aktivieren automatisch eine Konfiguration entsprechend der aktuell angeschlossenen Geräte. Alle später angeschlossenen Geräte müssen händisch konfiguriert werden.
55 +
56 +Will man eine zentrale Konfiguration für alle Geräte pflegen und z.B.: alle Eingabegeräte, Webcams.... generell erlauben, so kann man hierzu den "Expertenmodus" verwenden. Sobald der Expternemodus aktiviert ist, wird die vom System erstellte Konfiguration mit an den TCMS und damit auch auf andere Geräte übertragen.
57 +
58 +{{warning}}
59 +Wenn Sie den Expertenmodus aktivieren **müssen **Sie die automatisch generierte Konfiguration händisch Anpassen. Wenn die automatisch generierte Konfiguration auf ein anderes Gerät übertragen wird, werden dort keinerlei USB-Geräte mehr funktionieren, da die Konfiguration Port und Seriennummer der angeschlossenen Geräte enthalte und diese auch von Gerät zu Gerät unterscheiden.
60 +{{/warning}}
61 +
62 +Den Expertenmodus aktivieren Sie unter {{status title="Peripherie"/}} (% id="cke_bm_78664S" style="display:none" %){{status title="Peripherie"/}}(%%) -> {{status title="USB-Geräte"/}} -> **USBGuard-Daemon-Konfiguration. **Sobald er aktiviert ist, steht Ihnen ein Textfeld "Benutzerdefinierte Regeln" in der **USBGuard-Geräteverwaltung** zur Verfügung.
63 +
64 +[[image:usb_guard_03.png||alt="USB Guard Expertenkonfiguration" width="1000"]]
65 +
66 +Der automatische Inhalt dient erstmal als "Platzhalter" und sorgt dafür, dass Sie mir Ihrem Gerät an dem Sie die Regeln erstellen und Testen noch weiterarbeiten können. Sobald Sie eigene Regeln geschrieben haben, können Sie den generierten Inhalt löschen.
67 +
68 +== Benutzerdefinierte Regeln erstellen ==
69 +
70 +Per Default werden neue Geräte bereits blockiert. Das heißt Sie in den regeln nur die Geräte oder Geräteklassen definieren die Sie zulassen möchten.
71 +
72 +=== Einzelnes Gerät an allen Plätzen erlauben ===
73 +
74 +Haben Sie Beispielsweise ein spezielles Maus-, Tastatur- oder Webcam Modell, so können Sie dieses eine Gerät für alle Plätze freigeben. Hierzu müssen Sie zunächst über (% id="cke_bm_155072S" style="display:none" %) (%%) {{status title="Peripherie"/}} (% id="cke_bm_78664S" style="display:none" %){{status title="Peripherie"/}}(%%) -> {{status title="USB-Geräte"/}} die PID:VID (Product & Vendor ID) zu Ihrem Produkt ermitteln. Anhand diesem kann ein Gerätemodell eindeutig identifiziert werden.
75 +
76 +[[image:usb_guard_04.png||alt="USB Guard Expertenkonfiguration" width="800"]]
77 +
78 +
79 +Dies geschieht anhand der Inferace Klasse. Es gibt 8 Geräteklassen die Sie erlauben können:
80 +
81 +1. Mass Storage Class (MSC): **08**
82 +1. Human Interface Device Class (HID): **03**
83 +1. Communication Device Class (CDC): **02**
84 +1. Audio Device Class (ADC): **01**
85 +1. Printer Device Class (PDC): **07**
86 +1. Image Device Class (IDC): **06**
87 +1. Still Image Capture Device Class (SICDC): **06**
88 +1. Video Device Class (VDC): **0E**
89 +1. HUB: **09**
90 +
91 +Eine Regel um zum Beispiel alle HID Geräte (Maus/Tastatur + HUBs) zu erlauben sähe dann so aus:
92 +
93 +allow with-interface one-of { 09:*:* 03:*:* }
94 +
95 +
96 +Sie können beliebig viele Inferfaceklassen hintereinander schreiben. Mit dieser  Kombination würden Sie HUBs + HIDs + Kameras + Audio Geräte erlauben:
97 +
98 +{ 09:*:* 03:*:* 0E:*:* 01:*:* }
99 +
100 +
101 +Bitte beachten Sie, dass wenn Sie die HUB Klasse (09) entfernen, verlieren Sie automatisch auch den Zugriff auf daran angeschlossene Geräte, auch wenn deren Klassen freigegeben sind.
1729856493274-643.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.twintrich
Size
... ... @@ -1,0 +1,1 @@
1 +126.5 KB
Content
usb_guard_03.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.twintrich
Size
... ... @@ -1,0 +1,1 @@
1 +177.6 KB
Content
usb_guard_04.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.twintrich
Size
... ... @@ -1,0 +1,1 @@
1 +116.1 KB
Content