REST Unified User Interface
The BWS unified user interface is an implementation based on the BWS Web API and provides a user interface where the developers can redirect their users to perform various biometric tasks like verification or enrollment.
It is currently implemented on our company web server https://www.bioid.com, but more implementations may be available soon. Anyway, the source code and the required modules (jQuery, Silverlight) are free to download and can be customized as needed. A project containing the sources and modules will be available on our GitHub account.
When a user opens the page, access to the camera is requested by the browser. After allowing access to the camera, the user can start the recording at any time using the buttons on top. After recording has been started the first image is automatically captured and sent to the Upload Web API. Then the application tries to detect motion in the central area in front of the camera. As soon as the motion-threshold is exceeded the next image is captured and uploaded.
The upload API at the BWS server performs a quality check of the uploaded images to decide, whether to keep the image or not. If enough images are available at the server, the application invokes the BWS liveness detection, verification, identification or enrollment web API (as prescribed by the token). These operations automatically do a liveness detection (if requested) before performing the biometric operations. If the job succeeds the user is done. Otherwise the user is shortly notified about the failure and the procedure is restarted up to a maximum number of tries.
Typically an application redirects here (via HTTP 302 status code), using a application/x-www-form-urlencoded message with parameters as follows:
|access_token||Required. A BWS web token that has previously been issued by the Token Web API.|
|return_url||Required. An URL to redirect the user after the task has been carried out.|
|state||Recommended. Client specific data to maintain state between request and callback. For example you might want to add some information about the user you are verifying or enrolling.|
|api_url||Optional, defaults to
|trait||Optional, defaults to Face. The UUI currently supports the traits Face and Periocular. To use both traits, just specify trait=Face,Periocular in the query.|
|autostart||Optional, defaults to false. A boolean parameter that indicates whether to start the verification- or enrollment-procedure automatically as soon as the camera has been started. If set to false, the user has to press the start button to start recording, if set to true recording starts automatically.|
The response is sent to the BWS client application using the provided
return_url by sending a application/x-www-form-urlencoded message with parameters as follows:
|access_token||The same BWS web token that has been sent to the unified user interface.|
|state||(only if presented) Client specific data to maintain state between request and callback.|
|error||(only for error response) The user interface forwards errors from the internal BWS Web API calls to the callback method. Additionally the error user_abort might be reported in case the user aborted the operation.|