JSS

Documentation

Warning

The JSS project has been relocated!

As of April 6, 2018, JSS has been migrated from Mercurial on Mozilla to Git on Github.

JSS source should now be checked out from the Github:

All future upstream enquiries to JSS should now use the Pagure Issue Tracker system:

Documentation regarding the JSS project should now be viewed at:

NOTE:  As much of the JSS documentation is sorely out-of-date, updated information will be a work in progress, and many portions of any legacy documentation will be re-written over the course of time.  Stay tuned!

Legacy JSS information can still be found at:

Network Security Services for Java (JSS) is a Java interface to NSS. JSS supports most of the security standards and encryption technologies supported by NSS reference. JSS also provides a pure Java interface for ASN.1 types and BER/DER encoding.

JSS offers a implementation of Java SSL sockets that uses NSS’s SSL/TLS implementation rather than Sun’s JSSE implementation. You might want to use JSS’s own SSL classes if you want to use some of the capabilities found in NSS’s SSL/TLS library but not found in JSSE.

NSS is the cryptographic module where all cryptographic operations are performed. JSS essentially provides a Java JNI bridge to NSS C shared libraries. When NSS is put in FIPS mode, JSS ensures FIPS compliance by ensuring that all cryptographic operations are performed by the NSS cryptographic module.

JSS offers a JCE provider, “Mozilla-JSS” JCA Provider notes.

JSS, jss4.jar, is still built with JDK 1.4.2. While JDK 1.4.2 is EOL’d and all new product development should be using the latest JavaSE, legacy business products that must use JDK 1.4 or 1.5 can continue to add NSS/JSS security fixes/enhancements.

JSS is used by Red Hat and Sun products that do crypto in Java. JSS is available under the Mozilla Public License, the GNU General Public License, and the GNU Lesser General Public License. JSS requires NSPR and NSS.

Java provides a JCE provider called SunPKCS11 (see Java PKCS#11 Reference Guide.) SunPKCS11 can be configured to use the NSS module as the crytographic provider. If you are planning to just use JSS JCE provider as a bridge to NSS’s FIPS validated PKCS#11 module, then the SunPKCS11 JCE provider may do all that you need. Note that Java 1.5 claimed no FIPS compliance, and Java 1.6 or higher needs to be used. A current limitation to the configured SunPKCS11-NSS bridge configuration is if you add a PKCS#11 module to the NSS database such as for a smartcard, you won’t be able to access that smartcard through the SunPKCS11-NSS bridge. If you use JSS, you can easily get lists of modules and tokens that are configured in the NSS DB and freely access all of it.

Before you use JSS, you should have a good understanding of the crypto technologies it uses. You might want to read these documents:

  • `Introduction to Public-Key Crypt

ography <https://developer.mozilla.org/en-US/do cs/Introduction_to_Public-Key_Cryptography>`__.

Explains the basic concepts of public-key cryptography that underlie NSS and JSS.

mozilla.org/en-US/docs/Introduction_to_SSL>`__.

Introduces the SSL protocol, including information about cryptographic ciphers supported by SSL and the steps involved in the SSL handshake.

For information on downloading NSS releases, see NSS sources building testing.

Read Using JSS to get you started with development after you’ve built and downloaded it.

Release Notes

mozilla.org/en-US/docs/JSS/4_3_ReleaseNotes>`__ - `Older Release

la.org/projects/security/pki/jss/index.html>`__

Build Instructions

  • :re

f:mozilla_projects_nss_jss_build_instructions_ for_jss_4_4_x#build_instructions_for_jss_4_4_x - `Building JSS

S/docs/JSS/Build_instructions_for_JSS_4.3.x>`__ - `Older Build

la.org/projects/security/pki/jss/index.html>`__

Download or View Source

.org/pub/mozilla.org/security/jss/releases/>`__ - `View the source

online <http://m

xr.mozilla.org/mozilla/source/security/jss/>`__

Testing

hg.mozilla.org/projects/jss/file/tip/README>`__

Frequently Asked Questions

Information on JSS planning can be found at wik i.mozilla.org, including:

  • `NSS FIPS Validati

on <http://wiki.mozilla.org/FIPS_Validation>`__ - `NSS Roadmap

Community

  • View Mozilla Cryptography forums…

/lists.mozilla.org/listinfo/dev-tech-crypto>`__
ps.google.com/group/mozilla.dev.tech.crypto>`__

gle.com/group/mozilla.dev.tech.crypto/feeds>`__

  • `Security <https:

//developer.mozilla.org/en-US/docs/Security>`__