Skip to main content

Expose Web Service using SSL in Business Central On-Premise


I had a requirement where the Web Services / APIs in NAV and Business Central On-premise needed to be exposed outside the VM to be consumed by third-party applications.
Also, this blog is a continuation of my previous blogs on NAVUserPassword and Single Sign On(SSO) 
In this blog, let us see how to expose the Webservice / API URLs outside the server and consume them.


  • Microsoft Dynamics Business Central On-premise
  • Static IP assigned to the Server
  • DNS configured with SSL or Self-signed certificate.


1. Changes to Business Central On-Premise / NAV Administration Console: Inside the Administration Console, you need to make sure that either you Business Central already has a way to be authenticated with the DNS link that you have provided. You can refer to my blogs  NAVUserPassword and Single Sign On(SSO) for this

After that make sure you enable SSL and change the Base URL to '<https://YourDomain:Port/ServerInstance>'. Also, make sure to allow the Inbound and Outbound from the Firewall settings as well.

Changes to Administration Console

2. Changes to Base URL in Web Services:
After you have restarted the Server Instance and login to Business Central and navigate to Web Services, you will notice that there is a change to the URL inside the ODATA and SOAP URLs.

Change to Base URL in ODATA and SOAP URLs

3. Calling the Web Service through the browser inside the server:
Simply creating a GET request and providing the credentials, you will also be able to call the ODATA URL and exchange data from inside the server.

Calling the ODATA URL from inside the Server / VM

4. Calling the Web Service through the browser outside the server:
Similarly, a final test to confirm that these URLs are accessible outside the VMs as well.
Calling the ODATA URL from outside browsers


I deliberately have written this blog because, whenever there are any issues configuring such requirements the most common solution available are done is using costly integration solutions because they have an On-Premise Agent which helps in seamless integration.
I want to make these web services / APIs accessible anywhere over the internet and can be integrated using a custom solution or apps.

I hope this blog helps in documenting the steps for such a process as well.

Thanks for reading.


Popular posts from this blog

Understanding and How to use APIs Business Central - 2

In my last blog post (Business Central API -1 ) on Creating API in Business Central, we discussed all the commonly used properties of the page, query, and controls like field and data-item. In today's blog, we will be diving deeply into the validation of the data passed through the API endpoint, how it enters into the source tables and is manipulated to be inserted/modified into single or multiple tables.
Also, I will be demonstrating how APIs are to be used.

Microsoft Dynamics Business Central (SaaS)VS Code( Language Extension( V1 from Business Central On-Premise DVD
Books & References:
API V1 from Business Central On-Premise DVDAPI(V1.0) for Business Central (Click Here)API(Beta) for Business Central (Click Here)
Understanding API in Business Central 1. BINDSUBSCRIPTIONS: Use to trigger IntegrationEvent for the Codeunit stated in parameters whenever the function calling BI…

Creating APIs in Business Central - 1

While writing a blog on Automated Testing in Business Central, I was going through sample apps provided by Microsoft and realized that the complexity is nowhere close to what examples Microsoft has provided on In this blog, I will try to explain how APIs work and how to be creative with the implementation. Also, an API which were in beta are finally out with version V1.0 in the April 2019 release let's see some important key things from development aspects.
This blog is going to be theoretical one kindly bear with me.

Microsoft Dynamics Business Central (SaaS)VS Code( Language Extension( V1 from Business Central On-Premise DVD
Books & References:
API V1 from Business Central On-Premise DVDAPI(V1.0) for Business Central (Click Here)API(Beta) for Business Central (Click Here)

Key Requirements:
API source table must have an Id(GUID) field per record for m…

Enum Object in Business Central - How to create and how to extend!

Since the dawn of Business Central Era (2nd April 2018 - Today), there are many new data types introduced by Microsoft.
One such data type is Enum(Enumeration). Essentially, what enumeration is having a single select value with multiple options at a given time!
Well, I know what your thinking what about the 'Option' data type.
Anyways, enough of talking let's just dive in!

Disclaimer:The knowledge in this blog is true and complete to the best of authors and publishers knowledge. The author and publisher disclaim any liability in connection with the use of this information.
Microsoft Dynamics Business Central (SaaS or On-Premise)
VS code with AL Language extension

1. Enum as an Object:
Just like Tables and Pages, Enum behaves like an Object.
Note that Extensible means that the Enum Object can be extended in another module. By default, this property is set to TRUE.

Enums and Enum Extensions behave differently. They follow a different number se…