Skip to content

Security: arthurjoanes/api-sentinel

Security

docs/security.md

Segurança da demonstração local

Os controles estão no Compose, na autorização, no cliente ERP e na ACL Redis. Scans e testes são observações das imagens, datas e bases identificadas em cada recibo.

Os serviços publicados usam 127.0.0.1. A demonstração pressupõe controle do host e dos volumes Docker; não é uma implantação compartilhada ou exposta à Internet. Os dados comerciais e as credenciais PostgreSQL de demonstração são locais e identificados como tal no Compose.

API e Redis

Na revisão de 03/10/2026, a autenticação recebeu limite de 100 requisições/s por peer, com rajada de 200, antes de consultar a credencial. O webhook aceita 10/s, com rajada de 20. Excesso retorna 429 com Retry-After; a quota Redis por organização continua compartilhada entre réplicas. Os novos limites são por processo, e clientes atrás do mesmo proxy compartilham o orçamento de peer. A revisão dos 18 itens registra correções, testes e limitações.

A autorização por organização, loja e escopo ocorre antes de ler o cache. O cursor autenticado vincula organização, loja, período e versão dos dados. Limites de entrada, admissão, consulta e resposta restringem o trabalho em andamento; a integração ERP usa destino fixo e não segue redirecionamentos.

O primeiro início gera credenciais Redis aleatórias em volumes próprios, fora do Git. Repetir o início preserva essas credenciais. O usuário default fica desabilitado; cache e quota usam usuários separados, com comandos e padrões de chave restritos. O healthcheck tem acesso a PING. A administração usada pelos experimentos fica em um volume montado somente no serviço operacional tools.

Os testes com Redis real verificam rejeição de conexão anônima e impedem que os usuários da aplicação executem administração ou acessem as chaves do outro usuário. A suíte também verifica quota compartilhada e prevenção de cálculos simultâneos da mesma chave. Os experimentos de indisponibilidade usam o acesso administrativo sem colocar senhas nos argumentos dos processos ou nos relatórios.

A quota selecionável preserva 429 por excesso e 503 por falha de Redis ou estado inválido. GCRA usa relógio Redis, operação Lua atômica e namespace próprio. A ACL de quota admite somente os comandos e prefixos necessários às duas políticas; continua sem administração e acesso ao cache. Configuração divergente entre réplicas impede a comparação, pois dois namespaces não formam um limite global combinado.

Ferramenta de contratos e isolamento

Schemathesis pertence ao grupo não padrão contracts, fixado no lock, e à imagem de ferramenta derivada da imagem da tentativa. O inventário de dependências antes/depois confere que API, ERP e receiver conservam o runtime normal. O gate dedicado falha quando a ferramenta ou sua dependência estiver ausente; a suíte normal pode executar sem esse grupo.

O verificador aceita somente o proxy do projeto descartável ou loopback associado à tentativa. Recusa URL externa arbitrária, userinfo e destino que não corresponda ao contexto autorizado. A credencial vem de arquivo privado, sem token em flags. Relatórios e comandos de reprodução preservam operação, seed, parâmetros e papel da credencial; removem Authorization, cookies e URLs que possam carregar segredo. A reprodução recompõe a autenticação pelo arquivo privado.

Cada tentativa usa -p próprio em todas as chamadas Compose, tags exclusivas para API/proxy/ferramentas e volumes de dados/credenciais próprios. O registro identifica IDs e labels dos recursos e compara inventários anterior/posterior. A limpeza usa somente os arquivos Compose e o projeto registrados; down --volumes fica restrito a essa identidade. CPU, RAM, cache de build e daemon Docker continuam compartilhados com outros projetos, conforme o escopo da medição.

Grafana

O painel é anônimo com papel Viewer. A autenticação por senha está desabilitada, não é criado administrador inicial e Gravatar está desabilitado. A versão 12.4.11 tem digest fixado no Compose. O aviso oficial CVE-2026-76154, publicado em 17/09/2026 e consultado em 22/09/2026, lista 12.4.11 entre as versões corrigidas para esse problema específico; isso não comprova correção de todas as vulnerabilidades da linha. Referências: autenticação Grafana e aviso de segurança corrigido em 12.4.11.

Os testes HTTP confirmam que o dashboard provisionado continua legível, sem permissão de edição ou administração, que a credencial inicial pública não acessa a API administrativa e que o endpoint de login por senha está desativado. Ocultar o formulário, isoladamente, não impedia esse acesso na configuração anterior.

Atualizar a configuração não apaga usuários, sessões ou dashboards de um volume Grafana existente. Os ensaios usam volumes novos; nenhum volume de demonstração anterior é removido pelo verificador.

Verificação e limites

Scan de 12/10/2026

A primeira execução Linux, no snapshot 7c2e829, bloqueou o proxy por CVE-2026-4775, HIGH, em tiff 4.7.1-r0. O Dockerfile do proxy passou a fixar tiff=4.7.2-r0 no commit 6383a6d, versão indicada para essa correção na base oficial Alpine 3.24. Base Nginx, rotas e os quatro pins da revisão de 03/10 foram preservados. A falha inicial permanece no resumo desta entrega.

Na rodada completa do snapshot bf71318, Trivy 0.74.0 reportou zero HIGH/CRITICAL na aplicação e no proxy corrigido, sem exclusões. A aplicação apresentou três MEDIUM, em zlib, Mako e uv; os achados permanecem no relatório. O proxy não apresentou achados. As imagens sha256:45d249e9… e sha256:7129ec54… têm IDs completos ligados à prova operacional.

O scan da aplicação inclui sistema, Python e o binário uv; o proxy inclui pacotes do sistema. Serviços auxiliares têm escopo separado. A publicação conserva o gate HIGH/CRITICAL e aprova somente as imagens examinadas. As observações históricas abaixo mantêm suas datas e imagens.

Na revisão de 22/09/2026, o scan da execução completa e o scan da imagem final das capturas reportaram zero vulnerabilidades no escopo da aplicação. Trivy 0.74.0 examinou sistema, Python e binário Rust, sem exclusões ou filtro de severidade. As imagens são diferentes e estão identificadas em cada registro; nenhuma delas representa um scan dos serviços auxiliares. O aviso de ausência da data de fim de suporte do Alpine 3.24 na lista interna do scanner permanece registrado.

Gitleaks 8.30.1 examinou os 12 commits alcançáveis e a cópia dos arquivos rastreados/novos publicáveis. A primeira leitura da nova evidência encontrou 12 checksums de fontes e um nome de fixture sintética. Recalculei os quatro SHA-256 e conferi o rótulo, sem confundi-los com valores de credenciais. A política passou a reconhecer apenas esses valores literais nos três caminhos exatos dos relatórios, e o nome exato em um deles. O scan seguinte passou; um token fictício no mesmo caminho continuou sendo detectado no controle positivo. Escopo, triagem e controle.

O workflow de segredos examina o histórico Git. As exceções de Gitleaks identificam fingerprints de arquivos e rótulos de credenciais sintéticas, sem excluir diretórios completos. Tokens, senhas e arquivos de execução permanecem fora do repositório.

O scan Trivy do CI cobre a imagem Python da aplicação e a imagem construída do proxy. Ele bloqueia achados HIGH e CRITICAL, mesmo quando ainda não há correção disponível. O incremento do proxy de 03/10/2026 atualizou quatro bibliotecas, preservando a base Nginx e a configuração de rotas; o scan completo da imagem corrigida ficou sem achados. PostgreSQL, Redis, observabilidade e geração de carga têm escopo separado. As versões e o escopo dos ensaios constam em verificação.

O runtime conserva as ferramentas existentes de testes e relatórios locais. O novo gate de contratos tem imagem e dependências separadas. Uma implantação de produção ainda precisaria de ciclos de entrega próprios para serviços e demais ferramentas; a demonstração permanece local.

There aren't any published security advisories