Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article Unrecognized SSL message



User is having trouble connecting to the client's REST API.

When running the REST connector in Pega user gets following error.

The Pega instance is connecting through a VPN tunnel into the client's network. The API does not have a publicly accessible URL. Pega support has configured the host machine's hosts file to resolve the URL.

Error Messages

** Caught unhandled exception: java.lang.RuntimeException: Unrecognized SSL message, plaintext connection?

Steps to Reproduce

Run the Test connection in the connect SOAP rule or the activity which invokes the connect SOAP rule.

Root Cause

A defect or configuration issue in the operating environment.

The end point host resolution from the /etc/hosts file is not taking into effect. After updating the host machine's hosts file, the host machine was not recycled.


Perform the following local-change steps:
  1. Recycle the host operating system hosting the Pega server.
  2. Run the SOAP connect wizard to generate the new connect rule.

Published August 8, 2017 - Updated October 8, 2020

Was this useful?

0% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us