When displaying Mango dashboards on a public kiosk it may be desirable to automatically login a user. Since version 3.1.8 of the UI module there are three options for supplying the auto-login credentials (in order of precedence):
- Url parameters
- Local storage/cookies (this used to be the only option)
- From the UI settings which are stored in the REST API JSON store
Important warning
Never use admin credentials for auto-login, always use a view-only/restricted user. The password will be stored/and or transmitted in plain text. When using the UI settings, the credentials will be publicly accessible from the REST API!
Url parameters
You can supply auto-login credentials using the autoLoginUsername and autoLoginPassword url/query parameters. e.g. https://mymangodomain.com/ui/home?autoLoginUsername=publicuser&autoLoginPassword=publicpassword
There is also a parameter which will store the credentials from the URL into the local storage/cookies - autoLoginStoreCredentials. This ensures that if the user navigates away and comes back to Mango the credentials are still available.
e.g. https://mymangodomain.com/ui/home?autoLoginUsername=publicuser&autoLoginPassword=publicpassword&autoLoginStoreCredentials
autoLoginDeleteCredentials can be used to delete these credentials in the event that you no longer want users to be auto-logged in.
Local storage/cookies
You can store the credentials in the browser's local storage/cookies via the "Auto-login (local)" page under "Administration", or via the url parameters as explained above. These credentials must be added on a per machine/browser basis.
UI settings/JSON store
You can store auto-login credentials for all clients on the "UI settings" page under "Administration". Any client/browser which connects to the Mango instance will use these credentials (provided they are not logged in via one of the previous methods).
Help video
This video explains how you can use the Auto Login feature to create a mobile webapp on your mobile devices that opens in app mode and automatically logs you in.