niis/harmony-ap repository overview

⁠Harmony eDelivery Access - Access Point

Harmony eDelivery Access Access Point⁠ is an AS4 Access Point for joining eDelivery policy domains.

⁠Links to Resources

• Full user guide on GitHub⁠.
• Dockerfile⁠.
• More information about Harmony eDelivery Access⁠.
• Harmony Access Point on GitHub⁠.
• Join⁠ the Harmony eDelivery Access Community Slack!

⁠Quick Start Guide

The Access Point container requires an external database. The following example defines an Access Point and a database using Docker compose⁠:

services:
  harmony-ap:
    image: niis/harmony-ap:2.2.0
    depends_on:
      - harmony-db
    environment:
      - DB_HOST=harmony-db
      - DB_SCHEMA=harmony_ap
      - DB_PASSWORD=dbpassword
      - ADMIN_PASSWORD=Secret
      - USE_DYNAMIC_DISCOVERY=false
      - PARTY_NAME=org1_gw
      - SERVER_FQDN=harmony-ap
    volumes:
      - ap_data:/var/opt/harmony-ap
    ports:
      - "8443:8443"
    restart: on-failure
    mem_limit: 1500m
  harmony-db:
    image: mysql:8
    environment:
      - MYSQL_ROOT_PASSWORD=root_password
      - MYSQL_DATABASE=harmony_ap
      - MYSQL_USER=harmony_ap
      - MYSQL_PASSWORD=dbpassword
    command:
      - "--character-set-server=utf8mb4"
      - "--collation-server=utf8mb4_bin"
    volumes:
      - db_data:/var/lib/mysql
    restart: on-failure
    mem_limit: 512m
volumes:
  ap_data:
  db_data:

⁠How to get the latest security updates?

Monthly security updates are provided to last three minor versions. The updates are released monthly on the 25th, with additional releases for critical vulnerabilities. The updates include the latest base image with up-to-date packages and security fixes. There are no changes to the Harmony Access Point software and its packages inside. These changes are released with a version change.

⁠Steps to update

Pull the latest version of your choice using the following command:

docker pull niis/harmony-ap:<target-version>

Note: If you do not pull the latest version, Docker may use a local image of the same version that may not be up-to-date. You can check when each image was last updated on Docker hub.

Follow the upgrade steps described here⁠.