Troubleshoot TLS Handshake Fail Error

Fix TLS handshake failures in Pynt. Learn how to troubleshoot and resolve issues preventing successful TLS connections during API security scans.

At a Glance: 🔒 TLS handshake failures in Pynt indicate that a secure connection to your API target couldn’t be established. This guide will help you resolve these issues for secure API scans.

---

TLS Error Messages

• TLS handshake failed because of an unauthorized certificate.

• TLS handshake failed because your target uses a self-signed certificate.

What Happened?

The SSL certificate used to identify the site is not trusted. This may be due to a self-signed certificate, an untrusted CA, or an SSL stripping mechanism.

How to Resolve?

1. Use the --insecure flag when running Pynt’s Docker container:

docker run --insecure ...

⚠️ Note: Running in insecure mode means the server’s identity cannot be verified. Use this option with caution.

---

For additional support, visit Pynt Community Support.