Skip to main content

How to Setup NavUserPassword with SSL for Microsoft Dynamics Business Central(NAVISION ERP)

Introduction:

In this blog, I'm attempting to setup basic authentication like NavUserPassword for Business Central On-Premise.
NavUserPassword is an authentication system, where each user have their own UserID and password which is configured inside Business Central itself.

Pre-requisites:

  • Microsoft Dynamics 365 Business Central On-Premise
  • Domain for your VM
  • Understanding of Credential Types in Business Central

Demonstration:

1. Setup DNS in Azure VM:
Go to your VM inside Azure to configure DNS.

Click on Configure
Put the URL as you need.

2.  Create a Webserver Instance for Business Central:
New-NAVWebServerInstance to create a Web Server Instance
Adding Web Server Instance with the name LS

3. Create a Self Signed Certificate or get an SSL from Domain provider:
Run the PowerShell script to create a self signed certificate
New Self-Signed Certificate
New Self-Signed Certificate created

After creation/installation of Certificate,
right-click on the Certificate > All Tasks>Manage Private Keys > Add NETWORK SERVICE and allow access to all the users and copy the certificate to Enterprise Trust, Trusted People, Trusted Publisher and Trust Devices folder.

4. Change Credential Type and Adding Thumbprint to Business Central Administration:
Change Credential Type and Add Certificate Thumbprint


5. Change the CredentialsType in navsettings.json files:
This tells Business Central Clients to change the CredentialTypes for the Client.
Goto C:\inetpub\wwwroot\<WEB SERVER INSTANCE>\navsettings.json
Change Client Service Credential in navsettings.json

6. Go to Users in Business Central, insert the Password:
Add Password to Users in Business Central
Note: Step 6 must be done prior to restarting Server Instance, which will change the protocols of communication between Client and Server.

7. Binding your Web Server Instance with SSL / Self-Signed Certificate in IIS:
IIS Bindings for with SSL / Self-Signed Certificate

Restart the Server Instance in Business Central Administration and Webserver instance in IIS. 

Output:

NAVUserPassword in WebClient
After inserting the credentials, you will get access to Business Central.
Business Central with NAVUserPasswod and accessible all over the world wide web.


Conclusion:

Thus in this blog, we saw how to setup NAVUserPassword for Microsoft Dynamics Business Central.
Importantly, we need to correctly setup SSL Certificate and how to bind with IIS.
In the next blog, I will show how to setup Single Sign-On(SSO) in Microsoft Dynamics Business Central and connect Business Central with Azure AD to login with your Office 365 credentials.

Despite all following these steps if you have issues starting Server Instance then refer to my blog HERE

Comments

  1. Hi Olister,

    How to apply certificate if we have 4-tier architecture. I completed the installation & configuration as Server1 (SQL), Server2(NST), Server3(IIS,Web) & Server4(RTC Client). All are working well with windows authentication. Now I have to change the authentication to NavUserPassword. For NavUserPassword I need to apply SSL, here I am not sure that how many SSL certificate needed and how to configure?

    See this blog describing the installation & configuration
    https://docs.microsoft.com/en-us/dynamics-nav/walkthrough--installing-the-microsoft-dynamics-nav-web-server-components-on-three-computers

    Thanks,
    Manish Sinha

    ReplyDelete
  2. Manish,

    For NavUserPassword it is not mandatory to use SSL unless you want to access your webclient over the Internet and not through local connection.
    For SSL, you need to make sure that your SSL pings to the URL that you wan to access after which your NAVUserPassword with SSL will work.

    Check if you can get NavUserPassword working without SSL in your LocalMachine.

    Thanks,
    Olister.

    ReplyDelete
  3. Hello,

    i follow thios article and has a uknown error when i will log in to NAV ... error: "An error has occurred" and I can only log out.

    Whats this error ?

    Kind regards

    ReplyDelete
  4. Same error here on a 17.2 version

    ReplyDelete

Post a Comment

Let me know your comments below. I'll try my best to answer your comment

Popular posts from this blog

Something went wrong. An Error occurred - Error Resolution

Introduction: With the installation of NAV 2018 or BC On-premise, I have observed that when creating New Server Instance and New WebServer Instance, you will get the error 'Something went wrong. An Error occurred '. I referred to the community questions below but didn't find my resolution. Hence, I decided to write this blog. Pre-requisites: Microsoft Dynamics Business Central - On-Premise / NAV 2018 Understanding of Business Central Authentication  Books & References: https://community.dynamics.com/nav/f/microsoft-dynamics-nav-forum/261301/nav-2018-web-client-an-error-has-occurred https://community.dynamics.com/business/f/dynamics-365-business-central-forum/421987/error-something-went-wrong-an-error-has-occurred-azure-ad-tenant Demonstration: 1. Creation of NAVServerInstance: In order to create NAVServerInstance, you can either add the Server Instance through Business Central Administration or Powershell command. Add Instance - Business Central Administration Add Insta...

How to resolve 'Edit in Excel' issues

  Introduction: As you know that D365 BC offers Edit in Excel functionality. But manipulating or customizing such a  standard functionality is difficult as there is not much control available. Hence, solving issues is also a difficult task. I will be resolving the issue for this specific issue, however, the debugging steps are similar. Pre- requisites : ODATA V4 Connectivity tool for Webservices Microsoft Dynamics 365 Business Central Books & References: https://community.dynamics.com/business/f/dynamics-365-business-central-forum/448226/issue-with-excel-add-in/ Demonstration: The way Edit in Excel works is that for a given page a Webservice is created adding PageID and Page Name. Hence, there are some Webservice connectivity checks in place to validate. 1. Edit in Excel Custom Action on the page: If you are adding Edit in Excel Action on the page, please ensure that you are providing appropriate PageName and Filter criteria as Webservice is using these parameters Refer Ed...

Installing LS Central - POS on local machine

Introduction: In this blog, I'm attempting to capture the LS Central - POS installation process on Local Machine. This blog has nothing to do LS Central - Server Setup for POS. LS Retail / LS Central - On Premise POS Pre- requisites : LS Central Installed on Server SSL Setup on LS Server (https://www.olisterr.tech/2020/03/how-to-setup-navuserpassword-with-ssl.html) LS - POS Installer Business Central - On Premise Installer Demonstration: Once your LS Retail / LS Central POS is setup on the main server. Just prior to Go-Live, you will actually have to install this POS on multiple systems and connect these POS to the main server with LS Retail / LS Central. 0.Preparation: Prior to actually installing Business Central On-Premise Windows Client, you need to make sure that you're able to ping the target with the correct Port number. For this I made use of PS-Ping tool.  PSPing - IP Address: Port If you're unable to PS-Ping the correct IP with Port number, simply check the Advan...