Harmony eDelivery Access - Access Point v2.0.0 Release Notes

Release Info

Version number

2.0.0

Release date

05.06.2023

Supported versions

Access Point

  • 2.0.0

  • 1.4.0

  • 1.3.1

Supported platforms

Access Point

  • Ubuntu 20.04 LTS

Official documentation

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

Source code

https://github.com/nordic-institute/harmony-access-point

Software license

EUPL 1.2

 

On this page:



Changes in This Release

Summary

  • Merge changes from European Commission's Domibus 5.1 into Harmony Access Point. More information.

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

  • Enable defining attachment name using the businessContentAttachment property.

Version upgrade from Harmony Access Point v.1.4.0

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

If the installer asks for database configuration during the upgrade, accept the existing configuration read from /etc/harmony-ap/domibus.properties. Leaving the database password blank uses the current password from configuration. Please do not change the configuration values proposed by the installer.

If you are using an external database, you need to grant the Harmony Access Point database user additional rights before the upgrade. The additional rights can be revoked afterwards.

-- mysql
grant SYSTEM_VARIABLES_ADMIN on *.* to harmony_ap'@'%'

The WS Plugin has a new interface with a new path and namespace. The old interface is still available, but it’s deprecated.

Old interface

Path: https://<AP_HOST>:8443/services/backend

Namespace: http://org.ecodex.backend/1_1/

New interface

Path: https://<AP_HOST>:8443/services/wsplugin

Namespace: http://eu.domibus.wsplugin/

Completed Issues

Issue ID

Type

Summary

Issue ID

Type

Summary

NEDS-100

Improvement

In Harmony Access Point versions < 2.0.0, the name of attachments is defined using the href attribute value prefixed with cid:. In the example below, the attachment name is attachment:

<ns:PartInfo href=cid:attachment> <ns:PartProperties> <ns:Property name="businessContentAttachment">file.xml</ns:Property> <ns:Property name="MimeType">text/xml</ns:Property> </ns:PartProperties> </ns:PartInfo>

Starting from Harmony Access Point version 2.0.0, the attachment name can be defined using the businessContentAttachment property. The property value is used as the attachment name when the Access Point generates the downloadable zip file containing all the message parts.

By default, the href attribute value prefixed with cid: is used as the attachment name. The businessContentAttachment property can be used as the attachment name by setting the domibus.payload.business.content.attachment.enabled property value to true in the /etc/harmony-ap/domibus.properties file. The harmony-ap service must be restarted after changing the property value.

NEDS-107

Improvement

Provide a better support for using a remote database. Make database connection details configurable during the Access Point 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.

Detailed instructions on configuring a remote database are available in the Harmony Knowledge Base.

NEDS-108

Improvement

Make database schema name configurable during the Access Point installation process. This change enables sharing the same database server between multiple Access Points.

NEDS-111

New / improvement

  • Support different security algorithm configurations.

  • Support different/multiple (types of) private keys to be used by different security configurations.

  • Add retry strategy with increasing delay between attempts.

  • Add possibility to configure retention policy for metadata separately than the one for data.

  • Allow batch (re)sending of messages from the admin console.

  • Production support for self-sending: Domibus will support the possibility for the receiving party of a message to use the same access point as the sending party.

Copied from the Domibus 5.1 release notes published by the European Commission.

NEDS-111

New / improvement

  • Improved upload time for large (MB) pMode files.

  • Add interval partitioning over the existing range partition by reference.

  • Add support for TLSv1.3 in DSS extension.

  • Handle receipts with the same message id.

Copied from the Domibus 5.0.5 release notes published by the European Commission.

NEDS-111

New / improvement

  • Possibility to visualize the non-repudiation receipts in the Admin console.

  • Improved overall performance including refactoring of the database to allow partitioning.

  • Possibility to use an external eArchiving agent.

  • Default WS Plugin: Possibility to implement PUSH.

  • Possibility to filter messages retrieved by the listPendingMessages WS Plugin method.

  • Implement offloading the SSL traffic to an external component.

  • Improve the decoupling of the Domibus core from the plugin implementations.

  • Possibility to validate incoming UserMessages using a Validation Extension.

  • Possibility to reference JMS Plugin payloads via HTTP endpoints.

  • New client authentication trust store admin console page.

  • New WS Plugin which uses the edelivery namespace.

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

NEDS-111

Improvement / fix

More information about other improvements and fixes is available in the Domibus release notes:

NEDS-126

Fix

Fix incorrect support URL in the Access Point UI.

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

Notes

Dependency

Old Version

New Version

Notes

ch.qos.logback:logback-classic

1.2.3

1.2.11

 

ch.qos.logback:logback-core

1.2.3

1.2.11

 

com.atomikos:transactions-api

4.0.6

-

 

com.atomikos:transactions-hibernate4

4.0.6

-

 

com.atomikos:transactions-jdbc

4.0.6

-

 

com.atomikos:transactions-jms

4.0.6

-

 

com.atomikos:transactions-jta

4.0.6

-

 

com.fasterxml.jackson.core:jackson-annotations

2.9.10

2.14.2

 

com.fasterxml.jackson.core:jackson-core

2.9.10

2.14.2

 

com.fasterxml.jackson.core:jackson-databind

2.9.10.8

2.14.2

 

com.fasterxml.jackson.datatype:jackson-datatype-jdk8

2.9.10

2.14.2

 

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

2.9.10

2.14.2

 

com.fasterxml.uuid:java-uuid-generator

3.2.0

4.0.1

 

com.github.tomakehurst:wiremock

2.26.2

2.27.2

 

com.google.code.gson:gson

2.8.6

-

 

com.google.guava:guava

28.0-jre

31.1-jre

 

com.h2database:h2

1.4.178

2.1.214

 

com.hazelcast:hazelcast-all

-

4.2.7

 

com.mchange:c3p0

0.9.5.4

-

 

commons-codec:commons-codec

1.13

1.15

 

commons-collections:commons-collections

3.2

3.2.2

 

commons-fileupload:commons-fileupload

1.4

1.5

 

commons-io:commons-io

2.7

2.11.0

 

commons-lang:commons-lang

2.6

-

 

commons-net:commons-net

3.5

-

 

com.opencsv:opencsv

5.0

5.7.1

 

com.sun.xml.bind:jaxb-core

2.3.0

-

 

com.sun.xml.bind:jaxb-impl

2.3.0

2.3.8

 

com.sun.xml.messaging.saaj:saaj-impl

1.5.1

1.5.3

 

com.thoughtworks.xstream:xstream

1.4.17

-

 

com.zaxxer:HikariCP

-

4.0.3

 

eu.europa.ec.digit.commons:commons-test

4.2

4.3

 

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

1.12

1.13

 

io.dropwizard.metrics:metrics-core

4.1.1

4.2.17

 

io.dropwizard.metrics:metrics-healthchecks

4.1.1

4.2.17

 

io.dropwizard.metrics:metrics-jmx

4.1.1

4.2.17

 

io.dropwizard.metrics:metrics-servlets

4.1.1

4.2.17

 

io.swagger.core.v3:swagger-annotations

-

2.2.4

 

io.swagger.core.v3:swagger-jaxrs2

-

2.2.4

 

io.swagger:swagger-annotations

1.5.3

-

 

jakarta.activation:jakarta.activation-api

1.2.1

-

 

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

2.3.2

4.0.0

 

javax.activation:activation

1.1

1.1.1

 

javax.annotation:javax.annotation-api

1.3.1

1.3.2

 

javax.cache:cache-api

-

1.1.1

 

javax.el:javax.el-api

2.2.4

-

 

javax.inject:javax.inject

-

1

 

javax.servlet:javax.servlet-api

3.1.0

4.0.1

 

javax.ws.rs:javax.ws.rs-api

-

2.1.1

 

javax.xml.bind:jaxb-api

2.3.0

2.3.1

 

javax.xml.ws:jaxws-api

2.2

2.3.1

 

jcifs:jcifs

1.3.17

-

 

junit:junit

4.12

4.13.2

 

mysql:mysql-connector-java

8.0.19

-

 

net.minidev:json-smart

-

2.4.8

 

net.sf.ehcache:ehcache

2.10.6

-

 

network.oxalis.vefa:peppol-lookup

-

2.4.0

 

no.difi.vefa:peppol-lookup

1.1.3

-

 

org.apache.activemq:activemq-all

5.15.13

-

 

org.apache.activemq:activemq-broker

5.15.14

5.16.5

 

org.apache.activemq:activemq-client

5.15.14

5.16.5

 

org.apache.activemq:activemq-jaas

5.15.14

5.16.5

 

org.apache.activemq:activemq-kahadb-store

5.15.14

5.16.5

 

org.apache.activemq:activemq-spring

5.15.14

5.16.5

 

org.apache.commons:commons-lang3

3.9

3.12.0

 

org.apache.commons:commons-vfs2

2.1

2.9.0

 

org.apache.cxf:cxf-core

3.3.11

3.5.5

 

org.apache.cxf:cxf-rt-bindings-soap

3.3.11

3.5.5

 

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

3.3.11

3.5.5

 

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

3.3.11

3.5.5

 

org.apache.cxf:cxf-rt-security

3.3.11

3.5.5

 

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

3.3.11

3.5.5

 

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

3.3.11

3.5.5

 

org.apache.cxf:cxf-rt-wsdl

3.3.11

3.5.5

 

org.apache.cxf:cxf-rt-ws-policy

3.3.11

3.5.5

 

org.apache.cxf:cxf-rt-ws-security

3.3.11

3.5.5

 

org.apache.httpcomponents:httpclient

4.5.13

4.5.14

 

org.apache.httpcomponents:httpcore

4.4.5

4.4.16

 

org.apache.neethi:neethi

3.1.1

-

 

org.apache.santuario:xmlsec

-

2.3.0

 

org.apache.tika:tika-core

1.26

2.7.0

 

org.apache.wss4j:wss4j-ws-security-common

2.2.6

2.4.1

 

org.aspectj:aspectjrt

1.9.4

1.9.9.1

 

org.aspectj:aspectjweaver

1.9.4

1.9.9.1

 

org.awaitility:awaitility

3.1.0

4.2.0

 

org.bouncycastle:bcpkix-jdk15on

1.67

-

 

org.bouncycastle:bcpkix-jdk18on

-

1.72

 

org.bouncycastle:bcprov-jdk15on

1.67

-

 

org.bouncycastle:bcprov-jdk18on

-

1.72

 

org.dom4j:dom4j

2.1.3

2.1.4

 

org.ehcache:ehcache

-

3.10.8

 

org.freemarker:freemarker

2.3.29

2.3.32

 

org.glassfish:javax.el

-

3.0.1-b12

 

org.hibernate:hibernate-core

-

5.6.15.Final

 

org.hibernate:hibernate-entitymanager

5.4.25.Final

5.6.15.Final

 

org.hibernate:hibernate-envers

5.4.25.Final

5.6.15.Final

 

org.hibernate:hibernate-jcache

-

5.6.15.Final

 

org.hibernate:hibernate-validator

5.1.2.Final

-

 

org.hibernate.validator:hibernate-validator

-

6.2.5.Final

 

org.javassist:javassist

-

3.28.0-GA

 

org.liquibase:liquibase-core

3.5.3

4.17.0

 

org.mapstruct:mapstruct

1.3.1.Final

1.5.3.Final

 

org.reflections:reflections

0.9.10

0.10.2

 

org.roda-project:commons-ip2

-

2.0.0-alpha2

 

org.slf4j:jcl-over-slf4j

1.7.28

1.7.36

 

org.slf4j:jul-to-slf4j

1.7.28

1.7.36

 

org.slf4j:log4j-over-slf4j

-

1.7.36

 

org.slf4j:slf4j-api

1.7.28

1.7.36

 

org.slf4j:slf4j-ext

1.7.28

1.7.36

 

org.springframework.security:spring-security-config

5.4.7

5.8.2

 

org.springframework.security:spring-security-core

5.4.7

5.8.2

 

org.springframework.security:spring-security-test

5.4.7

5.8.2

 

org.springframework.security:spring-security-web

5.4.7

5.8.2

 

org.springframework.session:spring-session-core

-

2.7.0

 

org.springframework.session:spring-session-jdbc

-

2.7.0

 

org.springframework:spring-aop

5.2.16.RELEASE

5.3.26

 

org.springframework:spring-beans

5.2.16.RELEASE

5.3.26

 

org.springframework:spring-context

5.2.16.RELEASE

5.3.26

 

org.springframework:spring-context-support

5.2.16.RELEASE

5.3.26

 

org.springframework:spring-core

5.2.16.RELEASE

5.3.26

 

org.springframework:spring-jms

5.2.16.RELEASE

5.3.26

 

org.springframework:spring-orm

5.2.16.RELEASE

5.3.26

 

org.springframework:spring-test

5.2.16.RELEASE

5.3.26

 

org.springframework:spring-tx

5.2.16.RELEASE

5.3.26

 

org.springframework:spring-web

5.2.16.RELEASE

5.3.26

 

org.springframework:spring-webmvc

5.2.16.RELEASE

5.3.26

 

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-ap_2.0.0-0.ubuntu20.04_all.deb

633d0a4a988c094ad26e5632f71484de357a812347cec717fd4d07984f63244f