> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad/release_notes/1.2.0_release_notes.md).

# 1.2.0

**Release date:** April 30, 2026

## Overview

**Facephi IAD Service 1.2.0** is a minor release focused on hardening license initialization and improving documentation accuracy. This release introduces no changes to the API endpoints or the configuration schema.

## Changes

### License initialization hardening

* **Embedded product credentials** — The service now applies the IAD Cryptlex product credentials at compile time during license initialization.
* **License file handling** — If `LICENSE_ID` or `LICENSE_DATA` are present in the license file, the service ignores them and uses the embedded product credentials instead.

### Documentation and API reference alignment

* **Engine rejection reasons** — The API documentation now lists the engine rejection reasons returned in `capture.rejection`.
* **Validation error codes** — The API and OpenAPI documentation now document the `error_code` values from the engine exposed by HTTP responses `400`.
* **Operational examples** — The Docker, OpenAPI, and configuration examples have been aligned with the `1.2.0` current version metadata, runtime defaults, and Endpoint paths `/api/v1/iad/*`.

## Compatibility

* Existing API clients continue to work without changes.
* Existing `config.json` files continue to work without changes.
* Existing license files continue to work. If your provisioning templates still populate `LICENSE_ID` or `LICENSE_DATA`, those values no longer have any effect and can be removed for clarity.

## Upgrade guide

This release requires no API or configuration migration. To upgrade:

1. Update the Docker image tag to `1.2.0`.
2. Redeploy the service.
3. Verify the running version using `GET /api/v1/iad/version`.
4. Review your license provisioning templates and stop relying on `LICENSE_ID` or `LICENSE_DATA` if they are being generated.

## Deployment

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:1.2.0

docker run -d \
  -p 6982:6982 \
  -v /path/to/license:/app/license \
  -v /path/to/config:/app/config \
  --name iad-service \
  facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:1.2.0
```

## Requirements

| Component        | Requirement                              |
| ---------------- | ---------------------------------------- |
| Operating system | Linux x86\_64 (Ubuntu 24.04 recommended) |
| License          | Valid Facephi license file               |
| Docker           | For container deployment                 |

## Known issues

No issues have been identified in this release.

## Support

For Technical Support, contact your Facephi representative.

## Documentation

* [Configuration reference](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad.md)
* [Installation guide](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad/installation/installation_instructions.md)
* [API reference](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad/technical_documentation/api_reference.md)
* [Changelog](https://docs.facephi.com/docs.facephi-en/sdks/backend-sdk/iad/changelog.md)
