Skip to content

Security: arthurjoanes/containerops

Security

docs/security.md

Segurança e isolamento de capacidade

A admissão é definida pelo domínio, pelo repositório e pelos testes de integração. O manifesto e o JUnit registram a execução de 22/09/2026.

Fronteiras do pacote de backup

O pacote portátil contém somente manifesto, dump, metadados e, por opção explícita, archive da imagem de aplicação. Ele exclui secrets, env, certificados privados, estado do runtime e inspect bruto. Dump e metadados podem conter dados dos jobs; exportação/importação usam destinos novos privados, POSIX 0700/0600 ou DACL Windows limitada ao operador e SYSTEM. ACL não é criptografia.

Importação confere chaves/tipos, datas, schema, ferramenta, origem, conjunto permitido, tamanhos e SHA-256 em streaming. Recusa links/reparse points, JSON duplicado, itens extras, destinos existentes e mudanças durante a cópia. Referências externas não definem caminhos de destino. Restore seleciona somente um ID catalogado no runtime reservado; importar não restaura nem carrega imagens.

As leituras comparam identidade, tamanho e mtime antes/depois e calculam o hash do conteúdo lido. No Windows, a assinatura usa st_birthtime_ns quando disponível: ctime é depreciado nessa plataforma e pode divergir entre stat e fstat após uma gravação comum. No POSIX, o ctime continua detectando mudanças de metadados. Os testes de identidade do arquivo cobrem uma gravação concluída antes da leitura; os testes de catálogo mantêm as recusas por corrupção e plano obsoleto. Veja o contrato de stat do Python.

Se a publicação do pacote concluir e a gravação do catálogo falhar, o pacote portátil sem registro continua classificado como importado e protegido. A ausência do registro não concede confiança local. Essa regra também cobre pacotes portáteis colocados manualmente no runtime; backups legados sem manifesto mantêm a política de compatibilidade anterior. backups protect --backup <id> valida e persiste a classificação conservadora; não retira a exigência de --trusted-source.

Hash detecta corrupção, mas não autentica um conjunto adulterado de dump e manifesto. O PostgreSQL documenta que restore executa código escolhido pela origem. --trusted-source declara explicitamente confiança ao restaurar uma cópia importada. O banco permanece descartável, com papéis e credenciais próprios, redes/mounts atuais e volume novo. Esse isolamento não torna seguro um dump de origem desconhecida.

backup-image-load --trusted-image-source exige archive conferido e sessão ativa. Exportação usa ImageID sem tags de substituição; carregamento aplica somente uma tag exclusiva da sessão e recusa colisão com conteúdo diferente. Config digest, ImageID e manifesto OCI são conferidos separadamente. A confiança na imagem continua necessária; validação de hashes não substitui auditoria ou política de vulnerabilidades.

Isolamento operacional e exclusão

CONTAINEROPS_SESSION limita o runtime a sessions/<slug> na raiz reservada, com validação de cada ancestral e recusa de links/junções/traversal. Lock, secrets, temporários, artefatos, cache e evidências usam o mesmo contexto. Tags e builder derivados impedem substituição acidental das identidades da demonstração; o daemon e os recursos do host continuam compartilhados.

Retenção atua sobre IDs internos exatos, com plano identificado e aplicação explícita sob lock. Latest, marcas, última cópia válida e último restore verificado por origem permanecem; cópias desconhecidas não são candidatas. Alteração desde o plano ou conteúdo inesperado interrompe a exclusão. Um journal permite retomar somente a tentativa aprovada. Os testes destrutivos usam fixtures temporárias; nenhum pruning dos backups existentes é necessário para validar a funcionalidade. A política dos dumps é separada da retenção de jobs no banco.

Os JSONs operacionais locais, incluindo backup.json e restore.json, podem conter caminhos absolutos e são vinculados pelo relatório HTML. Nas cópias desses registros do cenário operations e da prova de transferência, public_record substitui o prefixo literal do runtime por <runtime>. O cenário full arquiva os registros originais. Confira as evidências antes de compartilhá-las.

O HTML escapa os campos do catálogo e apresenta comandos locais; abrir a página não chama backup/restore. Uma cópia no mesmo host continua exposta à perda física dessa máquina.

COPS-01 Ocupação da fila por um proprietário

A revisão local encontrou um problema de disponibilidade: um Bearer válido podia criar os 100 jobs pendentes permitidos e fazer outro proprietário receber 429. No Compose, o atraso de demonstração aceita até 15 segundos por trabalho. A seleção FIFO global ainda deixava o segundo proprietário atrás de todo o backlog do primeiro, mesmo quando havia espaço para admitir seu pedido.

A correção mantém a demo e atua nos dois pontos:

  • A transação de admissão conta queued/running globais e do proprietário. O limite é 100 globais e 20 por proprietário, sob o mesmo lock da inserção. Réplicas da API não conseguem ultrapassar o limite por uma corrida entre contagem e gravação.
  • O despacho prioriza o proprietário sem execução anterior ou menos recentemente ativo. A escolha fica persistida antes do próximo despacho concorrente. Dentro da prioridade, o job mais antigo é escolhido. O cálculo continua fora do lock.
  • Replay idempotente é resolvido antes das quotas: permanece 200 no limite; conteúdo conflitante permanece 409. Excesso novo é 429 com Retry-After 2.
  • Jobs running consomem quota. Conclusão/falha terminal libera a vaga. Tentativas, lease, proteção contra worker antigo e o teto global permanecem ativos.

Não há migração de schema. API e worker precisam executar a imagem com a correção; retornar a uma imagem anterior também retorna ao comportamento anterior de fila.

Validação de 22/09/2026 UTC

A suíte completa com PostgreSQL real passou: 188 testes e 99 subtests, sem casos pulados. São 116 testes da aplicação (18 integrações), 30 da operação e 42 do relatório. Ruff, formatação e mypy estrito passaram. Os comandos executaram o código do checkout montado em /audit, com a imagem local de ferramentas containerops-test:local; não houve reconstrução das imagens de release nesta validação. Resultado JUnit e saída. O manifesto registra imagens, comando, hashes das fontes/locks e resultados. Permanecem duas advertências de depreciação de Starlette/httpx e AnyIO, sem falhas ou casos pulados.

As quatro regressões novas em app/tests/test_integration.py cobrem:

  1. Oito admissões simultâneas disputam a última vaga de Alice: uma cria, sete recebem limite; um job running é contado e sua conclusão libera uma vaga.
  2. Alice envia 20 trabalhos de demo de 15 s e recebe 429 no seguinte; Bob ainda recebe 201. Replay/conflict de Alice continuam 200/409. Bob é escolhido no segundo despacho, antes dos outros 19 jobs de Alice.
  3. Quatro workers disputam a fila: quatro leases distintas, duas para cada owner, mesmo quando todos os jobs de Alice são mais antigos.
  4. Despachos e conclusões sucessivos alternam entre dois backlogs, sem processar todos os jobs do primeiro proprietário antes do segundo.

O teste global existente agora preenche 99 vagas com vários proprietários e mantém a disputa atômica da centésima. Os testes anteriores de lease obsoleta, expiração, exaustão, pausa, retenção e schema compatível também passaram. A duração 15 s foi validada como entrada e persistência; estes testes não esperam 15 s por job nem constituem um teste de carga ou medição de latência.

Para repetir pela operação suportada: python scripts/ops.py build seguido de python scripts/ops.py verify. Isso cria a imagem atual e executa os testes de integração em banco descartável. Nunca configure CONTAINEROPS_TEST_DATABASE=1 contra o banco da demonstração: a fixture limpa seus dados.

Limites restantes

Na revisão de 03/10/2026, /v1/ recebeu limite de 100 requisições/s por peer, com rajada de 200, e Bearers válidos receberam 20/s por proprietário, com rajada de 40. A recepção do corpo tem prazo total de 3 s. Exceções inesperadas recebem resposta genérica, com categoria e ID no log. A revisão dos 18 itens registra os testes e o alcance desses controles.

O Compose mantém DEMO_MODE=true; definir false recusa durações positivas, mas não é necessário para que quota e distribuição funcionem. A fila não faz preempção: se todos os workers já executam jobs, um novo proprietário aguarda uma vaga de execução. A política baseada em atividade recente não é um SLA de latência nem garantia de pesos iguais; renovação/conclusão também contam como atividade, e o histórico some após a retenção de 24 horas.

Cinco owners podem consumir os 100 lugares juntos. A quota não é um limitador de requisições por segundo e não impede abuso com várias credenciais administradas fora da aplicação. Os tokens são locais e estáticos, o host é único, não há RLS nem transporte TLS na rede interna, e o backup local não cobre perda da máquina. Exposição pública exige revisar esses pressupostos, medir contenção no banco e definir política de identidade/admissão compatível com o uso real.

Esta revisão não substitui a evidência de build, recuperação e imagens em verification.md; aquela execução tem outro fingerprint e continua identificada como histórica.

There aren't any published security advisories