How to Update Web SDK
This guide is for on-premise installations, where you run the Web SDK in your own infrastructure. Oz engineers can assist with the update; contact your Oz representative.
The Web SDK consists of two parts: the Web Adapter (server side) and the Web Plugin (plugin_liveness.php, the frontend part). Your web page loads the plugin from the Web Adapter URL, so the plugin version always matches the Web Adapter it is served from. To update the Web SDK, you update the Web Adapter. Your page code stays the same unless the updating instructions say otherwise.
Before you update
Read the updating instructions for every version between your current one and the target one, not only the latest. They are published in the Web SDK changelog and list what you must change on your side: configuration parameters, infrastructure settings and breaking changes.
Back up your Web Adapter configuration: the
app_config.jsonfile you mount into the container, and anyWA_*environment variables or Helm values. Note the image tag or chart version you run now, so you can roll back.
Update
The Web SDK image is ozforensics/oz-webliveness on Docker Hub. The image tag is the Web SDK version, for example, ozforensics/oz-webliveness:2.2.0.
Docker / Docker Compose: set the new image tag, pull the image and recreate the container:
docker pull ozforensics/oz-webliveness:<version> docker compose up -dKubernetes (Helm): run
helm repo update, then upgrade theoz-k8s-sdkrelease to the new chart version with your existing values file.
Apply any configuration changes the updating instructions require. The Web Adapter reads its configuration only at container start, so the new configuration takes effect after a restart.
After you update
Open your page and launch the plugin. The Web SDK version is shown in the bottom right corner of the plugin screen; make sure it is the new one.
Run a full liveness session. Make sure the capture completes and you receive the result in your callbacks.
Rollback
If something goes wrong, redeploy the previous image tag or chart version with the configuration you backed up, and contact Oz support.
Last updated
Was this helpful?
