# nordic-institute/harmony-access-point architecture

> Architecture diagram of the GitHub repository nordic-institute/harmony-access-point, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nordic-institute/harmony-access-point
- Repository: https://github.com/nordic-institute/harmony-access-point

## Overview

Harmony eDelivery Access is an AS4 Access Point based on Domibus, used to join one or more eDelivery policy domains. Its operator-facing workflow is sign-in, navigate role-protected administration screens, and manage or inspect Access Point configuration and messages. The repository also includes message-pull processing and plugin interfaces/implementations for backend integration. The excerpts establish UI routing and a few core service contracts, but do not show most runtime wiring; those relationships are omitted rather than inferred.

Main entry points: [`Core/Domibus-MSH-angular/src/app/app.routes.ts`](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/app.routes.ts) (UI router), [`Core/Domibus-MSH/src/main/java/eu/domibus/core/message/pull/PullMessageService.java`](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH/src/main/java/eu/domibus/core/message/pull/PullMessageService.java) (Message pull), [`Core/Domibus-MSH-api/src/main/java/eu/domibus/api/multitenancy/Domain.java`](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/multitenancy/Domain.java) (Domain model), [`Plugin-FS/Domibus-default-fs-plugin/src/main/java/eu/domibus/plugin/fs/worker/FSAuthenticationService.java`](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Plugin-FS/Domibus-default-fs-plugin/src/main/java/eu/domibus/plugin/fs/worker/FSAuthenticationService.java) (Filesystem auth)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Operator console"]
  node_router["UI router<br/>[app.routes.ts]"]
  node_login["Sign in<br/>[login.component.ts]"]
  node_message_log["Message log"]
  node_error_log["Error log"]
  node_pmode["PMode management"]
  node_parties["Party management<br/>[party.component.ts]"]
  node_filters["Message filters"]
  node_truststore["Truststore management"]
end

subgraph group_messaging["Message processing"]
  node_message_pull["Message pull"]
  node_pull_state["Pull state"]
  node_user_message["User message model<br/>[UserMessage.java]"]
  node_message_log_model["Message log model"]
end

subgraph group_integration["Backend integration"]
  node_retriever["Message retrieval API"]
  node_fs_auth["Filesystem auth"]
  node_ws_backend["Web-service backend"]
  node_jms_queue["JMS queues"]
  node_plugin_auth["Plugin authentication API"]
  node_fs_sender["Filesystem sender"]
end

subgraph group_platform["Shared platform"]
  node_auth_api["Authorization API"]
  node_domain["Domain model<br/>[Domain.java]"]
  node_properties["Property resolution"]
  node_ecas["ECAS authentication"]
  node_auth_service["Authentication contract"]
  node_auth_utils["Security context<br/>[AuthUtils.java]"]
  node_archive_api["E-archive API"]
  node_cluster_listener["Cluster commands"]
  node_logger["Structured logging<br/>[DomibusLogger.java]"]
  node_logger_factory["Logger factory"]
  node_jms_spi["Internal JMS SPI"]
  node_property_api["Property provider API"]
  node_property_config["Property configuration API"]
  node_property_metadata["Property metadata API"]
  node_sessions["User sessions API"]
end

node_operator(("Operator"))

node_operator -.->|"uses console"| node_router
node_router -->|"routes to"| node_login
node_router -->|"routes to"| node_message_log
node_router -->|"routes to"| node_error_log
node_router -->|"routes to"| node_pmode
node_router -->|"routes to"| node_parties
node_router -->|"routes to"| node_filters
node_message_pull -->|"uses model"| node_user_message
node_message_pull -->|"uses model"| node_message_log_model
node_fs_auth -->|"authenticates via"| node_plugin_auth
node_ecas -->|"filters domains"| node_domain
node_cluster_listener -.->|"dispatches commands"| node_jms_spi
node_properties -->|"resolves by domain"| node_domain
node_logger_factory -->|"creates proxy"| node_logger

click node_router "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/app.routes.ts"
click node_login "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/security/login/login.component.ts"
click node_message_log "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/messagelog/messagelog.component.ts"
click node_error_log "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/errorlog/errorlog.component.ts"
click node_pmode "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/pmode/current/currentPMode.component.ts"
click node_parties "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/party/party.component.ts"
click node_filters "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/messagefilter/messagefilter.component.ts"
click node_truststore "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/truststore/truststore.component.ts"
click node_message_pull "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH/src/main/java/eu/domibus/core/message/pull/PullMessageService.java"
click node_pull_state "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH/src/main/java/eu/domibus/core/message/pull/PullMessageStateService.java"
click node_user_message "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/model/UserMessage.java"
click node_message_log_model "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/model/UserMessageLog.java"
click node_retriever "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-plugin-api/src/main/java/eu/domibus/ext/services/MessageRetrieverExtService.java"
click node_fs_auth "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Plugin-FS/Domibus-default-fs-plugin/src/main/java/eu/domibus/plugin/fs/worker/FSAuthenticationService.java"
click node_ws_backend "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Plugin-WS/Domibus-default-ws-plugin/src/main/java/eu/domibus/plugin/ws/backend/dispatch/WSPluginBackendService.java"
click node_jms_queue "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Plugin-JMS/Domibus-default-jms-plugin/src/main/java/eu/domibus/plugin/jms/JMSPluginQueueService.java"
click node_auth_api "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/authorization/AuthorizationService.java"
click node_domain "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/multitenancy/Domain.java"
click node_properties "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH/src/main/java/eu/domibus/core/property/PropertyRetrieveManager.java"
click node_ecas "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Weblogic/Domibus-MSH-weblogic-eu-login/src/main/java/eu/domibus/weblogic/security/ECASUserDetailsService.java"
click node_auth_service "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/security/AuthenticationService.java"
click node_auth_utils "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/security/AuthUtils.java"
click node_archive_api "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/earchive/DomibusEArchiveService.java"
click node_cluster_listener "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH/src/main/java/eu/domibus/core/clustering/ControllerListenerService.java"
click node_logger "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-logging/src/main/java/eu/domibus/logging/DomibusLogger.java"
click node_logger_factory "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-logging/src/main/java/eu/domibus/logging/DomibusLoggerFactory.java"
click node_jms_spi "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-jms-spi/src/main/java/eu/domibus/jms/spi/InternalJMSManager.java"
click node_property_api "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/property/DomibusPropertyProvider.java"
click node_property_config "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/property/DomibusConfigurationService.java"
click node_property_metadata "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/property/DomibusPropertyMetadataManagerSPI.java"
click node_sessions "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/multitenancy/UserSessionsService.java"
click node_plugin_auth "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-plugin-api/src/main/java/eu/domibus/ext/services/AuthenticationExtService.java"
click node_fs_sender "https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Plugin-FS/Domibus-default-fs-plugin/src/main/java/eu/domibus/plugin/fs/worker/FSSendMessagesService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_router,node_login,node_message_log,node_error_log,node_pmode,node_parties,node_filters,node_truststore toneBlue
class node_message_pull,node_pull_state,node_user_message,node_message_log_model toneAmber
class node_retriever,node_fs_auth,node_ws_backend,node_jms_queue,node_plugin_auth,node_fs_sender toneMint
class node_auth_api,node_domain,node_properties,node_ecas,node_auth_service,node_auth_utils,node_archive_api,node_cluster_listener,node_logger,node_logger_factory,node_jms_spi,node_property_api,node_property_config,node_property_metadata,node_sessions toneRose
class node_operator toneIndigo
```

## Components

### Operator console

- [UI router](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/app.routes.ts): `Core/Domibus-MSH-angular/src/app/app.routes.ts`
- [Sign in](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/security/login/login.component.ts): `Core/Domibus-MSH-angular/src/app/security/login/login.component.ts`
- [Message log](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/messagelog/messagelog.component.ts): `Core/Domibus-MSH-angular/src/app/messagelog/messagelog.component.ts`
- [Error log](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/errorlog/errorlog.component.ts): `Core/Domibus-MSH-angular/src/app/errorlog/errorlog.component.ts`
- [PMode management](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/pmode/current/currentPMode.component.ts): `Core/Domibus-MSH-angular/src/app/pmode/current/currentPMode.component.ts`
- [Party management](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/party/party.component.ts): `Core/Domibus-MSH-angular/src/app/party/party.component.ts`
- [Message filters](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/messagefilter/messagefilter.component.ts): `Core/Domibus-MSH-angular/src/app/messagefilter/messagefilter.component.ts`
- [Truststore management](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-angular/src/app/truststore/truststore.component.ts): `Core/Domibus-MSH-angular/src/app/truststore/truststore.component.ts`

### Message processing

- [Message pull](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH/src/main/java/eu/domibus/core/message/pull/PullMessageService.java): `Core/Domibus-MSH/src/main/java/eu/domibus/core/message/pull/PullMessageService.java`
- [Pull state](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH/src/main/java/eu/domibus/core/message/pull/PullMessageStateService.java): `Core/Domibus-MSH/src/main/java/eu/domibus/core/message/pull/PullMessageStateService.java`
- [User message model](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/model/UserMessage.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/model/UserMessage.java`
- [Message log model](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/model/UserMessageLog.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/model/UserMessageLog.java`

### Backend integration

- [Message retrieval API](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-plugin-api/src/main/java/eu/domibus/ext/services/MessageRetrieverExtService.java): `Core/Domibus-plugin-api/src/main/java/eu/domibus/ext/services/MessageRetrieverExtService.java`
- [Filesystem auth](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Plugin-FS/Domibus-default-fs-plugin/src/main/java/eu/domibus/plugin/fs/worker/FSAuthenticationService.java): `Plugin-FS/Domibus-default-fs-plugin/src/main/java/eu/domibus/plugin/fs/worker/FSAuthenticationService.java`
- [Web-service backend](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Plugin-WS/Domibus-default-ws-plugin/src/main/java/eu/domibus/plugin/ws/backend/dispatch/WSPluginBackendService.java): `Plugin-WS/Domibus-default-ws-plugin/src/main/java/eu/domibus/plugin/ws/backend/dispatch/WSPluginBackendService.java`
- [JMS queues](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Plugin-JMS/Domibus-default-jms-plugin/src/main/java/eu/domibus/plugin/jms/JMSPluginQueueService.java): `Plugin-JMS/Domibus-default-jms-plugin/src/main/java/eu/domibus/plugin/jms/JMSPluginQueueService.java`
- [Plugin authentication API](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-plugin-api/src/main/java/eu/domibus/ext/services/AuthenticationExtService.java): `Core/Domibus-plugin-api/src/main/java/eu/domibus/ext/services/AuthenticationExtService.java`
- [Filesystem sender](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Plugin-FS/Domibus-default-fs-plugin/src/main/java/eu/domibus/plugin/fs/worker/FSSendMessagesService.java): `Plugin-FS/Domibus-default-fs-plugin/src/main/java/eu/domibus/plugin/fs/worker/FSSendMessagesService.java`

### Shared platform

- [Authorization API](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/authorization/AuthorizationService.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/authorization/AuthorizationService.java`
- [Domain model](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/multitenancy/Domain.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/multitenancy/Domain.java`
- [Property resolution](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH/src/main/java/eu/domibus/core/property/PropertyRetrieveManager.java): `Core/Domibus-MSH/src/main/java/eu/domibus/core/property/PropertyRetrieveManager.java`
- [ECAS authentication](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Weblogic/Domibus-MSH-weblogic-eu-login/src/main/java/eu/domibus/weblogic/security/ECASUserDetailsService.java): `Weblogic/Domibus-MSH-weblogic-eu-login/src/main/java/eu/domibus/weblogic/security/ECASUserDetailsService.java`
- [Authentication contract](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/security/AuthenticationService.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/security/AuthenticationService.java`
- [Security context](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/security/AuthUtils.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/security/AuthUtils.java`
- [E-archive API](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/earchive/DomibusEArchiveService.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/earchive/DomibusEArchiveService.java`
- [Cluster commands](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH/src/main/java/eu/domibus/core/clustering/ControllerListenerService.java): `Core/Domibus-MSH/src/main/java/eu/domibus/core/clustering/ControllerListenerService.java`
- [Structured logging](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-logging/src/main/java/eu/domibus/logging/DomibusLogger.java): `Core/Domibus-MSH-logging/src/main/java/eu/domibus/logging/DomibusLogger.java`
- [Logger factory](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-logging/src/main/java/eu/domibus/logging/DomibusLoggerFactory.java): `Core/Domibus-MSH-logging/src/main/java/eu/domibus/logging/DomibusLoggerFactory.java`
- [Internal JMS SPI](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-jms-spi/src/main/java/eu/domibus/jms/spi/InternalJMSManager.java): `Core/Domibus-MSH-jms-spi/src/main/java/eu/domibus/jms/spi/InternalJMSManager.java`
- [Property provider API](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/property/DomibusPropertyProvider.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/property/DomibusPropertyProvider.java`
- [Property configuration API](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/property/DomibusConfigurationService.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/property/DomibusConfigurationService.java`
- [Property metadata API](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/property/DomibusPropertyMetadataManagerSPI.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/property/DomibusPropertyMetadataManagerSPI.java`
- [User sessions API](https://github.com/nordic-institute/harmony-access-point/blob/harmony-main/Core/Domibus-MSH-api/src/main/java/eu/domibus/api/multitenancy/UserSessionsService.java): `Core/Domibus-MSH-api/src/main/java/eu/domibus/api/multitenancy/UserSessionsService.java`

### Other components

- **Operator**

## Connections

- Operator → UI router: uses console
- UI router → Sign in: routes to (evidence: `Core/Domibus-MSH-angular/src/app/app.routes.ts`)
- UI router → Message log: routes to (evidence: `Core/Domibus-MSH-angular/src/app/app.routes.ts`)
- UI router → Error log: routes to (evidence: `Core/Domibus-MSH-angular/src/app/app.routes.ts`)
- UI router → PMode management: routes to (evidence: `Core/Domibus-MSH-angular/src/app/app.routes.ts`)
- UI router → Party management: routes to (evidence: `Core/Domibus-MSH-angular/src/app/app.routes.ts`)
- UI router → Message filters: routes to (evidence: `Core/Domibus-MSH-angular/src/app/app.routes.ts`)
- Message pull → User message model: uses model (evidence: `Core/Domibus-MSH/src/main/java/eu/domibus/core/message/pull/PullMessageService.java`)
- Message pull → Message log model: uses model (evidence: `Core/Domibus-MSH/src/main/java/eu/domibus/core/message/pull/PullMessageService.java`)
- Filesystem auth → Plugin authentication API: authenticates via (evidence: `Plugin-FS/Domibus-default-fs-plugin/src/main/java/eu/domibus/plugin/fs/worker/FSAuthenticationService.java`)
- ECAS authentication → Domain model: filters domains (evidence: `Weblogic/Domibus-MSH-weblogic-eu-login/src/main/java/eu/domibus/weblogic/security/ECASUserDetailsService.java`)
- Cluster commands → Internal JMS SPI: dispatches commands
- Property resolution → Domain model: resolves by domain (evidence: `Core/Domibus-MSH/src/main/java/eu/domibus/core/property/PropertyRetrieveManager.java`)
- Logger factory → Structured logging: creates proxy (evidence: `Core/Domibus-MSH-logging/src/main/java/eu/domibus/logging/DomibusLoggerFactory.java`)
