Network Security Services for Java (JSS)

Overview

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

• Website: http://www.dogtagpki.org/wiki/JSS
• Issues: https://pagure.io/jss/issues
• Archive: https://github.com/dogtagpki/jss-archive
• Javadocs: https://dogtagpki.github.io/jss

NOTICE: As of JSS version 4.5.1, the legacy build instructions will not work; the build system has been completely replaced with CMake.

Dependencies

This project has the following dependencies:

• NSPR
• NSS
  • Minimum version: 3.30
  • A c and c++ compiler such as gcc
  • zlib
• OpenJDK 1.8.0
• CMake
• Apache Commons Lang
• Apache Commons Codec
• JavaEE JAXB
• SLF4J
• JUnit 4

To install these dependencies on Fedora, execute the following:

sudo dnf install apache-commons-codec apache-commons-lang gcc-c++ \
                 java-devel jpackage-utils slf4j zlib-devel \
                 glassfish-jaxb-api nss-tools nss-devel cmake \
                 junit

To install these dependencies on Debian, execute the following:

sudo apt-get install build-essential libcommons-codec-java \
                     libcommons-lang-java libnss3-dev libslf4j-java \
                     openjdk-8-jdk pkg-config zlib1g-dev \
                     libjaxb-api-java libnss3-tools cmake zip unzip \
                     junit4

Building

To build JSS and make a best effort to detect environment variables:

git clone https://github.com/dogtagpki/jss
cd jss/build && cmake ..
make all test

Alternatively, to build a RPM distribution of JSS:

git clone https://github.com/dogtagpki/jss
cd jss
./build.sh

To view more detailed instructions for building JSS, please refer to the build documentation: docs/building.md.

Contributing

We welcome all contributions to JSS! If you're looking for help getting started, check out our documentation, or if you want to contact us, check out the following forums:

• The pki-devel mailing list.
• The #dogtag-pki IRC channel on Freenode.