> 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.1.0_release_notes.md).

# 1.1.0

**Data de lançamento:** 20 de março de 2026

## Resumo geral

**Facephi IAD Service 1.1.0** foca em resiliência operacional, flexibilidade de configuração e melhor diagnóstico. Esta é uma versão totalmente retrocompatível: não há alterações incompatíveis na API nem na configuração.

## Novidades

### Melhoria no diagnóstico de licenças

* **Tradução de erros de licença** — Mais de 110 códigos de status de licença agora são mapeados para mensagens legíveis por humanos com recomendações acionáveis.
* **Relatório de erros normalizado** — As falhas relacionadas à licença produzem entradas de log consistentes e estruturadas para facilitar a resolução de problemas.

### Hardening da imagem Docker

* Imagem base simplificada com superfície de ataque reduzida.
* Melhor gerenciamento de pacotes e fixação (pinning) de dependências.
* Saída de logs mais limpa (o excesso de logging detalhado na detecção do Docker e na ativação do engine foi removido).

## Correção de erros

* Os erros do proxy REST agora são criados e reportados por meio de uma única rota de código consistente.
* As respostas de erro do engine são normalizadas antes de serem encaminhadas ao cliente.
* O excesso de logging de depuração durante a detecção do ambiente Docker foi removido.

## Guia de atualização

Esta versão não requer etapas de migração. Os arquivos `config.json` existentes e os clientes de API continuam funcionando sem alterações.

Para aproveitar a configuração por meio de variáveis de ambiente, defina as variáveis `FACEPHI_IAD_REST_*` ou `FACEPHI_IAD_ENGINE_*` desejadas antes de iniciar o serviço ou no seu manifesto do Docker Compose / Kubernetes.

## Implantação

```bash
docker pull facephicorp.jfrog.io/docker-pro-fphi/facephi-iad-service:1.1.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.1.0
```

## Requisitos

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

## Problemas conhecidos

Não foram identificados problemas nesta versão.

## Suporte

Para suporte técnico, entre em contato com seu representante da Facephi.

## Documentação

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