Setting Up ZetaCA

ZetaCA is deployed as Docker containers. To enable HSM integration: 

  1. Extract the ZetaCA package:

     tar xzf zetaca-v1.0.0.tar.gz && cd zetaca 
    
  2. Mount the Utimaco PKCS#11 R3 library in docker-compose.yml

    volumes: 
    /opt/utimaco/lib/libcs_pkcs11_R3.so:/usr/lib/libcs_pkcs11_R3.so:ro 
    /etc/utimaco/cs_pkcs11_R3.cfg:/etc/utimaco/cs_pkcs11_R3.cfg:ro 
    
  3. Set environment variables.

    CS_PKCS11_R3_CFG=/etc/utimaco/cs_pkcs11_R3.cfg
    
  4. Start ZetaCA:

    docker compose up -d
    

     

image-20260719-180442.png


ZetaCA administration login page

  1. Open https://<hostname>/sysadmin/ and navigate to HSM > Add HSM Configuration.

image-20260719-180816.png


ZetaCA administration dashboard

  1. Enter: Name, PKCS#11 Library (/usr/lib/libcs_pkcs11_R3.so), Slot (0), PIN (activated User PIN), Provider Config (/etc/utimaco/cs_pkcs11_R3.cfg). 

image-20260719-181209.png


ZetaCA HSM management page showing registered PKCS#11 configurations

image-20260719-182412.png


Edit Utimaco v6.4 Simulator HSM configuration.

image-20260719-182621.png


Successful HSM connectivity test