> 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/backend1n/release_notes/4.5.0_release_notes.md).

# 4.5.0

Nesta versão, foi adicionado suporte a bancos de dados PostgreSQL. Também foi adicionada autenticação JWT opcional, configurável em `config.json` ou por meio das variáveis de ambiente `FACEPHI_BACKEND1N_REST_*`.

**Não há alterações no contrato** dos endpoints. O suporte anterior ao MongoDB também não foi alterado. A tecnologia de banco de dados que o serviço usará é determinada na inicialização, com base na string de conexão:

```bash
# Prefixos aceitos pelo MongoDB.
# mongodb://
# mongodb+srv://
export DATABASE_CONNECT_STRING=mongodb://user:pass@localhost:32902/?directConnection=true&serverSelectionTimeoutMS=5000

# Prefixos aceitos pelo PostgreSQL.
# postgres://
# postgresql://
export DATABASE_CONNECT_STRING=postgresql://user:pass@localhost:32903/db_backend
```

## Sobre os bancos de dados

No caso do MongoDB, o próprio serviço criará um banco de dados chamado `db-backend`, caso ele ainda não exista. Nele, serão armazenadas duas coleções:

* `media` para armazenar imagens.
* `patterns` para armazenar padrões biométricos.

O caso do PostgreSQL é um pouco diferente. Um banco de dados com o nome `db_backend` deve ser criado previamente pelo administrador do sistema. O PostgreSQL dificulta a criação de bancos de dados pelo próprio cliente. Um exemplo dos comandos que o administrador deve executar previamente seria:

```bash
sudo -u postgres psql -c "CREATE ROLE backend1n WITH LOGIN PASSWORD 'backend1n';"
sudo -u postgres psql -c "CREATE DATABASE db_backend OWNER backend1n;"
sudo -u postgres psql -d db_backend -c "GRANT ALL ON SCHEMA public TO backend1n;"
```

No banco de dados PostgreSQL, o serviço criará duas tabelas, assim como acontecia com o MongoDB:

* `media` para armazenar imagens.
* `patterns` para armazenar padrões biométricos.

> **Importante:** As strings de conexão devem incluir as informações de usuário e senha, ou quaisquer informações adicionais que permitam ao serviço acessar o banco com permissões de leitura e escrita.

## Adicionado

* Autenticação JWT opcional, configurável em `config.json` ou por meio das variáveis de ambiente `FACEPHI_BACKEND1N_REST_*`.
* Suporte a bancos de dados `PostgreSQL`.
* Cobertura de testes de integração para endpoints públicos e protegidos quando a autenticação JWT está habilitada.
* Cobertura de testes de integração para os backends MongoDB e PostgreSQL.
