Page tree

European Commission Digital

Services

SML - v4.1 RC1

This page collects the resources for Service Metadata Locator version 4.1 RC1 , released in January 2021.


Download SML v4.1 RC1

Verify files integrity
Access source code (select 4.1 RC1 tag)

Access the eDelivery videos and eLearnings

SML Video tutorial


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 CEF eDelivery SML specification. In version 4.1.x, as in version 4.0.x the BDMSL will also provide support for the eDelivery BDXL profile, as well as the PEPPOL SML specification. As the PEPPOL SML specification continues to be supported, current users of the BDMSL software shouldn't suffer of any disruption of service. The SML managed service offered by DIGIT uses this sample implementation and therefore benefits from its features.

The SML 4.1.RC1 release includes a number of new features, improvements, and bug fixes, including:

New features:

  • Enhancement of certificate trust validation with truststore on the back-end.

  • Immediate property refresh on non-cluster environment.

  • New services for administrators for managing truststore certificates.

  • Option to update the Certificate also for so-called "non-root" certificates.

  • Configuration option to support U-NAPTR regular expression as defined in RFC 4848 '.*' and Oasis BDXL examples '$.*^'.

  • Certificate verification - Mandatory subject values CN, O, C.

  • SML Issuer-Certificate based authorization - domain owners have not option to define domain specific regular expression for subject validation when authorizing SMP clients using the Issuer-Certificate based authorization.

  • Update all dependent libraries to the latest versions.

  • Property for configuring DNS Timeout.

  • Releasing disk space after inconsistency report is generated.

  • Fix typo in admin services: regularExpression instead of reqularExpression.

  • Change certificate with itself creates a "deadlock" issue.

  • Invalid handling of certificates with space at the end of subjects RDN.

  • Deleting and creating participants if DNS timeout.


Warning:
After the BDMLS 4.1.RC1 deployment in acceptance (SMK), the new NAPTR values will contain regular expression as defined in RFC 4848 as this: '.*'.

Migration from 4.0.2 to 4.1 RC1

  1. Database migration scripts are provided in the setup bundle.

  2. Configure new properties in the BDMSL configuration table:  authorization.domain.legacy.enabled, cert.revocation.validation.crl.protocols, cert.revocation.validation.graceful, dnsClient.use.legacy.regexp, dnsClient.tcp.timeout, sml.cluster.enabled.

  3. Create new truststore with all the domain certificates including the PKI chain, deploy it in the configurationFolder and set the properties truststoreFileName and truststorePassword.


Documentation

Interface Control Document of SML (pdf)
This document covers the service interface of the CEF 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 CEF 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.




Release note

Improvements and new features

  • EDELIVERY-7600 - New services for administrators for managing truststore certificate
  • EDELIVERY-7582 - Property for configuring DNS Timeout
  • EDELIVERY-7599 - Immediate property refresh on non-cluster environment
  • EDELIVERY-7485 - Configuration option to support U-NAPTR regular expression as defined in RFC 4848 '.*' and Oasis BDXL examples '$.*^'
  • EDELIVERY-7397 - Enhancement of certificate trust validation with truststore on the back-end
  • EDELIVERY-6772 - Certificate verification - Mandatory subject values CN, O, C
  • EDELIVERY-6631 - SML Issuer-Certificate based authorization - domain owners have not option to define domain specific regular expression for subject validation when authorizing SMP clients using the Issuer-Certificate based authorization
  • EDELIVERY-6495Update all dependent libraries to the latest version
  • EDELIVERY-6464 - Option to update the also for so-called "non-root" certificate

Fixed Bug

  • EDELIVERY-7612 - Releasing disk space after inconsistency report is generate
  • EDELIVERY-7601 - Fix typo in admin services: regularExpression instead of reqularExpression
  • EDELIVERY-7583 - Deleting and creating participants if DNS timeout
  • EDELIVERY-7016 - Change certificate with itself creates a "deadlock" issue
  • EDELIVERY-6485 - Invalid handling of certificates with space at the end of subjects

Known issues and limitations

None

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