Equisys technical notes

Technical guidance, explanations and fixes for our products

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

Print

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/)

EquisysLogo

Recent news

It’s that time of year again. Directions EMEA is right around the corner. This year, it takes place at the Austria Center in Vienna, between 9-11 October. Traditionally, Directions NA would take ...

We are delighted to announce that the Zetadocs Delivery and Zetadocs Capture Extension for Business Central is now available on AppSource, the app store for Business Central. This is an ...