Last modified by Tobias Wintrich on 2023/06/21 13:03

Show last authors
1 (% class="auto-cursor-target" %)
2
3
4 {{info title="Prerequisites"}}
5 **Firmware and software (recommended):**
6
7 **RangeeOS**
8
9 * firmware x64 - 11.00 build 302
10 * Hybrid Desktop Browser Redirection 11.00 Build 008
11
12 **To use the ICA Channel (Optional)**
13
14 * ICA 22.09 11.00 (at least build 008) or higher
15 * Hybrid Desktop Channel_1.0-x64 Build 003
16 * [[Guideline for Positive List of Virtual Channels under Citrix>>doc:HowTos.Citrix - Create Positive List for Virtual Channels.WebHome]]
17
18 **License:**
19
20 * HybridDesktop Browser Redirection //or Rangee Browser Redirection (not included in "All")//
21
22 **Browser on server side:**
23
24 * Google Chrome //([[Download>>url:https://www.google.com/chrome/||shape="rect"]])// or Microsoft Edge (Chrome based)
25 * Plugin: HD BrowserRedirection Extension// ([[Download>>https://chrome.google.com/webstore/detail/hd-browserredirection-ext/kgihjigonjmklfpbmagbdofjafegeoke?hl=de||shape="rect"]])//
26
27 **On the server side:**
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 HybridDesktop Browser Redirection allows to display specified pages via a local browser upstream of the server browser. This provides significantly better performance when playing media or using conferencing and video telephony solutions than is possible via an RDP/ICA/PCOIP connection or other remote protocols.
35
36 {{toc outline="true"/}}
37
38 = Client =
39
40 == Installation ==
41
42 Install on the thin client side
43
44 Firmware 11.00 Build 302
45
46 and the software module "hybrid-desktop-browser-redirection
47
48 To use the Citrix ICA channel, the package "hybrid-desktop-channel_1.0-x64" is also required.
49
50 You also need a suitable ICA client (see above for versions).
51
52 [[image:attach:Rangee_Browser_Redirection_02_02_23.png||data-xwiki-image-style-border="true"]]
53
54 Instructions for installing software and firmware updates can be found [[here>>doc:HowTos.RangeeOS - Firmware and Software Update.WebHome]].
55
56 == Configuration ==
57
58 {{id name="Thin Client - Configuration"/}}
59
60 After installation, navigate to {{status title="Connections & Applications"/}} → {{status title="HYBRID DESKTOP BROWSER REDIRECTION - CONFIGURATION"/}}
61
62 [[image:attach:Screenshot 2022-12-12 154713.png]]
63
64 {{info title="License error"}}
65 If you see a license error instead of options on this page, there is currently no valid license for Rangee Browser Redirection on the device.
66
67 [[image:attach:Screenshot 2022-12-12 161158.png]]
68
69 If you already have a license for the module, you can deposit this license as [[here >>doc:HowTos.General - Rangee Licensing.General - Get or Install Client Licenses.WebHome]] described.
70
71 If you don't have a license for the module yet, you can purchase a license through our [[Sales >>url:https://rangee.com/kontakt/||shape="rect"]]or our [[Contact form >>url:https://rangee.com/kontakt/||shape="rect"]] or request a 30-day demo license.
72 {{/info}}
73
74 === Options ===
75
76 {{info}}
77 An explanation of all other available options, is displayed with a click on the blue question mark icon (top right).
78 {{/info}}
79
80 Here is an overview of the most important options:
81
82 (% style="list-style-type:square" %)
83 * **Enable:** This option enables the Remote Browser service.
84 Once the service is enabled, a corresponding icon will appear in the tray of the thin client:{{lightbox image="01-rangee-browser-redirection-tray.PNG" group="1"/}}
85 * **Allowed websites:** At this point, any number of websites (one entry per line) can be defined for forwarding. The entry must include HTTP or HTTPS. "*" can be used as a wildcard as often as desired.
86 * **Allow forwarding of user defined web pages:** With this option you allow users to forward any web pages. Using the associated browser plugin, if this option is enabled, the user can create their own list of web pages to forward or forward the current web page with the click of a button.
87 * Connection mode: This option defines how the communication between server and client should take place. Select "Websocket" for the generic TCP based connection or "Channel" for the use of the Citrix ICA channel.
88
89 (% id="HTaskbarSettings28Optional-Recommended29" class="auto-cursor-target" %)
90 = Server =
91
92 == Installation of the "HybridDesktop Redirection Connector" ==
93
94 {{id name="Configuration Utility"/}}
95
96 Using the "HybridDesktop Redirection Connector", the browser plugin can automatically query the current IP of the thin client in the background, or the entire traffic can be tunneled using a corresponding channel plugin.
97
98 This makes it convenient to work with changing client IP addresses.
99
100 [[image:attach:Screenshot 2022-12-12 160243.png]]
101
102 == Installation of the Chrome "HD BrowserRedirection Extension" ==
103
104 === Option 1 - Manual per user ===
105
106 {{info}}
107 When using the Microsoft Edge browser, you must first agree to the installation of extensions from other stores. See[[ Add, disable or remove extensions 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 Open [[https:~~/~~/chrome.google.com/webstore/detail/hd-browserredirection-ext/kgihjigonjmklfpbmagbdofjafegeoke?hl=en>>https://chrome.google.com/webstore/detail/hd-browserredirection-ext/kgihjigonjmklfpbmagbdofjafegeoke?hl=de||shape="rect"]] or search for "HD BrowserRedirection Extension" in the Chrome Store and select {{status title="ADD"/}} (at the very bottom).
111
112 [[image:attach:HDbrowserredirectionchromestore.png||data-xwiki-image-style-border="true"]]
113
114 === Option 2 - Automatically via GPO ===
115
116 A guide to distributing Chrome plugins via GPO can be found [[here>>url:https://support.google.com/chrome/a/answer/7649924?hl=en&ref_topic=7649835||shape="rect"]].
117
118 Plugin data:
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 The distribution via group policy is currently only possible for the Google Chrome browser. Microsoft does not offer a guideline for the automatic installation of plugins from other stores.
125 {{/info}}
126
127 == Configuration of the Chrome "HD BrowserRedirection Extension" ==
128
129 Open the options of the Chrome plugin
130
131 [[image:attach:Screenshot 2022-12-12 160850.png]]
132
133 With default settings, the plugin tries to determine the thin client and the required settings via the "HybridDesktop Redirection Connector".
134
135 [[image:attach:HDbrowserredirectionchromesettings.png||data-xwiki-image-style-border="true"]]
136
137 If a green status icon is displayed here, the configuration is complete. If not, further settings must be made manually.
138
139 === Settings ===
140
141 **Remote Browser Mode: ** Here you can choose between Auto (Channel/IP-Detection) and Manual. In Auto mode, the necessary data is automatically stored by the HybridDesktop Redirection Connector. In Manual mode, on the other hand, the connection settings must be configured manually.
142
143 **IP-Address:** Either the IP of the client (mode -> websocket on client side) or "HybridDesktop Channel".
144
145 **port:** port for websocket communication or empty if mode channel on client side
146
147 **Session token:** Token for the websocket communication or empty if mode channel on client side
148
149 **Remoting URLs (server defined):** is filled in automatically on successful connection, shows all pages to be redirected (configured on thin client side)
150
151 **Remoting URLs (user-defined): **In this list, the user can independently configure pages for permanent redirection (option //"Allow redirection of user-defined web pages"// must be set on thin client side).
152
153 === Display of the plugin status icon (optional) ===
154
155 To display the current plugin status, the plugin must first be pinned
156
157 {{lightbox image="10-rangee-browser-redirection-ping-plugin.PNG" group="1"/}}
158
159 The plugin can display the following statuses:
160
161 (% style="list-style-type:square" %)
162 * [[image:attach:icon0.png]]Plugin active and successfully configured, current tab is not redirected
163 * [[image:attach:icon1.png]]Plugin active and configured, current tab is redirected
164 * [[image:attach:icon2.png]]Plugin not active - Possibly error in configuration or Thin Client not reachable - Check options page for more detailed message
165
166 === Forward current web page ===
167
168 If the //"Allow redirection of user-defined web pages"// option is enabled on Thin Client page, any currently displayed web page can be redirected immediately by clicking the plugin icon.
Rangee GmbH ©2022