Setting up a Validation Authority Peer Publisher

ENTERPRISE This is an EJBCA Enterprise feature.

The following covers how to set up a Validation Authority (VA) Peer Publisher. A VA Peer Publisher publishes revocation information from the CA to a VA using the Peers protocol.

For more information about the Validation Authority (VA) Peer Publisher, see Validation Authority Peer Publisher and for general information on publishers, see Publishers Overview.

    Prerequisites

    The following instructions assume that the following is already in place:

    Step 1 - Create the Publisher

    To add a publisher:

    1. On the CA instance, click Publishers under CA Functions to open the Manage Publishers page.

      images/download/attachments/108529898/Screenshot_2020-12-17_at_14.21.55.png
    2. In the Add Publisher field, enter a publisher name, and click Add.

    This will create a new publisher, defaulting to an LDAP Publisher.

    Step 2 - Configure the Publisher

    To configure the publisher:

    1. From the List of Publishers, select the newly created publisher and click Edit Publisher.

    2. On the Edit Publisher page Publisher Type field, select Validation Authority Peer Publisher.
      images/download/attachments/108529898/Screenshot_2020-12-17_at_14.41.27.png

    3. For general publishing operations, you can use the default values. However, ensure that the correct Outgoing Peer Connection has been selected as Peer System.

      images/download/attachments/108529898/Screenshot_2020-12-17_at_14.43.52.png
    4. Click Save and Test Connection to perform input validation.

    Step 3 - Configure the Issuing CA

    Once the publisher is saved and tested, update the configuration of the issuing CA:

    1. Click Certification Authorities under CA Functions.

    2. Click Edit on any CAs that you wish to publish from.

    3. Under CRL Specific Data, in the Publishers field, select the created publisher.

      images/download/attachments/108529898/Screenshot_2020-12-17_at_15.38.32.png

    Step 4 - Configure the VA to accept Publishing

    On the VA side, it needs to be configured to accept the connection from the CA and allow it to write certificates and CRLs to its database.

    Enable Incoming Connections on the VA node

    On the VA node, click Peer Systems under System Functions and click Allow Incoming Connections.

    images/download/attachments/108529898/Screenshot_2020-12-17_at_15.41.14.png

    Contact the VA node from the CA

    1. On the CA node, click Peer Systems under System Functions and you should see the outgoing peer enabled and active as configured above.

      images/download/attachments/108529898/Screenshot_2020-12-17_at_15.41.26.png
    2. Next, to contact the VA to let it know that there's an incoming connection request, click Ping for the outgoing Peer.

    3. This will result in the following expected error message, which means that the CA can contact the VA and is authenticated through the Authentication Key Binding, but is not authorized to perform any operations.

    images/download/attachments/108529898/Screenshot_2020-12-17_at_15.41.02.png

    Authorize the Incoming Connection on the VA

    Going back to the Peer Systems page on the VA (System Functions>Peer Systems), there is now an incoming connection request waiting:

    images/download/attachments/108529898/Screenshot_2020-12-17_at_15.41.34.png

    Since EJBCA requires authentication for even internal processes between nodes (in order to strengthen domain security and allow multi tenancy), there needs to be a Role created that matches the certificate defined in the CA's Authentication Key Binding. To create a role:

    1. Click Create Role on the incoming connection.

    2. Next, either select an existing role or create a new one:

      • If you already have a role prepared with the required authorizations then feel free to pick it, and the TLS certificate in the Authentication Key Binding will be added to that role. I

      • To create a new role, pick Create new role and click Select.
        images/download/attachments/108529898/Screenshot_2020-12-17_at_15.41.43.png

    3. Name the role and ensure that it's allowed to publish and renew its certificate.

      images/download/attachments/108529898/Screenshot_2020-12-17_at_15.49.11.png
    4. Click Create new role and your role will be automatically generated with the required access rules enabled.

    5. Returning to the Peer Systems overview page, you can now see that the incoming connection is fully authorized and online.

      images/download/attachments/108529898/Screenshot_2020-12-17_at_15.49.52.png

    The VA Peer Publisher set up is now complete and any CRLs, revocations (and certificates if configured) will automatically be written to the VA after being issued on the CA.