How To Create a Custom App Registration for Eagle

In this section, the specific settings for the App registration for Eagle is specified.

Note

It is optional to use a custom App Registration. Eagle provides a pre-configured App Registration that can be used out of the box.

Specific Eagle Settings for App Registration

Perform the steps below to create the Application (client) ID and secret needed to set up Eagle in Business Central.

  1. Create a new App Registration in the Microsoft Entra admin center.
  2. For the new registration:
    1. Enter a suitable name.
    2. Select account type:
      1. Eagle supports Single tenant and Multitenant.
    3. Add Redirect URI:
      1. Select platform Web.
      2. Enter https://businesscentral.dynamics.com/OAuthLanding.htm as URI.
  3. Add API permissions for the created app registration:
    1. Select the Dynamics 365 Business Central API.
      1. Select Delegated Permissions.
      2. Add permission: Financials.ReadWrite.All.
    2. Optionally select the SharePoint API.
      1. Select Delegated Permissions.
      2. Add permission: AllSites.Write.
  4. Optionally perform Grant admin consent for the added permission.
  5. Create a new secret.
Note

Copy the Application (client) ID and secret since they are needed to set up Eagle in Business Central on the Eagle Setup page.

Note

It is optional to add the SharePoint API. This is only needed if you want to export the results in Eagle to SharePoint. See more information in How To Use Queue Result Settings if you want to export the results to SharePoint.

Note

Find more information about Delegated Permissions on Microsoft Learn.

Add the App Registration to Eagle

  1. Choose the search icon in Business Central (ALT+Q), enter Eagle Setup, and then choose the related link.
  2. Activate the Use custom Azure App Registration toggle on the Azure App Registration FastTab.
  3. Paste the Application (client) ID and secret into the corresponding fields.

Information about the App Registration provided by SmartApps

The SmartApps App Registration is pre-configured with all required permissions
for Eagle. If you use this App Registration, you can skip the steps
above. When the Use custom Azure App Registration field is disabled on the Eagle Setup page, the SmartApps App Registration is used automatically.

SmartApps App Registration includes these API permissions:

  • Dynamics 365 Business Central API: Delegated permission
    • Financials.ReadWrite.All
  • SharePoint API: Delegated permission
    • AllSites.Write
Note

Delegated permissions allow the app to act as the logged-in user, but only within the user's permission. The app can only read, access information, and perform actions that the user is permitted to do.

See Also