InStore_Auth

The InStore_Auth module provides functionality to authenticate users and authorize their access to InStore features based on assigned roles.

Capabilities

The InStore_Auth module handles the following InStore functions:

  • Receives data from the InStore_State module about an external source of retailer-managed users and saves it to the browser storage.
  • Receives credentials (username and password), or a PIN associated with each user.

  • Initializes and persists session data after a user is authenticated.

  • Registers a role for each user.
    You can manage roles and permissions in the InStore Center.

Administration parameters

You can modify the behavior of this module by setting the following administration parameters in the InStore Center:

Store Front parameters

  • Enable_Soft_Login_with_PIN
  • Mask_Soft_Login_PIN

Access the InStore colleague app

You manage your own access to the InStore colleague app and can access it by using a custom URL that has the following format:

{host site}/{environment label}/{location ID}/{workstation ID}

For easy access, program this URL into each workstation's locked browser. When a user logs in, the app claims that workstation for their session.

If you need another user to log in, or if you're replacing a device, you can force a new login, adding ?forceClaim=true to the end of the workstation's URL:
{host site}/{environment label}/{location ID}/{workstation ID}?forceClaim=true

User interface

This module affects the login screen on the InStore colleague app UI.

Authentication error codes

If there is a problem with authentication, you may receive one of the following error codes:

CodeMessage
9000Tenant environment not found
9001Location not found
9002Workstation not found
9003Workstation already claimed
9009Timeout
9010Server error