Migration from 3D Mask in Web SDK

On January 1, 2027, 3D Mask will become unavailable. To ensure your integration continues to function correctly, you will need to remove several configuration parameters from your setup. This guide describes the exact changes required across three areas of your integration.

Web Adapter configuration file (backend)

In the Web Adapter configuration file, locate and remove the following two attributes:

• load_3d_mask

• enable_3d_mask

Web Plugin (frontend)

In your frontend integration code, remove the enable_3d_mask parameter from OzLiveness.open() parameters.

Look & feel customization

In the Style section of OzLiveness.open, locate and entirely remove the maskCustomization block. For more details, please refer to the customization guide.

Summary of changes

The table below lists all parameters to remove and their locations.

Parameter	Location
load_3d_mask	Web Adapter configuration file
enable_3d_mask	Web Adapter configuration file
enable_3d_mask	Web Plugin launch parameters (OzLiveness.open)
maskCustomization	The Style section in OzLiveness.open

After removing the parameters listed above, relaunch Web Plugin and check that the liveness flow works as expected. If you encounter any issues, please contact Oz Forensics support.