How to connect to e-CODEX? A hands-on approach

e-CODEX Illuminated, Brussels – 25.6.2019

e-CODEX

How to connect to e-CODEX? A hands-on approach

e-CODEX Illuminated, Brussels – 25.6.2019 1


Agenda

2

• e-CODEX Architecture

• 6 steps to connect e-CODEX

• e-CODEX Support

e-CODEX


Maximum Number of participants in a single e-CODEX use case

3


Expected number of e-CODEX participants by late 2019

4


e-CODEX Architecture

5






Supports a specific cross-border legal

procedure (e-CODEX use-case):

• Creates Business documents

• Sends/receives Business

documents in both XML and PDF

format plus optional attachments


• Validates signatures of pdf-

documents

• Creates, signs/validates signed

ASiC-S container and generates

Trust-Token

• Creates/forwards “ETSI REM

Evidences” on delivery status

• (Optional): maps national XML

data format to/from e-CODEX

“business document” XML

data form

•

• Establishes connection

• Sends/receives AS4/ebMS v3.0

message:

- ebMS v3.0 header

- Attachments

• (Optional): signs all or specific

parts of the message

• (Optional): encrypts/decrypts all

or specific parts of the message

C G


6 steps to connect e-CODEX

9


6 steps to connect e-CODEX

10

1. Hardware available

2. Gateway installed

3. e-CODEX Connector installed

4. Configuration data (pModes) created

5. Tests completed

6. Business application integrated

6 steps


Hardware/Technichal Infrastructure available

6 steps

Domibus Gateway

• Application Server (z.B. Tomcat, Weblogic, Wildfly)

• Connection to separate DB (e.g. MySQL, ORACLE)

• Internet connection

e-CODEX Connector

• Application Server (Servlet environment)

• Connection to separate DB

• Internet connection

Business Application

• Application Server

• Connection to separate DB

Virtual (or physical) server of your choice to install these components in your regular IT environment. These JAVA-applications should run on your preferred platform.


Gateway installed

12

• Recommendation: Domibus Gateway

• Domibus Gateway is maintainted by CEF as the “e-Delivery

Building Block”

• https://ec.europa.eu/cefdigital/wiki/display/CEFDIGITAL/Domibus

6 steps

https://ec.europa.eu/cefdigital/wiki/display/CEFDIGITAL/Domibus




Gateway versions since 3.0

6 steps

3.0-FINAL

9/2015

e-Codex

3.0.1-FINAL

3/2016

e-Codex

3.0.2-FINAL

3/2016

e-Codex

v3.1 FR

5/2016

CEF

v3.2 FR

10/2016

CEF

v3.2.5 MR

6/2017

CEF

3.3

10/2017

CEF

Current Civil

v3.3.1

12/201

7

CEF

v4.0 FR

09/2018

CEF

Current Criminal

v4.0.2

02/201

9

CEF

Current v4.1

07/2019

CEF

Planned v4.2

12/2020

CEF


e-CODEX Connector installed

14

• Connector is maintained and developed by Me-CODEX II & EXEC

• Hand-over to an EU-institution is planned

6 steps


Connector versions since 3.0

15

6 steps

3.0-RELEASE

10/2015

e-Codex

3.1-RELEAS

E

11/2015

e-Codex

3.2-

RELEASE

7/2016

Me-Codex

3.2.1-RELEASE

7/2016

Me-Codex

3.2.2

2/2017

Me-Codex

3.5-

RELEASE

5/2017

Me-Codex

Web-Connector

4.0-RELEASE 3/2018

Me-Codex

Current Civil

3.5.1-RELEASE

12/2017

Me-Codex

Current Criminal

4.1-RELEASE 9/2018 EXEC

Planned 4.2

2019 EXEC


Configuration data (pModes) created

6 steps

Connection Parameters

Services (Legal Procedures)

Public Keys

Partners Actions Security Levels


Tests completed

17

• CTP – Central Testing Platform

• Sends and receives messages

• Creates Delivery Evidences

• Step 1: Connectivity-Tests with CTP

• Step 2: Use Case Tests with CTP

• Step 3: Partner-to-Partner Tests with e-CODEX participants

6 steps


Dashboard

• See CTP & Consortium

status

• Navigate to:

• Messages

• Log Viewer

• Material

• Help

• About


Messages Module • Heart of the CTP

• Messages that are

either sent to or from

your gateway

• Grouped by

ConversationID in

collapsible panels

• Click on info button

for details on each

message


Message Details


Business application integrated

21

• Integration into central application

• Reference Implementation for EIO

• e-Justice Portal

• iSupport

• Integration into national solutions

• EPO-Client

• National Case Management System

6 steps


e-CODEX Support

22


Maintenance & Sustainability

e-CODEX Support

Component Origin Current Maintenance

Future Maintenance (planned)

Domibus Gateway e-CODEX CEF e-Delivery eu-LISA

Domibus Connector e-CODEX EXEC & Me-CODEX II eu-LISA

Judicial semantic assets: - Process Models - XML data structures

e-CODEX Me-CODEX II eu-LISA

National Application Member State Member State Member State

e-Evidence Reference Implementation

European Commission

Candidate for eu-LISA

e-CODEX Illuminated, Brussels – 25.6.2019 24

Domibus Gateway – Document and Support by CEF • CEF Website for Domibus:


• CEF Domibus Releases: https://ec.europa.eu/cefdigital/wiki/display/CEFDIGITAL/Domibus+releases

• CEF e-Delivery Support: [email protected]

• Supported Versions:

• For each new version the support for an old version ends

• Support for each version for approx. 1 year

e-CODEX Support




https://ec.europa.eu/cefdigital/wiki/display/CEFDIGITAL/Domibus+releases



mailto:[email protected]






e-CODEX Connector - Resources

25

• e-CODEX Starter Kit

• Content

• e-CODEX StarterKit Documentation

• domibusConnector: Software and Documentation

• domibusWebAdmin: Software und Documentation

• EPO Schemas

• Available at

• BSCW-Server (www.jol.nrw.de – Access on demand)

• e-CODEX Workshops

• 1-2 days

• Guided e-CODEX Demo-Installation

• Comprehensive Documentation

e-CODEX Support

http://www.jol.nrw.de/


e-CODEX Support

26

• e-CODEX Website: www.e-codex.eu

• Domibus Gateway Support: [email protected]

• Connector Support: [email protected]

• e-CODEX Contact: www.e-codex.eu/contact

e-CODEX Support


Thank you!


Backup Slides

28


Configuration distribution

Available Support within Me-CODEX

Common closed

repository (Nexus)

p-Modes

Trust Stores

All participants

Connection Parameters

Public Keys

Participant

Generate p-Mode files and trust

stores (with DE-NRW tool)

BSCW- Server

Services (Legal Procedures)

• Partners • Services (Legal

Procedures) • Actions (Forms) • Security Levels

• Public Keys of all participants


Product Costs

30

• Open Source: European Union Public Licence (EUPL v1.2)

• No license fees

How much does e-CODEX cost?


Installation Costs

31

How much does e-CODEX cost?

Member State CEF & Me-CODEX Effort

Clear description of CEF eDelivery and e-CODEX use case specification

Clear description of the national technical infrastructure and information management policy

Identification of dedicated servers, ports and lines for e-CODEX traffic

1 week preparation for at least 2-4 national representatives on e-CODEX documentation

2-4 persons 1 week

Preparation for e-CODEX team on a MS national technical infrastructure and information management policy

2 persons 1 week

Workshop for MS technical team and e-CODEX team to exchange views and make planning 2-4 persons 2 days

Member State CEF & Me-CODEX Effort

Workshop for MS experts on 1st legal procedure on e-CODEX and e-CODEX experts on process and data modelling 4-6 persons 2 days

e-CODEX and MS technical team to set up and test e-CODEX gateway in Member State 1 week

Adjustment MS back end solution to be specified

Experts to configure and test MS e-CODEX connectors in Member States 1 week

Preparation Go LIVE 1 day

Testing 1 week

Go LIVE 1 day

Pe

r Infrastru

cture

p

er U

se C

ase

40

-70

pe

rson

days

Documents

How to connect to e-CODEX? A hands-on approach