View source for PKIX Path Building Failure

===Network Requests Fail with Certificate Error (PKIX Path Building Failed)===
Some customers may encounter the following error when using features in ProtocaseDesigner that make outgoing network requests: 

<code>PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException</code>

This error occurs when Java is unable to validate the SSL certificate presented by the server you're connecting to.

==== Cause ====
ProtocaseDesigner is packaged with its own embedded Java runtime (JRE). This JRE included a bundled certificate store (cacerts) that does <b>not</b> automatically include custom or system-installed certificates.

If your organization uses a <b>custom internal certificate authority (CA) OR intercepts HTTPS traffic </b> (e.g., via a proxy or firewall with SSL inspection), the Java runtime may reject the certificate because it doesn't recognize it as trusted.

====Workaround====

Until a permanent fix is available, you can resolve this issue by manually adding your organization's certificate to the Java runtime's certificate store bundled with our application.

<b>Steps to Add a Custom Certificate:</b>

1. Locate the Java <b>cacerts</b> file:

Windows:
* <code>C:\Users\<USERNAME>\AppData\Local\ProtocaseDesigner\runtime\lib\security\cacerts</code>

MacOS:
* <code>Applications\ProtocaseDesigner.app\Contents\runtime\COntents\Home\lib\security\cacerts</code>

Linux (DEB):
* <code>[AppInstallDir]/runtime/lib/security/cacerts</code>


2. Import your organization's certificate:

* In a terminal or command prompt, navigate to the directory located above and run the following command, while replacing "yourcompany-cert" and "/path/to/your/certificate.crt" with your companies certificate name and path.
* <code>keytool -import -trustcacerts -keystore cacerts -storepass changeit -noprompt -alias yourcompany-cert -file /path/to/your/certificate.crt</code>

3. Restart the application.

==== Permanent Fix (Coming Soon) ====

We hope to soon have a permanent solution that allows our application to automatically trust certificates from the system’s certificate store. This will eliminate the need for manual configuration in future versions.

==== Need Help? ====
If you're unsure how to obtain or install your organization's certificate, please contact your IT or network security team.

You may also contact our support team at designersupport@protocase.com for assistance.