> 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 na resiliência operacional, na flexibilidade de configuração e em um diagnóstico melhor. Esta é uma Versão totalmente retrocompatível: não há alterações incompatíveis na API nem na configuração.

## Novidades

### Melhoria do 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 solução de problemas.

### Endurecimento 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 (foi removido o excesso de logging detalhado na detecção do Docker e na ativação do motor).

## Correção de erros

* Os erros do proxy REST agora são criados e relatados por meio de um único caminho de código consistente.
* As respostas de erro do motor são normalizadas antes de serem reenviadas ao cliente.
* Foi removido o excesso de logging de depuração durante a detecção do ambiente Docker.

## 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 em 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 (recomenda-se Ubuntu 24.04) |
| Licença             | Arquivo de Licença válido da Facephi      |
| Docker              | Para a 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)