In this Article

Overview

Snaps in the Microsoft Business Central Snap Pack require an Access Token or OAuth2 account to access the resources in Azure. For the accounts to authorize successfully, ensure to create and configure an application corresponding to the account as displayed in the workflow.

...

.

Prerequisites

An Azure account with a free subscription to create the application.

Key Steps in the Workflow

Create an Application in the Azure Portal

1. Log in to the Microsoft Azure Portal.

2. Navigate to Azure services > Azure Active DirectoryMicrosoft Entra ID.

3. Navigate to Add > App registration.

4. On the Register an application page, specify the name for registering the application and click Register. Learn more about creating an application at : https://learn.microsoft.com/en-us/azure/active-directory/develop/quickstart-register-app.

Locate/Define Information Required to Create your <Snap Pack Name> OAuth2 Account

Specify the values required to create a successful <Snap Pack Name> OAuth2 account.

1. Navigate to the <Snap Pack Name> Snap of your choice and configure the <Snap Pack Name> OAuth2 Account with the following details:

   • Client ID: A Public Identifier for your app. Provide the Client ID that is auto-generated after creating the app in the <endpoint>

   • Client Secret: Secret value known only to the app and the auth server. Provide the Client Secret that is auto-generated after creating the app in the <endpoint>.

   • OAuth2 Endpoint:

   • OAuth2 Token: 
     <Insert Account image>

2. Click Authorize.
   You will be redirected to the login page of ServiceNow.

3. Log into ServiceNow and accept the permissions.
   The Access token and the Refresh Token will be generated.

4. Select the Auto-refresh token checkbox and save the account.

Define Permissions

The Microsoft Business Central Snap Pack supports the following account types:

• Business Central OAuth2 Account

• Business Central Access Token Account

The permissions for the registered application are either Delegated or Application based on the account types.

1. On the left navigation panel, navigate to Manage,andselect API permissions > Add a permission.
   

   Image Added

2. On the Request API permissions window, select Microsoft Graph > Dynamics 365 Business Central for the OAuth2 and Access Token Account.
   

   Image Added

3. Select Delegated Permissions or Application Permissions.
   

   Image Added

4. Select the permissions you require.
   

   Image Added

5. Click Add Permissions. You can view all the permissions added under Configured permissions.
   

   Image Added

6. Click Overview and select Add a Redirect URI. You will be redirected to the Platform configurations page.
   

   Image Added

   1. Under Platform configurations, click Add a platform.
      

      Image Added

   2. Select Web and specify the Redirect URI in the following format: 
      https://<control-plane-name>.snaplogic.com/api/1/rest/admin/oauth2callback/<snap-pack-name>
      where the <control-plane-name> corresponds to the domain part of your SnapLogic URL—elastic (global control plane) or emea (EMEA control plane).
      For example:
      https://elastic.snaplogic.com/api/1/rest/admin/oauth2callback/businesscentral
https://emea.snaplogic.com/api/1/rest/admin/oauth2callback/businesscentral

   3. Click Configure. A popup message indicates that the application is successfully updated.

7. On the Platform configurations page, click Save. The Redirect URIs are added to the application.
   

Configure the Business Central Application

1. Log in to the Microsoft Business Central application.

2. Search for aad in the search box.

   Image Added

3. Navigate to Azure Active Directory Application and select New.

4. Configure the following fields for the new record:

   1. In the Client ID field, specify the client ID that is generated from the registered application in the Azure Active Directory.

   2. In the Description field, specify a name for the application.
      

      Image Added

   3. Change the State to Enabled.

      Image Added

   4. In the User Permission Sets, select the ellipsis (…)and select the required Permission Set.
      

      Image Added

   5. Click Grant Consent to provide permission to access the Business Central Data.
      

      Image Added

Specify the Credentials and Validate the Snap Account

To authorize your account in the SnapLogic (R) Platform, you must have the following application credentials:

• Instance URL

• Application (client) ID

• Client secret value

1. Navigate to the Business Central Snap of your choice and configure the Business Central OAuth2 Account with the details from the registered application in the Business Central Portal.
   

   Image Added

2. Click Authorize. You are redirected to the sign-in page of the Azure Portal.

3. Sign in to Azure Portal with valid credentials to redirect to the Snap Edit account settings dialog. The Access and Refresh tokens are auto-populated and encrypted in the Account settings.

Troubleshooting

Snap Pack History

Related Content

• Getting Started with SnapLogic

• Business Central OAuth2 Account

• Business Central Access Token Account