¿Se admite el archivo de bloqueo?
El árbol opcional admite package-lock.json de npm y yarn.lock de Yarn v1. Para pnpm o Bun utiliza un lector externo y registra la cobertura pendiente; un árbol vacío o fallido no demuestra ausencia de dependencias.
Elysia Tools
导航
Workflow Playbook
Fija el inventario de una versión Node.js, revisa un SBOM externo con una política de licencias aprobada y entrega cambios, excepciones y pruebas de aprobación trazables.
第一次接触这个流程?按步骤顺序来,从下面第一个工具开始。已经知道自己需要什么?直接跳到对应的步骤——本流程用到的全部工具都在下面的对比表里。
专题
| 工具 | 用来做什么 | 分类 |
|---|---|---|
| Verificador de Hash de Archivo | Calcula valores hash MD5/SHA1/SHA256 para archivos y verifica contra hashes esperados | Utilities |
| Auditor de dependencias de package.json | Audita un package.json en busca de higiene de dependencias y calidad de rangos de versión, y opcionalmente inspecciona el árbol transitivo desde package-lock.json o yarn.lock. Señala duplicados, comodines o pre-release, claves sin ordenar, metadatos ausentes y dependencias runtime/dev mal clasificadas. | Development |
专题
| Valida números de versión según Semantic Versioning 2.0.0 (formato x.y.z-alpha.1) |
| Validation |
| Validador de JSON Schema | Valida datos JSON contra un JSON Schema para verificar estructura y tipos de datos | Validation |
| Auditor de políticas de licencias SBOM SPDX / CycloneDX | Audita licencias de componentes SPDX 2.3 o CycloneDX 1.5 y genera SARIF con rutas de dependencia | Development |
| Visualizador de diferencias JSON | Compara dos JSON y genera un informe visual con colores, rutas y estadisticas | Development |
| Linter Markdown | Comprueba Markdown por problemas de estilo: niveles de encabezado, cercas de código, consistencia de listas y más (motor de reglas sin dependencias) | Development |
| Convertidor de Markdown a PDF | Convertir archivos Markdown a documentos PDF con formato, resaltado de sintaxis y estilo | Document Tools |
Este recorrido sirve a responsables de proyectos Node.js que necesitan entregar una revisión comprobable antes de publicar. Reúne el artefacto exacto, revisión de código, package.json, archivo de bloqueo y SBOM generado externamente. Anota generador, ajustes e inclusión de dependencias de desarrollo. Calcula huellas de cada original y explica qué compilación representa. El bloqueo describe una resolución: el empaquetado y las dependencias opcionales o específicas de plataforma pueden cambiar lo distribuido. Sin vínculo con el artefacto, la cobertura sigue pendiente.
Confirma autorización antes de enviar nombres privados o direcciones internas y nunca incluyas credenciales del registro. Conserva por separado originales y copias censuradas, con huellas propias y una correspondencia controlada. Este flujo no instala paquetes, genera SBOM, inspecciona el archivo final ni busca vulnerabilidades.
El auditor revisa package.json y ofrece árbol opcional para package-lock.json de npm o yarn.lock de Yarn v1. Un bloqueo pnpm o Bun requiere un lector externo; convertirlo solo para adaptarlo al formulario no demuestra cobertura equivalente. Sin bloqueo utilizable, las conclusiones se limitan a declaraciones. Registra origen del árbol, profundidad y avisos: un resultado vacío tras un fallo no significa que no haya dependencias.
Por ejemplo, ^2.4.0 es un rango declarado y 2.4.3 una versión resuelta. Usa SemVer para la segunda y documenta aparte referencias Git, etiquetas y espacios de trabajo. La validación JSON exige aportar el esquema correspondiente y un dialecto compatible. Estructura correcta no equivale a inventario completo ni a metadatos veraces. El auditor de política admite SPDX 2.3 JSON y CycloneDX 1.5 JSON/XML; las ramas de esquema y comparación JSON no validan XML. Conserva XML original y aplica comprobaciones externas adecuadas.
Registra ajustes reales del perfil, tolerancia copyleft, listas permitidas y denegadas y tratamiento de desconocidas. Un nombre de perfil sin su configuración puede resultar ambiguo al cambiar versiones. Guarda el reporte Markdown o SARIF; si necesitas ambos, ejecuta cada formato con los mismos datos y ajustes. Conserva expresiones completas, incluidos AND, OR y WITH, y solicita revisión de textos y obligaciones. No reduzcas una expresión a su fragmento más permisivo.
Examina cada hallazgo y su ruta disponible. Una ruta ausente puede indicar relaciones incompletas del SBOM, no aislamiento. Compara JSON con el inventario aprobado anterior y reconcilia manualmente identidad, versión y licencia. Orden de arrays, marcas de tiempo e identificadores generados producen ruido; el comparador no empareja paquetes semánticamente. Explica altas, bajas y cambios inesperados. Una excepción necesita responsable, motivo, publicación afectada, alcance y vencimiento, no una modificación silenciosa de la lista permitida.
Mantén un registro Markdown independiente con identidad de versión, huellas de artefacto y SBOM, revisión de política, componente, versión, expresión exacta, ruta o ausencia, evidencia, decisión y responsable. Son campos recomendados para revisión, no una promesa de que el reporte los genere todos. Marca pendientes sin evidencia como pendientes o bloqueados. Si cambian entradas o política, repite comprobaciones y conserva las revisiones anteriores.
El comprobador Markdown ayuda con presentación, no con conclusiones jurídicas. Revisa cualquier PDF: tablas, identificadores y rutas largas pueden quedar cortados. Conserva fuente íntegra y reportes legibles por máquina, incluso si el PDF parece correcto. Archiva archivos locales con sus huellas finales; los enlaces temporales no sustituyen un archivo. SARIF no configura por sí mismo una barrera de CI. El flujo de contenedores cubre Dockerfile y entorno; el de diferencias amplía comparaciones y el de firmas sirve cuando debes verificar autoría, no solo igualdad de bytes.
Guía de flujo de trabajo
Registra huellas, revisión de código y configuración del generador SBOM. Distingue las declaraciones de package.json de lo realmente distribuido.
Audita manifiesto y bloqueo admitido, comprueba versiones resueltas y valida JSON con su esquema. Conserva advertencias y formatos sin cobertura.
Procesa el SBOM externo con los ajustes registrados. Guarda Markdown o SARIF y revisa licencias desconocidas, expresiones completas y rutas ausentes.
El árbol opcional admite package-lock.json de npm y yarn.lock de Yarn v1. Para pnpm o Bun utiliza un lector externo y registra la cobertura pendiente; un árbol vacío o fallido no demuestra ausencia de dependencias.
Valida JSON con un esquema compatible aportado por ti y compara sus diferencias. El auditor admite CycloneDX XML compatible, pero validar y comparar XML requiere otra ruta, no una conversión supuestamente sin pérdidas.
Mantén pendientes las licencias desconocidas, las fuentes ausentes y los fallos hasta que un responsable revise las pruebas o autorice una excepción delimitada. Un resultado positivo no acredita cumplimiento legal ni ausencia de vulnerabilidades.
Compara JSON actual y aprobado, reconcilia componentes y descarta ruido de ordenación. Repite tras correcciones y asigna alcance, responsable y caducidad a las excepciones.
Comprueba el registro Markdown y, si procede, el PDF con tablas y rutas largas. Calcula huellas finales y archiva reportes, advertencias y decisión.