Wiki source code of Rangee - Browser Redirection

Version 30.1 by rangee rangee on 2021/09/22 14:07

Hide last authors
tobias 28.2 1 (% class="auto-cursor-target" %)
Tobias Wintrich 29.1 2
tobias 28.2 3
4 {{info title="Voraussetzungen"}}
5 **Firmware und Software:**
6
7 firmware x64 - 11.00 Build 133
8 rangee-browser-redirection  - 11.00 build 005
9
10 **Lizenz:**
11
12 Browser Redirection //(nicht in "All" enthalten)//
13
14 **Browser auf Serverseite:**
15
16 Google Chrome //([[Download>>url:https://www.google.com/chrome/||shape="rect"]])//
17
Tobias Wintrich 29.1 18 Plugin: Rangee - Browser Redirection Extension// ([[Download>>url:https://chrome.google.com/webstore/detail/rangee-browser-redirectio/ehgbdadgapifmainlghihmabodkpgenn||shape="rect"]])//
tobias 28.2 19
20 **Remoteverbindung:**
21
22 Aktuell können nur im Modus "Vollbild" gestartete Verbindungen unterstützt werden
23 {{/info}}
24
25 Die Rangee Browser Redirection erlaubt es dem Viewport definierte Seiten über einen 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 Remotingprotokolle möglich ist.
26
27
28
29 {{toc outline="true"/}}
30
31 = Thin Client =
32
33 == Installation ==
34
35 Installieren Sie auf Thin Client Seite die aktuellste Firmware Version (min. 11.00 build 133) sowie das Softwaremodul rangee-browser-redirection . Um die Funktion sinnhaft nutzen zu können, sollte zudem mindestens ein Remotingprotokoll (z.B.: RDP, ICA, VMWare View...) installiert sein.
36
37 [[image:attach:01-rangee-browser-redirection-software-thinclient.PNG]]
38
39 Eine Anleitung zur Installation von Software- und Firmwareupdates finden Sie [[hier>>doc:Rangee Firmware- und Softwareupdate Update]].
40
Tobias Wintrich 29.1 41 == Konfiguration ==
tobias 28.2 42
43 {{id name="Thin Client - Konfiguration"/}}
44
rangee rangee 30.1 45 Navigieren Sie nach der Installation zu (% class="mark" %)VERBINDUNGEN(%%) → (% class="mark" %)RANGEE BROWSER REMOTE DAEMON - KONFIGURATION
tobias 28.2 46
Tobias Wintrich 29.1 47 **[[image:attach:BrowserRedirectionConfig.PNG]]**
tobias 28.2 48
49 {{info title="Lizenzfehler"}}
50 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.
51
52 [[image:attach:01-rangee-browser-redirection-lizenzfehler.PNG]]
53
54 Sollten Sie bereits eine Lizenz für das Modul besitzen, können Sie diese Lizenz wie [[hier >>doc:Client Lizenzen abrufen bzw\. installieren]]beschrieben hinterlegen.
55
56 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.
57 {{/info}}
58
59 === Optionen ===
60
61 {{info}}
62 Eine Erklärung aller weiteren verfügbaren Optionen, wird mit einem Klick auf das blaue Fragenzeichensymbol (oben rechts) eingeblendet.
63 {{/info}}
64
65 Hier eine Übersicht über die Wichtigsten Optionen:
66
Tobias Wintrich 29.1 67 (% style="list-style-type:square" %)
tobias 28.2 68 * **Aktivieren:** Mit dieser Option wird der Remote Browser Dienst aktiviert
69 Sobald der Dienst aktiviert ist, erscheint ein entsprechendes Icon im Tray des Thin Clients:
70 [[image:attach:01-rangee-browser-redirection-tray.PNG]]
71 * **Port:** Über diesen Port kann das Chrome Server Plugin mit dem Remote Dienst kommunizieren. Der Client muss von Serverseite aus über diesen Port erreichbar sein.
72 * **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.
73 * **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.
74 * **Automatisches Zugriffstoken:** Mit dieser Option wird bei jedem Start des Daemons ein neues Zugriffstoken zur Steuerung des Dienstes definiert. Das Token muss auf Client- und Serverseite stets identisch konfiguriert sein. Der Austausch des Tokens kann über das "Rangee Browser Redirector - Configuration Utility" automatisiert vorgenommen werden. Ist dies nicht möglich, wird hier das Setzen eines manuellen Tokens empfohlen.
75
Tobias Wintrich 29.1 76 (% class="auto-cursor-target" id="HTaskbarEinstellungen28Optional-empfohlen29" %)
tobias 28.2 77 == Taskbar Einstellungen (Optional - empfohlen) ==
78
rangee rangee 30.1 79 Um eine Überlagerung der lokalen Thin Client Taskbar mit der Server Taskbar bei einem aktiven Browser Redirection Tab zu verhindern, wird empfohlen diese unter (% class="mark" %)DESKTOP-KONFIGURATION(%%) entweder zu deaktivieren oder die Option "Automatisch ausblenden" zu konfigurieren.
tobias 28.2 80
81 [[image:attach:04-rangee-browser-redirection-traskbar.PNG]]
82
83 = Server =
84
85 == Installation der "Rangee Browser Redirector - Configuration Utility" (Optional - empfohlen) ==
86
87 {{id name="Configuration Utility"/}}
88
89 Über die "Rangee Browser Redirector - Configuration Utility" kann das Browser Plugin im Hintergrund die aktuelle IP des Thin Clients, den zu verwendenden Port sowie das aktuelle Zugriffstoken automatisch abfragen. Hierduch kann, komfortabel, mit wechselnden Client IP Adressen und automatisch generierten Zugriffstoken gearbeitet werden.
90
91 [[image:attach:05-rangee-browser-redirection-server-app.PNG]]
92
93 == Installation der Chrome "Rangee - Browser Redirection Extension" ==
94
95 === Option 1 - Manuell je User ===
96
97 Öffnen Sie [[https:~~/~~/chrome.google.com/webstore/detail/rangee-browser-redirectio/ehgbdadgapifmainlghihmabodkpgenn>>url:https://chrome.google.com/webstore/detail/rangee-browser-redirectio/ehgbdadgapifmainlghihmabodkpgenn||shape="rect"]] oder Suchen Sie im Chrome Store nach "Rangee - Browser Redirection Extension" und wählen Sie
98
99 {{status title="Hinzufügen"/}} (ganz unten)
100
101 [[image:attach:06-rangee-browser-redirection-add-extension.PNG]]
102
103 === Option 2 - Automatisch per GPO ===
104
105 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"]].
106
107 Daten des Plugins:
108
109 **id:** ehgbdadgapifmainlghihmabodkpgenn
110 **update_url:** [[https:~~/~~/clients2.google.com/service/update2/crx>>url:https://clients2.google.com/service/update2/crx||shape="rect"]]
111
112 == Konfiguration der Chrome "Rangee - Browser Redirection Extension" ==
113
114 Öffnen Sie die Optionen des Chrome Plugins
115
116 [[image:attach:07-rangee-browser-redirection-config-extension.PNG]]
117
118 Mit Standardeinstellungen versucht das Plugin über das "Rangee Browser Redirector - Configuration Utility" den Thin Client und die benötigen Einstellungen über eine aktive RDP Verbindung zu ermitteln.
119
120 [[image:attach:08-rangee-browser-redirection-config-OK.PNG]]
121
122 Wird Ihnen hier ein grünes Status Icon angezeigt, so ist die Konfiguration abgeschlossen. Falls nicht, müssen weitere Einstellungen händisch vorgenommen werden.
123
124 === Einstellungen ===
125
126 **Remote Browser Mode:** Im Manuellen Modus, müssen die Verbindungseinstellungen händisch konfiguriert werden. Im Modus RDP/ICA/VMWare View ermittelt das Plugin alle weiteren Einstellungen automatisch (nur in Verbindung mit installierter "[[Rangee Browser Redirector - Configuration Utility>>doc:||anchor="Configuration Utility"]]")
127
128 **IP-Address:** IP Adresse oder Hostname des Thin Clients
129
130 **Port:** zu verwendender Port (gleicher Port wie unter [[Thin Client - Konfiguration>>url:https://rangee.com/knowledgebase/display/RAN/Rangee+-+Browser+Redirection#RangeeBrowserRedirection-ThinClient-Konfiguration||shape="rect"]] konfiguriert)
131
132 **Session Token:** Das unter [[Thin Client - Konfiguration>>url:https://rangee.com/knowledgebase/display/RAN/Rangee+-+Browser+Redirection#RangeeBrowserRedirection-ThinClient-Konfiguration||shape="rect"]] konfigurierte Session Token
133
134 **Remoting URLs (server defined):** wird automatisch bei erfolgreicher Verbindung ausgefüllt, zeigt alle weiterzuleitenen Seiten an (auf Thin Client Seite konfiguriert)
135
136 **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)
137
138 [[image:attach:07-rangee-browser-redirection-config-rdp.PNG]]
139
140 === Anzeige des Plugin Status Icons (Optional) ===
141
142 Zur Anzeige des aktuellen Plugin Status, muss das Plugin zunächst angepinnt werden
143
144 [[image:attach:10-rangee-browser-redirection-ping-plugin.PNG]]
145
146 Das Plugin kann folgende Status anzeigen:
147
Tobias Wintrich 29.1 148 (% style="list-style-type:square" %)
tobias 28.2 149 * [[image:attach:11-rangee-browser-redirection-plugin-state-OK.PNG]]Plugin aktiv und erfolgreich konfiguriert, aktueller Tab wird nicht weitergeleitet
150 * [[image:attach:11-rangee-browser-redirection-plugin-state-OK-active.PNG]]Plugin aktiv und konfiguriert, aktueller Tab wird umgeleitet
151 * [[image:attach:11-rangee-browser-redirection-plugin-state-inactive.PNG]]Plugin nicht aktiv - Eventuell Fehler in Konfiguration oder Thin Client nicht erreichbar - Optionsseite für genauere Meldung überprüfen
152
153 === Aktuelle Webseite weiterleiten ===
154
155 Wenn die Option //"Erlaube Weiterleitung vom Benutzer definierter Webseiten"//  auf Thin Client aktiviert ist, kann jede beliebige aktuell angezeigte Webseite über einen Klick auf das Plugin Icon sofort weitergeleitet werden.
156
Tobias Wintrich 29.1 157