Setup Authentication for BCPortal on Entra

This article will help you setup an Entra Application ID and Secret. This is needed for the portal in order to authenticate to Business Central.

Published 2026-03-15
Setup #entra

Step 1: Open Azure

Goto the Azure portal. You need might admin credentials of your company to configure new applications. Often this step is done by the employee or IT company who maintains the Azure environment for the customer.

Next, click on Microsoft Entra ID.

Azure Entra ID

This will open the Overview page of Microsoft Entra.


Step 2: Add an App Registration

In this overview, click on Add , App registration:

App registration

A new page will open where you can fill in the required information and register the application.


Step 3: Register an application

Fill in the required fields:

Register Application

Use a descriptive name for the application, in our case "BCPortal" because that is where the application is used for.

Choose 'single tenant only'

For the redirect URL paste this text because this is case-sensitive: https://businesscentral.dynamics.com/OAuthLanding.htm

Proceed by clicking the Register button.


Step 4: Add a secret

After registering a new page is opened with your application:

Application

Copy the Application (client) ID and store in a safe location. For security reasons we have blacked out our example.

Next, click on 'Add a certificate or secret'

New Client Secret

A small overlay appears on the right that lets you enter a description and a term for the expiration of the secret. The maximum period for this is 24 months. It is also possible to choose a specific date range. When a secret is no longer valid, BCPortal is not able anymore to integrate with your Business Central tenant.

The secret is added after clicking on the button 'Add'.

Add Secret
Secret

After adding the secret will be show in the secrets section of the page but beware: as soon as you leave this page the secret will not be shown anymore so be sure to copy the secret directly and store it into a safe place.


Step 5: Add Permissions

Click in the menu on API Permissions:

Permission Menu

Next to the menu a new page is opened, click on 'Add a permission':

Permissions

Click on Dynamics Business Central:

Business Central API Permissions

Click on Application Permissions:

Application Permissions

Check API.ReadWrite All and click the button 'Add permissions':

Request API Permissions

Step 6: Grant Admin Consent

Finally, we need to grant Admin consent for these permission, click on Grant admin consent for:

Grant Admin Consent

After granting consent this should look like this:

Grant Admin Consent Finished

You can now proceed to add the Entra Application ID to Business Central