Skip to Content

Wiki source code of HD Browser Redirection

Version 2.1 by rangee rangee on 2023/03/27 15:31
Show last authors
1 (% class="auto-cursor-target" %)
2
3
4 {{info title="Voraussetzungen"}}
5 **Firmware und Software (empfohlen):**
6
7 **RangeeOS**
8
9 * firmware x64 - 11.00 Build 302
10 * Hybrid Desktop Browser Redirection 11.00 Build 008
11
12 **Zur Nutzung des ICA Channels (Optional)**
13
14 * ICA 22.09 11.00 (mindestens Build 008) oder höher
15 * Hybrid Desktop Channel_1.0-x64 Build 003
16 * [[Richtlinie für Positivliste der virtuellen Kanäle unter Citrix>>doc:HowTos.Citrix - Positivliste für virtuelle Kanäle anlegen.WebHome]]
17
18 **Lizenz:**
19
20 * HybridDesktop Browser Redirection //oder Rangee Browser Redirection (nicht in "All" enthalten)//
21
22 **Browser auf Serverseite:**
23
24 * Google Chrome //([[Download>>url:https://www.google.com/chrome/||shape="rect"]])// oder Microsoft Edge (Chrome basiert)
25 * Plugin: HD BrowserRedirection Extension// ([[Download>>https://chrome.google.com/webstore/detail/hd-browserredirection-ext/kgihjigonjmklfpbmagbdofjafegeoke?hl=de||shape="rect"]])//
26
27 **Auf Serverseite:**
28
29 * HybridDesktopBrowser Redirection Connector 1.2.0.0
30 * HybridDesktop Channel Agent 1.0.2.1
31 * HybridDesktop Channel for ICA 1.0.0.0
32 {{/info}}
33
34 Die HybridDesktop Browser Redirection erlaubt es vorgegebene Seiten über einen dem Serverbrowser vorgelagerten, lokalen Browser darzustellen. Hierdurch wird bei Wiedergabe von Medien oder auch bei der Nutzung von Konferenz- und Videotelefonielösungen eine deutlich bessere Performance erreicht, als es über eine RDP/ICA/PCOIP-Verbindung oder sonstige Remoteprotokolle möglich ist.
35
36 {{toc outline="true"/}}
37
38 = Client =
39
40 == Installation ==
41
42 Installieren Sie auf der Thin Client Seite
43
44 Firmware 11.00 Build 302
45
46 und das Softwaremodul "hybrid-desktop-browser-redirection"
47
48 Zur Verwendung des Citrix ICA-Channels wird zusätzlich das Paket "hybrid-desktop-channel_1.0-x64" benötigt.
49
50 Außerdem benötigen sie einen passenden ICA Client (Versionen siehe oben).
51
52 [[image:Main.WebHome@Rangee_Browser_Redirection_02_02_23.png||data-xwiki-image-style-border="true"]]
53
54 Eine Anleitung zur Installation von Software- und Firmwareupdates finden Sie [[hier>>doc:HowTos.RangeeOS - Firmware- und Softwareupdate.WebHome]].
55
56 == Konfiguration ==
57
58 {{id name="Thin Client - Konfiguration"/}}
59
60 Navigieren Sie nach der Installation zu {{status title="Verbindungen & Anwendungen"/}} → {{status title="HYBRID DESKTOP BROWSER REDIRECTION - KONFIGURATION"/}}
61
62 [[image:attach:Screenshot 2022-12-12 154713.png]]
63
64 {{info title="Lizenzfehler"}}
65 Wird Ihnen auf dieser Seite anstelle der Optionen ein Lizenzfehler angezeigt, so ist auf dem Gerät aktuell keine gültige Lizenz für die Rangee Browser Redirection vorhanden.
66
67 [[image:attach:Screenshot 2022-12-12 161158.png]]
68
69 Sollten Sie bereits eine Lizenz für das Modul besitzen, können Sie diese Lizenz wie [[hier >>doc:HowTos.Allgemein - Rangee Lizenzierung.Allgemein - Client Lizenzen abrufen bzw\. installieren.WebHome]] beschrieben hinterlegen.
70
71 Wenn noch keine Lizenz für das Modul besitzen, können Sie über unseren [[Vertrieb >>url:https://rangee.com/kontakt/||shape="rect"]]oder unser [[Kontaktformular >>url:https://rangee.com/kontakt/||shape="rect"]] eine Lizenz erwerben oder eine 30 tägige Demo Lizenz anfragen.
72 {{/info}}
73
74 === Optionen ===
75
76 {{info}}
77 Eine Erklärung aller weiteren verfügbaren Optionen, wird mit einem Klick auf das blaue Fragenzeichensymbol (oben rechts) eingeblendet.
78 {{/info}}
79
80 Hier eine Übersicht über die Wichtigsten Optionen:
81
82 (% style="list-style-type:square" %)
83 * **Aktivieren:** Mit dieser Option wird der Remote Browser Dienst aktiviert
84 Sobald der Dienst aktiviert ist, erscheint ein entsprechendes Icon im Tray des Thin Clients:{{lightbox image="01-rangee-browser-redirection-tray.PNG" group="1"/}}
85 * **Zulässige Webseiten:** An dieser Stelle kann eine beliebige Anzahl von Webseiten (ein Eintrag je Zeile) zur Weiterleitung definiert werden. Der Eintrag muss inkl. HTTP oder HTTPS erfolgen. "*" kann beliebig oft als Wildcard eingesetzt werden.
86 * **Erlaube Weiterleitung vom Benutzer definierter Webseiten:** Mit dieser Option erlauben Sie Benutzern beliebige Webseiten weiterzuleiten. Über das zugehörige Browser Plugin kann der Nutzer, wenn diese Option aktiviert ist, eine eigene Liste weiterzuleitender Webseiten anlegen oder die aktuelle Webseite per Knopfdruck weiterleiten.
87 * **Verbindungsmodus:** Mit dieser Option wird festgelegt wie die Kommunikation zwischen Server und Client stattfinden soll. Wählen Sie hier "Websocket" für die generische TCP basierte VErbindung oder "Channel" für die Nutzung des Citrix ICA-Channels aus.
88
89 (% id="HTaskbarEinstellungen28Optional-empfohlen29" class="auto-cursor-target" %)
90 == Server ==
91
92 == Installation des "HybridDesktop Redirection Connectors" ==
93
94 {{id name="Configuration Utility"/}}
95
96 Über den "HybridDesktop Redirection Connector" kann das Browser Plugin im Hintergrund die aktuelle IP des Thin Clients automatisch abfragen oder es kann der komplette Verkehr über ein entsprechendes Channel Plugin getunnelt werden.
97
98 Hierduch kann, komfortabel, mit wechselnden Client IP Adressen gearbeitet werden.
99
100 [[image:attach:Screenshot 2022-12-12 160243.png]]
101
102 == Installation der Chrome "HD BrowserRedirection Extension" ==
103
104 === Option 1 - Manuell je User ===
105
106 {{info}}
107 Bei verwendung des Microsoft Edge Browser muss zunächst der Installation von Erweiterungen aus anderen Stores zugestimmt werden. Siehe hierzu[[ Hinzufügen, Deaktivieren oder Entfernen von Erweiterungen in Microsoft Edge>>url:https://support.microsoft.com/de-de/microsoft-edge/hinzuf%C3%BCgen-deaktivieren-oder-entfernen-von-erweiterungen-in-microsoft-edge-9c0ec68c-2fbc-2f2c-9ff0-bdc76f46b026]]
108 {{/info}}
109
110 Öffnen Sie [[https:~~/~~/chrome.google.com/webstore/detail/hd-browserredirection-ext/kgihjigonjmklfpbmagbdofjafegeoke?hl=de>>https://chrome.google.com/webstore/detail/hd-browserredirection-ext/kgihjigonjmklfpbmagbdofjafegeoke?hl=de||shape="rect"]] oder Suchen Sie im Chrome Store nach "HD BrowserRedirection Extension" und wählen Sie {{status title="HINZUFÜGEN"/}} (ganz unten).
111
112 [[image:attach:HDbrowserredirectionchromestore.png||data-xwiki-image-style-border="true"]]
113
114 === Option 2 - Automatisch per GPO ===
115
116 Ein Anleitung zur Verteilung von Chrome Plugins per GPO finden Sie [[hier>>url:https://support.google.com/chrome/a/answer/7649924?hl=en&ref_topic=7649835||shape="rect"]].
117
118 Daten des Plugins:
119
120 **id:** kgihjigonjmklfpbmagbdofjafegeoke
121 **update_url:** [[https:~~/~~/clients2.google.com/service/update2/crx>>url:https://clients2.google.com/service/update2/crx||shape="rect"]]
122
123 {{info}}
124 Die Verteilung per Gruppenrichtlinie ist aktuell nur für den Google Chrome Browser möglich. Microsoft bietet hier keine Richlinie zur automatischen Installation von Plugins aus anderen Stores an.
125 {{/info}}
126
127 == Konfiguration der Chrome "HD BrowserRedirection Extension" ==
128
129 Öffnen Sie die Optionen des Chrome Plugins
130
131 [[image:attach:Screenshot 2022-12-12 160850.png]]
132
133 Mit Standardeinstellungen versucht das Plugin über den "HybridDesktop Redirection Connector" den Thin Client und die benötigen Einstellungen zu ermitteln.
134
135 [[image:attach:HDbrowserredirectionchromesettings.png||data-xwiki-image-style-border="true"]]
136
137 Wird Ihnen hier ein grünes Status Icon angezeigt, so ist die Konfiguration abgeschlossen. Falls nicht, müssen weitere Einstellungen händisch vorgenommen werden.
138
139 === Einstellungen ===
140
141 **Remote Browser Mode:** Hier gibt es die Wahl zwischen Auto (Channel/IP-Detection) und Manual. Im Auto Modus werden die notwendigen Daten durch den HybridDesktop Redirection Connector automatisch hinterlegt. Im Manuellen Modus hingegen müssen die Verbindungseinstellungen händisch konfiguriert werden.
142
143 **IP-Address:** Hier steht Entweder die IP des Clients (Modus -> Websocket auf Clientseite) oder "HybridDesktop Channel"
144
145 **Port:** Port für die Websocket Kommunikation oder leer wenn Modus Channel auf Clientseite
146
147 **Session Token:** Token für die Websocket Kommunikation oder leer wenn Modus Channel auf Clientseite
148
149 **Remoting URLs (server defined):** wird automatisch bei erfolgreicher Verbindung ausgefüllt, zeigt alle weiterzuleitenen Seiten an (auf Thin Client Seite konfiguriert)
150
151 **Remoting URLs (userdefined): **In dieser Liste kann der User selbstständig Seiten zur dauerhaften Weiterleitung konfigurieren (Option //"Erlaube Weiterleitung vom Benutzer definierter Webseiten"// muss auf Thin Client Seite gesetzt sein)
152
153 === Anzeige des Plugin Status Icons (Optional) ===
154
155 Zur Anzeige des aktuellen Plugin Status, muss das Plugin zunächst angepinnt werden
156
157 {{lightbox image="10-rangee-browser-redirection-ping-plugin.PNG" group="1"/}}
158
159 Das Plugin kann folgende Status anzeigen:
160
161 (% style="list-style-type:square" %)
162 * [[image:attach:icon0.png]]Plugin aktiv und erfolgreich konfiguriert, aktueller Tab wird nicht weitergeleitet
163 * [[image:attach:icon1.png]]Plugin aktiv und konfiguriert, aktueller Tab wird umgeleitet
164 * [[image:attach:icon2.png]]Plugin nicht aktiv - Eventuell Fehler in Konfiguration oder Thin Client nicht erreichbar - Optionsseite für genauere Meldung überprüfen
165
166 === Aktuelle Webseite weiterleiten ===
167
168 Wenn die Option //"Erlaube Weiterleitung vom Benutzer definierter Webseiten"// auf Thin Client Seite aktiviert ist, kann jede beliebige aktuell angezeigte Webseite über einen Klick auf das Plugin Icon sofort weitergeleitet werden.