A origem registrada junto do artefato
A provenance de software é um registro verificável de onde e como um artefato foi produzido, como um pacote distribuído para instalação. Sua declaração de proveniência relaciona esse resultado ao código de origem e ao processo de build, que prepara o software para distribuição.
No npm, essa associação usa declarações assinadas por meio do Sigstore e registradas em um serviço público de transparência. Você pode conferir a origem declarada e consultar as instruções de construção. O registro permite investigar uma publicação feita a partir de um repositório diferente do esperado.
Verificação das dependências instaladas
O npm documenta este comando para verificar assinaturas e atestações das dependências já instaladas no projeto:
npm audit signaturesO relatório apresenta quantos pacotes tiveram assinaturas verificadas e quantos tiveram atestações verificadas. Os totais podem ser diferentes, pois uma assinatura do registry e uma atestação de proveniência são registros distintos. Um resultado de verificação precisa ser interpretado junto da origem indicada pelo pacote.
A associação confirmada ainda pode levar a código com falhas ou comportamento malicioso. A revisão do código e os testes continuam necessários para avaliar o que a dependência faz na aplicação. As condições para gerar e verificar a declaração estão na documentação de provenance do npm.
Dúvidas frequentes
Perguntas frequentes sobre provenance
- O que uma verificação de provenance confirma?
- Ela confere a associação declarada entre o pacote e sua construção. No npm, isso permite examinar a origem e as instruções de build, mas não comprova a ausência de código malicioso.
- Um hash fornece a mesma informação?
- O hash permite comparar o conteúdo de um arquivo com uma referência. A provenance acrescenta informações sobre a produção desse arquivo, como o código de origem e o sistema de build.
- Toda publicação no npm inclui provenance?
- A presença da declaração depende do método de publicação e dos requisitos do npm. Uma versão sem declaração não oferece essa associação verificável para consulta.
Para continuar
Recursos relacionados
Documentação
npm: declarações de provenance
Explica como gerar declarações, quais ambientes são aceitos e como verificar as atestações dos pacotes instalados.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para investigar o processo de build e publicação de uma dependência usada na aplicação.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O desenvolvimento com agentes exige compreender o comportamento da aplicação e conferir o resultado das alterações.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.