Tuesday, January 12, 2016

Quick Configuration of ClientUserSettings.config file for Microsoft Dynamics NAV 2013 R2

client user settings config file icon logo

Are you facing problem while configuring ClientUserSettings.config file? If Yes, then don't worry, sit back and relax as I am going to guide you through very easy steps of the configuration of the file. The file has been by default created in the folder

C:\ProgramData\Microsoft\Microsoft Dynamics NAV\71 

while the installation of Client in the system. The first time when a user opens the Microsoft Dynamics NAV Windows client, a copy of ClientUserSettings.config file is created in the folder 

C:\Users\<username>\AppData\Roaming\Microsoft\Microsoft Dynamics NAV\71 

where the <username> is the name of Windows User. By default, the folders and files are hidden. You have to unhide the folder from the folder options and have to select Show all hidden folders and files.

Before getting into the Configuration of ClientUserSettings.config file, let us first understand the ClientUserSettings.config file in Detail to help build better understanding of what this file does.

Configuration of ClientUserSettings.config file to open RTC using NavUserPassword

The fields that you have to take care while configuring the file are:

  • Server
  • Client Services Port
  • Server Instance
  • URL History
  • Client Services Credential Type
  • Services Certificate Validation Enabled
  • Dns Identity

I have also added a screenshot after the points below to give you a better understanding. So let's talk about each field one by one. Let's start with the first one:
  • Server: In this field, the name of your server which is running the Microsoft Dynamics NAV Server and you want to access is to be mentioned here.
  • Client Services Port: In this field, you have to mention the listening TCP Port for the Microsoft Dynamics NAV Server Instance that you want to connect.
  • Server Instance: In this field, you have to mention the name of the Server Instance that you want to connect to.
  • URL History: It is a comma-delimited list of Dynamics NAV Server connections. The value must contain a Computer name, the Client Port number and the Name of the Server instance. You can write it in the format below:
"Computer Name:Client Port Number/Server Instance Name"
  • Client Services Credential Type: This is the field where you mention method of Authentication while connecting to the Dynamics NAV Server. Here you will put the value as "NavUserPassword" to open the RTC with the NavUserPassword Authentication type. 
  • Services Certificate Validation Enabled: It field which you can either put True or False based on whether you want to enforce validation of the certificate or not.
  • Dns Identity: In this field, you have to mention the name of the Service Certificate you have created.

Check the above fields in the screenshot accordingly:

Configuring ClientUserSettings config file to open RTC using NavUserPassword

    Watch the Video to get more understanding if the process is still not clear.

    Configuration of ClientUserSettings.config file to open RTC using Windows

    To configure the ClientUserSetting.config file to open the RTC using Windows authentication, the Server, Client Services Port, Server Instance, URL History fields will all remain the same as discussed previously. The only changes will be in the 3 fields discussed below:
    • Client Services Credential Type: In this field, to open the RTC using Windows Authentication, remember to put the value as "Windows".
    • Services Certificate Validation Enabled: This boolean field will be False as we are opening the RTC using Windows Authentication so we don't need Services Certificate Validation.
    • Dns Identity: The DNS Identity field have to be left blank as we don't require Certificate in the Windows Authentication method.

    Look for the changes yourself in the screenshot below to have a clear picture in your mind:

    Configuring ClientUserSettings config file to open RTC using Windows

    I am sure that you find this post useful. Please Follow us on Social Platforms to keep getting updates like these. Subscribe to our Newsletter to get feeds on your mail. 

    Do you think you know everything about Navision? Well, if you have any doubt then read this:8 Things you may not clearly know about Dynamics Nav

    Keep reading and Have a Nice Day!

    1 comment:

    1. Hello,

      is it also possible to add the Company in this configfile?

      Thanks in advance.