Tempo de leitura estimado : 5 min · Publicado
Conecte cada dependência ao seu propósito
Componentes diretos de inventário e dependências trazidas pelas ferramentas. Registre a versão instalada, registro ou fornecedor, recurso compatível e proprietário de atualização. Inclua plugins do CMS em vez de apenas pacotes gerenciados pelo desenvolvedor.
Faça uma pergunta de simplificação: se o recurso desaparecesse, qual jornada útil seria perdida? Um componente instalado, mas esquecido, adiciona trabalho sem estabelecer seu valor. Considere a remoção somente após verificar o conteúdo, dados e componentes dependentes.
Avalie um alerta contra o projeto real
Compare o pacote e a versão afetados com o inventário. Examine as condições de exposição, a correção anunciada e as dependências relacionadas. Um alerta não descreve toda a arquitetura e a ausência de alertas não é uma garantia de segurança.
Documente um motivo de prioridade: funcionalidade exposta, dados afetados, exploração conhecida ou alteração necessária. Quando a situação for incerta, envolva um revisor qualificado em vez de substituir a incerteza por uma pontuação apresentada como certeza.
Prepare uma atualização reproduzível
Mantenha arquivos descrevendo as versões resolvidas e construir etapas. Use um ambiente de teste representativo, dados sintéticos e um backup adequado. Compare jornadas afetadas, como busca, formulários, check-out ou administração de acordo com o componente.
O NPM Provenance conecta um pacote publicado com informações de origem e construção; Não certifica que o pacote é seguro. Revise as evidências disponíveis sem tratar a proveniência como uma recomendação de instalação automática.
Exemplo fictício: DEMO-PKG é declarado pela gama ^2.4.0, mas o ficheiro de bloqueio e a referência do artefacto publicado indicam 2.4.1. O aviso inventado para o exercício abrange 2.4.0 a 2.4.2 e propõe 2.4.3. A declaração já permite essa correção nas versões estáveis compatíveis; não demonstra que tenha sido resolvida, construída ou publicada.
No npm, npm ci usa o bloqueio existente e não o atualiza para escolher uma correção mais recente. Compare declaração, versão resolvida, artefacto construído e versão realmente servida. Após uma atualização preparada, a tabela exige a reconciliação com 2.4.3 e testes do percurso afetado. A versão e o aviso são fictícios; a concordância não garante ausência de outros defeitos.
Desloque a tabela horizontalmente para ler todas as colunas. Com o teclado, coloque o foco na tabela e utilize as teclas de seta.
| Referência verificada | Valor do exercício | O que demonstra |
|---|---|---|
| Declaração no manifesto | ^2.4.0 | Gama estável permitida, não versão publicada |
| Bloqueio antes da correção | 2.4.1 | Versão resolvida ainda abrangida pelo aviso fictício |
| Artefacto publicado antes da correção | Referência 2.4.1 | Correção 2.4.3 ainda não comprovada em produção |
| Após atualização controlada | Bloqueio, construção e artefacto servido: 2.4.3 | Reconciliação esperada, depois testes funcionais e decisão de publicação |
- npm : npm ci
npm, consultado em 22 de outubro de 2026: comportamento de npm ci. DEMO-PKG, versões e aviso formam um cenário fictício.
- npm/node-semver : Caret Ranges
npm/node-semver, consultado em 22 de outubro de 2026: gamas de versões e regras das versões preliminares.
Registre o resultado e o plano de recuperação
Registre as versões antes e depois, testes passados, áreas não verificadas e a decisão de liberação. A recuperação deve incluir dados quando uma atualização altera sua estrutura; Substituir arquivos por si só pode ser insuficiente.
Escolha a próxima revisão de acordo com a função do componente e a capacidade da equipe. A entrega é uma lista de componentes úteis com origem, proprietário, testes e recuperação, em vez de um cronograma de alterações automatizadas cegas.
Documentação principal: npm : Generating provenance statements.
Controlar ficheiros JavaScript ou CSS externos com versão fixa.
Caso fictício: um componente carrega um ficheiro versionado de uma CDN. Calcule a impressão exata e verifique CORS. Altere a cópia de teste: deve ser recusada. Scripts que mudam automaticamente exigem outra estratégia; uma impressão antiga impede o carregamento.
- A versão esperada funciona, a alterada é bloqueada e as atualizações estão previstas.
- MDN Subresource Integrity
Mecanismo para comparar um recurso descarregado com uma impressão esperada antes da utilização.
Decidir numa situação concreta
Exemplo fictício: atualização corrige problema e quebra extensão essencial. Identifique usos e versões, prepare ensaio isolado e alternativa; instalar não termina tarefa.
Registe dependência direta ou indireta, versão, uso, responsável e teste. Guarde configuração reproduzível sem segredos; relacione avisos com componente e contexto implantados.
- Proteger e verificar a pré-produção
Separe o ambiente de teste do site público, limite o acesso e use dados de teste. Verifique formulários sem contactar clientes reais. Antes de publicar, reveja autenticação, noindex, URL canónicos e ligações externas. robots.txt não substitui proteção de acesso.
Documentos de referência
- MDN Subresource Integrity · Fonte consultada
- npm : Generating provenance statements
Conteúdo atualizado
