FAQs & Known issues¶
FAQs¶
Display Height Problem on Safari Browsers on iPhones¶
In certain scenarios, developers have reported an issue with the display height when integrating our SDK on Safari browsers running on iPhones. The display height does not render correctly, causing visual inconsistencies and potential usability issues.
This issue is typically caused by the unique way Safari handles viewport units on iPhones. The browser calculates the viewport height (vh) unit differently than other browsers, which can lead to unexpected results when using vh for element heights in an iFrame.
We have prepared a detailed guide to address this issue, which includes a workaround and steps to implement it. Please refer to the XpressID guide for more information and the solution: https://docs.veridas.com/xpressid/web/latest/integration/#iframe-integration
We recommend all developers facing this issue to review the guide and apply the suggested workaround in their integration. If the problem persists after applying the workaround, please contact our support team for further assistance.
Server Side¶
Avoid blocking server-side resources.
This could happen if the content-security-policy
header is enabled in your server configuration, blocking the access to server resources such as:
- workers
- images
- fonts
- styles
To solve this problem, it would be necessary to review the content-security-policy
headers and enable access to these resources.
Browsers¶
-
Safari camera permission error
Privacy in Safari is very strict, therefore it is necessary to take into account that if an end user rejects the permissions by clicking Don't allow or Never for this website will not be able to use the SDKs as they need camera permissions in order to work. It is important to ensure that the user knows how to switch the permission back on again in case it wants to, by going to the browser settings on that specific website and enabling the permissions as it is shown in the following image, since the user query prompt will not be shown again.
-
Instructions to allow camera permissions in Safari
- PROMPT SELECTION
- CAMERA ACCESS GRANTED ALL IS OK
- CAMERA ACCESS NOT GRANTED PAUSED OR BLOCKED
- HOW TO ALLOW ACCESS
1. Go to Safari site settings
2. Click on camera permission and change it from ask to allow
3. Permissions should now looks like this:
-
Known issues¶
Microsoft Surface tablets compatibility¶
We are aware of the incompatibility of the selfie, document and video SDKs with certain Microsoft devices, specifically with the range of Surface tablet devices with Windows operating system installed (such as Surface Pro models). These devices may experience issues with the rear camera due to a known issue. This can result in a flipped or inverted video preview during capture, making the process difficult. To avoid this, we recommend using a compatible device for a smoother experience.
Camera issues with invalid certificates¶
To use the camera in the browser, it is essential to have a valid certificate (HTTPS). Without this certificate, browsers block access to the camera for security and privacy reasons, preventing the application from functioning correctly.
Camera Feed Rotation Issue on Firefox¶
On certain devices using the Firefox browser, you may experience an issue where the camera feed appears rotated 90 degrees. This is not a fault of our system, but rather a peculiarity of the browser on those devices, which is out of our control.