Introduction¶
DEPRECATION NOTICE
We are in the process of deprecating our "Selfie Alive" process. As a first step, we are going to deprecate it in our web SDKs (Web-Components only) in the next SDKs release.
This means that the next Web-Components SDKs released won't have this functionality.
Those customers with our Web-components web SDKs already integrated and using "Selfie Alive" will need to adapt their integrations to our passive ("Selfie") or active ("Selfie Alive Pro") liveness capture, according to their use case requirements.
The latest web SDKs released with support to "Selfie Alive" (v5.2.14) will be supported and maintained for 6 more months, until February 2025.
IMPORTANT NOTE
Major versions represent a big change from the previous major version, providing more capabilities and potential. At the same time, moving from a major version means a break in backward compatibility that must be managed using the provided migration guide. Please make sure to perform proper tests in development environments to ensure that everything is working as expected.
Differential features and improvements of WC SDKs
- Greatly improved browser's compatibility
- Webviews support available
- Fully customizable UI with configuration and CSS Parts available
- Improved detection and quality of the captures generated
- Improved and organized configuration
- Optimization and reduction of memory requirements
- Reduced weight of the SDKs
Selfie SDK is a JS library that allows detecting and capturing a person's face, using advanced biometric techniques. This allows to carry out a face biometry verification step in the context of the identity verification process offered by Veridas. Selfie SDK has three different ways of detection, each with a higher level of security: Selfie, Selfie Alive and Selfie Alive Pro, the most secure one.
Flows¶
- Selfie(Selfie): The most basic flow. Consists of capturing an image of the face. The SDK automatically detects the face when it is positioned on the guiding oval and takes a photo.
- Selfie Alive Pro(Head Movement): This is the most advanced and higher security flow. It is based on a challenge-response design and also provides an advanced form of face liveness detection. Consists of capturing a video of the person performing a head movement challenge which is guided by a head animation displayed on the screen, which must be followed by the person who is doing the process.
Specifications¶
The following permission is required for the framework to work:
- Camera: By default, the SDK launch Front camera on all devices (smartphones, tablets, desktops, laptops...), but you can choose the camera you want to use with the selectCamera property. With this property you can launch the Back camera, to use with Selfie flow.
Browser compatibility¶
The SDK supports the following devices and browsers:
Desktop Browsers¶
| Browser Name | Minimum version | Current version |
|---|---|---|
| Chrome | 83 | 136 |
| Firefox | 132 | 138 |
| Safari | 15.4 | 18.3 |
| Opera | 69 | 118 |
| Edge | 83 | 134 |
Mobile and Tablets Browsers¶
| Browser Name | Platform | Minimum version | Current version |
|---|---|---|---|
| Chrome | Android | 135 | 135 |
| Firefox | Android | 132 | 138 |
| Edge | Android | 83 | 135 |
| Opera Mobile | Android | 80 | 89 |
| Samsung Internet | Android | 13.0 | 27 |
| Chrome | iOS | 135 | 136 |
| Firefox | iOS | 132 | 130 |
| Edge | iOS | 135 | 135 |
| Opera Mobile | iOS | 80 | 5.5 |
| Safari | iOS | 15.4 | 18.4 |
Browser APIs¶
ResizeObserver GetUserMedia WebAssembly
Webview compatibility¶
The SDK supports the following webviews:
| Webview Name | iOS | Android |
|---|---|---|
| Yes | Yes | |
| Yes | Yes | |
| WKWebView native iOS webview | Yes | - |
| SFSafariViewController native iOS webview | Yes | - |
| Android WebView native Android webview | - | Yes |
| Chrome Custom Tabs native Android webview | - | Yes |
| Trusted Web Activity native Android webview | - | Yes |
The SDK is compatible with Meta webviews, i.e. you can run it in Facebook and Instagram apps for Android and iOS. We also support native webviews for iOS and Android. However, we do not guarantee full compatibility or functionality with webviews from applications built using other frameworks, including hybrid frameworks, the performance and behaviour may vary.
Minimum recommended requirements for devices¶
Veridas recommends the following minimum requirements:
| Android devices | Minimum recommended requirement |
|---|---|
| Camera resolution | At least 1080p (Full HD) |
| RAM | At least 4GB, 6GB preferred |
| Processor (CPU) | Mid-range and recent |
| Screen resolution | At least 1080p (Full HD) |
| iOS devices | Minimum recommended requirement |
|---|---|
| Device model | From iPhone 11 onwards |
Please note that devices below these minimums may not function properly. Additionally, it's important to emphasize that while meeting these minimum specifications ensures functionality, exceeding them does not guarantee impeccable performance in all cases.
Dependencies¶
| File Name | Size file |
|---|---|
| vd-selfie.umd.js | 1.99 MB |
| vd-selfie.es.js | 1.99 MB |
| images | 1.26 MB |
| OpenCV | undefined |
| Tensorflow | 288 bytes |
| cv.worker.js | undefined |
| tf.worker.js | undefined |