Technical Notes, Zetadocs

FIX: On selecting Save and Send on NAV 2013 a security warning is displayed.

ZTN4212

ID: ZTN4212

This Zetadocs technical note applies to:

  • Version 5.3 of Zetadocs Express

Symptom

On selecting Save and Send on a NAV 2013 system with Zetadocs Express installed a security warning is displayed at the start of every session. This security warning can be resolved by selecting Allow for this session, after which Zetadocs Express will work as expected. The steps below will allow you to stop this warning from appearing.

Cause

NAV 2013 requires SPN (Service Principal Name) and some configuration settings to be configured to allow communications with third party modules without any security warnings. By default this is not set to support Zetadocs Express on NAV 2013.

Resolution

To prevent this security warning from occurring you need to configure the NAV user settings to provide communications without generating the warning. Note that SPN must be set up on the machine beforehand.

To do this simply:

  1. Locate and open the ClientUserSettings.config file, this can be found here: C:\Users\< username> \AppData\Roaming\Microsoft\Microsoft Dynamics NAV\70
  2. Find the line < add key=" ServicePrincipalNameRequired" value=" false" /> and change false to true
  3. Next find or add the line < add key=" UnknownSpnHint" value=" (net.tcp://example.equisys.com:7046/DynamicsNAV70/Service)=NoSpn;" /> and change NoSpn to Spn.
  4. Save your changes and test the save and send feature the warning should no longer appear.

Example ClientUserSettings.config file with the required changes highlighted

< ?xml version=" 1.0" encoding=" utf-8" ?>

< configuration>

  < appSettings>

    < add key=" Server" value=" example.equisys.com" />

    < add key=" ClientServicesPort" value=" 7046" />

    < add key=" ServerInstance" value=" DynamicsNAV70" />

    < add key=" ClientServicesProtectionLevel" value=" EncryptAndSign" />

    < add key=" UrlHistory" value=" localhost:7046/DynamicsNAV70example.equisys.com:7046/DynamicsNAV70" />

    < add key=" ClientServicesCompressionThreshold" value=" 64" />

    < add key=" ClientServicesChunkSize" value=" 28" />

    < add key=" MaxNoOfXMLRecordsToSend" value=" 5000" />

    < add key=" MaxImageSize" value=" 26214400" />

    < add key=" ClientServicesCredentialType" value=" Windows" />

    < add key=" AllowNtlm" value=" true" />

    < add key=" ServicePrincipalNameRequired" value=" true" />

    < add key=" ClientServicesCertificateValidationEnabled" value=" true" />

    < add key=" DnsIdentity" value=" " />

    < add key=" UnknownSpnHint" value=" (net.tcp://example.equisys.com:7046/DynamicsNAV70/Service)=Spn;" />

  < /appSettings>

< /configuration>

Status

This has been identified by Equisys as a problem with the software versions given above.

Last updated: 25th October  2012 (MW/)