V-Fire-Monitor/docs/LICENCIAMENTO.md

Licenciamento

Este guia cobre a geracao e a instalacao de licenca do V-Fire Monitor.

Como o licenciamento funciona

A licenca vincula:

• HWID da maquina
• nome do cliente
• data de expiracao

O serial e salvo em license.key.

Modos de chave

Existem dois cenarios:

1. Chave mestre via VFM_LICENSE_MASTER_KEY
2. Chave legada embutida

Para producao, use VFM_LICENSE_MASTER_KEY.

Identificar o HWID

Quando o app esta sem licenca, a tela inicial mostra o Hardware ID.

Voce tambem pode coletar no proprio sistema onde o app esta rodando:

python3 - <<'PY'
from vfire_monitor.core import get_hardware_id
print(get_hardware_id())
PY

Gerar o serial

Uso por argumentos:

python3 generator.py --hwid "HWID-DA-MAQUINA" --cliente "Nome do Cliente" --expira 2027-01-01

Se VFM_LICENSE_MASTER_KEY estiver definida no ambiente, o gerador usa essa chave.

Se nao estiver definida, ele usa a chave legada embutida.

Instalar a licenca pelo painel

1. Abra o painel do V-Fire Monitor
2. Na tela de bloqueio, copie o HWID
3. Gere o serial
4. Cole o serial no campo de ativacao
5. Clique em Ativar licenca

O backend valida:

• serial
• HWID
• data de expiracao

Se tudo estiver correto, o monitoramento e liberado.

Instalar a licenca manualmente no servidor

Se voce ja tem o serial:

cat > /var/lib/vfire-monitor/license.key <<'EOF'
SEU_SERIAL_AQUI
EOF

chown vfire-monitor:vfire-monitor /var/lib/vfire-monitor/license.key
chmod 600 /var/lib/vfire-monitor/license.key
systemctl restart vfire-monitor

Validar a licenca instalada

Exemplo local:

python3 - <<'PY'
from pathlib import Path
from vfire_monitor.core import LEGACY_LICENSE_KEY, LicenseService

service = LicenseService(Path("license.key"), LEGACY_LICENSE_KEY)
status = service.verify()
print(status.valid, status.message, status.days_remaining, status.hardware_id)
PY

Se a instalacao de producao usar VFM_LICENSE_MASTER_KEY, a validacao deve usar a mesma chave mestre.

Quando a licenca falha

Os erros mais comuns sao:

• Licenca ausente
• Serial invalido
• HWID incompativel
• Licenca expirada

Boas praticas

• use chave mestre por variavel de ambiente em producao
• nao distribua a chave legada em ambiente final
• mantenha backup de:
  • license.key
  • app_secret.key
  • config_nodes.json
  • mapa_dispositivos.json