Uploaded image for project: 'EJBCA'
  1. EJBCA
  2. ECA-6682

Improve and harmonize ePassport documentation


    • Type: Improvement
    • Status: Open
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: None
    • Labels:


      We are getting suport questions around ePassport and eID PKI. Currently we have some documentation, but it is a bit spread out, and there are important parts that are not documented.

      Topic that should be documented, should be separated between X.509 (ICAO) and CVC (EAC):

      • Creating a new CSCA (ICAO)
      • Renewing CSCA with name change, in EJBCA
      • Renewing CSCA without name change, in EJBCA
      • Creating link certificates when renewing in EJBCA
      • Creating link certificate when there is an old CSCA in another product, and new CSCA in EJBCA
      • Creating link certificate when there is an old CSCA in EJBCA, and new CSCA inanother product,
      • Importing CRL from an old CSCA into a new CSCA in EJBCA
      • Having the CRL entries imported appear in the new CSCA CRL (when the old CSCA has a different CA subjectDN)
      • Creating DS certificates (ICAO)
      • Creating DVs and IS certificates (CVC/EAC)
      • Using algorithms that are non-standard in Java PKCS#11 (i.e. patching java)
      • Using EC keys which must be encoded with explicit parameters in CSCAs (ICAO)


      In general it can be divided in five groups:

      1. Creating and renewing CAs
      2. Creating link certificates
      3. Handling CRLs, according to ICAO special requirements
      4. Using CAs, creating end entity certificates
      5. Algorithm management (patching java, explicit EC parameters, etc)


      For link certificates we have two tools, in the Admin GUI of EJBCA, and also using clientToolBox which has been the most commonly used tool recently.


      Having this in an easy to understand documentation will help users manage their ePassport and eID PKIs, while minimizing support.


          Issue Links



              annica.waltersson@primekey.com Annica Waltersson
              tomas Tomas Gustavsson
              1 Vote for this issue
              5 Start watching this issue