Skip to content

Commit

Permalink
Merge branch 'develop'
Browse files Browse the repository at this point in the history
  • Loading branch information
rsarendus committed Sep 5, 2023
2 parents a4b4a76 + a115853 commit fb68686
Show file tree
Hide file tree
Showing 77 changed files with 3,558 additions and 2,054 deletions.
32 changes: 0 additions & 32 deletions .github/workflows/digidoc4j-verify.yml

This file was deleted.

1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
.idea/*
target/*
*.iml
.mvn/wrapper/maven-wrapper.jar
**/.DS_Store
55 changes: 0 additions & 55 deletions .mvn/settings.xml

This file was deleted.

Binary file removed .mvn/wrapper/dists/apache-maven-3.8.5-bin.zip
Binary file not shown.
Binary file removed .mvn/wrapper/maven-wrapper.jar
Binary file not shown.
2 changes: 1 addition & 1 deletion .mvn/wrapper/maven-wrapper.properties
Original file line number Diff line number Diff line change
@@ -1 +1 @@
distributionUrl=https://repo1.maven.org/maven2/org/apache/maven/apache-maven/3.8.5/apache-maven-3.8.5-bin.zip
distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.9.4/apache-maven-3.9.4-bin.zip
35 changes: 21 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,14 +1,10 @@
![EU Regional Development Fund](digidoc4j/src/main/doc/resources/EL_Regionaalarengu_Fond_horisontaalne-vaike.jpg)

# Build status

[![Digidoc4j CI with Maven](https://github.com/open-eid/digidoc4j/actions/workflows/digidoc4j-verify.yml/badge.svg?branch=master)](https://github.com/open-eid/digidoc4j/actions/workflows/digidoc4j-verify.yml)

# DigiDoc4j
DigiDoc4j is a Java library for digitally signing documents and creating digital signature containers of signed documents.

# Features
* Creating ASiC-E and BDOC containers
* Creating ASiC-E
* Validating ASiC-E, BDOC, ASIC-S and DDOC containers
* Creating and validating detached XadES

Expand All @@ -31,18 +27,22 @@ DigiDoc4j is a Java library for digitally signing documents and creating digital
* It is recommended not to use special characters in the data file’s name, i.e. it is suggested to use only the characters that are categorized as “unreserved” according to RFC3986 (https://datatracker.ietf.org/doc/html/rfc3986).

# BDOC (Estonian specific implementation of Associated Signature Container Extended) container format
The support for creating BDOC-specific **time-mark** signatures was removed since DigiDoc4j version **5.2.0** in relation to
[discontinuation of **time-mark**-capable OCSP responders in 2023](https://www.id.ee/en/article/ria-stops-supporting-the-creation-of-the-bdoc-tm-digital-signature-format-in-the-software-it-develops/).

* Has **.bdoc** extension
* BDOC is a digital signature format developed in 2014 to replace the old, DDOC (DigiDoc) digital signature format.
* This format has been used as a default digital signature format in Estonia since 2015 until end of 2018.
* BDOC container is based on **ASiC-E** standard.
* Signatures are stored in **XAdES** format.
* Supports signature formats:
* Supports signature formats:
* **LT_TM** (Long Term TimeMark) - signature has **time-mark** ensuring long-term provability of the authenticity of the signature.
**LT_TM** signing support in DigiDoc4j was removed since version **5.2.0**.
* It is based on **XAdES baseline LT** signature format.
* **.bdoc** file is in fact a ZIP container with the signed files, the signatures and the protocol control information and can basically be opened by any program that recognizes the ZIP format.
* It is recommended not to use special characters in the data file’s name, i.e. it is suggested to use only the characters that are categorized as “unreserved” according to RFC3986 (https://datatracker.ietf.org/doc/html/rfc3986).

# ASiC-S (ASiC-E - Associated Signature Container Simple) container format
# ASiC-S (Associated Signature Container Simple) container format
* Has **.asics** or **.scs** extension
* Container associates one data file with either:
- one signature file containing one or more XAdES detached digital signature(s) that apply to it; or
Expand All @@ -69,10 +69,10 @@ DigiDoc4j is a Java library for digitally signing documents and creating digital
# Requirements
* Java **8** or higher (since version 4.0.0-RC.1)
* Internet access to external verification services
* OCSP (Online Certificate Status Protocol) - http://ocsp.sk.ee
* EU TSL (European Commission's Trusted Status List) - https://ec.europa.eu/information_society/policy/esignature/trusted-list/tl-mp.xml
* All the EU member states' TL servers referred in the EU TSL. Note that this list may change. (e.g. https://sr.riik.ee/tsl/estonian-tsl.xml, https://sede.minetur.gob.es/Prestadores/TSL/TSL.xml, https://www.viestintavirasto.fi/attachments/TSL-Ficora.xml etc.)
* TSA (Time Stamping Authority) - http://tsa.sk.ee
* OCSP (Online Certificate Status Protocol) - http://ocsp.sk.ee
* EU TSL (European Commission's Trusted Status List) - https://ec.europa.eu/information_society/policy/esignature/trusted-list/tl-mp.xml
* All the EU member states' TL servers referred in the EU TSL. Note that this list may change. (e.g. https://sr.riik.ee/tsl/estonian-tsl.xml, https://sede.minetur.gob.es/Prestadores/TSL/TSL.xml, https://www.viestintavirasto.fi/attachments/TSL-Ficora.xml etc.)
* TSA (Time Stamping Authority) - http://tsa.sk.ee

## Maven
You can use the library as a Maven dependency from the Maven Central (http://mvnrepository.com/artifact/org.digidoc4j/digidoc4j)
Expand All @@ -90,7 +90,14 @@ You can use the library as a Maven dependency from the Maven Central (http://mvn
* © Estonian Information System Authority

## Support
Official builds are provided through [releases](https://github.com/open-eid/digidoc4j/releases). If you want support, you need to be using official builds. Contact for assistance by email [[email protected]](mailto:[email protected]).
Additional information can be found in [wiki Q&A](https://github.com/open-eid/digidoc4j/wiki/Questions-&-Answers) and on [ID.ee portal](https://www.id.ee/rubriik/digidoc-teegid/).
Official builds are provided through [releases](https://github.com/open-eid/digidoc4j/releases).
If you want support, you need to be using official builds.
For assistance, contact us by email [[email protected]](mailto:[email protected]).
Additional information can be found in [wiki Q&A](https://github.com/open-eid/digidoc4j/wiki/Questions-&-Answers) and
on [ID.ee portal](https://www.id.ee/en/rubriik/digidoc-libraries/).

For staying up to date with news impacting services and applications that use the DigiDoc4j library,
[join DigiDoc4j library newsletter](https://www.id.ee/en/article/join-dd4j-library-newsletter/).

Source code is provided on "as is" terms with no warranty (see license for more information). Do not file Github issues with generic support requests.
Source code is provided on "as is" terms with no warranty (see license for more information).
Do not file GitHub issues with generic support requests.
24 changes: 24 additions & 0 deletions RELEASE-NOTES.txt
Original file line number Diff line number Diff line change
@@ -1,6 +1,30 @@
DigiDoc4J Java library release notes
------------------------------------

Release 5.2.0
------------------
Summary of the major changes since 5.1.0
------------------------------------------
* Disabled the possibility to create signatures with LT_TM and B_EPES profiles
* Fixed OCSP request nonce encoding (in CommonOCSPSource) on signature creation - OCSP nonce, used in
"id-pkix-ocsp-nonce" OCSP extension, is now a DER-encoded OCTET STRING, which is encapsulated as another OCTET STRING
(see https://www.rfc-editor.org/rfc/rfc4366.html#section-3.6 and https://www.rfc-editor.org/rfc/rfc6961.html#section-2.2)
* Deprecated "full report" configuration flag, as enabling it can produce false negative validation results in some cases:
- Deprecated setFullReportNeeded and isFullReport needed methods in Configuration class
- Deprecated -err/-showerrors command line option in DigiDoc4J command line utility
* Updated dependencies

Known issues
------------
* We have noticed a slight increase in TSL loading times due to pivot LOTL support
* We have noticed a decrease in performance with the introduction of properly accessing AIA certificate resources
* Opening a container that contains signatures, triggers TSL loading (TSL lazy loading does not work as expected)
* While upgrading from versions older than 2.1.1 be sure that your integration :
- doesn't use Xalan or XercesImpl dependencies
- uses a patched Java version (JDK8 or higher)
Xalan and XercesImpl were used to patch XML vulnerabilities in older java versions. They should be discarded with higher versions because they override default Java XML security.
If it is not possible to remove Xalan, then you can set your system property to override TransformerFactory : System.setProperty("javax.xml.transform.TransformerFactory","com.sun.org.apache.xalan.internal.xsltc.trax.TransformerFactoryImpl");

Release 5.1.0
------------------
Summary of the major changes since 5.0.0
Expand Down
4 changes: 2 additions & 2 deletions ddoc4j/pom.xml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@

<artifactId>ddoc4j</artifactId>
<packaging>jar</packaging>
<version>5.1.0</version>
<version>5.2.0</version>

<name>DDoc4J</name>
<description>DDoc4J is Java Library for validating DDOC documents. It's not recommended to use it directly but rather through DigiDoc4J's API.</description>
Expand All @@ -14,7 +14,7 @@
<parent>
<artifactId>digidoc4j-parent</artifactId>
<groupId>org.digidoc4j</groupId>
<version>5.1.0</version>
<version>5.2.0</version>
</parent>

<dependencies>
Expand Down
Loading

0 comments on commit fb68686

Please sign in to comment.