Rotas da API
A câmera fala com /api/device/*; o painel, com /api/admin/*.
| Rota | Quem chama | Para quê |
|---|---|---|
POST /api/device/events | câmera | entrega um evento; repetir o mesmo identificador não duplica |
POST /api/device/photo | câmera | foto JPEG de até 256 KB, só para evento de acesso autorizado |
POST /api/device/heartbeat | câmera | sinal de vida a cada 10 s, com fila e perdas; devolve a hora do servidor |
GET /api/device/command | câmera | busca comando pendente (troca de senha pedida no painel) |
POST /api/device/command-result | câmera | confirma que o Mega aplicou ou recusou o comando |
GET /api/admin/overview | painel | últimos 200 eventos, pessoas, comandos e estado do aparelho |
GET /api/admin/photo | painel | foto de um evento |
POST /api/admin/reset | painel | pede nova senha de 6 dígitos para um ID; fica pendente até o Mega confirmar |
A troca de senha nunca é aplicada pelo servidor: ele cria um comando, a câmera leva ao Mega, o Mega confere se a senha é única e responde. O painel mostra "pendente" até essa resposta chegar. Comando sem resposta em 24 h expira e a senha guardada nele é apagada.
Banco de dados
| Tabela | Guarda |
|---|---|
events | cada evento com identificador, sessão, tipo, pessoa, método, motivo, horário do aparelho e horário de chegada |
photos | o JPEG de cada acesso autorizado, ligado ao evento |
users | IDs conhecidos e se estão ativos |
commands | pedidos de troca de senha e o resultado |
devices | último sinal de vida, fila e contadores de perda acumulados entre reinícios da câmera |
Segurança
- Duas chaves separadas: a câmera usa a chave do aparelho; o painel usa o PIN de administrador de 10 dígitos. Comparação em tempo constante.
- Limite de tentativas: 10 erros em 60 s bloqueiam aquele IP e aquele papel por um tempo. Atrás do proxy, o IP vem do cabeçalho que o próprio Caddy acrescenta (opção
--trust-proxy), para um atacante não conseguir bloquear a câmera. - Validação de tudo que chega: tipos, tamanhos e formatos; corpo JSON limitado a 16 KB; JPEG conferido pelo início e fim do arquivo.
- Cabeçalhos do navegador: política de conteúdo restrita ao próprio site, sem cache, sem incorporação em outros sites.
- Banco criado com permissão só do dono, e nada de corpo ou cabeçalho nos logs.
Hospedagem
Uma VM pequena, HTTPS automático e custo vigiado.
- Máquina: EC2 t3.micro em São Paulo, Ubuntu 24.04, disco de 8 GB, atualizações de segurança automáticas.
- Portas: 80 e 443 abertas; acesso administrativo só a partir de um IP autorizado.
- Domínio: subdomínio DuckDNS que a própria VM mantém apontado para o IP atual, no boot e a cada 5 minutos.
- Certificado: emitido e renovado sozinho pelo Caddy, fixado na Let's Encrypt porque a câmera só confia nas raízes dela. A cadeia servida termina em ISRG X1, conferida só com as raízes que a câmera tem.
- Serviço isolado: usuário próprio sem login, sistema de arquivos só de leitura fora da pasta de dados, sem acesso a dispositivos.
- Custo: coberto por crédito; um alarme de orçamento desliga a VM sozinho no primeiro centavo de gasto real.
Painel
O painel fica atrás de duas camadas: a senha que o navegador pede (Caddy) e o PIN de 10 dígitos do sistema. Ele não é público, e este site não publica o endereço dele.
Testar o servidor sem a placa
O script scripts/testar-servidor.py confia só nas raízes gravadas na câmera, mantém a conexão aberta como ela e usa apenas pedidos que não gravam nada. Medido contra a VM: negociação TLS 1.3 em cerca de 300 ms e cada pedido seguinte entre 22 e 50 ms. Contra um site com certificado de outra autoridade, ele acusa a falha, que é exatamente o que a câmera faria.
DEVICE_KEY=... python3 scripts/testar-servidor.py https://<domínio>