For confidentiality reason, users are required to login before they have access to most of the UBIK® features.
Contents
Accessing login dialog
Near the bottom of the start menu which users see immediately after launching UBIK® application, there is a Login button. Clicking it opens the login dialog.
Logging in
In the login dialog, users can provide their credentials to identify themselves. If the authentication is successful, the dialog will be dismissed and users will have access to all the UBIK® features. Otherwise, the error details will be given in the authentication messages.
Logging in with the current UBIK settings
If all the UBIK® setting values are already configured correctly before login, users can simply click Login in the dialog. During the time of authentication, there will be a progress dialog displayed. Once users' identities are confirmed, both dialogs will be dismissed.
Logging in with a selected Preset
It is also possible to specify a collection of setting values to use before login. In this case, simply click Load Preset. A preset selection dialog will then be shown. After choosing the desired preset, users can click Login in the selection dialog to trigger the authentication.
Authentication messages
No user input
When users try to login with no input at all, the indicating message says "Please enter your username and password."
Password missing
When users try to login with only usernames but not passwords, the indicating message says "Type the password for this account."
Invalid user credentials
When the usernames being used is invalid, the indicating message says "The username isn't valid. Please try again.". Also when the password being used is invalid, the indicating message says "The password isn't valid. Please try again."
Web service messages
In case an error occurred while/when the client sends a request to the web service for authentication, a message detailing the reason for failure will be displayed according to the following
| Cause | Message displayed |
|---|---|
| Invalid satellite | The satellite isn't valid. |
| Locked satellite | The satellite is locked. |
| Service unavailable | The service is unavailable. |
| Service maintenance | The service is in maintenance. |
| Internal error | An internal error occurred at server side. |
| Unknown error | An error occurred at service side. |
| Authorization error | An authorization error occurred. Erroneous HTTP status code 401. |
| Service not found | The service couldn't be called. Please check the configuration. Erroneous HTTP status code 404. |
 | Verification of username and password happens only if the web service is configured accordingly. |
| Detailed failed login error messages Available since VersionAndroid |
Remembering passwords
(Available since VersionAndroid)
UBIK® allows users to remember their passwords for easy login. In the login dialog, there’s an extra checkbox below the password field. Once a user has successfully logged in with it checked, he/she will be remembered. During next time’s login, as soon as the same username is entered and the focus leaves the name field, UBIK® detects the remembered state and updates the password field ("*****" regardless of what the real password is) and the checkbox. Similarly, users can uncheck the checkbox to forget their remembered states.
 | The user and password can only be remembered / forgotten if the login is successful. |
| It is possible to enter a password even when the user is remembered. In this case, the entered password will be used for login. |
Offline Login
Once a user has successfully logged in online, the account is remembered locally and an offline login can be done.
| The same password the online login succeeded with has to be used for subsequent offline logins. So even if the authentication web service is not password-restrictive, the client always is. |
| For the UBIK WinX client, offline login only is possible if the user data is sent to the client via the web service first. The logins have to be configured in the ACM infrastructure therefore. |