(DomiSML FAQ) General

(DomiSML FAQ) Technical

How are security and authentication handled in DomiSML?

DomiSML relies on mutual TLS for secure connections. User authentication is enforced, with roles assigned to ensure proper access control. For example, only users with the ROLE_SMP role can manage participant entries within a given SMP instance.

How does DomiSML ensure dynamic discovery of endpoints?

DomiSML uses unique URLs as identifiers for each participant. These URLs are registered in the DNS, which helps systems find the correct SMP and endpoint.

A DNS NAPTR record is created for each participant. The record's name is based on a hash of the participant's identifier and includes the SMP's URL. This allows the sender to get all the necessary details to send a document to the recipient using the right protocols and settings.

How do I renew my SMP certificate if the current one is still valid?

To renew your SMP certificate, you need to register the new certificate in DomiSML. Follow these steps:

  1. Use the DomiSML Web Service: Call the PrepareChangeCertificate operation in the BDMSLServiceInterface to schedule the certificate change on a future date.
  2. Ensure these pre-requisites are met:
    1. Your current certificate is still valid.
    2. The new certificate complies with permission rules in DomiSML.
    3. You have the new certificate file ready.
  3. Important details:
    1. If a migrationDate is provided, the new certificate must be valid from that date.
    2. If no migrationDate is provided, the Valid From date in the new certificate will be used as the migration date, and this must be a future date.

What database management systems (DBMS) does DomiSML support?

DomiSML has been tested with MySQL (version 5.x and above) and Oracle (version 11 and above).

For information on the supported databases in the current version, please refer to the DomiSML release page. If you require support for other databases, see the Support for additional databases initiative within the eDelivery community, where patches for additional database compatibility may be developed and shared.

What database does DomiSML require?

DomiSML has been tested with MySQL (version 8 and above) and Oracle (version 19c and above). Future versions may also be compatible.

For information on the supported databases in the current version, please refer to the DomiSML release page. If you require support for other databases, see the Support for additional databases initiative within the eDelivery community, where patches for additional database compatibility may be developed and shared.

What happens if there is an error while using a DomiSML service?

DomiSML handles errors through SOAP Fault messages, providing clear error details to help users understand and resolve issues quickly.

What should I do if my SMP certificate has expired?

If your SMP certificate has expired, follow these steps to update it:

  1. Notify eDelivery Support Office at EC-EDELIVERY-SUPPORT@ec.europa.eu.
  2. Provide the following details:
    • The new certificate file (.cer), zipped and attached.
    • The serial number of the new certificate.
    • The SMP ID.
    • The environment (for example, Production or Acceptance).

Example email content:

  • Attachment: Zipped new certificate file.
  • SMP ID: Test_SMP_ID.
  • Serial number: 0BF1 1660 4702 F47B F02E 0491 ED54 3C9B.
  • Environment: Acceptance.

Our Support Office will assist you with the update since the expired certificate prevents API access.

Where can I find the database JDBC drivers for DomiSML?

You can download the JDBC drivers from the official websites of the respective manufacturers:

What is DomiSML?

DomiSML (Domain Interoperability Service Metadata Locator) is a sample implementation provided by the European Commission as part of the eDelivery Building Block. It is responsible for dynamic service location, allowing a sender to discover where a receiver's information is stored. DomiSML adds, updates and deletes information about participants' Service Metadata Publisher (SMP) locations on the DNS, guiding senders to the appropriate SMP. It is based on the eDelivery BDXL profile and the PEPPOL SML Specification.

Can I use DomiSML for professional purposes?

Yes, DomiSML is an eDelivery sample implementation of the SML service. It is released under the European Union Public Licence (EUPL) version 1.2. This means it is free to use for professional purposes. The software is actively maintained, including regular security and bug fix updates.

From where can I download DomiSML?

DomiSML is freely downloadable from DomiSML.

How does DomiSML communicate with SMPs?

DomiSML connects to SMPs using a SOAP API over HTTPS. Through this API, SMPs can manage participant identifiers and update data in DomiSML's database. When data changes, DomiSML simultaneously updates the records on a dedicated DNS server.

How does DomiSML trust the SMP that requests to perform operations?

DomiSML authorises requests from the SMPs by verifying their certificates. Trust is established in one of two ways:

  1. Trusted PKI path: The certificate is validated through a trusted PKI path.
  2. Registered in truststore: The certificate is directly registered in DomiSML's truststore.

Only certificates that meet these criteria and have the appropriate trust anchor configured in DomiSML are authorised to perform operations.

What is the difference between DomiSML and DomiSMP?

DomiSMP, the eDelivery sample implementation of Service Metadata Publisher (SMP), stores and provides information about service endpoints, making it easier to discover who can exchange specific messages. DomiSML, the eDelivery sample implementation of Service Metadata Locator (SML), helps route SMP lookups to the right server so that the correct information about endpoints can be found.

What is the difference between eDelivery SMK, eDelivery SML and DomiSML?

  • eDelivery SMK: Serves as the acceptance environment for the eDelivery SML service.
  • eDelivery SML: Operates as the production environment for the eDelivery SML service.
  • DomiSML: Offers a sample implementation of the eDelivery SML service.

What is the location of the DomiSML source code?

The DomiSML source code is available in the BDMSL project git repository (BDMSL is the original name of the software).

What web services does DomiSML expose?

The Service Metadata Locator service provides four main web service interfaces.

PEPPOL-based services:

  • ManageServiceMetadataService: Manages service metadata.
  • ManageBusinessIdentifierService: Manages participant identifiers.

Note: DomiSML does not actively track changes to the PEPPOL specification.

DomiSML-specific services:

  • BDMSLService: Provides SMP utility services, including certificate updates.
  • BDMSLAdminService: Provides administrative services for DomiSML.

Which application servers does DomiSML support?

Support for application servers varies with each DomiSML version. To view the most current list of supported application servers, please visit the DomiSML release page.

Which operating system platforms does DomiSML support?

DomiSML has been successfully deployed and tested on Windows and Linux. Developed entirely in Java, DomiSML is portable to any platform that supports Oracle Java JRE/JDK versions 8 and 11. For more information on supported platforms for specific DomiSML versions, please visit its release page.

edel-soft
For full FAQ, see DomiSML FAQ.