The following example shows how to change the client certificate and update the trusted CA for Management Interface using WebConf.

The new superuser certificate has to be issued from the same CA (MyCustomCA) that we will install for TLS authentication. First we need to specify the information about the certificate (MyUsername.pem) to be used as superuser.

  1. Check the SubjectDN of the certificate using openssl.
    Run the following command as 'user':

    \$ openssl x509 -in MyUsername.pem -subject
    subject= /C=MyCountry/O=MyCompany/SN=MyLastName/GN=MyFirstName \
    /serialNumber=G824734/CN=MyFirstName MyLastName/UID=R4501ZHE
    -----BEGIN CERTIFICATE----- 
    -----END CERTIFICATE-----


    In the subject value, slashes (/) have to be replaced with commas (,).

  2. Open the WebConf Access tab and click on Appliance Accounts:

  3. In the section PKI Appliance Management Accounts, select clientcert, provide the following SubjectDN and click Add.

    EJBCA is using which interprets SN as serialNumber. We inherit this in org.cesecore.util.CeSecoreNameStyle (Legacy reasons).


     Replace SN with SURNAME and GN with GIVENNAME otherwise you risk being locked out.


    The clientcert will be displayed.

  4. Switch the tab and go to Client TLS trust anchors. The section Trusted CAs for TLS client authentication is divided in two columns.
    Application Interface
    Management Interface

  5. First Management Interface is edited.
    Click Add... > Browse and select the certificate chain you got from your issuing CA.

    The whole chain from the issuer CA of the client certificate up to the trusted RootCA is required.

  6. Click Activate new CA certificate to allow TLS to update the new trust of CA.

  7. Once the update is made, the new trusted configuration is used for authentication in the Management Interface.

  8. Next, the Application Interface must be edited. Please refer to Changing Client Certificate and Trusted CA for Application Interface.