Hotspot Browser Documentation

Commentaren

Transcriptie

Hotspot Browser Documentation
Hotspot Browser Documentation
Release 2.0.2
Glück & Kanja Consulting AG
Version 2016-11-04
Contents
1
Einleitung
2
Dokumentation
2.1 Grundlagen . . . . . . . . . . .
2.2 Überprüfung des Onlinestatus
2.3 Installation . . . . . . . . . . .
2.4 Einstellungen . . . . . . . . . .
2.5 Frequently Asked Questions .
2.6 Support . . . . . . . . . . . . .
2.7 Version History . . . . . . . . .
2.8 Lizenz . . . . . . . . . . . . . .
2.9 Kontakt . . . . . . . . . . . . .
1
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
2
2
4
4
5
7
7
8
9
12
i
ii
CHAPTER 1
Einleitung
Bei Nutzung öffentlicher WLAN Access Points (‚Hotspots’) für den Internet-Zugriff wird der
Web-Browser des Anwenders üblicherweise zunächst auf die Startseite des Hotspot-Betreibers
umgeleitet. Auf dieser Seite erfolgt dann die Eingabe von Abrechnungsinformationen (Kreditkartendaten oder Anmeldedaten). Nach erfolgreicher Anmeldung ist der Zugriff auf das
Internet möglich. Es kann dann beispielsweise ein Web-Browser verwendet oder eine VPN
Verbindung aufgebaut werden.
Unter Umständen ist der Browser (z.B. Internet Explorer) nicht in der Lage, die Startseite des
Hotspots zu adressieren. Dies kann der Fall sein, wenn in den Browser-Einstellungen ein
sogenannter Proxy-Server voreingestellt ist. In diesem Fall versucht der Browser immer seine
Zieladresse über diesen Proxy-Server, der in dem WLAN-Segement nicht erreichbar ist, zu
erreichen. Gleiches gilt, wenn auch noch ein VPN-Verbindung aufgebaut werden muss, denn
auch die VPN-Verbindung kann ohne die vorherige Anmeldung am Hotspot nicht aufgebaut
werden.
Um ein sicheres Verbinden mit der Anmeldeseite eines WLAN-Hotspots zu gewährleisten,
wurde der Hotspot Browser entwickelt. Der Hotspot Browser ist ein minimaler Webbrowser,
der sich nur starten lässt, wenn sich der Benutzer nicht im öffentlichen Internet befindet.
Weitere Informationen und Bezugsquellen finden Sie auf der Website zum Hotspot Browser.
1
CHAPTER 2
Dokumentation
2.1 Grundlagen
Der Hotspot Browser wird als Windows-Installationspaket geliefert und lässt sich sowohl auf
einem Einzelplatz installieren als auch in einer gemanagten Enterprise-Umgebung über eine
Softwareverteilung einrichten.
2.1.1 Anwendung
Die Hotspot Browser Anwendung besteht aus einem Fenster mit zwei Komponenten: Hauptmenü und Toolbar.
2
Hotspot Browser Documentation, Release 2.0.2
2.1.2 Ablauf
Beim Starten überprüft der Hotspot Browser, ob eine Verbindung zum öffentlichen Internet
besteht.
Wenn eine Verbindung besteht, gibt er eine Meldung aus und beendet sich, ohne das Hauptfenster darzustellen. Wenn keine Verbindung besteht, wird das Hauptfenster dargestellt und
es wird versucht, die konfigurierte Startseite zu laden. Die Anfrage nach der Startseite wird
vom Hotspot umgeleitet und man erreicht die Startseite des Anbieters, auf der man sich dann
für das Internet freischalten lassen kann.
Wenn der Hotspot Browser einmal gestartet ist, überprüft er im Hintergrund den Onlinestatus.
Der Intervall für die Prüfung ist variabel konfigurierbar. Sobald festgestellt wurde, dass der
Onlinestatus gegeben ist, wird eine Meldung angezeigt und weiteres Arbeiten im Hotspot
Browser ist nicht mehr möglich.
2.1. Grundlagen
3
Hotspot Browser Documentation, Release 2.0.2
2.2 Überprüfung des Onlinestatus
2.2.1 CaptivePortalDetect
CaptivePortalDetect versucht eine HTTP-Verbindung zu einer zuvor konfigurierten URL
aufzubauen. Sollte der Verbindungsaufbau gelingen und somit der erwartete HTTP-Status
zurückgeliefert werden, wird davon ausgegangen, dass eine Internetverbindung besteht.
Sollte beim Aufruf der konfigurierten URL nicht der erwartete HTTP-Status geliefert werden
sondern ein anderer HTTP-Status oder auch ein Timeout, wird davon ausgegangen das ein
Captive-Portal verfügbar ist. Der oben beschriebene Vorgang wird von einem Hilfsprogramm
ausgeführt. Der sogenannte NetWatcher ist für das Prüfen und Auswerten zuständig und
übernimmt das Starten und Schließen des eigentlichen Hotspot Browsers.
2.2.2 Diagnostics
Nachdem ein Verbindungsversuch unternommen wurde besteht die Möglichkeit Diagnose Informationen auszulesen. Hierzu muss der Knopf “Diagnostics” betätigt werden. Weiterhin ist
es möglich jederzeit Diagnose Informationen über das Untermenü “Help” zu beziehen.
2.3 Installation
2.3.1 Installation Hotspot Browser
1. Führen Sie die HotspotBrowser-(version).msi mit administrativen Rechten aus.
2.2. Überprüfung des Onlinestatus
4
Hotspot Browser Documentation, Release 2.0.2
Bemerkung: Nachdem die Lizenzvereinbarungen akzeptiert wurden, ist das Fortsetzen mit
“install” möglich .
2.4 Einstellungen
2.4.1 Konfigurationsdatei
Die Konfiguration des Hotspot Browsers wird über eine Textdatei mit der Bezeichnung hsbrowser.ini durchgeführt. Diese Datei muss im gleichen Verzeichnis wie die ausführbare Datei
HSBrowser.exe liegen. Die in dieser Datei enthaltenen Konfigurationsparameter.
Der Hotspot Browser installiert sich in das Standard-Programmverzeichnis unter \Hotspot
Browser.
Damit Anwender keinen Einfluss auf das Verhalten des Hotspot Browsers haben können, sollte
Ihnen auf der Dateisystemebene lediglich das Leserecht auf diese Datei bzw. das komplette
Verzeichnis gewährt werden (ggfs. Logfile beachten).
2.4.2 Sektion: common
Startpage
Die Adresse, die beim Starten des Hotspot Browsers angefordert werden soll.
Beispiel:
2.4. Einstellungen
5
Hotspot Browser Documentation, Release 2.0.2
startpage=http://www.google.de
PreCheckStartpage
Prüft ob die unter startpage konfigurierte Adresse auflösbar und erreichbar ist. Diese Überprüfung findet vor dem Start des Hauptprogramms statt. Zusätzlich lassen sich mit “prechecktimeout” und “precheckfailmsg” die für diese Anfrage verwendete Zeitüberschreitung und
die im Fehlerfall angezeigte Meldung konfigurieren.
Beispiel:
precheckstartpage=1
prechecktimeout=3500
precheckfailmsg=Failed to open the providerpage!
IntervalTimer
Intervall, in dem zur Laufzeit überprüft wird, ob eine Internetverbindung besteht. Wird in
Sekunden angegeben. Zum Deaktivieren eine 0 angeben.
Beispiel:
IntervalTimer=10
Topmost
Fenstergröße: 1 = Hauptfenster in Maximalgröße und immer im Vordergrund 0 = Hauptfenster in Normalgröße
Beispiel:
topmost=0
2.4.3 Sektion: isinternet
CaptivePortalDetectURL
Diese URL wird für den Internet-Konnektivitätstest genutzt.
Beispiel:
CaptivePortalDetectURL=http://clients3.google.com/generate_204
CaptivePortalDetectExpectedStatus
Folgend konfigurierter HTTP-Status wird von der oben konfigurierten CaptivePortalDetectURL erwartet.
Beispiel:
2.4. Einstellungen
6
Hotspot Browser Documentation, Release 2.0.2
CaptivePortalDetectExpectedStatus=204
CaptivePortalDetectExpectedContent
Dieser Parameter kann als zusätzliche Methode für den Konnektivitätstest genutzt werden.
Folgendes Beispiel zeigt wie dies in Verbindung mit einem HTTP-Status 200 aussehen kann.
Beispiel:
CaptivePortalDetectURL=http://www.apple.com/library/test/success.html
CaptivePortalDetectExpectedStatus=200
CaptivePortalDetectExpectedContent=<HTML><HEAD><TITLE>Success</TITLE>
</HEAD><BODY>Success</BODY></HTML>
2.4.4 Benutzersicherheit:
• Benutzer können (bei korrekter Systemkonfiguration) keinerlei Settings ändern
• Benutzer können keine eigenen URLs angeben
• Sobald der Hotspot Browser eine Internetverbindung feststellt, beendet er sich automatisch
2.5 Frequently Asked Questions
2.5.1 Welche Installationsvoraussetzungen müssen erfüllt sein?
Windows XP, Windows Vista (32-Bit, 64-Bit), Windows 7 (32-Bit, 64-Bit) oder Windows 8 (32Bit, 64-Bit).
2.6 Support
2.6.1 Supportvertrag
Helpdesk
Erreichbarkeit 8 – 18 Uhr an Werktagen, Rückmeldung bei Störungsfällen innerhalb von 4 Std.
Support per E-Mail bei Fragen zur Einrichtung, Konfiguration, Updates und bei technischen
Problemen (im Ermessen des Anbieters auch telefonisch)
Feature Requests
Änderungen und Erweiterungen können im Ermessen des Anbieters priorisiert in Produktupdates einfließen
2.5. Frequently Asked Questions
7
Hotspot Browser Documentation, Release 2.0.2
Softwareaktualisierungen
Kostenfreie reguläre Softwareaktualisierungen innerhalb der Wartungslaufzeit
2.7 Version History
Version 2.1.4
• Add access to diagnostic information to the help menu
Version 2.0.0
• Windows 10 support
Version 1.9.0
• Add diagnostics
Version 1.8.6
• Bugfixes
Version 1.8.5
• Bugfixes
Version 1.8.4
• Bugfixes
Version 1.8.2
• Bugfixes
Version 1.8
• New version of browser component
• Bugfixes
Version 1.6
• Next Generation Browser Component
• New Hotspot Detection
Version 1.0.0.5
• printing now enabled
• removed print preview
Version 1.0.0.4
• changed name to HSExplorer
• checking for a internet connection every 60 seconds, exit if connection
detected
Version 1.0.0.3
• added version management trough “version.h”
Version 1.0.0.2
2.7. Version History
8
Hotspot Browser Documentation, Release 2.0.2
• disabled self registration of mozilla activex control
Version 1.0.0.1
• supports multiple windows (also opens links in new windows, if requested)
• disabled local file access and ftp access
• disabled file download
• mozilla activex control dialogs improved
• correct setting of windows title (e.g. “EnBW Browser - <HTML Page Title>”)
• xp style toolbar icons added
• minimum window size restricted to 640x480
Version 1.0
• Initial public version
2.8 Lizenz
Copyright (c) 2008-2014 Glueck & Kanja Consulting AG
Glück & Kanja Consulting AG - License Agreement from March 3, 2012
1. Introduction - This is the license agreement between the end user (below “user” is defined as either an individual person or a legal person) and the Glück & Kanja Consulting
AG, Kaiserstraße 39, 63065 Offenbach, Germany (below “Glück & Kanja”) about the right
to use (license) for all Glück & Kanja products and their respective demo-versions. While
the license agreement covers the legal aspects of all of these products, it is only valid for
the product or products (below “product”), which the user has received free of or with
charge from Glück & Kanja or a distributor.
2. Copyright/Reproduction - All Glück & Kanja products, including the complete documentation, are protected by copyright. However, the user is entitled to either (a) make
one single copy of the software product solely for back-up or archiving purposes, or (b)
to transfer the software product to one single hard disk, provided the user keeps the
original for the sole purpose of back-up or archiving.
3. Grant of General License - The user, who has purchased a general license for a product
for a respective fee from Glück & Kanja or a distributor, is entitled to operate one copy of
the product on any computer, provided that the product is in use on only one computer at
any given time. The product is in use on one computer if it is loaded in a temporary data
medium (e.g. RAM) or saved on one non-volatile memory (e.g. hard drive, CD-ROM, or
another data medium) of this computer.
4. Multiple-Shift Usage and Network Use - The use of the product within a network or
another multi-station computer system is not permitted, unless the possibility of simultaneous multiple-shift usage of the product is created. If the user would like to use the
product within a network or another multi-station computer system, he must prevent a
simultaneous multiple-shift usage through access protection mechanisms or purchase a
special multi-user license. If a user has purchased a multi-user license for a product, the
2.8. Lizenz
9
Hotspot Browser Documentation, Release 2.0.2
number of the permitted uses increases depending on the multi-user license. If the possible number of users in a network exceeds the number of permitted users of a multi-user
license, the user must make arrangements that assure that only the permitted number of
users can use the program simultaneously.
5. Varying License Models - If a special license model is agreed upon with an enterprise
within the context of a contract, these special provisions are valid in reference to the
number and use that differ from the above mentioned provisions through the contract
transferred licenses.
6. Grant of Demo License - When dealing with a demo-version of the product (also “Evaluation Copy”, “Beta Version”, “Pre-Release Version”, etc.), the user receives a temporary
right to use a copy of the product on any computer, provided that the product is in use on
only one computer at any given time. If the product is a pre-release version (also “Beta”,
“Preview”, “Technical Beta”, “Technical Preview”, “Release Candidate“ etc.), then this
license loses its validity with the release of the final version of the same product. If the
product is a free test version (“Evaluation Copy” etc.), this license expires thirty (30) days
after receipt (e.g. download); the license cannot be extended through renewed receipt or
downloading. Glück & Kanja reserves the right to withdraw every temporary license
without giving a reason.
7. Software in Different Versions - If the transferred software covers many versions (e.g.
different language versions, operating system versions), the user may only use one version of the supplied files for this software. The user may not use the other versions on a
different computer or computer network, nor may he rent, loan or transfer them to any
other user, unless a part of a transfer or use is expressly permitted in this license. If the
software is an upgrade or should this be increased to an upgrade, the software may only
be used together with previous versions or transferred. Every transfer of the license to a
third party must contain the newest upgrade and all previous versions.
8. Resale, Rental and Leasing - The user may not resale, rent or lease the software to a
third party for the purpose of purchase. The user may sell the product to a third party,
provided that the third party agrees with the present terms of this agreement and agrees
that all terms of this agreement also apply to him. In case of a transfer, the user must
hand over all program copies of the software including available security copies where
applicable and the entire written corollary material and/or destroy the copies that are
not handed over to the third party.
9. Reverse Engineering, Decompilation und Disassembly - The user is not authorized to
reverse engineer, decompile or disassemble the software product, unless and only if the
applicable law, regardless of this restriction, expressly permits this.
10. Support. Glück & Kanja assumes responsibility for technical support for the product,
which the user has purchased from Glück & Kanja or a distributor. The user can contact the support team only via e-mail at [email protected] Support for
every license packet is limited to a (1) contact person and a (1) representative on the customer side and stretches exclusively to product-conditional installation problems and
debugging, along with that, support from Glück & Kanja is voluntary.
The claim to support expires when one of the following conditions has been reached:
• Six (6) months after purchase of the product
• Three (3) months after a later version of the product (Major Release) is released from
Glück & Kanja.
2.8. Lizenz
10
Hotspot Browser Documentation, Release 2.0.2
Glück & Kanja offers further support extensions over the standard support. These are
liable to costs and regulated through a separate contract. Owners of a demo-license as
well as a freeware edition have no claim to support from Glück & Kanja. However,
support is available for these versions and is liable to cost.
11. Warranty. Glück & Kanja warrants that the products primarily fulfill the main functions
in line with the documentation and correspond to the recognized rules of the technology
as well as making sure that the products are not inflicted with mistakes that cancel or
reduce the value or the efficiency of the purpose described in the documentation.
Faults in the software including the documentation and other documents are remedied
within the warranty period of twelve (12) months after delivery (e.g. download) according to corresponding notification through the user. It is Glück & Kanja’s or the distributor’s option whether this will be done through subsequent improvement or replacement.
When an improvement or replacement fails, the user is entitled to a refund of the price
paid (if any) for the product or reduction. In the case of refund of purchase price, the user
must return the product to Glück & Kanja or a distributor along with a declaration that
all other copies of the product were deleted. Demo versions (also “Evaluation Copy”,
“Beta Version”, “Pre-Release Version”, etc.) that were available for the user at no charge,
do not fall under the warranty for the full version. Such versions are available as restricted functioning versions. Please note that free test versions should only be deployed
in designated testing environments.
12. Liability. Glück & Kanja shall be liable without any limitation for damages due to defects
of the missing of warranted characteristics. Liability for initial inability, delay or impossibility shall be limited to the amount actually paid by the user for the product as well as
to such damages that have to be reckoned with the typically occur in the context of making available of software. In any other circumstance, Glück & Kanja shall be liable only
for intent and gross negligence, including its legal representatives and vicarious agents,
unless a specific obligation of Glück & Kanja is involved that must not be infringed and
must be complied with for its major importance for the achievement of the contractual
purpose (cardinal obligation). In case of an infringement upon a cardinal obligation, the
company shall also be liable for slight negligence. However, the limitation of liability for
initial inability shall be considered accordingly.
The user must take notice in carrying out data protection with due diligence. Glück &
Kanja is not liable for damage that occurs due to data loss, unless such damages, that
also would have ensued with correct data protection.
13. Third party rights - Glück & Kanja does not guarantee that the use of the license does not
interfere with third party trademark rights or copyrights or that a third party does not
cause damage to it, as long as Glück & Kanja regulations to the contrary or third party
damage are not known.
14. Should this agreement contain a loophole or if any of the provisions of this agreement
are invalid, ineffective or unenforceable, that will not affect the validity of the remaining
provisions.
15. The user verifies that he has read, understood and accepted these license conditions. The
user also verifies that this license agreement represents the only and exclusive agreement
between the user and Glück & Kanja, which suspends all previous written or oral proposals or agreements, as well as all previous product-relevant communication between
the user, Glück & Kanja and its distributors.
2.8. Lizenz
11
Hotspot Browser Documentation, Release 2.0.2
16. This agreement will be governed exclusively by German law. The application of the UN
Sales Convention (CISG) is explicitly excluded
2.9 Kontakt
Haben Sie Fragen zu diesem Produkt?
[email protected]
2.9. Kontakt
Schreiben Sie uns eine E-Mail an prod-
12

Vergelijkbare documenten