Install the crypto.jar module

The latest crypto.jar may or may not be present in the Workbench modules folder. Even if crypto.jar is present, it may need to be replaced.

Users of NiagaraAX-3.5.25.1 and earlier versions have a stub crypto.jar file instead of the actual module. This was because, by law, the US Government required Tridium to verify that the transfer of encryption software was not being made to a “denied person.” This restriction has been lifted. NiagaraAX-3.5.25.2 and later versions include the normal crypto.jar.

If you have a stub file, you need the correct crypto.jar. The email, which you may have received with the license, may also include the correct crypto.jar file or you may download crypto.jar from Niagara Central.

1. To check the Workbench version, Help->About.

2. Check the Niagara\version\modules folder (where version is the version of NiagaraX you are using).

   Figure 1. Normal crypto.jar file

   
   
   
   
   

   A crypto stub file is about 6KB. The normal crypto.jar file in the example above is 881 KB.

3. If you have a stub file or are in doubt, download the latest module .jar files from Niagara Central.

4. Save the modules in the Niagara\version\modules folder.

Install the TKS Provider

If you previously installed StandaloneTksProvider.jar in your JRE, delete it from the lib/ext directory.

1. If you haven’t already done so, download the Tridium Key Store (TKS) Provider jar file, TridiumProvider.jar, from Niagara Central.

2. Install the jar into the lib/ext directory of your chosen JRE.

   Do not install TridiumProvider.jar into the Niagara JRE.

3. Add the following line to the list in the lib/security/java.security file, which is located in your JRE:

   security.provider.nn=com.tridium.crypto.TksProvider

   where nn is a sequential number.

   Make sure that the number following “security.provider” is sequential.