Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

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.

Setting up connectors for NTLMv2 using the JCIFS library

Updated on August 30, 2019

If your application requires resources from an application using NTLM v2 authentication, you can use the JCIFS library to enable the Pega 7 Platform SOAP and HTTP connectors to access the resources.

By default, the Pega 7 Platform uses an Apache library to enable the connectors for NTLM v2, but you can alternatively use the open-source JCIFS library. The process involves two steps:

  • Download the JCIFS library and store it in your application server’s /lib directory
  • In Designer Studio, create a dynamic system setting to enable the new library’s use

Download the JCIFS library

Follow these steps to download the JCIFS library and put it in your runtime classpath:

  1. Download JCIFS library (jar file, version 1.3.17 or later) from
  2. Copy the .jar file to the appropriate location on the application server for the runtime classpath. (For example, on a Tomcat system, the /lib folder.) Ensure the file is on the production application server and specified on the server’s classpath.
  3. Restart the server.

Create dynamic system setting

Follow these steps to create dynamic system setting EnableJCIFSEngine:

  1. In Application Explorer, right-click your application and select New > SysAdmin > Dynamic System Settings.
  2. In the Dynamic System Settings: New rule form, enter Pega-IntegrationEngine in the Owning Ruleset field.
  3. In the Setting Purpose field, enter EnableJCIFSEngine.

The Create Dynamic System Settings dialog

  1. Click Create and open.
  2. On the Settings tab, in the Value field, enter trueand save the rule.
If the library is not in runtime classpath and the dynamic system setting is set to true, an exception occurs and displays the following message:The JCIFS library may not be in runtime classpath. Disable dynamic system setting Pega-IntegrationEngine/EnableJCIFSEngine by setting to false to fall back to default NTLMEngine.

Have a question? Get answers now.

Visit the Support 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. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us