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:

Unable to render {include} The included page could not be found.
edel-soft