Java, C#, Python, Go… — QATrax senza Node.js
Produrre la propria SBOM e il proprio report dei test con gli strumenti del proprio linguaggio, poi caricarli come qualsiasi cliente.
Autore: Dr Hamid MADANI <drmdh@msn.com>
QATrax non legge il Suo codice. Legge due file standard che tutti i linguaggi sanno produrre:
- la SBOM della Sua versione: CycloneDX o SPDX, in JSON;
- il report dei Suoi test, così come lo scrive il Suo strumento: JUnit XML (il più diffuso), NUnit, TRX, TestNG, Robot Framework, CTest, Cucumber JSON, Behave JSON, Allure 2, CTRF o TAP.
Lei non cambia né strumento né formato: sono anche quelli che leggono Xray, TestRail, Allure TestOps o Azure DevOps.
Il resto del percorso è lo stesso per tutti: In breve. I Suoi requisiti e il Suo piano di test si definiscono una volta, come per qualsiasi cliente: schede Requisiti e Piano Dev+Test.
1. Denominare i Suoi test secondo il Suo piano
Ogni test riporta, all’inizio del suo nome, il suo riferimento nel Suo piano (T-MOD-01). I linguaggi rifiutano il trattino nel nome di una funzione; lo scriva con dei _: è riconosciuto. In BDD (Cucumber, Behave), con Robot Framework o Allure, basta un’etichetta uguale al riferimento (@T-MOD-01).
| Linguaggio | Nome del test |
|---|---|
| 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é (oppure l’etichetta [Tags] T-MOD-01) |
| Cucumber, Behave | @T-MOD-01 sopra lo scenario |
Dettagli del formato: Formato dei risultati.
2. Produrre la SBOM e il report
Uno strumento per tutti i linguaggi: Syft legge la Sua cartella e produce la SBOM.
syft dir:. -o cyclonedx-json=sbom.cyclonedx.json
Può anche usare lo strumento CycloneDX del Suo linguaggio:
| Linguaggio | SBOM (CycloneDX JSON) | Report dei test (così com’è) | |
|---|---|---|---|
| Java — Maven | mvn org.cyclonedx:cyclonedx-maven-plugin:makeAggregateBom → target/bom.json | mvn test → target/surefire-reports/TEST-*.xml | |
| Java — Gradle | plugin org.cyclonedx.bom, poi ./gradlew cyclonedxBom → build/reports/ | ./gradlew test → build/test-results/test/TEST-*.xml | |
| C# — .NET | lo strumento CycloneDX (dotnet tool install --global CycloneDX), oppure Syft | dotnet test --logger trx → TestResults/*.trx (TRX), oppure TestResult.xml di NUnit, oppure il JUnit di JunitXml.TestLogger | |
| Python | pip install cyclonedx-bom, poi cyclonedx-py environment --output-format JSON --output-file sbom.cyclonedx.json | pytest --junitxml=resultats.xml | |
| Java — TestNG | come 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 (oppure ctest --output-junit resultats.xml) | |
| Robot Framework | Syft (oppure lo strumento CycloneDX di Python) | robot … → output.xml | |
| BDD — Cucumber, Behave | lo strumento del linguaggio | --format json:cucumber.json; behave -f json -o behave.json | |
| Allure (qualsiasi linguaggio) | lo strumento del linguaggio | allure-results/: jq -s . allure-results/*-result.json > allure.json per un solo caricamento | |
| Altro | Syft, oppure trivy fs --format cyclonedx --output sbom.cyclonedx.json . | qualsiasi strumento che scriva uno di questi formati, JUnit XML o TAP |
3. Caricare i due file
Dall’interfaccia. Scheda Percorso: carichi la SBOM al passo ③, poi il report al passo ② (oppure nella scheda Esecuzioni). Il report è collegato alla versione scelta in alto nella pagina.
Dalla Sua CI. Crei una chiave nella scheda Progetti, colonna Chiavi CI, poi invii i due file con curl. Indichi la versione (version=) in entrambi gli invii: è essa che colloca i Suoi test nel fascicolo di quella versione.
V=1.4.0 # la versione che consegna
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
Il content-type conta poco: il formato è riconosciuto dal contenuto (.trx, output.xml, Test.xml, cucumber.json… si inviano allo stesso modo). Se ha più file di report (uno per classe di test con Maven e Gradle, uno per test con Allure), li invii uno alla volta, oppure riunisca i risultati Allure in un array.
La risposta indica il formato letto, il numero di test riconosciuti nel Suo piano e quelli che non lo sono stati.
3 bis. Facoltativo: il rapporto di validazione sigillato, come in Node.js
Se la Sua CI dispone di Node.js (versione 18 o superiore, presente nella maggior parte delle immagini), @mostajs/mjs-unit può leggere il report del Suo strumento. Non riesegue alcun test. Ne ricava il rapporto di validazione sigillato, collegato alla Sua SBOM e al Suo piano, e lo invia con il piano e la SBOM. Non deve scrivere alcun JavaScript.
# Java (Maven): i report Surefire; .NET: TestResults (i .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 # legge i report, scrive il rapporto di validazione sigillato
npx -y -p @mostajs/mjs-unit mjs-unit-menu --choix=4 # invia il piano, la SBOM, poi il rapporto di validazione
Con il rapporto di validazione, qatrax esegue due verifiche in più: il report non è stato ritoccato dopo la sua lettura, ed è proprio la SBOM caricata a essere stata messa alla prova.
4. Emettere
È la stessa conclusione di qualsiasi cliente: scheda SBOM/Vulnerabilità, valuti ciascuna; poi scheda Consegna → Emetti e sigilla.
Che cosa cambia rispetto a Node.js
Il verdetto e il certificato sono gli stessi. Una sola differenza: il rapporto di validazione sigillato. Se invia il Suo JUnit o il Suo TAP direttamente (curl), qatrax non esegue le due verifiche del rapporto di validazione. Le esegue se passa da mjs-unit in modalità lettore (§ 3 bis).