You are here:
Application Security PIN
To enable better security and adherence to the mobile security standards, the Consumer Goods Cloud offline mobile app has a PIN feature. This pin is specific to a user and enables access to the Consumer Goods Cloud offline mobile app. It also enables the application to lock itself, if the user is inactive for a predefined period.
Required Editions
| Available in Lightning Experience in Professional, Unlimited, and Enterprise Editions that have Consumer Goods Cloud enabled. |
This PIN feature is independent of any other PIN feature of the device. This feature enables you to:
- Create a PIN, if the PIN Protect option is enabled in the Sync Configurator.
- Enter PIN, if the application is idle for a predefined period
- Reset your PIN
By default, PIN isn’t an application feature but must be activated from the backend. The administrator can enable the PIN feature and define the following configurations:
- PIN Protect
- Inactivity timeout in minutes
- Number of digits for the PIN
On each restart of the Consumer Goods Cloud offline mobile app, the application validates if the settings or configurations have changed. The new settings are applied only when you restart the application.
Create PIN
The Create PIN screen is displayed if you restart the application after the administrator enables the PIN Protect option or changes the number of digits for the PIN. The Create PIN screen doesn’t display if the configuration changes are made and the application isn’t restarted.
Enter PIN
The Enter PIN screen is displayed when the Consumer Goods Cloud offline mobile app has been idle for a predefined period due to user inactivity.
User activity in this context can be broadly defined as follows:
- When you interact with the business logic layer by changing values in the input fields, creating objects, or switching between list items
- When you end a process by tapping the Back button on the device
- When you open an external image viewer
- When you enter a PIN
- When you authenticate through Single Sign On (SSO)
If you aren’t performing any of these actions and the application is lying idle, the Enter PIN screen is displayed when you try to resume work.
Error Messages and Warnings
The PIN feature also has error messages enabled for the scenarios defined in the following table.
| Scenario |
|---|
| Repeated use of the same digit, for example, 1111 |
| User Inactivity |
| Incorrect PIN |
Reset PIN
Consumer Goods Cloud mobile framework enables you to trigger reset PIN functionality using the user.resetPIN() API. This method is part of the application user object.
The PIN is also reset automatically after three incorrect PIN entries and you’re logged out of the Consumer Goods Cloud offline mobile app. Create a PIN on your next login.
PIN Reset During Synchronization
You can’t reset the PIN in Sync Management app.
- The user.resetPIN() method doesn’t work and displays a warning message.
- If the PIN screen displays but synchronization starts and you enter incorrect PIN thrice, then PIN is deleted and a warning message is displayed. You’re logged out after the synchronization stops. Create a PIN on your next login.
