Define app entitlements to map permission sets to AppSource monetization licenses
Important
This content is archived and is not being updated. For the latest documentation, go to What's new and planned for Dynamics 365 Business Central. For the latest release plans, go to Dynamics 365 and Microsoft Power Platform release plans.
| Enabled for | Public preview | General availability |
|---|---|---|
| Admins, makers, marketers, or analysts, automatically | 
Sep 1, 2022 |
Oct 1, 2022 |
Business value
In 2022 release wave 2, AppSource apps for Business Central will be able to opt in to AppSource transactability based on credit card payment and per-user licensing. To do this, publishers will need to define offers and plans in Partner Center, as well as map those offers to functionality in their apps. This is where entitlements come into play—they relate the different license types to permission sets in the apps that make up the offer. Business Central already uses entitlements in first-party apps to map functionality to Business Central licenses. This option is now also available for publishers.
Feature details
The entitlement object in Business Central describes which objects in an app a customer is entitled to use according to the license that they purchased or the role that they have in Azure Active Directory.
An entitlement consists of references to a number of PermissionSet objects put together to constitute a set of meaningful permissions for a user. An entitlement can only include permission set objects, which reference the objects that are included within the same app. This is to ensure that the entitlements included with one app cannot alter or redefine the entitlements included with another app.
Each entitlement can then be linked to a license identifier. When a user signs in, entitlements are resolved, and if a user has the license that the entitlement links to, the user will get the permissions that the entitlement defines access to.
Note that while entitlements can be defined already at the time of general availability of Business Central 2022 release wave 2, the first wave of actual AppSource transactability support will not be generally available until spring of 2023.
Tell us what you think
Help us improve Dynamics 365 Business Central by discussing ideas, providing suggestions, and giving feedback. Use the forum at https://aka.ms/bcideas.