Funcionalidade seguranca actions - BrunodosSantosVaz/big-bang GitHub Wiki

Auditoria de segurança

Funcionalidade BB-F-036 · requisito RF-BB-036 · versão documentada 2.0.1 · código 9c73feb3e357a1216011eaf64bf4b5d944827087.

Finalidade

Manter scanners de segredos, código, dependências e banco ativos e bloquear vulnerabilidade alta ou crítica.

Atores

Pessoa responsável pelo projeto, IA com posse confirmada e automações explicitamente autorizadas.

Pré-condições

Repositório e raiz corretos, versão instalada e configuração compatível. Para operações de escrita, exige-se autorização vigente, branch adequada e acesso ao recurso envolvido; consultas não conferem permissão adicional.

Fluxo principal

Executar scanners fixados por versão e hash; conferir código, histórico e pacote do front; avaliar OSV e RLS; reportar achados e falhar os controles correspondentes.

Validações

Não se desliga scanner para entregar; exceção exige decisão e ADR; dependência e configuração sensível passam pelo modelo de revisão.

Alternativas e erros

Achado, download inválido ou retorno de scanner reprovado bloqueia CI; erro de acesso não equivale a auditoria limpa.

Permissões

Leitura usa permissões mínimas do repositório. Operações locais respeitam a posse e worktree; escrita no GitHub exige acesso explícito. Esta funcionalidade não concede novas permissões a visitantes nem substitui decisões exigidas pelo fluxo.

Resultados

Resultado esperado: Manter scanners de segredos, código, dependências e banco ativos e bloquear vulnerabilidade alta ou crítica. O retorno e os arquivos afetados são conferidos pelos cenários rastreados abaixo; falha impede considerar a operação concluída.

Referência da implementação

Os símbolos abaixo compõem o inventário real do módulo, incluindo auxiliares internos; não representam APIs públicas independentes.

seguranca.sh

Implementação revisada.

Cenários e rastreabilidade

Requisitos · Matriz de rastreabilidade · Referência CLI

Fontes rastreadas