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:
- Download JCIFS library (jar file, version 1.3.17 or later) from http://jcifs.samba.org/.
- 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.
- Restart the server.
Create dynamic system setting
Follow these steps to create dynamic system setting EnableJCIFSEngine:
- In Application Explorer, right-click your application and select New > SysAdmin > Dynamic System Settings.
- In the Dynamic System Settings: New rule form, enter Pega-IntegrationEngine in the Owning Ruleset field.
- In the Setting Purpose field, enter
- Click Create and open.
- On the Settings tab, in the Value field, enter
trueand save the rule.
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.