Using Artifactory 5.x ?
JFrog Artifactory 5.x User Guide
Have a question? Want to report an issue? Contact JFrog support
Overview
Java Web Start is a technology developed by Sun Microsystems (now Oracle) to allow you to download and run Java applications directly from your browser with one-click activation.
Java Web Start requires that any JAR downloaded is signed by the software vendor. To support this requirement, Artifactory lets you manage a set of signing keys that are used to automatically sign JAR files downloaded from a virtual repository.
For more information, please refer to the Oracle documentation for Java Web Start.
Managing Signing Keys
Signing keys are managed in the Admin module under Security | Signing Keys.
Debian Signing Key
Debian signing keys are also managed on this page, however these are not related to JAR signing. For details, please refer to Debian Signing Keys.
Generating JAR Signing Keys
In order to sign JAR files, you first need to create a keystore, and generate and add key pairs to it. These can be created with Oracle's keytool
utility, that comes built into your Java Runtime Environment (JRE), by executing the following command:
keytool -keystore <keystore filename> -keypass <key_password> -storepass <store_password> -alias <store_alias> \ -genkeypair -dname "cn=<cName>, ou=<orgUnit>, o=<orgName>, S=<stateName>, c=<country>" -validity <days>
For details, please refer to the Oracle keytool - Key and Certificate Management Tool documentation.
Setting Your Keystore and Keys
Before you can add a keystore, you must set the password that will be needed to make any later changes to the keystore. You will need this password to remove or update the keystore.
Set the password and click "Create". This will unlock the rest of the keystore management fields.
Once your keystore password is set and you have created a keystore and a set of signing keys, you can add them to Artifactory.
First upload your keystore file under Add Key-Store and enter the keystore password. Click "Unlock"
Once your keystore is set in Artifactory you may add key pairs under Add Key-Pair.
Removing a Key Pair
To remove a key pair, simply select the key pair and click "Remove".
Configuring Virtual Repositories to Sign JARs
Once Artifactory has a keystore and key pairs, you can configure a virtual repository with the key pair you wish to use for JAR signing. This is done in the Advanced settings of the virtual repository configuration screen.
Screencast - Using Artifactory with JFrog JavaFX Maven Plug-in
Screencast for V4 is coming soon...
Resources used in the screencast
- The JavaFX Maven Plugin provided by JFrog has it's own documentation page.
The personal test PKS (acme-demo.store file) was done using the java keytool:
keytool -keystore acme-demo.store -keypass password -storepass password -alias acme-demo \ -genkeypair -dname "cn=Acme Dev, ou=r&d, o=ACME, S=California, c=US" -validity 365
- The FishSim demo subversion is here.
- You can test this Add-on for free (no questions asked) for 30 days, with the two main repositories required (jfrog plugins, jfrog libs), using Artifactory SaaS.
How to build FishSim
If you are not using Artifactory as illustrated in the screencast, you can activate the profile "jfrog" to access the repo.jfrog.org required resources. This enables build running "mvn -Pjfrog install" to work.