Times que já geram SBOMs e ainda tropeçam para responder quais aplicações dependem de um pacote comprometido encontram no GUAC uma saída direta. O projeto, incubado pela OpenSSF dentro do grupo Supply Chain Integrity, agrega metadados de segurança em um grafo consultável de toda a cadeia de software, em vez de um documento por vez. A ferramenta interessa a equipes de desenvolvimento, operações, segurança e escritórios de open source que precisam priorizar correções e avaliar fornecedores críticos; a ação prioritária é centralizar os SBOMs e atestações que a organização já produz e passar a consultar dependências por pacote, por aplicação e por dono.
O problema: SBOMs soltos
A maioria das empresas já gera algum artefato de transparência: SBOM produzido no build, atestação assinada no pipeline, relatório de vulnerabilidade do scanner. O problema é que cada documento vive isolado. A página oficial do projeto resume a lacuna: as ferramentas existentes param na geração e deixam para você descobrir como tudo se encaixa. Quando surge um pacote malicioso ou uma falha grave, a pergunta operacional — quais sistemas são afetados e quem responde por eles — depende de alguém cruzar planilhas, repositórios e consoles na mão, com risco de resposta tardia justamente no momento em que cada hora conta.
O GUAC, criado por Kusari, Google e Purdue University, ataca exatamente essa lacuna. Em vez de mais um gerador de SBOM, o projeto ocupa a camada de agregação e síntese do modelo de transparência da cadeia de software: recebe os metadados que a organização já produz, normaliza as identidades dos artefatos e monta as relações entre eles. O resultado é um grafo em que cada nó é um artefato, pacote ou repositório, e cada aresta é uma dependência, uma atestação ou uma evidência de vulnerabilidade. A partir do mesmo dado, o time de segurança pergunta por risco, o time de compliance pergunta por evidência e os desenvolvedores perguntam por impacto de mudança.
Como o GUAC monta o grafo
A ingestão aceita SBOMs em SPDX e CycloneDX, atestações SLSA e in-toto, dados do deps.dev e do OSV, além de resultados do OpenSSF Scorecard. Documentos de fontes diferentes são convertidos para um modelo comum, o que permite responder perguntas que nenhum documento isolado responde: qual aplicação depende de um pacote específico; quais binários em produção não têm atestado de proveniência; quais componentes exibem version sprawl, com várias versões da mesma dependência convivas no portfólio; quais upstreams estratégicos mantêm práticas fracas de segurança segundo os critérios que já detalhamos no guia de auditoria de dependências com OpenSSF Scorecard.
A consulta acontece por uma API GraphQL — no empacotamento padrão, o playground responde em http://localhost:8080/query — e por uma interface de visualização que retrata o estado corrente do portfólio. O repositório oficial, publicado sob licença Apache 2.0, oferece um quickstart com docker compose e um devcontainer que sobe a pilha completa localmente, incluindo os coletores do deps.dev, do OSV e do ClearlyDefined. Isso reduz a barreira de entrada: dá para validar o valor do grafo em um notebook antes de discutir arquitetura de produção.
Do ponto de vista de governança, o grafo também serve como prova. Auditorias de cadeia de software cada vez mais cobram evidência de que cada binário em produção rastreia um repositório gerenciado e um processo de build conhecido. Com as relações centralizadas, verificar essa cadeia deixa de ser amostragem manual e passa a ser consulta.
Ingestão de SBOMs na prática
Para um teste manual, basta apontar o cliente de linhaha de comando para um arquivo: guacone collect files my-sbom.spdx.json. A coleta também funciona com diretórios usando globs do shell, o que permite carregar de uma vez o acervo de SBOMs acumulado pelo CI ao longo dos meses. Em operação contínua, o modo daemon usa coletores que fazem polling em intervalos configurados e alimentam o grafo de forma permanente, inclusive a partir de blob storage e de repositórios externos de pacotes. A regra prática é equilibrar a frequência da coleta com a carga gerada, e monitorar a conectividade entre o GUAC e as fontes para não acumular atraso silencioso de ingestão.
Um efeito imediato da centralização é a visibilidade dos pacotes internos. Conflitos de namespace, como os explorados em ataques de dependency confusion, ficam evidentes quando o grafo mostra o mesmo identificador publicado em registries públicos e privados. Antes de automatizar políticas de admissão, vale auditar quantos pacotes internos usam nomes que também existem em registries públicos e definir a fronteira de confiança de cada origem.
Certificação e consulta de vulnerabilidades
O grafo sozinho descreve estrutura; o certificador OSV adiciona a camada de risco. O componente correlaciona os pacotes do grafo com a base OSV em ciclos programados: ele extrai nomes, versões e identificadores de ecossistema dos SBOMs, consulta o banco em lote e grava os resultados como atestados no padrão in-toto, associados às versões exatas de cada pacote. A cobertura documentada inclui npm, PyPI, Maven, Go, Cargo e NuGet, além de um conjunto amplo de distribuições, linguagens e fontes como GitHub Actions e o kernel do Linux.
Os limites precisam entrar no runbook. O certificador só enxerga o que está publicado no OSV: não detecta vulnerabilidades privadas, não cobre software proprietário, não faz varredura de binários e depende de SBOM válido como entrada. Trate o resultado como sinal de priorização, não como inventário completo de risco — a decisão de corrigir continua combinando criticidade de negócio, exposição e evidência de exploração.
Procedimento para começar hoje
| Etapa | Comando ou configuração | Resultado esperado |
|---|---|---|
| Subir a pilha | docker compose do quickstart oficial | GraphQL, REST, ingestor e coletores locais |
| Coletar acervo | guacone collect files seguido do caminho | SBOMs do portfólio dentro do grafo |
| Certificar com OSV | guacone certifier osv | Vulnerabilidades ligadas às versões dos pacotes |
| Consultar | GraphQL em localhost:8080/query | Respostas por pacote, aplicação e dono |
| Operar contínuo | modo daemon com coletores em polling | Grafo atualizado sem intervenção manual |
Do ponto de vista defensivo, a implantação mínima tem valor mensurável em um incidente: com o grafo populado, o raio de blast de um pacote ruim é uma consulta, não uma investigação. O time pergunta quais aplicações alcançam o pacote afetado, desde quando a dependência existe e qual dono responde pela remoção — as três respostas que demoram horas quando os SBOMs estão soltos.
Prioridades, sinais e limites
- P1 — carregar no grafo os SBOMs das aplicações de produção e garantir que qualquer consulta de impacto por pacote seja respondida em minutos, não em dias.
- P1 — programar o certificador OSV com polling e definir quem recebe os resultados e com qual prazo de triagem.
- P2 — apontar lacunas de evidência: aplicação sem SBOM, build sem atestado SLSA, dependência sem dono declarado.
- P2 — usar SBOM diff entre versões para enxergar mudanças de composição a cada release e ranquear upstreams por resultados de Scorecard para decidir substituição ou endurecimento.
Sinais de maturidade do grafo: toda aplicação em produção tem SBOM associado; todo binário crítico rastreia um repositório gerenciado; o diff de versões faz parte do ritual de release; e a consulta por pacote afetado retorna dono, versões e caminhos de dependência em uma única chamada.
Por fim, calibre a expectativa: o repositório oficial avisa que o GUAC está em desenvolvimento ativo. A arquitetura de coletores, ingestores e certificadores é plugável, mas interfaces podem mudar. A recomendação é tratar a implantação como infraestrutura em evolução, com ambiente de teste separado e pin de versão, em vez de assumir estabilidade de API de longo prazo.