This sections refers to issues potentially caused by a misconfiguration that is solvable. For limitations of the Access App, refer to the chapter Known Limitations.
|Platform||Operating System||Manufacturer / Device||Issue||Possible Root Causes||Possible Solutions|
|iOS||All||All||App is not opening from the mobile browser via the Universal link (mobile-only feature). Instead, the browser navigates to the App Store page.||The AASA file (Apple-App-Site-Association file) does not exist. The content of the AASA file does not match with the used App ID.||See Solution for iOS App Link.|
|iOS||All||iPhone X||App with version 1.8.0 crashes when you try to change the backend URL||The backend URL was changed to an invalid value.||Reinstall the app. Update to app release 1.9.x.|
|Android||All||Samsung S7, Samsung S7 Edge||The authentication QR code is not correctly scanned.||-||Slowly move the camera away from the QR code.|
|Android||All||Xiaomi||Biometric credentials registered in a non-work profile show up in the work profile as well but cannot be used for authentication.||The Xiaomi Android OS itself behaves incorrect in combination with work profiles, it does not separate credentials across profiles. When using a working profile the FIDO UAF credentials cannot be protected by the Operating System through user authentication.||Update to Android app release 2.4.x.|
|Android||Android 11 and later||Xiaomi Nova 9||No device passcode fallback screen is displayed when the user provides invalid biometric credentials too many times.||The Xiaomi biometric implementation incorrectly handles the case where the user provides invalid credentials too many times.||Bring the application to the background and then to the foreground.|
|iOS||15.5||iPhone X||When trying to scan a QR code, the app responds with "Camera Access denied" asking the user to give access via the app system settings. The system settings does not show an option to enable camera access||Another application requested camera access before and something went wrong there. A screen sharing application was used, this is known to cause issues in regards to camera access||A reboot of the iPhone solves the issue.|
Solution for iOS App Link
The AASA file must be placed in the following location:
https://<domain>/.well-known/apple-app-site-associationThe domain must be configured in the
.entitlementsfile of the App:App .entitlements file
The AppID (created by concatenating the teamID and the bundleID) must be listed in the served-out AASA file:AASA file
The following file is a minimalistic workable example:Example AASA file
For more details of the Mobile-Only feature, see Mobile-Only Authentication / Deep Linking Best Practices.
Nevis recommends using the simpler custom URIs.