Creating Root CA

Note: Customers using the complimentary CA can click the +Create CA button to directly create subordinate CA for external CA as explained in the Section, Creating Subordinate CA from External Root CA. The complimentary root CA is considered as an external CA in this case.

The complimentary CA can be deleted and re-created as required.

To create root CA:

  1. Go to (Menu) icon > PKI+ > CA Inventory.
    The CA Inventory page appears.
  2. Click +Create CA on the top-right corner of the page.

    The Create CA page is displayed.

  3. Enter the fields as described in the table.
    Table 1. Field Description for PKIaaS Management page
    Field Description
    *CA Name Provide a friendly name for reference with no special characters except dash (-) and underscore (_).
    Description Provide a description for the CA. The maximum character limit is 500. Special characters that are not supported include ', ", ;, <, >, &, $, |, #, \, `.
    Tier This is a ready-only field. In case of standard initialization, Standard is selected; else AppViewX PKIaaS Native if it was used for PKI initialization.
    Certificate Authority Type Select Root CA.
    *Template This field appears only if Tier = AppViewX PKIaaS Native. Select a template from the dropdown list.
    *Valid for Select the number of years to CA expiry.
    Configure CA Subject DN Details
    *CA Common Name Enter the root CA subject name.
    *Organization Enter the organization name owning the CA.
    Organization Unit Enter the business unit for CA operations.
    City Enter the city name.
    State Enter the state name.
    Country Enter the country of the organization.
    Configure CA Key Size and Algorithm
    CSR Generation Select AppViewX if you are generating keys using HashiCorp Vault; else, select HSM.
    Use Existing Key Select this option if you want to use an existing key from HSM.
    *Device This field is displayed only when CSR Generation = HSM. Select a configured device from the dropdown list. This list is retrieved from the HSM configured under the platform.
    *Key Handler Name This field is displayed only when CSR Generation = HSM. You can either create the new key in HSM by providing the reference name or use an existing key handler name (alias/label name) in HSM by running the following command:
    pkcs11-tool --module /path/to/pkcs11.so --list-objects
    Click Validate button:
    • If validation is successful, then a message, Key is available in the HSM, is displayed.
    • If validation is unsuccessful, then a message, Key is not available in the HSM, is displayed.
    • If the key provided is not supported by the CA being created, then a message, The algorithm for this key is not supported for CA creation, is displayed.
    *Key Size and Algorithm Select the CA key size and algorithm from the dropdown list. By default, RSA_PKCS1_4096_SHA256 is selected.
    Note: Fields marked with red asterisk (*) symbol are mandatory.
  4. Click Save.

    A window with the summary of values entered appears.

  5. Click Proceed to trigger the approval flow.

    The newly created CA appears in the table with the approval status as Create - Approval Pending and the status as Awaiting Approval until all the necessary approvals are completed. If you want to abort the action, then click Abort.

    An email from AppViewX is sent to all the active custodians for approving the CA.

  6. Click the here hyperlink in the email to be redirected to the AppViewX login page.

    On successfully logging in, the approval request is displayed with the Approve and Reject buttons.

    Tip: You can also approve by clicking the (Notification Center) on the top right-hand-corner of the page.
  7. Enter the comments and click Approve.

    A confirmation popup window appears if you want to submit the request.

  8. Click OK. Once the approval count reaches the minimum approval as set by the quorum number, the custodian is approved.

    The approval status changes to Create - Approved and the status to In Progress until the CA is created and is enabled.

  9. Click the (Refresh) icon to see the status as Active once the CA is activated. Click Resubmit if the action fails for any reason.

    Certificates can be issued from this CA. CRLs are generated for this CA.

  10. [Optional] Click the Audit Log against the CA to view the audit log details. You can also download the audit log by clicking the Download button on the Audit Log view page. The audit log is exported in the .xls format.
    Note: Once the audit log is fully loaded, the Loading button will turn to View. Refresh the page to see the View button.
  11. [Optional] Click the Approval Status column value link to check the update on approvals.
    Note: The PKI CA thus created cannot be modified but can be viewed from the PKI+ > CA Inventory page.
    What to do next: