Difference between revisions of "DE4A Connector it2"

From DE4A
Jump to navigation Jump to search
Line 10: Line 10:
  
 
[[File:De4a-schema-it1.png|Conceptual schema of the target DE4A system for the first iteration|alt=|center|frame]]
 
[[File:De4a-schema-it1.png|Conceptual schema of the target DE4A system for the first iteration|alt=|center|frame]]
 +
 +
== Functionalities provided ==
 +
The main purpose of the DE4A Connector is sending and receiving of evidence requests and their responses. The message exchange process is described in the DE4A deliverables D2.4 Project Start Architecture and D5.3 Initial technical design of interfaces.
 +
 +
=== Routing information lookup ===
 +
The Connector is responsible for obtaining the Data Provider information from the IDK. It exposes a REST API <code>/lookupRoutingInformation</code> to get information about the Data Owners that provide a specific Canonical Evidence Type and further related information. That information is used to construct a request message to be sent through the Connector. Thus, the Data Evaluator is the only consumer of the mentioned API method.
 +
 +
=== Dynamic discovery of Services ===
 +
In order for the Connector to be able to send a message to the corresponding endpoint, the [[Usage of third party specifications and components|eDelivery]] dynamic discovery mode of operation is used. This operation mode is based on the use of the [[Usage of third party specifications and components|SML/DNS]] and SMP components of the eDelivery infrastructure. The main elements stored in the SML/DNS and SMPs for this purpose are the following:
 +
 +
* ''ParticipantIdentifier'': The Data Owner/Data Evaluator identifier who is publishing its [[Usage of third party specifications and components|AS4]] communication point (of the Connector linked to it).
 +
* ''DocumentTypeIdentifier'': Canonical evidence type.
 +
* ''ProcessIdentifier'': Orchestration type (request/response).
 +
* ''AS4'' endpoint: AS4 service endpoint URL.
 +
* ''Certificate'': The X.509 certificate of the AS4 server, used to encrypt the transmitted data for this specific participant.
 +
 +
The information described above is managed by the SML/DNS and SMP components and is used by the Connector when working with the phase4 implementation of AS4.

Revision as of 10:11, 10 November 2022

The DE4A Connector is a technical proxy that allows the final participants (DE or DO) to send requests for evidence or responses to other final participants over an eDelivery communication environment. In addition, to handle the message exchange process, the Connector is responsible for obtaining the message routing information, by exchanging information with external components such as the IDK, the SML/DNS or the SMP.

To do so, it provides a common interface to DEs and DOs, making the complexity of the system transparent to the final participants and integration easier.

The Connector component provides the AS4 Gateway functionality, so it can assume both the role of Data Requestor and Data Transferor. This first approach makes the Connector a stand-alone web application that can be deployed on any suitable application server.

The security and integrity of messages, as well as the unique identification of the participants involved, are the cornerstones of the Connector component.

Follow the link to the Installation and configuration guide of the DE4a Connector.

Conceptual schema of the target DE4A system for the first iteration

Functionalities provided

The main purpose of the DE4A Connector is sending and receiving of evidence requests and their responses. The message exchange process is described in the DE4A deliverables D2.4 Project Start Architecture and D5.3 Initial technical design of interfaces.

Routing information lookup

The Connector is responsible for obtaining the Data Provider information from the IDK. It exposes a REST API /lookupRoutingInformation to get information about the Data Owners that provide a specific Canonical Evidence Type and further related information. That information is used to construct a request message to be sent through the Connector. Thus, the Data Evaluator is the only consumer of the mentioned API method.

Dynamic discovery of Services

In order for the Connector to be able to send a message to the corresponding endpoint, the eDelivery dynamic discovery mode of operation is used. This operation mode is based on the use of the SML/DNS and SMP components of the eDelivery infrastructure. The main elements stored in the SML/DNS and SMPs for this purpose are the following:

  • ParticipantIdentifier: The Data Owner/Data Evaluator identifier who is publishing its AS4 communication point (of the Connector linked to it).
  • DocumentTypeIdentifier: Canonical evidence type.
  • ProcessIdentifier: Orchestration type (request/response).
  • AS4 endpoint: AS4 service endpoint URL.
  • Certificate: The X.509 certificate of the AS4 server, used to encrypt the transmitted data for this specific participant.

The information described above is managed by the SML/DNS and SMP components and is used by the Connector when working with the phase4 implementation of AS4.