[{"_1":2,"_185":-5,"_186":-5},"loaderData",{"_3":4,"_13":14,"_20":21,"_158":159},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","routes/_layout.r.$namespace.$reponame",{"_22":23,"_24":-5,"_25":11,"_26":11,"_27":28,"_29":30,"_31":-5,"_32":11,"_33":34,"_93":-5,"_94":95,"_151":-5,"_152":11,"_153":17,"_154":11,"_155":-5,"_156":157},"canonicalUrl","https://hub.docker.com/r/isaitb/asx-messaging-v4/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","isaitb","reponame","asx-messaging-v4","cloudBuildSource","isAutobuildsAvailable","repo",{"_35":36,"_48":49,"_51":52,"_53":54,"_55":11,"_56":57,"_58":59,"_60":61,"_38":30,"_27":28,"_63":64,"_65":50,"_66":67,"_68":69,"_70":71,"_72":-5,"_73":67,"_74":75,"_76":11,"_77":28,"_78":79,"_84":11,"_85":86,"_90":28,"_91":92},"categories",[37,42,45],{"_38":39,"_40":41},"name","Integration & delivery","slug","integration-and-delivery",{"_38":43,"_40":44},"Developer tools","developer-tools",{"_38":46,"_40":47},"Monitoring & observability","monitoring-and-observability","content_types",[50],"image","date_registered","2018-11-08T12:17:12.019248Z","description","GITB messaging service to integrate GITB TDL test cases with a Domibus AS4 (eDelivery) gateway.","is_private","last_updated","2026-09-14T13:19:30.41153Z","last_modified","2025-03-04T14:12:00.746648Z","media_types",[62],"application/vnd.oci.image.index.v1+json","pull_count",4599,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","![Banner](https://www.itb.ec.europa.eu/files/banners/gitb_banner.png)\n\n# Introduction\n\nA web application implementing the [GITB messaging service API](https://www.itb.ec.europa.eu/docs/services/latest/messaging/index.html) to allow [GITB TDL test cases](https://www.itb.ec.europa.eu/docs/tdl/latest/) to send and receive messages over a [Domibus AS4 gateway](https://ec.europa.eu/digital-building-blocks/wikis/display/DIGITAL/Domibus) ([eDelivery](https://ec.europa.eu/digital-building-blocks/wikis/display/DIGITAL/eDelivery)). This service is meant to be used as the [service handler](https://www.itb.ec.europa.eu/docs/tdl/latest/introduction/index.html#introduction-concepts-messaging-handlers) for GITB TDL [messaging transactions](https://www.itb.ec.europa.eu/docs/tdl/latest/constructs/index.html#btxn), to realise [send](https://www.itb.ec.europa.eu/docs/tdl/latest/constructs/index.html#send) and [receive](https://www.itb.ec.europa.eu/docs/tdl/latest/constructs/index.html#receive) steps.\n\nThis image is maintained by the **European Commission's DIGIT** and specifically the **Interoperability Test Bed**, a conformance testing service for projects involved in the delivery of cross-border public services. Find out more [here](https://joinup.ec.europa.eu/collection/interoperability-test-bed-repository/solution/interoperability-test-bed).\n\n# Capabilities\n\nThe purpose of this service is to integrate with a specific Domibus instance in order to:\n* **Send** a message using a prepared header and payload as inputs.\n* **Check** for an acknowledgement received for a given message (previously sent) based on a message identifier.\n* **Receive** a message based on an expected message identifier.\n\nIn carrying out these actions, this component expects to interact with the linked Domibus instance via its [Default WebService Plugin](https://ec.europa.eu/digital-building-blocks/wikis/display/DIGITAL/Domibus) (minimum version 4.0). In the case of messages waiting to be received (i.e. a [receive](https://www.itb.ec.europa.eu/docs/tdl/latest/constructs/index.html#receive) step in a test case), the service uses polling based on a configurable **polling rate**.\n\n# Configuration and deployment\n\nTo deploy this service the simplest approach is to use it via [Docker Compose](https://docs.docker.com/compose/). The following is a sample `docker-compose.yml` file to use for its deployment that represents the minimum configuration needed:\n\n```\nversion: '2'\n\nservices:\n asx-messaging:\n image: isaitb/asx-messaging-v4:latest\n restart: unless-stopped\n environment:\n - messaging.as4GatewayUrl=https://path.to/domibus/services/msh\n - messaging.as4Backend=https://path.to/domibus/services/backend?wsdl\n ports:\n - \"8888:8888\"\n```\n\nRegarding the configuration of the service, the key points to take into account are the following:\n* The internal port on which the service is listening on is `8888`. This needs to be mapped to your host or accessed directly if within the same Docker network.\n* The web application context used by the service is `/ms`.\n\nThe following table lists the supported configuration properties that can be used as environment variables as well as any assumed defaults:\n\n| Variable | Description | Default value |\n|---|---|---|\n| messaging.as4GatewayUrl | The complete URL for the Domibus msh service (usually at `/domibus/services/msh`). | - |\n| messaging.as4Backend | The complete URL for the WSDL of the Domibus backend SOAP API (usually at `/domibus/services/backend?wsdl`) | - |\n| messaging.as4BackendUsername | An optional username to use for authentication against the AS4 backend services. | - |\n| messaging.as4BackendPassword | An optional password to use for authentication against the AS4 backend services (mandatory if `messaging.as4BackendUsername` is provided). | - |\n| messaging.as4BackendAuthType | The type of authentication to carry out if a username and password are provided (`Basic` or `Digest`). | `Basic` |\n| messaging.backendPollingRate | The delay in milliseconds between each polling of the Domibus backend SOAP API (in case messages or acknowledgements are waiting to be received). | `10000` |\n| messaging.maxPollingThresholdPerMessage | The maximum time in milliseconds for which to continue polling for an expected message or acknowledgement. | `600000` |\n| messaging.ackSuccessStates | A comma-separated list of acknowledgement states for which an acknowledgement should be considered as a success. | `ACKNOWLEDGED` |\n| messaging.ackFailureStates | A comma-separated list of acknowledgement states for which an acknowledgement should be considered as a failure. | `SEND_FAILURE,NOT_FOUND` |\n| messaging.maxSessionTime | The maximum time in milliseconds for which a test session should be considered as alive. | `7200000` |\n| messaging.soapEndpointUrl | The (optional) publishing URL to use for the messaging service's endpoint in the produced WSDL. | `http://localhost:8888/ms/services/as4messaging` |\n\nIn addition, is it interesting to note that the service is implemented using [Spring Boot](https://spring.io/projects/spring-boot) and as such any standard [Spring Boot configuration properties](https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html) can also be similarly set via environment variables. Properties you may consider to override are relevant to `logging`, the `server.servlet.context-path` (set by default to `/ms`) and the `server.port` (set by default to `8888`).\n\nOnce your `docker-compose.yml` file has been prepared to match your environment you may start the service using `docker compose up -d`. Assuming a deployment using the default configuration on your localhost's port 8080, the service will be available at `http://localhost:8080/ms/api/as4messaging`. This means that when used in the Test Bed as a messaging handler (which requires the WSDL address), this would be provided as `http://localhost:8080/ms/api/as4messaging?wsdl`.\n\n# Use within GITB TDL test cases\n\nThe following sections explain how to use the service from GITB TDL test cases.\n\n## Send a message\n\nTo send a message use a [send](https://www.itb.ec.europa.eu/docs/tdl/latest/constructs/index.html#send) step passing the following inputs:\n* `as4.send.header`, the AS4 message XML header (of type \"string\", \"object\" or \"binary\").\n* `as4.send.payload`, the list of payloads to send (of type \"list[binary]\").\n\n```\n\n \n $headerToUse\n $payloadToInclude\n \n $header\n $payloads\n \n \n $data{as4.send.messageId}\n \n \n\n```\n\n## Check for a sent message's acknowledgement\n\nTo check for a sent message's acknowledgement use a [receive](https://www.itb.ec.europa.eu/docs/tdl/latest/constructs/index.html#receive) step passing the following inputs:\n* `as4.receive.type`, set to `ack_check`.\n* `as4.receive.messageId`, the ID of the message to check for (of type \"string\").\n\n```\n\n \n ...\n \n $header\n $payloads\n \n ...\n \n $data{as4.send.messageId}\n 'ack_check'\n \n \n $ackData{as4.send.messageId}\n $ackData{as4.message.send.reason}\n \n\n```\n\n## Receive a message\n\nTo receive a message use a [receive](https://www.itb.ec.europa.eu/docs/tdl/latest/constructs/index.html#receive) step passing the following input:\n* `as4.receive.messageId`, the ID of the message to lookup (of type \"string\").\n\n```\n\n \n \n $messageId\n \n \n $data{payload}{payload.1}{payload.content}\n \n\n```\n\n# Licence\n\nThis tool is shared using the [European Union Public Licence (EUPL) version 1.2](https://joinup.ec.europa.eu/sites/default/files/custom-page/attachment/eupl_v1.2_en.pdf).\n \n# Legal notice\n\nThe authors of this tool waive any and all liability linked to its usage. In terms of data, the tool does not harvest, collect or process in any way data nor does it maintain any state linked to its processed eDelivery messages.\n\n# Contact\n\nTo get in touch for feedback or questions please send an email to DIGIT-ITB@ec.europa.eu.","has_starred","hub_user","immutable_tags_settings",{"_80":11,"_81":82},"enabled","rules",[83],".*","is_automated","permissions",{"_87":17,"_88":11,"_89":11},"read","write","admin","user","storage_size",14941658455,"orgData","recentTags",[96],{"_97":50,"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_56":140,"_141":99,"_142":28,"_143":62,"_38":144,"_145":146,"_147":138,"_148":140,"_149":71,"_150":17},"content_type","creator",637659,"digest","sha256:fc137c55828a7ccecc87ccbbe6cd3ea554c779ffc637b397bf7ff6a7204c0a27","full_size",155198377,"id",39524215,"images",[108,125,130,136],{"_109":110,"_100":111,"_112":113,"_114":115,"_116":117,"_118":119,"_120":113,"_121":-5,"_122":123,"_68":71,"_124":-5},"architecture","amd64","sha256:c804eef20472f8b69f4a213798ffab66e25ed8cab36b2d524bd641161863d939","features","","last_pulled","2026-09-17T08:48:37.952436302Z","last_pushed","2026-09-14T12:10:36.194850048Z","os","linux","os_features","os_version","size",158462946,"variant",{"_109":126,"_100":127,"_112":113,"_114":128,"_116":129,"_118":119,"_120":113,"_121":-5,"_122":103,"_68":71,"_124":-5},"arm64","sha256:04a526b5b86727a4c8d007ec21b3fd1424db495057205a9e1a5c340f7f077b65","2026-09-15T16:10:41.241122203Z","2026-09-14T12:10:35.132997656Z",{"_109":131,"_100":132,"_112":113,"_114":133,"_116":134,"_118":131,"_120":113,"_121":-5,"_122":135,"_68":71,"_124":-5},"unknown","sha256:1acf429d41697d9e58d802d6bc6e1bd605f6688af27626ca4cedb9e27185b06c","2026-09-15T16:10:41.259818191Z","2026-09-14T12:10:35.686437922Z",1250,{"_109":131,"_100":137,"_112":113,"_114":138,"_116":139,"_118":131,"_120":113,"_121":-5,"_122":135,"_68":71,"_124":-5},"sha256:a14b13fcb6ff19cdc3e3765cac038b43daedd9a51a51f84fc64fcf4dfce8b433","2026-09-17T08:48:38.366998209Z","2026-09-14T12:10:36.768723909Z","2026-09-14T12:10:37.565221Z","last_updater","last_updater_username","media_type","latest","repository",6264392,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_33":160,"_170":171,"_156":183,"_184":11},{"_35":161,"_48":165,"_51":52,"_53":54,"_55":11,"_56":57,"_58":59,"_60":166,"_38":30,"_27":28,"_63":64,"_65":50,"_66":67,"_68":69,"_70":71,"_72":-5,"_73":67,"_74":75,"_76":11,"_77":28,"_78":167,"_84":11,"_85":169,"_90":28,"_91":92},[162,163,164],{"_38":39,"_40":41},{"_38":43,"_40":44},{"_38":46,"_40":47},[50],[62],{"_80":11,"_81":168},[83],{"_87":17,"_88":11,"_89":11},"tags",{"_172":69,"_173":-5,"_174":-5,"_175":176},"count","next","previous","results",[177],{"_97":50,"_98":99,"_100":101,"_102":103,"_104":105,"_106":178,"_56":140,"_141":99,"_142":28,"_143":62,"_38":144,"_145":146,"_147":138,"_148":140,"_149":71,"_150":17},[179,180,181,182],{"_109":110,"_100":111,"_112":113,"_114":115,"_116":117,"_118":119,"_120":113,"_121":-5,"_122":123,"_68":71,"_124":-5},{"_109":126,"_100":127,"_112":113,"_114":128,"_116":129,"_118":119,"_120":113,"_121":-5,"_122":103,"_68":71,"_124":-5},{"_109":131,"_100":132,"_112":113,"_114":133,"_116":134,"_118":131,"_120":113,"_121":-5,"_122":135,"_68":71,"_124":-5},{"_109":131,"_100":137,"_112":113,"_114":138,"_116":139,"_118":131,"_120":113,"_121":-5,"_122":135,"_68":71,"_124":-5},[],"canDeleteTags","actionData","errors"]

Digest	OS/ARCH	Compressed size
c804eef20472	linux/amd64	151.12 MB
04a526b5b867	linux/arm64	148.01 MB

isaitb/asx-messaging-v4

Tags for isaitb/asx-messaging-v4