Java, C#, Python, Go… — QATrax sin Node.js
Producir su SBOM y su informe de pruebas con las herramientas de su lenguaje y cargarlos como cualquier cliente.
Autor: Dr Hamid MADANI <drmdh@msn.com>
QATrax no lee su código. Lee dos archivos estándar que todos los lenguajes saben producir:
- la SBOM de su versión: CycloneDX o SPDX, en JSON;
- el informe de sus pruebas, tal como lo escribe su herramienta: JUnit XML (el más extendido), NUnit, TRX, TestNG, Robot Framework, CTest, Cucumber JSON, Behave JSON, Allure 2, CTRF o TAP.
No cambia de herramienta ni de formato: son también los que leen Xray, TestRail, Allure TestOps o Azure DevOps.
El resto del camino es el mismo para todos: En resumen. Sus requisitos y su plan de pruebas se establecen una sola vez, como para cualquier cliente: pestañas Requisitos y Plan Dev+Test.
1. Nombrar sus pruebas según su plan
Cada prueba lleva, al principio de su nombre, su referencia en su plan (T-MOD-01). Los lenguajes no admiten el guion en el nombre de una función; escríbala con _: se reconoce. En BDD (Cucumber, Behave), con Robot Framework o Allure, basta una etiqueta igual a la referencia (@T-MOD-01).
| Lenguaje | Nombre de la prueba |
|---|---|
| Java (JUnit) | void test_T_MOD_01_aucune_vulnerabilite() |
| C# (xUnit, NUnit, MSTest) | public void test_T_MOD_01_aucune_vulnerabilite() |
| Python (pytest) | def test_T_MOD_01_aucune_vulnerabilite(): |
| Go | func Test_T_MOD_01_aucune_vulnerabilite(t *testing.T) |
| C++ (CTest) | add_test(NAME T_MOD_01_aucune_vulnerabilite COMMAND …) |
| Robot Framework | T-MOD-01 Aucune vulnérabilité (o la etiqueta [Tags] T-MOD-01) |
| Cucumber, Behave | @T-MOD-01 encima del escenario |
Detalle del formato: Formato de los resultados.
2. Producir la SBOM y el informe
Una herramienta para todos los lenguajes: Syft lee su carpeta y produce la SBOM.
syft dir:. -o cyclonedx-json=sbom.cyclonedx.json
También puede usar la herramienta CycloneDX de su lenguaje:
| Lenguaje | SBOM (CycloneDX JSON) | Informe de pruebas (tal cual) | |
|---|---|---|---|
| Java — Maven | mvn org.cyclonedx:cyclonedx-maven-plugin:makeAggregateBom → target/bom.json | mvn test → target/surefire-reports/TEST-*.xml | |
| Java — Gradle | complemento org.cyclonedx.bom, después ./gradlew cyclonedxBom → build/reports/ | ./gradlew test → build/test-results/test/TEST-*.xml | |
| C# — .NET | la herramienta CycloneDX (dotnet tool install --global CycloneDX), o Syft | dotnet test --logger trx → TestResults/*.trx (TRX), o TestResult.xml de NUnit, o el JUnit de JunitXml.TestLogger | |
| Python | pip install cyclonedx-bom, después cyclonedx-py environment --output-format JSON --output-file sbom.cyclonedx.json | pytest --junitxml=resultats.xml | |
| Java — TestNG | como Maven o Gradle | testng-results.xml (nativo) | |
| Go | Syft | `go test -v ./... 2>&1 \ | go-junit-report > resultats.xml` |
| C, C++ — CMake | Syft | ctest -T Test → Testing/<date>/Test.xml (o ctest --output-junit resultats.xml) | |
| Robot Framework | Syft (o la herramienta CycloneDX de Python) | robot … → output.xml | |
| BDD — Cucumber, Behave | la herramienta del lenguaje | --format json:cucumber.json ; behave -f json -o behave.json | |
| Allure (cualquier lenguaje) | la herramienta del lenguaje | allure-results/ : jq -s . allure-results/*-result.json > allure.json para una sola carga | |
| Otro | Syft, o trivy fs --format cyclonedx --output sbom.cyclonedx.json . | cualquier herramienta que escriba uno de estos formatos, JUnit XML o TAP |
3. Cargar los dos archivos
Por la interfaz. Pestaña Recorrido: cargue la SBOM en el paso ③ y después el informe en el paso ② (o en la pestaña Ejecuciones). El informe se vincula a la versión elegida en la parte superior de la página.
Por su CI. Cree una clave en la pestaña Proyectos, columna Claves de CI, y envíe los dos archivos con curl. Indique la versión (version=) en los dos envíos: es ella la que coloca sus pruebas en el expediente de esa versión.
V=1.4.0 # la versión que entrega
curl -fsS -X POST "$QATRAX_URL/sbom?p=$QATRAX_PROJET&version=$V" \
-H "Authorization: Bearer $QATRAX_CLE" -H "content-type: application/json" \
--data-binary @sbom.cyclonedx.json
curl -fsS -X POST "$QATRAX_URL/runs?p=$QATRAX_PROJET&version=$V&format=json" \
-H "Authorization: Bearer $QATRAX_CLE" -H "content-type: application/xml" \
--data-binary @resultats.xml
El content-type importa poco: el formato se reconoce por el contenido (.trx, output.xml, Test.xml, cucumber.json… se envían de la misma manera). Si tiene varios archivos de informe (uno por clase de prueba en Maven y Gradle, uno por prueba en Allure), envíelos uno a uno, o reúna los resultados de Allure en una matriz.
La respuesta indica el formato leído, el número de pruebas reconocidas en su plan y las que no lo han sido.
3 bis. Opcional: el informe de validación sellado, como en Node.js
Si su CI tiene Node.js (versión 18 o superior, presente en la mayoría de las imágenes), @mostajs/mjs-unit puede leer el informe de su herramienta. No vuelve a lanzar ninguna prueba. Elabora con él el informe de validación sellado, vinculado a su SBOM y a su plan, y lo envía con el plan y la SBOM. No tiene que escribir nada de JavaScript.
# Java (Maven): los informes Surefire; .NET: TestResults (los .trx); Robot: output.xml; Allure: allure-results
export MJS_DEPUIS=target/surefire-reports MJS_SBOM=target/bom.json MJS_PLAN=plan.json
export QATRAX_URL=… QATRAX_CLE=… QATRAX_PROJET=…
npx -y -p @mostajs/mjs-unit mjs-unit-menu --choix=3 # lee los informes, escribe el informe de validación sellado
npx -y -p @mostajs/mjs-unit mjs-unit-menu --choix=4 # envía el plan, la SBOM y después el informe de validación
Con el informe de validación, qatrax hace dos verificaciones más: el informe de pruebas no se ha retocado después de su lectura, y la SBOM probada es efectivamente la que se cargó.
4. Emitir
Es el mismo final que para cualquier cliente: pestaña SBOM/Vulnerabilidades, resuelva cada una; después, pestaña Entregable → Emitir y sellar.
Lo que cambia respecto a Node.js
El veredicto y el certificado son los mismos. Una sola diferencia: el informe de validación sellado. Si envía su JUnit o su TAP directamente (curl), qatrax no hace las dos verificaciones del informe de validación. Las hace si pasa por mjs-unit en modo lector (§ 3 bis).