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

Cannot connect to REST service with client certificate for auth



When connecting to a REST service using client certificate authentication method, the connection works but the response comes back with the exception.

Error Messages Failed to parse XML. Error: White spaces are required between publicId and systemId.

Steps to Reproduce

  1. Run a Connect-REST rule involving client certificate authentication method​

Root Cause

User wanted to use CLIENT-CERTIFICATE AUTHENTICATION for REST service. PRPC provides two options for securing REST SERVICE endpoints : BASIC AUTHENTICATION and CUSTOM AUTHENTICATION. There is no Out-Of-The-Box mechanism to allow CLIENT-CERTIFICATE AUTHENTICATION. User followed the PDN article ( to configure CLIENT-CERTIFICATE AUTHENTICATION. However at Pega end, user configured Use authentication, created an authentication profile and added the CLIENT-CERTIFICATE user. This not the correct configuration. User have to pass the client certificate user name in the message header. 


Perform the following local-change:
  1. Uncheck the Use authentication  check box and remove the authentication profile
  2. Update the Connect REST rule, add Request Header under Methods tab --> Post and set the client certificate username matching client certificate user name. 


Published October 7, 2016 - 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