Mass deploy the mobile app with user-based authentication

Automated deployment and configuration of Warehouse Management can be more efficient than manual deployment when you manage many devices. One way to achieve this automation is to use a mobile device management (MDM) solution such as Microsoft Intune. For general information about how to use Intune to add apps, see Add apps to Microsoft Intune.

This article explains how to mass deploy the Warehouse Management mobile app with user-based authentication by using Microsoft Intune.

Prerequisites

To use an MDM solution to deploy the Warehouse Management mobile app and the related authentication certificates, you must have the following resources available:

• Warehouse Management mobile app version 4.0 or later on all mobile platforms. (If you're still running version 3.x, migrate to version 4 before proceeding.)
• A valid store account for each mobile platform that you support (Microsoft account, Google Account, and/or Apple Account)
• Microsoft Entra ID (Microsoft Entra ID Premium P2 license)
• Microsoft Endpoint Manager admin center (the Intune website)

Authentication behavior after mass deployment

After you deploy the app through MDM, the authentication experience depends on whether single sign-on (SSO) is enabled.

• With SSO (recommended for MDM) — If a worker is already signed in to another app on the device (such as Microsoft Teams, Intune Company Portal, or Outlook) by using the same Microsoft Entra ID account, the Warehouse Management mobile app reuses that authentication token. No separate sign-in is needed to connect the app. Workers might still need to sign in by using their warehouse app user account depending on your user account configuration.
• Without SSO — Workers must manually authenticate the app on each device after deployment. This requirement applies when using device code flow or username/password authentication without brokered authentication. This approach doesn't benefit from the automatic token-sharing that makes MDM most efficient.

Set up the source files for distribution

Each MDM solution offers several methods for sourcing the apps that it delivers to end devices. For example, a solution might use locally stored binary files or fetch binaries from an app store. Use app stores as the preferred method because it's simple and offers the most convenient way to receive updates.

The following subsections provide examples that show how to set up Intune to fetch apps from the different app stores.

Set up Intune to fetch the app from Google Play

Follow these steps to set up Intune to fetch the Warehouse Management mobile app from Google Play.

1. Sign in to the Microsoft Endpoint Manager admin center.
2. Go to Apps > Android.
3. On the Android apps page, on the toolbar, select Add.
4. In the Select app type dialog box, in the App type field, select Managed Google Play app. Then select Select.
5. On the Managed Google Play page, if you're setting up Google Play for the first time, you're prompted to sign in to Google Play. Sign in by using your Google account.
6. In the Search field, enter Warehouse Management. Then select Search.
7. On finding the Warehouse Management app, select Approve.
8. In the Approve settings dialog box, select an option to specify how updates should be handled when a new version of the app requests more permissions than the current version. We recommend that you select the Keep approved when app requests new permissions option. When you've finished, select Done to continue.
9. Select Sync.
10. You're returned to the Android apps page. On the toolbar, select Refresh to refresh the list of applications. Then, in the list, select Warehouse Management.
11. On the Warehouse Management page, on the Properties tab, select the Edit link next to the Assignments heading.
12. On the Edit application page, on the Assignments tab, add the user groups and devices that the Warehouse Management app should be available and required for. For information about how to use the settings, see Assign apps to groups with Microsoft Intune.
13. Select Review + save.
14. On the Review + save tab, review your settings. If they look correct, select Save to save them.

Set up Intune to fetch the app from Microsoft Store

Follow these steps to set up Intune to fetch the Warehouse Management mobile app from Microsoft Store.

1. Sign in to the Microsoft Endpoint Manager admin center.
2. Go to Apps > Windows.
3. On the toolbar, select Add.
4. In the Select app type dialog box, in the App type field, select Microsoft Store app (new). Then select Select.
5. On the Add App page, on the App information tab, select the Search the Microsoft Store app (new) link.
6. In the Search the Microsoft Store app (new) dialog box, in the Search field, enter Warehouse Management.
7. When you've found the Warehouse Management app, select it, and then select Select.
8. The App information tab now shows information about the Warehouse Management app. Select Next to continue.
9. On the Assignments tab, add the user groups and devices that the Warehouse Management app should be available and required for. For information about how to use the settings, see Assign apps to groups with Microsoft Intune.
10. Select Next to continue.
11. On the Review + save tab, review your settings. If they look correct, select Create to save them.

Set up Intune to fetch the app from the Apple App Store

Follow these steps to set up Intune to fetch the Warehouse Management mobile app from the Apple App Store.

1. Sign in to the Microsoft Endpoint Manager admin center.
2. Go to Devices > iOS/iPadOS.
3. On the iOS/iPad enrollment tab, select the Apple MDM Push certificate tile.
4. In the Configure MDM Push Certificate dialog box, follow the on-screen instructions to create and upload the required Apple MDM push certificate. For more information about this step, see Get an Apple MDM push certificate.
5. Go to Apps > iOS/iPadOS.
6. On the toolbar, select Add.
7. In the Select app type dialog box, in the App type field, select iOS store app. Then select Select.
8. On the Add App page, on the App information tab, select the Search the App Store link.
9. In the Search the App Store dialog box, in the Search field, enter Warehouse Management. Then, in the drop-down list next to the Search field, select your country or region.
10. When you've found the Warehouse Management app, select it, and then select Select.
11. The App information tab now shows information about the Warehouse Management app. Select Next to continue.
12. On the Assignments tab, add the user groups and devices that the Warehouse Management app should be available and required for. For information about how to use the settings, see Assign apps to groups with Microsoft Intune.
13. Select Next to continue.
14. On the Review + save tab, review your settings. If they look correct, select Create to save them.

Manage connection configurations

The Warehouse Management mobile app lets you import connection settings as a managed configuration through an MDM solution. The same ConnectionsJson configuration key is shared across all platforms.

The following subsections provide examples that show how to set up Intune to provide managed configuration for each of the supported mobile platforms. Learn more in App configuration policies for Microsoft Intune.

Create a connection JSON file

To set up managed configuration for all mobile platforms, create a connection JSON file as described in Create a connection settings file or QR code. This file enables the mobile app to connect to and authenticate with your Dynamics 365 Supply Chain Management environment.

Set up Intune to support managed configuration for Android devices

Follow these steps to set up Intune to support managed configuration for Android devices.

1. Sign in to the Microsoft Endpoint Manager admin center.
2. Go to Apps > App configuration policies.
3. On the App configuration policies page, on the toolbar, select Add > Managed devices.
4. On the Create app configuration policy page, on the Basics tab, set the following fields:
   • Name – Enter a name for the policy.
   • Platform – Select Android Enterprise.
   • Profile type – Select the device profile types that the app configuration profile applies to.
   • Targeted app – Select the Select app link. In the Associated app dialog box, select the Warehouse Management app in the list, and then select OK to apply the setting and close the dialog box.
5. Select Next to continue.
6. On the Settings tab, in the Permissions section, select Add.
7. In the Add permissions dialog box, select the checkboxes for Camera, External storage (read), and External storage (write). Then select OK to close the dialog box and add those permissions to the Settings tab.
8. In the Permission state field for each permission that you just added, select Auto grant.
9. In the Configuration Settings section, in the Configuration settings format field, select Use configuration designer.
10. In the Configuration Settings section, select Add.
11. In the dialog box, select the checkbox for ConnectionsJson. Then select OK to close the dialog box.
12. A new row is added to the grid in the Configuration Settings section of the Settings tab. The Configuration key field is set to ConnectionsJson. In the Value type field, select String. Then, in the Configuration value field, paste the entire contents of the JSON file that you created in the Create a connection JSON file section.
13. Select Next to continue.
14. On the Assignments tab, add the user groups and devices that the configuration policy should apply to. For information about how to use the settings, see Add app configuration policies for managed Android Enterprise devices.
15. Select Next to continue.
16. On the Review + save tab, review your settings. If they look correct, select Create to save them.

Set up Intune to support managed configuration for Windows devices

Follow these steps to set up Intune to support managed configuration for Windows devices.

1. Sign in to the Microsoft Endpoint Manager admin center.
2. Go to Devices > Windows.
3. On the Windows devices page, on the Configuration profiles tab, on the toolbar, select Create profile.
4. In the Create a profile dialog box, set the following fields:
   • Platform – Select Windows 10 and later.
   • Profile type – Select Templates.
   • Template name – Select Custom.
5. Select Create to apply your settings and close the dialog box.
6. On the Custom page, on the Basics tab, enter a name for the configuration profile, and then select Next to continue.
7. On the Configuration settings tab, select Add.
8. In the Add Row dialog box, set the following fields:

   • Name – Enter a name for the new row.

   • Description – Enter a short description for the new row.

   • OMA-URI – Enter the following value:

     ./User/Vendor/MSFT/EnterpriseModernAppManagement/AppManagement/AppStore/Microsoft.WarehouseManagement_8wekyb3d8bbwe/AppSettingPolicy/ConnectionsJson
     

   • Data type – Select String.

   • Configuration value – Paste the entire contents of the JSON file that you created in the Create a connection JSON file section.

9. Select Save to apply your settings and close the dialog box.
10. Select Next to continue.
11. On the Assignments tab, add the user groups and devices that the configuration profile should apply to.
12. Select Next to continue.
13. On the Applicability rules tab, you can limit the set of devices that the configuration profile applies to. To apply the profile to all qualifying Windows devices, leave the fields blank. For more information about how to use the settings, see Create a device profile in Microsoft Intune.
14. Select Next to continue.
15. On the Review + save tab, review your settings. If they look correct, select Create to save them.

Set up Intune to support managed configuration for iOS devices

Follow these steps to set up Intune to support managed configuration for iOS devices.

1. Sign in to the Microsoft Endpoint Manager admin center.
2. Go to Apps > App Configuration policies.
3. On the App configuration policies page, on the toolbar, select Add > Managed devices.
4. On the Create app configuration policy page, on the Basics tab, set the following fields:
   • Name – Enter a name for the app configuration profile.
   • Platform – Select iOS/iPadOS.
   • Profile type – Select the device profile types that the profile applies to.
   • Targeted app – Select the Select app link. In the Associated app dialog box, select the Warehouse Management app in the list, and then select OK to apply the setting and close the dialog box.
5. Select Next to continue.
6. On the Settings tab, in the Configuration settings format field, select Use configuration designer.
7. In the grid at the bottom of the page, set the following fields for the first row:
   • Configuration key – Enter ConnectionsJson.
   • Value type – Select String.
   • Configuration value – Paste the entire contents of the JSON file that you created in the Create a connection JSON file section.
8. Select Next to continue.
9. On the Assignments tab, add the user groups and devices that the configuration policy should apply to. For information about how to use the settings, see Add app configuration policies for managed iOS/iPadOS devices.
10. Select Next to continue.
11. On the Review + save tab, review your settings. If they look correct, select Create to save them.

Enroll devices with Intune

You must enroll each device that you want to manage by using Intune. Enrollment involves registering with Intune and applying organizational policies for security. Depending on the type of device and the platform, you can use the Company Portal app to enroll devices. The enrollment programs provide access to work or school resources.

Android and iOS devices

To enroll an Android or iOS device, install the Intune Company Portal app on the device. The local user must then sign in to the Company Portal app by using their company account.

Windows devices

Several methods are available to enroll a Windows device. For example, you can install the Intune Company Portal app on the device. For information about how to set up the Company Portal app and how to use the other options, see Enroll Windows 10/11 devices in Intune.

Related information

• Install the Warehouse Management mobile app
• User-based authentication for the Warehouse Management mobile app
• User-based authentication FAQ