Harmony eDelivery Access - SMP v2.0.0 Release Notes

Release Info

Version number

2.0.0

Release date

10.08.2023

Supported versions

  • 2.0.0

  • 1.4.0

  • 1.3.1

Supported platforms

  • Ubuntu 20.04 LTS

Official documentation

https://github.com/nordic-institute/harmony-common

Source code

https://github.com/nordic-institute/harmony-smp

Software license

EUPL 1.2



On this page:



Changes in This Release

Summary

  • Merge changes from European Commission's DomiSMP 5.0 into Harmony SMP. More information.

  • Provide support for using a remote database and customizing the database schema name.

  • Add support for OpenJDK 11.

Only upgrades from Harmony SMP version 1.4.0 are supported. If you're using an older Harmony SMP version, please upgrade to version 1.4.0 first, and to version 2.0.0 after that.

Version upgrade from Harmony SMP v.1.4.0

It is strongly recommended to take a backup of the system (database and configuration in /etc/harmony-smp) before the upgrade.

If the installer asks for database configuration during the upgrade, accept the existing configuration read from /etc/harmony-smp/tomcat-conf/context.xml. Leaving the database password blank uses the current password from configuration. Please do not change the configuration values proposed by the installer.

Completed Issues

Issue ID

Type

Summary

Issue ID

Type

Summary

NEDS-127

Improvement

  • Multiple document types can now be published via a new extension mechanism.

    • Extensions for Oasis SMP 1.0 and Oasis SMP 2.0 are included in Harmony SMP.

  • Support for ECDSA and EdDSA XML signatures for XML responses to SMP client​.

  • Renewed look and feel of the UI​ and more flexible user management via multiple management layers​.

  • Users can have multiple security tokens as well as TLS certificates for REST API authentication.

  • The resources (ServiceGroups and Service Metadata documents) can be set as private on Domain, Domain subgroup or Resource level. The protected resource document can be accessed only by authenticated users with sufficient access rights

  • The resources (ServiceGroups and Service Metadata documents) are versioned.

  • Various security and UI enhancements.

Copied from the DomiSMP 5.0 release notes published by the European Commission.

NEDS-127

Fix

  • Space character URLs encoding in service-group response.

  • Wrong ebCore party identifier serialization in XML response.

  • Registering redirect service metadata using the UI tools fails.

Copied from the DomiSMP 5.0 release notes published by the European Commission.

NEDS-128

Improvement

Add support for OpenJDK 11 for the Harmony SMP. By default, the Harmony SMP uses OpenJDK 11 for new installations starting from version 2.0.0. Versions prior to version 2.0.0 support only OpenJDK 8.

The Java runtime version isn’t updated automatically during the SMP version upgrade. Instead, a manual migration is required. First, upgrade the Harmony SMP to version 2.0.0 and then complete the steps described in the migration guide.

NEDS-129

New

Add support for using a remote database. Make database connection details configurable during the SMP installation process. The following connection details have been made configurable:

  • host

  • port

  • username

  • password

When using a local database, the default values should be accepted.

NEDS-130

New

Make database schema name configurable during the SMP installation process. This change enables sharing the same database server between multiple SMPs.

NEDS-139

Improvement

Update the Dynamic Discovery Configuration Guide.

NEDS-140

New

Create a migration guide for migrating from Java 8 to Java 11.

Issue types: fix (bug fix or technical debt), improvement (improvement to an existing feature), new (a new feature).

New/Updated Dependencies

Dependency

Old version

New version

Dependency

Old version

New version

com.fasterxml.jackson.core:jackson-annotations

2.13.3

-

com.fasterxml.jackson.core:jackson-core

2.13.3

2.15.2

com.fasterxml.jackson.core:jackson-databind

2.13.3

2.15.2

com.fasterxml.jackson.datatype:jackson-datatype-jsr310

2.13.3

2.15.2

com.fasterxml.jackson.module:jackson-module-jaxb-annotations

-

2.15.2

com.h2database:h2

1.4.200

2.2.220

commons-fileupload:commons-fileupload

1.3.3

1.5

commons-io:commons-io

2.11.0

2.13.0

com.mysql:mysql-connector-j

-

8.0.33

com.smartbear.soapui:soapui

-

5.1.2

com.sun.xml.bind:jaxb-core

2.2.11

-

com.sun.xml.bind:jaxb-impl

2.2.11

-

eu.europa.ec.dynamic-discovery:dynamic-discovery-client

-

2.0

eu.europa.ec.edelivery:edelivery-springsecurity-2-way-ssl-auth

1.11

1.13

jakarta.xml.bind:jakarta.xml.bind-api

-

2.3.3

junit:junit

-

4.13.2

org.apache.commons:commons-lang3

-

3.12.0

org.apache.cxf:cxf-rt-features-logging

3.5.2

3.5.6

org.apache.cxf:cxf-rt-frontend-jaxws

3.5.2

3.5.6

org.apache.cxf:cxf-rt-transports-http

3.5.2

3.5.6

org.apache.cxf.xjc-utils:cxf-xjc-runtime

3.3.2

-

org.apache.httpcomponents:httpclient

4.5.13

4.5.14

org.apache.santuario:xmlsec

-

2.3.3

org.apache.tomcat.embed:tomcat-embed-jasper

-

9.0.75

org.bouncycastle:bcpkix-jdk15to18

1.70

-

org.bouncycastle:bcprov-jdk15to18

1.70

-

org.freemarker:freemarker

2.3.31

2.3.32

org.glassfish.jaxb:jaxb-runtime

-

2.3.8

org.hamcrest:hamcrest

-

2.2

org.hibernate:hibernate-core

5.6.9.Final

5.6.15.Final

org.hibernate:hibernate-envers

5.6.9.Final

5.6.15.Final

org.junit.jupiter:junit-jupiter-engine

-

5.9.2

org.junit.jupiter:junit-jupiter-params

-

5.9.2

org.jvnet.jaxb2_commons:jaxb2-basics

1.11.1

-

org.mockito:mockito-core

2.23.4

4.10.0

org.mockito:mockito-inline

-

4.10.0

org.mockito:mockito-junit-jupiter

-

4.10.0

org.slf4j:slf4j-simple

-

1.7.36

org.springframework.boot:spring-boot-starter-data-jpa

2.7.0

2.7.12

org.springframework.boot:spring-boot-starter-test

2.7.0

2.7.12

org.springframework.boot:spring-boot-starter-web

-

2.7.12

org.springframework.security:spring-security-cas

5.7.2

5.8.5

org.springframework.security:spring-security-config

5.7.2

5.8.5

org.springframework.security:spring-security-core

5.7.2

5.8.5

org.springframework.security:spring-security-test

5.7.2

5.8.5

org.springframework:spring-beans

5.3.21

5.3.29

org.springframework:spring-context

5.3.21

5.3.29

org.springframework:spring-context-support

5.3.21

5.3.29

org.springframework:spring-core

5.3.21

5.3.29

org.springframework:spring-jdbc

5.3.21

5.3.29

org.springframework:spring-orm

5.3.21

5.3.29

org.springframework:spring-test

5.3.21

5.3.29

org.springframework:spring-web

5.3.21

5.3.29

org.springframework:spring-webmvc

5.3.21

5.3.29

Contributors

The following developers have contributed to the development of this release version. A contribution means at least one Git commit that is included in the release.

GitHub Username

GitHub Username

bertvi

jhyoty

petkivim

Other Notes

-

Package Repositories

Repository

URL

Repository

URL

Focal

deb https://artifactory.niis.org/artifactory/harmony-release-deb focal-current main

Repository Sign Key Details

Download URL

https://artifactory.niis.org/api/gpg/key/public

Hash

935CC5E7FA5397B171749F80D6E3973B

Fingerprint

A01B FE41 B9D8 EAF4 872F A3F1 FB0D 532C 10F6 EC5B

3rd party key server

Ubuntu key server

Packages

Focal

Package

SHA256 checksum

Package

SHA256 checksum

harmony-smp_2.0.0-0.ubuntu20.04_all.deb

71729e03452110f129f75ee5c4efb4ac9de2525fd5b2d1fa4aecf06c2dcd912c