Run the HTML5 Web XPanel

This topic describes various procedures required to run the HTML5 Web XPanel project in a web browser.

Project URL Convention

Once the HTML5 Web XPanel project is deployed onto a control system, it will have one of the two following URLs:

  • https://[hostname]/[projectname]/index.html - The default URL, where [hostname] is the control system host name or IP address and [projectname] is the specified project name.
  • https://[hostname]:[port]/[projectname]/index.html - Used only if the securewebport setting is changed from its default, where [port] is the modified secure web port. Refer to Control System Configuration for more information.

For example, if the control system IP address is 10.1.1.124 and the project name is "huddle-room" (distributed from huddle-room.ch5z), then the URL would be https://10.1.10.24/huddle-room/index.html

Default Control System URL

If you deploy an HTML5 Web XPanel project via the Web Pages and Mobility Project function in Crestron Toolbox at least once, or if you issue the webinit console command, the last HTML5 Web XPanel project deployed on a control system will be the default project. Refer to Control System Configuration for more information.

For example, https://[hostname] will be redirected to https://[hostname]/[projectname]/index.html.

URL Parameters for the Crestron Template Project

As described in Add or Remove HTML5 Web XPanel Support , if you use the Crestron Template Project, connection parameters can be added after the URL.

For example, if you are using IP IDs "9" and "A" on your control system program, you can provide the bookmarks to end users:

  • https://[hostname]/[projectname]/index.html?ipId=9
  • https://[hostname]/[projectname]/index.html?ipId=A

Authentication tokens can also be passed via the URL of the CH5 application (4-Series and VC-4 only). Authentication tokens are supported for applications that are deployed in the control system and not the touch screen. Refer to the following URL syntax examples:

  • 4-Series: https://[hostname]/[projectname]/index.html?ipId=[value]&authtoken=[value]

  • VC-4: https://[hostname]/VirtualControl/MA/Rooms/[roomid]/XPanel/index.html?ipId=[value]&authtoken=[value]

Self-Signed Certificate Warnings

All browsers supported by HTML5 Web XPanel will provide warning messages upon connecting to the browser if the control system has a self-signed certificate.

An example from the Chrome® browser is shown below:

Self-Signed Certificate Warning

This behavior is expected. There are three solutions that can be used to address this.

  • Use a CA-signed certificate on your control system (preferred method).
  • Your IT Administrator extracts the self-signed certificate and installs onto your workstation as a trusted certificate.
  • The end user accepts the self-signed certificate for that browser on their workstation to prevent the message from showing again.

For additional instructions on how to connect a VC-4 room to an HTML5 Web XPanel project when using self-signed certificates, refer to the Crestron Virtual Control Server Software Product Manual.