MuleSoft · Salesforce Connector

SALESFORCE:MUTUAL_AUTHENTICATION_FAILED

Short answer

SALESFORCE:MUTUAL_AUTHENTICATION_FAILED means mutual TLS authentication with Salesforce failed. Check the certificate and key the connector presents, using SSL debug logging to see the handshake.

VerifiedLast verified

01Error text

MuleSoft error
Error type: SALESFORCE:MUTUAL_AUTHENTICATION_FAILED

02Likely causes

  • The mutual authentication failed.

03How to fix it

  1. Check the keystore and TLS settings on the Salesforce connector configuration.
  2. Add the VM argument -M-Djavax.net.debug=ssl:handshake to see the handshake. It affects performance, so remove it afterward.
  3. Turn on verbose logging: in log4j2.xml add <AsyncLogger name="org.mule.extension.salesforce" level="DEBUG"/> inside <Loggers>. Turn it off after troubleshooting.
  4. Handle the failure with an error handler of type SALESFORCE:MUTUAL_AUTHENTICATION_FAILED.

04Official documentation

Test every fix in a non-production environment before you apply it to production. See how entries are verified.

More for MuleSoft work:Open MuleSoft jobsMuleSoft rates and salariesHire a senior MuleSoft developer

The iPaaS Brief

Subscribe to The iPaaS Brief.

The iPaaS newsletter for the people who run integrations. From iPaaS Group.

Free. You finish on theipaasbrief.com and confirm by email.