Secure image capture

Yoti age estimation comes with SICAP (Secure Image Capture). This ensures the captured image has not been manipulated (for example, injected) before it is submitted to the Yoti backend for processing.

In order to use SICAP, you will need to:

  • Install Yoti’s Face Capture Module (FCM)
  • Set the secure prop to true
  • Use the full FCM output for the image and secure data
  • Add a query parameter when calling the Yoti API endpoints
  • Ensure to pass both the image and secure body to Yoti API endpoints
Good to know
FCM image output cannot be modified. Any change in ‘img’ will be rejected by the backend. For the best security, you should always ensure the latest version of the Face Capture module is being used, and keep this regularly updated.

Endpoints

If you wish to use the secure feature, you will need to add the query parameter ‘?secure=true’ to the applicable endpoint below:

  • /v1/age?secure=true
  • /v1/age-antispoofing?secure=true
  • /v1/antispoofing?secure=true

Note: if secure is requested, you will also need to add a “secure” field in the request body, or you will get an 'INVALID_REQUEST_BODY' error message.

If using the YotiSDK, the query parameter should be set with the appropriate query parameter function call, not directly to the endpoint.

Request body

Face capture module will automatically return “img” and “secure” on success. Do not modify these fields manually.

JSON
Copy

Response body

This remains the same as the response without the SICAP. Example for /v1/age-antispoofing:

JSON
Copy

Error codes

SICAP feature introduces new API error codes:

HTTP CodeError CodeError Description
400SECURE_REQUEST_IS_EMPTYSecure request field is empty.
400SECURE_SESSION_NOT_FOUNDSecure session not found.
400SECURE_SIGNATURE_NOT_FOUNDSecure signature not found.
400SECURE_VERSION_NOT_FOUNDSecure version not found.
400INVALID_SECURE_SIGNATUREFailed to verify secure session signature.
400SECURE_VERIFICATION_NOT_FOUNDSecure verification not found.
400UNTRUSTED_SECURE_SESSIONUntrusted secure session
401INVALID_SECURE_SESSIONInvalid secure session token.
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard