> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração

> Variáveis de ambiente da API Alforse agrupadas por assunto.

## Visão geral

Resumo das variáveis da API. Alforse Cloud usa valores SaaS; auto-hospedagem empresarial usa os mesmos nomes com infraestrutura do cliente. Segredos devem ficar em cofre seguro.

| Categoria                 | Notas                                                                                                 |
| ------------------------- | ----------------------------------------------------------------------------------------------------- |
| Edição e runtime          | EDITION, NODE\_ENV, PORT. self\_hosted requer licença empresarial.                                    |
| Infraestrutura central    | PLATFORM\_DATABASE\_URL, TENANT\_DATABASE\_URL, REDIS\_URL. Bancos ficam separados.                   |
| Auth e integridade        | JWT\_ACCESS\_SECRET, JWT\_REFRESH\_SECRET, API\_HMAC\_SECRET, MFA\_SECRET\_KEY.                       |
| URLs públicas e CORS      | API\_PUBLIC\_URL, WEB\_PUBLIC\_URL, DEALS\_PUBLIC\_URL, CONSOLE\_PUBLIC\_URL, CORS\_ALLOWED\_ORIGINS. |
| Armazenamento e varredura | OSS\_\*, FILE\_SCAN\_MODE, FILE\_SCAN\_ENDPOINT, FILE\_DOWNLOAD\_REQUIRES\_CLEAN\_SCAN.               |
| OCR, IA, SSO, e-mail      | Configure OCR, gateway IA, provedores SSO e e-mail conforme necessário.                               |

## Tratamento de segredos obrigatórios

* `JWT_ACCESS_SECRET`
* `JWT_REFRESH_SECRET`
* `API_HMAC_SECRET`
* `MFA_SECRET_KEY`
* `OSS_SECRET_KEY`
* `FILE_SCAN_API_KEY`
* `OCR_API_KEY`
