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.

Last updated