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.

Fontes