Digital

Page tree

Skip to main content


Products

 On this page:


SML 4.2.RC1


This page collects the resources for Service Metadata Locator (SML) version 4.2 RC1, released in September 2022.

Download SML v4.2.RC1

Verify files integrity
Access source code (select tag 4.2.RC1)

Description

The Directorate-General for Informatics (DIGIT) is happy to announce the upgrade of the BDMSL, the sample implementation of the SML software in order to fully support the eDelivery SML specification. BDMSL version 4.2.x continues to provide support for the eDelivery BDXL profile and the PEPPOL SML specification.

BDMSL 4.2 RC1 includes the following new features and fixed bugs:

  • X.509 certificate policy validation: the BDMSL can now restrict the valid certificates also based on the certificate policy ID

  • A new report for detecting SMP instances with expired certificates

  • A new web service for checking if a participant identifier is already registered by the SMP

  • Support for the creation of the participant identifiers without scheme

  • Support for configuring the regular expression that splits the "URN identifiers" into the scheme and id parts. This new option introduces the possibility to use custom URN identifier schemes.

  • Support for quick start-up using Spring Boot: this option is intended only for demonstration and testing purposes

  • Support for limiting the maximum number of participants that can be registered per domain and per SMP instance

  • Update all dependent libraries to the latest versions

BDMSL 4.2 RC1 is backward compatible with version 4.1.1.


Supported platforms:

  • Application servers:
    • WebLogic 12.2.1.4
    • Apache Tomcat 9.0
  • Databases:
    • MySQL 8 (tested version, future versions might work)
    • Oracle 11 XE and Oracle 19c
  • Jva 8 for compile, tested to run correctly with:
    • Oracle JDK 8 for WebLogic 12.2.1.4.
    • OpenJDK 8 and OpenJDK 11 for Tomcat 9.

Documentation

Interface Control Document of SML (pdf)
This document covers the service interface of the eDelivery SML sample implementation. It includes information regarding the description of the services available, the list of use cases, the information model and the sequence of message exchanges for the services provided.
SML Software Architecture Document (pdf)
This document is the Software Architecture document of the eDelivery SML sample implementation. It intends to provide detailed information about the project: an overview of the solution, the different layers, the principles governing its software architecture.
Quick start guide (pdf)
This document provides a brief description of the installation of the SML sample implementation component on a Tomcat/MySQL environment.
Service Offering Document (pdf)
This document described the services offered by the SML.
Licence (pdf)
European Union Public Licence.

Migration from BDMSL 4.1.1 to BDMSL 4.2.RC1

In order to upgrade to BDMSL 4.2.RC1, please follow the steps:

  • Database migration scripts are provided in setup bundle
  • Configure new properties to BDMSL configuration table:  authentication.sslclientcert.enabled, report.expiredSMPCertificates.cron, report.expiredSMPCertificates.recipientEmail, report.expiredSMPCertificates.senderEmail, report.expiredSMPCertificates.serverInstance,partyIdentifier.splitPattern
  • Update columns in database table bdmsl_subdomain :   domain_max_participant_count,smp_max_participant_count and  smp_ia_cert_policy_oids
  • Deploy the new WAR file

Release notes

Please find below the list of new features, improvements, solved bugs and known limitations.

Improvements

  • [EDELIVERY-7098] - New report for detecting the SMP instances with expired certificates
  • [EDELIVERY-7913] - Add limitation of the participants for the domain and for the SMP instance
  • [EDELIVERY-8762] - Update all dependent libraries to the latest versions
  • [EDELIVERY-9003] - New web service for checking if the SMP already registered the participant identifier
  • [EDELIVERY-9012] - Enhancement of the certificate trust validation using the certificate policy validation
  • [EDELIVERY-9301] - BDMSL allows to enable creation of the participant identifiers without scheme
  • [EDELIVERY-9499] - BDMSL enables to configure the regular expression for splitting the "urn identifiers" to scheme and id part
  • [EDELIVERY-9615] - Add support for Tomcat 9 and MySQL 8 and drop support for Tomcat 8 and MySQL 5.7
  • [EDELIVERY-9617] - Add option to startup BDMSL with the spring-boot for demonstration and testing purposes

Fixed bugs

  • [EDELIVERY-7790] - Fix the "graceful validation" of the Certificate validity against the revocation list
  • [EDELIVERY-9270] - Fix the double registration issue when participant identifier can be registered twice for the domain
  • [EDELIVERY-9745] - Add missing configuration option to enable/disable SSLClientCert header
  • [EDELIVERY-9617] - Document how to configure the truststore for retrieving the CRL files over the HTTPS

For more information, please contact us via our portal or by e-mail: EC-EDELIVERY-SUPPORT@ec.europa.eu.