# dss **Repository Path**: caohenghui/dss ## Basic Information - **Project Name**: dss - **Description**: DSS : Digital Signature Service - **Primary Language**: Java - **License**: LGPL-2.1 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-06-26 - **Last Updated**: 2025-06-26 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ## DSS : Digital Signature Service This is the official repository for project DSS : https://ec.europa.eu/digital-building-blocks/wikis/display/DIGITAL/Digital+Signature+Service+-++DSS. # Issue Tracker Please, use the new JIRA for project is on https://ec.europa.eu/digital-building-blocks/tracker/projects/DSS/issues. # Requirements The latest version of DSS framework has the following minimal requirements: * Java 8 or higher (tested up to Java 24) is required for usage; * Java 11 or higher is required for the build. Java 15 is the minimal requirement for a build with unit tests; * Maven 3.6.3 and higher (if build required); * Memory and Disk: see minimal requirements for the used JVM. In general the higher available is better; * Operating system: no specific requirements (tested on Windows and Linux). Starting from version `6.0`, DSS uses `jakarta.\*` namespace naming of Specification API. If your application uses `javax.*` namespaces, please use version `5.13`. # Maven repository The release is published on Maven Central repository : https://central.sonatype.com/search?q=eu.europa.ec.joinup.sd-dss 
<!-- Add dss-bom for easy integration -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>eu.europa.ec.joinup.sd-dss</groupId>
            <artifactId>dss-bom</artifactId>
            <version>6.3.RC1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<!-- Add required modules (example) -->
<dependencies>
    <dependency>
        <groupId>eu.europa.ec.joinup.sd-dss</groupId>
        <artifactId>dss-utils-apache-commons</artifactId>
    </dependency>
    <dependency>
        <groupId>eu.europa.ec.joinup.sd-dss</groupId>
        <artifactId>dss-xades</artifactId>
    </dependency>
    ...
</dependencies>
# Build and usage A simple build of the DSS Maven project can be done with the following command: ``` mvn clean install ``` This installation will run all unit tests present in the modules, which can take more than one hour to do the complete build. In addition to the general build, the framework provides a list of custom profiles, allowing a customized behavior: * quick - disables unit tests and java-doc validation, in order to process the build as quick as possible (takes 1-2 minutes). This profile cannot be used for a primary DSS build (see below). * quick-init - is similar to the `quick` profile. Disables java-doc validation for all modules and unit tests excluding some modules which have dependencies on their test classes. Can be used for the primary build of DSS. * slow-tests - executes all tests, including time-consuming unit tests. * owasp - runs validation of the project and using dependencies according to the [National Vulnerability Database (NVD)](https://nvd.nist.gov). * jdk19-plus - executed automatically for JDK version 9 and higher. Provides a support of JDK 8 with newer versions. * spotless - used to add a licence header into project files. In order to run a build with a specific profile, the following command must be executed: ``` mvn clean install -P *profile_name* ``` # Documentation The [documentation](dss-cookbook/src/main/asciidoc/dss-documentation.adoc) and samples are available in the dss-cookbook module. [SoapUI project](dss-cookbook/src/main/soapui) and [Postman project](dss-cookbook/src/main/postman) are also provided to illustrate SOAP/REST calls. In order to build the documentation by yourself, the following command must be executed in *dss-cookbook* module: ``` mvn clean install -P asciidoctor ``` # JavaDoc The JavaDoc is available on https://ec.europa.eu/digital-building-blocks/DSS/webapp-demo/apidocs/index.html # Demonstration The release is deployed on https://ec.europa.eu/digital-building-blocks/DSS/webapp-demo The source code of the demonstrations is available on https://github.com/esig/dss-demonstrations # Ready-to-use bundles Bundles which contain the above demonstration can be downloaded from the [Maven repository](https://ec.europa.eu/digital-building-blocks/artifact/service/rest/repository/browse/esignaturedss/eu/europa/ec/joinup/sd-dss/dss-demo-bundle/). The code of the demonstration can be found on https://ec.europa.eu/digital-building-blocks/code/projects/ESIG/repos/dss-demos/browse # Licenses The DSS project is delivered under the terms of the Lesser General Public License (LGPL), version 2.1 [![License (LGPL version 2.1)](https://img.shields.io/badge/license-GNU%20LGPL%20version%202.1-blue.svg?style=flat-square)](https://opensource.org/licenses/LGPL-2.1) SPDX-License-Identifier : LGPL-2.1 [![SonarCloud](https://sonarcloud.io/api/project_badges/measure?project=eu.europa.ec.joinup.sd-dss%3Asd-dss&metric=alert_status)](https://sonarcloud.io/dashboard?id=eu.europa.ec.joinup.sd-dss%3Asd-dss)