release-notes-3.1.x.adoc

include::_common-settings.adoc[]


== OIORASP version 3.1.0

IMPORTANT: MitID / OCES3 certificates uses _RSASSA-PSS_ as Signature algorithm (see https://cms.nemlog-in.dk/media/m0zjfotx/sammenligning-af-oces2-vs-oces3.pdf[sammenligning-af-oces2-vs-oces3.pdf]). Only newer versions of Java supports this algorithm: Java 1.8.0.261 or newer, and Java 11.0.1 or newer (https://bugs.openjdk.org/browse/JDK-8230978[JDK documentation]).


=== New features
* Support for the new UtilityStatement (UTS) version 2.1 - see <<Configuration>> section (NH-2431).

=== Fixes
* N/A

=== Changes
* Unit tests has been updated to jUnit version 4.13.2 (NH-1664).
* Log4j's library has been updated to version 2.17.2.
* Classes updated to use slf4j.

=== Removals
* Unused class SimpleCrlLookup has been removed.
* OIOXML support has been removed from RaspConfiguration.xml files, including example files (NH-2431).


=== How to upgrade
How to upgrade project from OIORASP Java 3.0.0 to version 3.1.0.

NOTE: The guide might not be 100% accurate, depending on your use of the library! Some steps might be unnecessary in your setup, and others might be as detailed as need in your setup!

Steps:

. Download new release from https://nemhandel.dk/opdateringer-releases
. File changes:
* Replace your old JAR file with the new (dk.gov.oiosi.library-{versionNumberTagged}.jar)
* Replace log4j library files with new files (eg. log4j-core-2.17.2.jar + log4j-api-2.17.2.jar + log4j-jcl-2.17.2.jar).
* In general the dependencies for OIORASP can be found in IVY-format in the file: https://rep.erst.dk/git/openebusiness/library/java/-/blob/master/dk.gov.oiosi.library/ivy.xml

. RaspConfiguration.xml must be updated!
* See <<Configuration>> section.


=== Configuration

include::release-notes-raspconfiguration-3.1.0.adoc[]


That should be it...!


If you meet problems, that should be included in this guide, please post your comments to the following email address: support@nemhandel.dk