QATrax
Vedi in Markdown

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:

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).

LinguaggioNome 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():
Gofunc Test_T_MOD_01_aucune_vulnerabilite(t *testing.T)
C++ (CTest)add_test(NAME T_MOD_01_aucune_vulnerabilite COMMAND …)
Robot FrameworkT-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:

LinguaggioSBOM (CycloneDX JSON)Report dei test (così com’è)
Java — Mavenmvn org.cyclonedx:cyclonedx-maven-plugin:makeAggregateBom → target/bom.jsonmvn test → target/surefire-reports/TEST-*.xml
Java — Gradleplugin org.cyclonedx.bom, poi ./gradlew cyclonedxBom → build/reports/./gradlew test → build/test-results/test/TEST-*.xml
C# — .NETlo strumento CycloneDX (dotnet tool install --global CycloneDX), oppure Syftdotnet test --logger trx → TestResults/*.trx (TRX), oppure TestResult.xml di NUnit, oppure il JUnit di JunitXml.TestLogger
Pythonpip install cyclonedx-bom, poi cyclonedx-py environment --output-format JSON --output-file sbom.cyclonedx.jsonpytest --junitxml=resultats.xml
Java — TestNGcome Maven o Gradletestng-results.xml (nativo)
GoSyft`go test -v ./... 2>&1 \go-junit-report > resultats.xml`
C, C++ — CMakeSyftctest -T Test → Testing/<date>/Test.xml (oppure ctest --output-junit resultats.xml)
Robot FrameworkSyft (oppure lo strumento CycloneDX di Python)robot … → output.xml
BDD — Cucumber, Behavelo strumento del linguaggio--format json:cucumber.json; behave -f json -o behave.json
Allure (qualsiasi linguaggio)lo strumento del linguaggioallure-results/: jq -s . allure-results/*-result.json > allure.json per un solo caricamento
AltroSyft, 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).