Internet Access & Error Handling Settings

Settings

Related Articles


Requires Internet Access

This setting allows Kiosk Pro to regularly check for internet access if connection is lost, and will reload the page when a connection is restored. If your content is online or uses embedded content that is hosted remotely (a YouTube video, for example), this should be turned On.

Default: On

If your content is completely local and does not require a connection for any functionality, you can turn this setting off so Kiosk Pro does not automatically reload the page being shown when a connection is detected.

If Internet connection is lost and the error message returned by the underlying UI WebView browser suggests that this is why Kiosk Pro is unable to load your content, a ‘No Internet Connection’ page (as shown below) is displayed until the connection is restored. If you prefer, you can define an  Alternate Homepage for Offline Use to be shown instead.

Since Kiosk Pro Lite is always dependent on remote content, this setting is automatically enabled and not included in app settings.

If your WiFi connection isn't stable, you may want to consider using a  Powered Ethernet Adapter, which allows you to connect your iPad to a power source and Ethernet at the same time.


Alternate Homepage for Offline Use

This setting allows you to set up your own locally stored content to be shown in case internet connection is lost as an alternative to the default ‘No Internet’ page.

Default: empty

By setting up local content, you are able to run certain content (either remote or local) as your primary Homepage while you have a connection, then failover to a different set of local-only content if the device is disconnected from the Internet.

This alternate homepage can be single or multipage HTML, a PDF, or an image file without interactivity.

Whatever you choose to display will need to be stored locally on the iPad as it must be accessible offline. Instructions for transferring content to the iPad can be found here.

As an example, let’s say you have a sign-up form hosted on your website and want visitors to still be able to sign up if connection is lost.

  1. Create an HTML page with a sign-up form that will save form data locally to your iPad using our custom JavaScript API.
  2. Upload your local content to the Kiosk Pro Documents folder.
  3. Set 'Alternate Homepage for Offline Use' to the HTML page (signup.html, for example).

If connection is lost, Kiosk Pro will redirect to the local HTML page defined in this setting. When connection is restored, the app will automatically reload your primary content.


Failed Request Log

This setting shows a table of the last 50 URLs that failed to load and more information on the error that was returned by the underlying UI WebView browser that can be used to diagnose and troubleshoot the problem.

This will include URLs of content that are embedded into a page (for example, an iframe or Youtube video). In this case, the entry will show both the URL of the page the content is embedded in and the URL of the content that failed to load.

The table can be exported to a .csv file into the Kiosk Pro Documents folder on the iPad by selecting ‘Export’ from the top right corner. You can find instructions on how to retrieve this file on our Storing Content Locally on the iPad article.


Custom 'File Not Found' Page

When Kiosk Pro is unable to find a file and the error message returned by the underlying WebView browser suggests that this is not caused by a connection error, a ‘File Not Found’ page is displayed (as shown below).

This setting allows you to set your own custom page to be shown instead. The previous method of setting a custom image using the 'KioskAssets' folder will still be supported for users who already have this set up.


Allow Exceptions to HTTPS:// Security Protocols in WKWebView

Added in 8.1

This feature allows you to set how Kiosk Pro handles security certificate errors when using the WKWebView browser engine.

Options:

  • Always Show Prompt (default)
  • Automatically (recommended only in restricted environments where all possible exceptions have been reviewed)
  • Never (any page with certificate errors will not load)

Always Show Prompt is the default behavior for Basic, Plus, and Enterprise, and is always used in Kiosk Pro Lite. Exceptions to HTTPS:// security protocols are only possible when using the WKWebView browser engine. If using the UIWebView browser engine, there is no currently available method to allow exceptions for failed security certificate authentication and so loading of a page with a certificate error will always fail.

When using Always Show Prompt, if a security certificate authentication error occurs, a prompt is shown to the visitor, alerting them to the error and allowing them to continue to view the page or cancel to prevent loading.

This prompt can only be shown every 30 seconds; if the Idle Time Limit is set to less than 30 seconds, the prompt will not be shown immediately.

Automatically allows pages with security certificate errors to load without displaying an alert. As this prevents the exception from being shown to the visitor, it should only be used in restricted environments where all possible exceptions have been reviewed (as in the case of self-signed certificates or certificate errors caused by network level blocking). This mode should never be used for kiosks that allow unrestricted browsing as that could potentially compromise sensitive information entered by visitors.

Never is the most secure approach and prevents any page with certificate errors from being displayed. If a visitor tries to view a page with certificate errors, they will see the Blocked Request Alert and the page will not be displayed.

Certificate authentication is performed by the underlying WebView browser layer so Kiosk Pro is unable to modify the specific types of errors requiring an exception.

Still stuck? How can we help? How can we help?