Manage Retail activation accounts and validate devices
This topic applies to Dynamics 365 for Retail and Dynamics 365 for Finance and Operations.
This topic explains how an IT Pro can set up Retail activation accounts for retail workers to activate Modern POS or Cloud POS devices.
Setting up a device activation account for a single worker
This procedure should be completed before you activate Cloud POS.
In Microsoft Dynamics 365 for Retail, from the Workers page, open the Worker details page for the worker to assign AAD device activation privileges to. Click Edit.
On the Retail tab, click the POS permissions link. Make sure that the worker is in the Manager Permission group, or that Manage Devices is set to Yes for the worker.
On the Retail tab, under External identity, update the values for the following fields:
- External identifier
You can update the External identity fields by using an existing AAD account or creating a new AAD account. To update the fields, access the External identity options from the Retail main menu (Retail > Associate existing identity or Retail > Create new identity).
To use an existing AAD account, select Retail > Associate existing identity. In the slider, click the AAD account that has the correct name, and then click OK. The AAD account that is associated with that name and alias is the user's Activation account for Modern POS.
Complete and save the changes on the Workers page, and then refresh the page. The section that contains external identity information should be updated with the new information. The mapped AAD account is now your Activation account for Cloud POS and Modern POS. This account is mapped to a worker for the required POS permissions. You can use this AAD account for Modern POS or Cloud POS activation.
The Create external identity feature creates a new AAD account for you by using the alias that you enter. To update the fields, access the External identity options from the Retail main menu (Retail > Create new identity).
You can either manually enter the alias to generate or use the Reset to default button. Then manually enter a strong password, and click OK.
If the worker is created successfully, you receive a message on the Workers page. The mapped AAD account is now the user's Activation account for Cloud POS and Modern POS. This account is mapped to a worker for the required POS permissions. You can use this AAD account for Modern POS or Cloud POS activation.
Setting up device activation accounts for multiple workers
You can set up activation accounts for multiple workers in bulk. However, this functionality is supported only if you're creating new external identities, not if you're associating identities.
- In the workers form, select the list of workers to set the activation account for.
- Click Retail > Create external identity to update the fields. Any AAD accounts that are associated with the workers appear in this pane. Note: These accounts aren't device activation accounts until you map them by using the external identity flow options.
- If you want to use the existing AAD accounts as activation accounts, you can't map them in bulk. Cancel the selection of those workers, and then map them individually by using Use existing external identity.
- To create new AAD accounts and associate them with the workers, so that they can be used as activation accounts, update the Alias and Password fields, and then click OK. In the main worker form, you receive a message as activation accounts are created for each worker.
Run the Validate Devices for Activation check at headquarters
Before handing an activation account to a worker, an IT Pro must run the Validate devices check for the devices assigned to the worker. This will help identify any potential failures of device activation in advance and fix it before it is given to the worker.
- Open the Device page in HQ (Retail and commerce > Channel setup > POS setup > Devices).
- Select the device to validate for device activation, and then click Validate devices for activation. For example, select device HOUSTON-2.
- In the dialog box that appears, select the worker to validate the device for (that is, the worker that you mapped to the AAD account in the previous procedure). For example, select worker 000160.
- Click OK, and make sure that you receive a message similar to the following: "Pre-Activation validation completed for Device HOUSTON-2 and Staff 000160. Validation: Passed"
Checklist to follow before activation
- Complete the Validate devices for activation check in HQ, and make sure that the device passes validation.
- On the client machine where you're activating the device, access the Retail Server URL health check, and make sure that the health check is passed. Use the following format: https://clxtestax404ret.cloud.test.dynamics.com/en/healthcheck?testname=ping
- The worker must be mapped to an AAD account (under External identity).
- The AAD account to map must belong to the same tenant.
- To map the worker to the AAD account, sign in to HQ by using the Admin account for Microsoft Dynamics Lifecycle Services (LCS).
- Make sure that the worker is set up as a Dynamics 365 for Retail user in the Manager role (checked by validation).
- Make sure that the channel data is present in the channel database.
- Set up the hardware profile under Registers > Register (checked by validation).
- Make sure that the register and store have a screen layout (checked by validation).
- Make sure that a primary address is set up for the legal entity.
- Make sure that the electronic funds transfer (EFT) configuration value is present.