> 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-pt-br/sdks/backend-sdk/iad/release_notes/1.2.0_release_notes.md).

# 1.2.0

**Data de lançamento:** 30 de abril de 2026

## Visão geral

**Facephi IAD Service 1.2.0** é uma versão menor focada no reforço (hardening) da Inicialização da Licença e na precisão da documentação. Esta versão não introduz alterações nos endpoints da API nem no esquema de configuração.

## Alterações

### Reforço da Inicialização da Licença

* **Credenciais do produto incorporadas** — O serviço agora aplica as credenciais do produto Cryptlex da IAD em tempo de compilação durante a Inicialização da Licença.
* **Tratamento do arquivo de licença** — Se `LICENSE_ID` ou `LICENSE_DATA` estiverem presentes no arquivo de licença, o serviço os ignora e usa as credenciais do produto incorporadas.

### Alinhamento da documentação e da referência da API

* **Motivos de rejeição do engine** — A documentação da API agora lista os motivos de rejeição do engine retornados em `capture.rejection`.
* **Códigos de erro de validação** — A documentação da API e do OpenAPI agora documenta os valores de `error_code` do engine expostos pelas respostas HTTP `400`.
* **Exemplos operacionais** — Os exemplos de Docker, OpenAPI e configuração foram alinhados aos metadados da versão `1.2.0` atual, aos valores padrão do runtime e aos caminhos de Endpoint `/api/v1/iad/*`.

## Compatibilidade

* Os clientes da API existentes continuam funcionando sem alterações.
* Os arquivos `config.json` existentes continuam funcionando sem alterações.
* Os arquivos de licença existentes continuam funcionando. Se seus modelos de provisionamento ainda preencherem `LICENSE_ID` ou `LICENSE_DATA`, esses valores não têm mais efeito e podem ser removidos para maior clareza.

## Guia de atualização

Esta versão não exige migração da API nem da configuração. Para atualizar:

1. Atualize a tag da imagem Docker para `1.2.0`.
2. Implante o serviço novamente.
3. Verifique a versão em execução usando `GET /api/v1/iad/version`.
4. Revise os modelos de provisionamento de licenças e deixe de depender de `LICENSE_ID` ou `LICENSE_DATA` se eles estiverem sendo gerados.

## Implantação

```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
```

## Requisitos

| Componente          | Requisito                                |
| ------------------- | ---------------------------------------- |
| Sistema operacional | Linux x86\_64 (Ubuntu 24.04 recomendado) |
| Licença             | Arquivo de Licença válido da Facephi     |
| Docker              | Para implantação em contêineres          |

## Problemas conhecidos

Nenhum problema foi identificado nesta versão.

## Suporte

Para obter Suporte Técnico, entre em contato com seu representante da Facephi.

## Documentação

* [Referência de configuração](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/iad.md)
* [Guia de instalação](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/iad/installation/installation_instructions.md)
* [Referência da API](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/iad/technical_documentation/api_reference.md)
* [Registro de alterações](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/iad/changelog.md)
