{"title":"Modifying Outlook add-in setup for Nested App Authentication (NAA)","url":"https://jonas-paprotka.de/docs/dev-itpro/administration/outlook-addins-setup-naa-modification/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/outlook-addins-setup-naa-modification, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/administration/outlook-addins-setup-naa-modification","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Learn how to modify your Outlook add-in setup in Business Central to support  Nested App Authentication (NAA).","date":"2025-01-30","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Modifying Outlook add-in setup for Nested App Authentication (NAA)","slug":"modifying-outlook-add-in-setup-for-nested-app-authentication-naa","at":0,"chars":4588},{"level":2,"title":"Modify the existing Outlook add-in setup","slug":"modify-the-existing-outlook-add-in-setup","at":191,"chars":3295},{"level":2,"title":"Why is this action needed?","slug":"why-is-this-action-needed","at":3486,"chars":660},{"level":2,"title":"Related information","slug":"related-information","at":4146,"chars":442}],"text":"# Modifying Outlook add-in setup for Nested App Authentication (NAA)\nStarting February 1, 2025, Microsoft Exchange Online requires all Outlook add-ins to use Nested App Authentication (NAA).\n## Modify the existing Outlook add-in setup\nComplete these steps to continue using the Business Central add-in for Outlook after February 01, 2025.\n1. Upgrade Business Central to at least version 25.3<https://support.microsoft.com/en-us/topic/released-updates-for-microsoft-dynamics-365-business-central-2024-release-wave-2-a8fc49a4-610e-4123-8bcd-a0aa5f3c9776>, 24.9<https://support.microsoft.com/en-us/topic/released-updates-for-microsoft-dynamics-365-business-central-2024-release-wave-1-0b644dfa-2eef-4f3e-9d77-bc92dbaafb65>, or 23.15<https://support.microsoft.com/en-us/topic/released-updates-for-microsoft-dynamics-365-business-central-2023-release-wave-2-7a4f98e8-66b9-4484-9bc1-66c466d8a82d> depending on your current version.\n1. Expose the API of the registered app in the Microsoft Entra ID used to authenticate users with Business Central.\n If your deployment is set up for the Outlook add-in, you already have an app registration in the Microsoft Entra admin center for authenticating Business Central users with Microsoft Entra ID. You might be using this same app registration for connecting Business Central to Outlook, or you might be using a separate app registration. This step applies to the app registration used for user authentication.\n In the app registration, expose the Business Central API with a scope requiring admin and user consent:\n 1. Sign in to Microsoft Entra admin center<https://entra.microsoft.com> and open the app registration.\n 1. Select Expose an API.\n 1. If there's no value for Application ID URI, select Add > Save. Make note of the Application ID URI for later.\n 1. On the Expose an API page, select Add a scope and configure these settings:\n  |Setting|Value|Example|\n  |-|-|-|\n  |Scope name|Specify a meaningful name for a permission scope.|BusinessCentralOnPrem.Access|\n  |Consent|Choose Admins and users.||\n  |Admin consent display name|Specify a meaningful name for admin consent.|Access Business Central as the signed-in user|\n  |Admin consent description|Specify a meaningful description.|Business Central is a business management solution that helps organizations work smarter, adapt faster, and perform better.|\n  |User consent display name|Specify a meaningful name for user consent.|Have full access to Business Central|\n  |User consent description|Specify a meaningful description.|Allow the application full access to Dynamics 365 on your behalf.|\n 1. Make a note of the scope's name on the Expose an API page and app registration's display name on the Overview page. You might need this information later.\n See Configure an application to expose a web API<https://learn.microsoft.com/entra/identity-platform/quickstart-configure-app-expose-web-apis#add-a-scope>.\n1. Create a new app registration specifically for connecting Outlook with Business Central:\n Follow the instructions in setting-up-office-add-ins-outlook-inbox#register-an-app-that-connects-outlook-and-business-central.\n1. Configure the Business Central web server instance to work with Exchange Online\n See setting-up-office-add-ins-outlook-inbox#configure-the-business-central-web-server-instance-to-work-with-exchange-online.\nLearn more details about these steps in Set up the add-ins for Outlook in Business Central on-premises<setting-up-office-add-ins-outlook-inbox>.\n## Why is this action needed?\nThe Outlook add-ins previously relied on Exchange Online tokens for authentication, which are deprecated and turned off starting in February 2025. See Nested app authentication and Outlook legacy tokens deprecation FAQ<https://learn.microsoft.com/office/dev/add-ins/outlook/faq-nested-app-auth-outlook-legacy-tokens>.\nTo continue using legacy Exchange Online tokens and delay the automatic switch to NAA, you can turn on the tokens. See Turn on legacy Exchange Online tokens<https://learn.microsoft.com/office/dev/add-ins/outlook/turn-exchange-tokens-on-off>. This change affects all add-ins and integrations in your environment.\n## Related information\nInstall minor update for version 25<../upgrade/upgrading-cumulative-update-v25>\nInstall minor update for version 24<../upgrade/upgrading-cumulative-update-v24>\nInstall minor update for version 23<../upgrade/upgrading-cumulative-update-v23>\nSet up the add-ins for Outlook in Business Central on-premises<setting-up-office-add-ins-outlook-inbox>\nUse Business Central as your Business Inbox in Outlook</work-outlook-addin>"}