Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Please find below information related to activities needed as part of the migration to a new version of the PEPPOL PKI Certificate.

For information about the Certificate issuing process please refer to the OpenPEPPOL public space  for /wiki/spaces/Public/pages/191496224

Background

...

The short version

The OpenPeppol eDelivery Network is migrating to a new PKI infrastructure.

  • After 2018-09-03 00:00:00 all Access Point Providers in the network MUST be able to support both the current PKI v2 certificates and the new PKI v3 certificates. Transactions can still be sent using EITHER v2 or v3 PKI certificates.
  • After 2018-11-30 23:59:59 all Access Point Providers in the network MUST only send and receive transactions using the new PKI v3 certificates.
  • The required Root and Intermediate CAs are available now for download here
  • You are encouraged to start enrolling for a PKI v3 certificate from mid-April 2018 in preparation for the September migration. The new PKI v3 certificates can be requested from PEPPOL Jira Service desk here: https://openpeppol.atlassian.net/servicedesk/customer/portal/1

Background

The migration is necessary and can not wait until the current PKI certificates expire, due to the following:

  • Improved security. The current PKI infrastructure is based on SHA-1 cryptography which not long time ago was , which was recently announced as not recommended to for use, due to discovered exploits. The new PKI infrastructure will issue be based on certificates supporting SHA-256 cryptography which currently is the recommended web standard. 
  • Responsible organization. In the current PKI infrastructure, the issuing agency organization is "DIGST" (Danish Agency for Digitisation) and it a request has been requested that made to move this responsibility is migrated to the correct organizationto the appropriate organization (OpenPEPPOL AISBL).
  • Minor improvements. Some smaller changes to the naming convention of the certificates conventions will make it easier to maintain the certificates and also to utilize a more cost effective pricing model which will not be will be based on issued certificate but on taken seat.the member level rather than on the individual certificates.

Dictionary

TermClarification

AP

Peppol Access Point
SMPService Metadata Publisher
T1Date when PKI migration starts
T2Date when PKI migration ends
C1Internal date when issuing of PKI v3 certificates will commence
C2Internal date when PKI v2 certificates can no longer be issued
Exchange transactionsAbility for a PEPPOL Access Point to both send and receive transactions
PKI v2 Certificates

The PKI certificates that are currently in use, that we are migrating from

PKI v3 CertificatesThe PKI certificates being implemented, that we are migrating to

Process implementation and timeline

Refer to the graph below;

  1. After C1 the operational office of OpenPeppol will commence issuing of PKI v3 certificates.
  2. Up until date T1;
    1. All APs MUST support current PKI infrastructure. (clarify what 'support' really means for sending/receiving)be able to exchange transactions using the PKI v2 certificates. 
    2. All SMPs MUST support current PKI infrastructurev2 certificates.
    3. SML MUST support current PKI infrastructurev2 certificates.
    4. PEPPOL Directory MUST support current PKI infrastructurev2 certificates.
  3. After date T1 and until date T2;
    1. All APs MUST be able to initiate a transaction (send) using ANY of the two available PKI infrastructurescertificates (v2 or v3).
    2. All APs MUST be able to support receiving transactions initiated using BOTH current PKI infrastructure AND the newavailable PKI certificates (v2 and v3).
    3. All SMPs MUST support BOTH current available PKI infrastructure and the newcertificates (v2 and v3).
  4. Before C1C2;
    1. All (operational before T1) AP and SMP providers will have been issued certificates from the new PKI v3 infrastructure . (Update: OpenPEPPOL internal (this is an internal OpenPeppol deadline).
  5. After date T2;
    1. All APs MUST only support new PKI infrastructureonly exchange transactions using PKI v3 certificates.
    2. All SMPs MUST only support new PKI infrastructurev3 certificates.

C1 = 2018-04-16 00:00:00

T1 = 2018-0409-03 00:00:00 (Suggestion Rune: too early)
C1

C2 = 2018-0810-15 31 23:59:59 (Suggestion Sven: 2018-09-15)

T2 = 2018-0911-30 23:59:59 (Suggestion Sven: 2018-10-30)
Image Removed

Image Added

Technical implementation

...

  1. Before T1. Prepare your implementation so that it will be able to entrust transactions/signatures using the new PKI infrastructurev3 certificates.
  2. Between T1 and T2 (and before C1). You will be issued a client certificate from the new PKI v3 infrastructure. Replace For your Peppol Access Point implementation, replace the current client certificate with the new one. Remember to update all participants in your SMP with public part of the new Any receivers (participants) you might have registered in an SMP must also be updated with the public key of the issued PKI v3 certificate.
  3. After T2. Patch your implementation so it no longer entrusts transactions/signatures using the current (then old) PKI infrastructurecertificates.

For SMP providers;

  1. Between T1 and T2. You will be issued a client certificate from the new PKI v3 infrastructure. Replace the current client certificate with the new oneYou will need to migrate the v2 SMP certificate in the SML to the v3 SMP certificate, the process for migrating the certificate has been digitalised and the official documentation of supported operations by the SML is available here. To migrate you will need to call interface UC12 - PrepareChangeCertificate.

The needed Root and Intermediate CAs are available for download here.

v2: current PKI version.

v3: new PKI version

 



Access PointSMP

PEPPOL Directory

SMLOpenPEPPOL

SendingReceivingServerClient
After



No later than T1
  • Must be able to validate MDNs signed with PKI v3.
  • MUST accept an incoming transaction signed with either PKI v2 or PKI v3.

  • Must accept responses signed with PKI v2 and v3
  • MUST accept SMP client certificates for both PKI v2 and v3.
  • MUST accept SMP client certificates for both PKI v2 and v3.
After
C1

No certificates issued for PKI v2.

??Question PH: doesn't that also mean: every participant received a new v3 certificate?
T1 only v3 certificates will be issued.
After C1





All service providers should have a v3 certificate.

No later than T2
  • MUST be able to sign transactions with PKI v3.
  • Must use PKI v3 to sign MDNs
  • MUST update AP configuration
in SMP if
  • with AP certificate PKI v3
is used
  • .
  • Provide PKI v3 SMP certificate to SML operator so they can update their entry.
  • Update all SMP entries to use a PKI v3 AP certficate
  • Must use PKI v3
  • Must use PKI v3
  • Must use PKI v3

After T2
  • Disable PKI v2 support
  • Disable support for receiving transactions signed with PKI v2.
  • Disable PKI v2 support
  • Disable PKI v2 support
  • Disable PKI v2 support
  • Disable support for SMP client PKI v2 certs.


How to act as a service provider?

...

ProviderIn PROD before T1In TEST before T1In TEST after T1Enter TEST after T1Certificate expire expires before T2Certificate expire expires after T2Recommendation
AP/SMPYES---YES
You will be prioritized in the process for being issued a NEWPKI PKI v3 certificate before T1. If you still believe you will not have time to install it can't install it before end of expiry of OLDPKI certificate PKI v2 certificates, then renew OLDPKI PKI v2 certificate and follow matching recommendation for that situationscenario.
AP/SMPYES---
YESBefore C1 you will have been issued a NEWPKI PKI v3 certificate. Make sure to implement this certificate into your platform before T2.
AP/SMP-YES

--If you complete your tests and become eligible for a PROD certificate before T1. You will be prioritized in the process for being issued a NEWPKI PKI v3 PROD certificate before T1.
AP/SMP-
YES
--If you complete your tests and become eligible for a PROD certificate before T2, you will be issued a NEWPKI PKI v3 PROD certificate. If you fail to complete your tests before T2, you will have to reapply for a NEWPKI PKI v3 TEST certificate.
AP/SMP-

YES--You will use NEWPKI a PKI v3 TEST certificate for your testing .You will be issued a NEWPKI PKI v3 PROD certificate when you complete tests and become eligible for a PROD certificate.

* NEWPKI - Refers to the new PKI infrastructure that will become mandatory after T2.

* OLDPKI - Refers to the current PKI infrastructure we are about to obsolete.