Overview
This Tutorial provides a walk-through of the steps to Admin login and set password for devices under EU RED compliance using RFID3 API
Create The Project
- Start by creating a new project in Android Studio. For help, see the Android Studio tutorial.
- Refer Hello RFID to prepare basic setup to work with RFID Reader and then follow this guide
Details
Admin login is required for devices under EU RED compliance. The list of applicable countries can be found in EU-RED-Countries.pdf.
To view or modify the features listed below, the user needs to log in as admin by entering the authorization password.
By default, Authorization password is set to “zebraRfid@1111”, which needs to be changed before accessing any of above features.
When user tries to login with default password, SDK returns RFIDResults.DEFAULT_PASSWORD_ERROR error code. So user has to change the default password, using the following APIs.
If user tries to access the above listed features without logging in will result in SDK throwing OperationFailure Exception with error code RFIDResults.ADMIN_CONNECT_ERROR
Setting it up
Admin Login
To login, user need to call the method adminLogin() with the password as parameter. If the password is correct, user will be able to view or modify the above listed features.
RFIDResults results = reader.Config.adminLogin(password);
when user tries to login with incorrect password, until 5 unsuccessful attempts user gets RFIDResults.PASSWORD_MISMATCH_ERROR. After 6th unsuccessful login attempt, each subsequent attempt will be delayed by 30 seconds with the error code RFIDResults.WRONG_PASSWORD_TIMEOUT_ERROR
Change Admin Password
To change the admin password, user need to call the method adminSetPassword() with the old password and new password as parameters.
Acceptance critera for new password
- Minimum length: 9 characters, maximum length: 31 characters
- At least one uppercase letter
- At least one lowercase letter
- At least one number
- At least one special character
- Cannot contain empty spaces
If the old password is correct and all acceptance criteria are met, the password will be changed to the new password.
If password criteria not met, SDK throws OperationFailure Exception with error code RFIDResults.PASSWORD_CRITERIA_MISMATCH_ERROR
RFIDResults results = reader.Config.adminSetPassword(oldPassword, newPassword, confirmNewPassword);