Edit

Create a custom application registration for the Warehouse Management mobile app

The Warehouse Management mobile app uses a Microsoft Entra ID application registration to authenticate and connect to your Supply Chain Management environment. By default, it uses a global application that Microsoft provides and maintains, and no extra setup is required.

Important

Most deployments don't need this article. Use the global application if possible. It's easier to set up and maintain, and it supports most scenarios, including Microsoft Entra Conditional Access. When you use the global application, you don't have to provide a client ID or tenant in the app's connection settings.

You need your own app registration (and therefore a client ID) only in the following cases:

  • You connect to a Dynamics 365 Finance + Operations (on-premises) environment.
  • You connect to a cloud other than Azure Global (for example, a sovereign cloud such as Microsoft Azure operated by 21Vianet in China).
  • You have specific requirements that the global application doesn't meet.

If none of these cases apply to you, use the global application instead. For more information, see Install the Warehouse Management mobile app.

When you use a custom app registration, set "AuthCloud": "Manual" in your connection settings, and provide your client ID in "ActiveDirectoryClientAppId". Learn more in Connection settings reference.

Register the application in Microsoft Entra ID

The following procedure shows one way to register an application in Microsoft Entra ID. For detailed information and alternatives, use the links at the end of this article.

  1. In a web browser, go to https://portal.azure.com.

  2. Enter the name and password of the user who has access to the Azure subscription.

  3. Use the search field at the top of the page to find and open the Microsoft Entra ID service.

  4. Make sure that you're working with the instance of Microsoft Entra ID that's used by Supply Chain Management.

  5. On the left navigation pane, expand Manage and select App registrations.

  6. On the toolbar, select New registration to open the Register an application wizard.

  7. Enter a name for the application, select the Accounts in this organizational directory only option, and then select Register.

  8. Your new app registration opens. Make a note of the Application (client) ID value, because you need it later. This ID is referred to later in this article as the client ID.

  9. In the Manage list, select Authentication.

  10. On the Authentication page for the new app, open the Settings tab, set Allow public client flows to Enabled, and select Save.

  11. Open the Redirect URI configuration tab and select Add redirect URI.

  12. In the dialog, select Android. Then set the following fields:

    • Package name – Enter the following value (case sensitive):

      com.Microsoft.WarehouseManagement

    • Signature hash – Enter the following value:

      hpavxC1xAIAr5u39m1waWrUbsO8=

    Select Configure to save your settings and close the dialog to return to the Authentication page, which now shows your new platform configurations.

  13. On the Redirect URI configuration tab, select Add redirect URI.

  14. In the dialog, select iOS / macOS.

  15. Set the Bundle ID field to the following value:

    com.microsoft.WarehouseManagement

  16. Select Configure to save your settings. Close the dialog to return to the Authentication page, which now shows your new platform configurations.

  17. On the left navigation pane, expand Manage and select API permissions.

  18. Select Add a permission.

  19. In the Request API permissions dialog, on the Microsoft APIs tab, select the Dynamics ERP tile and then the Delegated permissions tile. Under CustomService, select the CustomService.FullAccess checkbox. Finally, select Add permissions to save your changes.

  20. Use the search field at the top of the page to find and open the Microsoft Entra ID service.

  21. On the left navigation pane, expand Manage and select Enterprise applications. Then, in the new Manage list, select All applications.

  22. In the search form, enter the name that you entered for the app earlier in this procedure. Confirm that the Application ID value for the app matches the client ID that you copied earlier. Then select the link in the Name column to open the properties for the app.

  23. On the left navigation pane, expand Manage and select Properties.

  24. Set the Assignment required? option to Yes and the Visible to users? option to No. Then select Save on the toolbar.

  25. On the left navigation pane, expand Manage and select Users and groups.

  26. On the toolbar, select Add user/group.

  27. On the Add Assignment page, select the link under the Users heading.

  28. In the Users dialog, select each user that you use to authenticate devices with Supply Chain Management.

  29. Select Select to apply your settings and close the dialog. Then select Assign to apply your settings and close the Add Assignment page.

  30. In the Security list, select Permissions.

  31. Select Grant admin consent for <your tenant>, and grant admin consent on behalf of your users. If you lack the necessary permissions, return to the Manage list, open Properties, and set the Assignment required? option to False. Each user can then provide consent individually.

More ways to register an application

For more information about how to register an application in Microsoft Entra ID, see the following resources:

  • Last updated on