Difference between revisions of "JASigning Platform Issues"

From Virtual Humans
Jump to: navigation, search
(Introduction of Electron applications.)
Line 1: Line 1:
 
[[Main Page]] >> [[JASigning]]
 
[[Main Page]] >> [[JASigning]]
 
----
 
----
== Browsers : HTML5 JavaScript and WebGL ==
+
= Supported Software : JavaScript =
 +
 
 +
== Web Applications : HTML5 JavaScript and WebGL ==
 
The core JASigning software is implemented in HTML5 using JavaScript and WebGL. It functions on OS X, Windows, Linux, iOS, and some Android devices. It may work on other platforms.
 
The core JASigning software is implemented in HTML5 using JavaScript and WebGL. It functions on OS X, Windows, Linux, iOS, and some Android devices. It may work on other platforms.
  
Line 11: Line 13:
  
 
==== Linux ====
 
==== Linux ====
JASigning WebGL software  should work with '''Firefox''', '''Chrome''', '''Chromium''', '''Opera''', and '''Vivaldi'''.
+
JASigning WebGL software  should work with '''Firefox''', '''Chrome''', '''Opera''', '''Chromium''', and '''Vivaldi'''.
  
 
==== iOS ====
 
==== iOS ====
 
JASigning WebGL software  should work with '''Safari'''.
 
JASigning WebGL software  should work with '''Safari'''.
  
== Applications : Node.js and Electron ==
+
== Standalone Applications : Node.js and Electron ==
 
Applications based on the HTML5 JavaScript and WebGL implementation can be installed on OS X, Windows, and Linux. In addition to being able to animate SiGML data provided as text or via a URL, the applications act as a server, receiving SiGML data on port 8052. A suitable client program is available as a Java Web Start application.
 
Applications based on the HTML5 JavaScript and WebGL implementation can be installed on OS X, Windows, and Linux. In addition to being able to animate SiGML data provided as text or via a URL, the applications act as a server, receiving SiGML data on port 8052. A suitable client program is available as a Java Web Start application.
  
== Browsers : Java Applets ==
+
==== OS X ====
Support for Java Applets is declining and the HTML5 approach should be used wherever possible.
+
The software is provided in a Disk Image via a '''.dmg''' file. The image should be mounted and the application copied to disk. Security preferences may prevent the application being opened immediately because they do not come from the App Store or an identified developer. To run blocked applications it is necessary to open them by double-clicking with the control-key down or by right-clicking and choosing ''Open''. On future occasions the software should launch normally.
 +
 
 +
==== Windows ====
 +
The software is provided as an executable '''.exe''' file that can be run to install and launch the software. A shortcut to the application will then be placed on the desktop.
 +
 
 +
==== Linux ====
 +
The software is provided in an application image '''.AppImage''' file which is program that will install the software. The downloaded application image file must be made executable and then run. This may be done by right-clicking the file, selecting Properties, selecting the Permissions tab, and choosing to allow executing the file as program. Alternatively, the command <code>chmod +x SiGML-Player.AppImage</code> can be entered in a shell.
 +
 
 +
= Legacy Software : Java =
  
JASigning applets may work with browsers other than those mentioned below, but our testing in such cases is at best limited. Let us know!
+
== Java Web Start ==
  
==== Windows ====
+
JASigning applications and applets are launched using [http://en.wikipedia.org/wiki/Java_Web_Start Java Web Start] through Java Network Launching Protocol (JNLP) files, which have extension <code>.jnlp</code>. Web pages using the more recent JASigning implementation for HTML5 using JavaScript and WebGL is not dependent on JNLP.
JASigning web applets should work with  '''Internet Explorer'''. The 32-bit (x86) release of Java should be installed.
 
  
==== OS X ====
+
The use of JNLP files for applets is deprecated in modern browsers. Where it is supported, it is fairly seamless, but changes to the Java security regime mean that some messages will be seen for the latest release of JASigning with older Java versions.
JASigning web applets should work with '''Safari'''.
 
  
'''Safari''' will block applets by default but clicking on the avatar display area will allow the applet plug-in to be enabled.  '''Safari 7''' and later impose a ''safe'' mode which blocks access to the local disk even though requested by the Java security settings. JASigning will operate in safe mode but will operate more slowly and will not work so well offline as a local cache will be disabled. The Safari Security preferences can be used to disable safe mode for JASigning applets, allowing the local cache to be used.
+
For applications, launching of Java Web Start is sometimes automatic, but sometimes requires further action. Apple makes it increasingly difficult to deploy components using JNLP so for recent versions of OS X it is necessary to override the default protection regime even though the components are correctly signed. See below for notes on using particular browsers.
  
If GateKeeper is active, launching of applications will be blocked. See the Platforms section above. Even if GateKeeper is disabled: Safari does not consider Java Web Start to be safe so JNLP files may be downloaded to a temporary area and can only be launched by clicking on the icon for the downloaded file in the Downloads window; JNLP files for applications can be downloaded and launched from '''Chrome''' but a warning suggests that JNLP files can be harmful.
 
 
== Code Signing ==
 
== Code Signing ==
  
 
JASigning components are digitally signed using a Code Signing Certificate issues by [http://www.globalsign.com/code-signing/ GlobalSign] to [http://www.uea.ac.uk/business/consultancy UEA Consulting Ltd]. Before 2014, certificates were issued to [http://www.sys-consulting.co.uk/ SYS Consulting Limited]. When installing applications or applets, users will be asked to confirm that they trust the publisher. Users can choose to trust the publisher permanently to avoid future confirmation requests.
 
JASigning components are digitally signed using a Code Signing Certificate issues by [http://www.globalsign.com/code-signing/ GlobalSign] to [http://www.uea.ac.uk/business/consultancy UEA Consulting Ltd]. Before 2014, certificates were issued to [http://www.sys-consulting.co.uk/ SYS Consulting Limited]. When installing applications or applets, users will be asked to confirm that they trust the publisher. Users can choose to trust the publisher permanently to avoid future confirmation requests.
  
The certificates have a limited lifetime and will now have expired. Unfortunately, it will be necessary to ignore security warnings to use the software. Components can still be used if http://vhg.cmp.uea.ac.uk is added to the Exception Site List via the Security tab on the Java control panel.
+
The certificates have a limited lifetime and have now expired. Unfortunately, it is therefore necessary to ignore security warnings to use the software. Components can still be used if http://vhg.cmp.uea.ac.uk is added to the Exception Site List via the Security tab on the Java control panel.
 +
 
 +
== Legacy Web Applications : Java Applets ==
 +
Support for Java Applets is now minimal and the HTML5 approach should be used wherever possible.
  
== Java Web Start ==
+
JASigning applets may work with browsers other than those mentioned below, but our testing in such cases is at best limited. Let us know!
  
JASigning applications and applets are launched using [http://en.wikipedia.org/wiki/Java_Web_Start Java Web Start] through Java Network Launching Protocol (JNLP) files, which have extension <code>.jnlp</code>. Web pages using the more recent JASigning implementation for HTML5 using JavaScript and WebGL is not dependent on JNLP.
+
==== Windows ====
 +
JASigning web applets should work with  '''Internet Explorer'''. The 32-bit (x86) release of Java should be installed.
  
The use of JNLP files for applets is deprecated in modern browsers. Where it is supported, it is fairly seamless, but changes to the Java security regime mean that some messages will be seen for the latest release of JASigning with older Java versions.
+
==== OS X ====
 +
JASigning web applets should work with '''Safari'''.
  
For applications, launching of Java Web Start is sometimes automatic, but sometimes requires further action. Apple makes it increasingly difficult to deploy components using JNLP so for recent versions of OS X it is necessary to override the default protection regime even though the components are correctly signed. See below for notes on using particular browsers.
+
'''Safari''' will block applets by default but clicking on the avatar display area will allow the applet plug-in to be enabled. '''Safari 7''' and later impose a ''safe'' mode which blocks access to the local disk even though requested by the Java security settings. JASigning will operate in safe mode but will operate more slowly and will not work so well offline as a local cache will be disabled. The Safari Security preferences can be used to disable safe mode for JASigning applets, allowing the local cache to be used.
  
== Platforms ==
+
If GateKeeper is active, launching of applications will be blocked. See the Platforms section above. Even if GateKeeper is disabled: Safari does not consider Java Web Start to be safe so JNLP files may be downloaded to a temporary area and can only be launched by clicking on the icon for the downloaded file in the Downloads window; JNLP files for applications can be downloaded and launched from '''Chrome''' but a warning suggests that JNLP files can be harmful.
  
Applications for the [http://vhg.cmp.uea.ac.uk/tech/jas/std/ current version of JASigning] are intended to run on Windows (XP, Vista, 7) and on the latest releases of OS X 10.5 and later.  JASigning apps are ''not'' supported on Linux at present. It is preferable to run JASigning with an up-to-date Java 8 run-time (JRE), although it should run with Java 7 and later versions of Java 6.
+
== Legacy Standalone Applications : Java ==
 +
The security constraints on running Java-based applications mean that the JavaScript JASigning applications are strongly preferred. At present, however, some functionality is only available in the Java software.
 +
 +
Java-based applications for the [http://vhg.cmp.uea.ac.uk/tech/jas/std/ current version of JASigning] are intended to run on Windows (XP, Vista, 7) and on the latest releases of OS X 10.5 and later.  Java-based JASigning apps are ''not'' supported on Linux. It is preferable to run JASigning with an up-to-date Java 8 run-time (JRE), although it should run with Java 7 and later versions of Java 6.
  
 
On the supported platforms, that is, Windows and OS X, JASigning supports both 32-bit and 64-bit operation.  Which of this modes it actually runs in on any given occasion depends on several factors:
 
On the supported platforms, that is, Windows and OS X, JASigning supports both 32-bit and 64-bit operation.  Which of this modes it actually runs in on any given occasion depends on several factors:

Revision as of 00:05, 1 February 2019

Main Page >> JASigning


Supported Software : JavaScript

Web Applications : HTML5 JavaScript and WebGL

The core JASigning software is implemented in HTML5 using JavaScript and WebGL. It functions on OS X, Windows, Linux, iOS, and some Android devices. It may work on other platforms.

OS X

JASigning WebGL software should work with Firefox, Chrome, Opera, and Safari.

Windows

JASigning WebGL software should work with Firefox, Chrome, Opera, Edge, and Internet Explorer.

Linux

JASigning WebGL software should work with Firefox, Chrome, Opera, Chromium, and Vivaldi.

iOS

JASigning WebGL software should work with Safari.

Standalone Applications : Node.js and Electron

Applications based on the HTML5 JavaScript and WebGL implementation can be installed on OS X, Windows, and Linux. In addition to being able to animate SiGML data provided as text or via a URL, the applications act as a server, receiving SiGML data on port 8052. A suitable client program is available as a Java Web Start application.

OS X

The software is provided in a Disk Image via a .dmg file. The image should be mounted and the application copied to disk. Security preferences may prevent the application being opened immediately because they do not come from the App Store or an identified developer. To run blocked applications it is necessary to open them by double-clicking with the control-key down or by right-clicking and choosing Open. On future occasions the software should launch normally.

Windows

The software is provided as an executable .exe file that can be run to install and launch the software. A shortcut to the application will then be placed on the desktop.

Linux

The software is provided in an application image .AppImage file which is program that will install the software. The downloaded application image file must be made executable and then run. This may be done by right-clicking the file, selecting Properties, selecting the Permissions tab, and choosing to allow executing the file as program. Alternatively, the command chmod +x SiGML-Player.AppImage can be entered in a shell.

Legacy Software : Java

Java Web Start

JASigning applications and applets are launched using Java Web Start through Java Network Launching Protocol (JNLP) files, which have extension .jnlp. Web pages using the more recent JASigning implementation for HTML5 using JavaScript and WebGL is not dependent on JNLP.

The use of JNLP files for applets is deprecated in modern browsers. Where it is supported, it is fairly seamless, but changes to the Java security regime mean that some messages will be seen for the latest release of JASigning with older Java versions.

For applications, launching of Java Web Start is sometimes automatic, but sometimes requires further action. Apple makes it increasingly difficult to deploy components using JNLP so for recent versions of OS X it is necessary to override the default protection regime even though the components are correctly signed. See below for notes on using particular browsers.

Code Signing

JASigning components are digitally signed using a Code Signing Certificate issues by GlobalSign to UEA Consulting Ltd. Before 2014, certificates were issued to SYS Consulting Limited. When installing applications or applets, users will be asked to confirm that they trust the publisher. Users can choose to trust the publisher permanently to avoid future confirmation requests.

The certificates have a limited lifetime and have now expired. Unfortunately, it is therefore necessary to ignore security warnings to use the software. Components can still be used if http://vhg.cmp.uea.ac.uk is added to the Exception Site List via the Security tab on the Java control panel.

Legacy Web Applications : Java Applets

Support for Java Applets is now minimal and the HTML5 approach should be used wherever possible.

JASigning applets may work with browsers other than those mentioned below, but our testing in such cases is at best limited. Let us know!

Windows

JASigning web applets should work with Internet Explorer. The 32-bit (x86) release of Java should be installed.

OS X

JASigning web applets should work with Safari.

Safari will block applets by default but clicking on the avatar display area will allow the applet plug-in to be enabled. Safari 7 and later impose a safe mode which blocks access to the local disk even though requested by the Java security settings. JASigning will operate in safe mode but will operate more slowly and will not work so well offline as a local cache will be disabled. The Safari Security preferences can be used to disable safe mode for JASigning applets, allowing the local cache to be used.

If GateKeeper is active, launching of applications will be blocked. See the Platforms section above. Even if GateKeeper is disabled: Safari does not consider Java Web Start to be safe so JNLP files may be downloaded to a temporary area and can only be launched by clicking on the icon for the downloaded file in the Downloads window; JNLP files for applications can be downloaded and launched from Chrome but a warning suggests that JNLP files can be harmful.

Legacy Standalone Applications : Java

The security constraints on running Java-based applications mean that the JavaScript JASigning applications are strongly preferred. At present, however, some functionality is only available in the Java software.

Java-based applications for the current version of JASigning are intended to run on Windows (XP, Vista, 7) and on the latest releases of OS X 10.5 and later. Java-based JASigning apps are not supported on Linux. It is preferable to run JASigning with an up-to-date Java 8 run-time (JRE), although it should run with Java 7 and later versions of Java 6.

On the supported platforms, that is, Windows and OS X, JASigning supports both 32-bit and 64-bit operation. Which of this modes it actually runs in on any given occasion depends on several factors:

  • Whether or not the processor supports 64-bit operation.
  • Whether or not the operating system supports 64-bit operation.
  • Whether the system has a 32-bit or a 64-bit Java installation (or both) -- and what options are set in the Java Control Panel (Windows) or Java Preferences app (OS X).
  • For a JASigning applet: whether the browser is running in 32-bit or 64-bit mode.

Windows

JASigning applications and applets (apart from the SiGML Service Client) on Windows may require the appropriate Microsoft Visual Studio C++ 2010 Redistributable Package to be installed on the system.

On many Windows systems the required Redistributable package will already have been installed. But if not, each JASigning application and applet will display a message at launch time giving the URLs from which the package can easily be downloaded and installed. These URLs can be copied from the Java console and pasted into a web browser.

There is a 32-bit (x86) and a 64-bit (x64) version of the Redistributable package. One or both of these should be installed, to match the system's JRE (Java Runtime Environment) installation(s).

OS X

Before installing and running JASigning applications, the corresponding JNLP file must be downloaded. The application is then launched using Java Web Start. The user will be warned that the application (its JNLP file) has been downloaded from the Internet. The user will also be asked to confirm that they trust the publisher.

Under the default settings for GateKeeper on OS X 10.7.5 Lion and onwards, JASigning applications are blocked from running because they do not come from the App Store or an identified developer. To run blocked applications it is necessary to locate the JNLP file, typically in the Downloads folder, and open it by double-clicking with the control-key down or by right-clicking and choosing Open. On some versions, GateKeeper can be disabled using the General tab of Security & Privacy in the System Preferences.

As documented in JASigning Release Notes, on OS X 10.6 Snow Leopard and later some rendering artefacts can appear with the freestanding SiGML URL Player and SiGML Service Player.



Main Page >> JASigning