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

Rule Connect SOAP invocations do not work with TLSv1.2



Rule Connect SOAP invocations do not work with Transport Layer Security (TLS) v1.2.

Error Messages

Caused by: Received fatal alert: handshake_failure

Steps to Reproduce

Invoke the flow by invoking the Rule-Connect-SOAP rules.

Root Cause

A defect or configuration issue in the operating environment. Legacy setup of SOAP Connectors was used and the trustStore setup via the Keystore rule was not present. The underlying JDK 1.7 defaults to a TLSv1 SSLContext and SSLContextFactory during the runtime.


Perform the following local-change: 
  1. Add the below Java source to Step7 of the InvokeAxis2 activity rule
    try {
      trustManagerFactory =;
     [] tm = trustManagerFactory.getTrustManagers();
               ctx.init(null, tm, null);
               javaFactory = ctx.getSocketFactory();
        } catch (Exception e)
         throw new ConnectorException("SSL configuration: unable to instantiate JSSE socket factory with current inputs", e);

  2. Save the Java source to the application ruleset


Published May 10, 2019 - 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