Troubleshooting Guide for Micro CA

Sr No Error Message Description & Remediation
1 PKI initialization failure The PKCS#11 .so file path or password value may be incorrect.

If SoftHSM is used, verify that the required access permissions are available.

2 Failed to load mTLS client cert/key Verify that the mTLS client certificate and key belong to the same client certificate pair.

Verify that the client certificate has the correct EKU values.

3 Error while sending request to Azure IoT Hub This can occur when Azure IoT Hub is configured to receive updates from microCA.

Verify network connectivity and firewall configuration between the services.

4 Connection timeout while reaching AppViewX Verify that mTLS connectivity is allowed between the endpoint machine and the CC/AppViewX node.

If a load balancer is used, ensure that mTLS passthrough is enabled. A Layer 4 load balancer is recommended.