Skip to main content

​
Overview

To authenticate with Microsoft Business Central, you need:
  1. Tenant ID - The unique identifier for your organization that uses Microsoft services.
  2. Enrivonment Name - The environment name to your organization.
  3. Client ID - The unique identifier that Azure assigns to your application when it’s registered.
  4. Client Secret - A unique string that enables the client application to access Microsoft Business Central.
This guide will walk you through generating and finding these credentials within Azure and Microsoft Business Central.

​
Prerequisites:

  • You must have an Azure account with an active Microsoft Business Central subscription.

​
Instructions:

​
Step 1: Finding your Tenant ID

  1. Your Tenant ID can be found in the Tenant ID field on the Overview page within your Azure account.

​
Step 2: Finding your Enrivonment Name

  1. Your Enrivonment Name can be found in the Environments tab of the Business Central administration center account.

​
Step 3: Generating your Client ID

  1. Navigate to the Azure portal home page and sign in using the credentials of an administrator.
  2. Select App registrations.
  1. Select New registration.
  1. In the Register an application section, enter a meaningful application name to display to users. Select who can use this application based on your environment and click Register.
  1. Once you have registered your application, your Client ID will be displayed in the Application (client) ID field within the Essentials.
  1. Go to Authentication, click Add a platform, and select Web.
  1. Set the redirect URI: https://businesscentral.dynamics.com/OAuthLanding.htm, then click Configure.

​
Step 4: Generating your Client Secret

  1. After registering a new app in the step above, you can now generate a client secret for that specific application. Navigate to Certificates & secrets under Manage, and click New client secret.
  2. A pop-up modal will appear, prompting you to enter your secret’s Description and Expires values. Fill these then click on Add.
  1. Once completed, your Client Secret will be generated. This value can be found in the Value field within the Client Secrets table.
  1. After generating the Client Secret, you must grant the registered application the necessary permissions for Dynamics 365 Business Central. To do this, navigate to API permissions, select Add a permission, and choose Dynamics 365 Business Central.
  1. Select Application permissions, choose the required permissions, and then click Add permissions.
  1. Grant admin consent for the selected permission by choosing it from the list and then clicking Grant admin consent for your specific tenant name.
  • After setting up the app above, we need to Configure service-to-service authentication for the Azure AD application in Business Central.
  1. Login to your Business Central client, search for Microsoft Entra Applications, open the page, and click New.
  1. In the opened screen, enter the Application (Client) ID to the Client ID field. This is the Azure AD application ID that you obtained at step 2 above.
  2. Fill in the Description field. If this application is set up by a partner, please enter sufficient partner-identifying information, so that all applications set up by this partner can be tracked in the future.
  3. Set the State to Enabled.
  4. Give a permission set or assign a user group.
  5. (Optional) - If you didn´t grant admin consent from Azure you can do it here as well by selecting Grant Consent.
Once you have your credentials:
  1. Open the form where you need to authenticate with Microsoft Business Central.
  2. Enter the Tenant ID, Enrivonment Name, Client ID and Client Secret in their designated fields.
  3. Submit the form, and you should be successfully authenticated.
You are now connected to Microsoft Business Central.