Java, C#, Python, Go… — QATrax sans Node.js
Produire sa SBOM et son rapport d’essais avec les outils de son langage, puis les déposer comme tout client.
Auteur : Dr Hamid MADANI <drmdh@msn.com>
QATrax ne lit pas votre code. Il lit deux fichiers standard que tous les langages savent produire :
- la SBOM de votre version : CycloneDX ou SPDX, en JSON ;
- le rapport de vos essais, tel que votre outil l’écrit : JUnit XML (le plus répandu), NUnit, TRX, TestNG, Robot Framework, CTest, Cucumber JSON, Behave JSON, Allure 2, CTRF ou TAP.
Vous ne changez ni d’outil, ni de format : ce sont aussi ceux que lisent Xray, TestRail, Allure TestOps ou Azure DevOps.
Le reste du chemin est le même pour tous : En bref. Vos exigences et votre plan d’essais se posent une fois, comme pour tout client : onglets Exigences et Plan Dev+Test.
1. Nommer vos essais d’après votre plan
Chaque essai porte, en tête de son nom, sa référence dans votre plan (T-MOD-01). Les langages refusent le tiret dans un nom de fonction ; écrivez-la avec des _ : elle est reconnue. En BDD (Cucumber, Behave), avec Robot Framework ou Allure, une étiquette égale à la référence suffit (@T-MOD-01).
| Langage | Nom de l’essai |
|---|---|
| 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é (ou l’étiquette [Tags] T-MOD-01) |
| Cucumber, Behave | @T-MOD-01 au-dessus du scénario |
Détail du format : Format des résultats.
2. Produire la SBOM et le rapport
Un outil pour tous les langages : Syft lit votre dossier et produit la SBOM.
syft dir:. -o cyclonedx-json=sbom.cyclonedx.json
Vous pouvez aussi utiliser l’outil CycloneDX de votre langage :
| Langage | SBOM (CycloneDX JSON) | Rapport d’essais (tel quel) | |
|---|---|---|---|
| Java — Maven | mvn org.cyclonedx:cyclonedx-maven-plugin:makeAggregateBom → target/bom.json | mvn test → target/surefire-reports/TEST-*.xml | |
| Java — Gradle | greffon org.cyclonedx.bom, puis ./gradlew cyclonedxBom → build/reports/ | ./gradlew test → build/test-results/test/TEST-*.xml | |
| C# — .NET | l’outil CycloneDX (dotnet tool install --global CycloneDX), ou Syft | dotnet test --logger trx → TestResults/*.trx (TRX), ou TestResult.xml de NUnit, ou le JUnit de JunitXml.TestLogger | |
| Python | pip install cyclonedx-bom, puis cyclonedx-py environment --output-format JSON --output-file sbom.cyclonedx.json | pytest --junitxml=resultats.xml | |
| Java — TestNG | comme Maven ou Gradle | testng-results.xml (natif) | |
| Go | Syft | `go test -v ./... 2>&1 \ | go-junit-report > resultats.xml` |
| C, C++ — CMake | Syft | ctest -T Test → Testing/<date>/Test.xml (ou ctest --output-junit resultats.xml) | |
| Robot Framework | Syft (ou l’outil CycloneDX de Python) | robot … → output.xml | |
| BDD — Cucumber, Behave | l’outil du langage | --format json:cucumber.json ; behave -f json -o behave.json | |
| Allure (tout langage) | l’outil du langage | allure-results/ : jq -s . allure-results/*-result.json > allure.json pour un seul dépôt | |
| Autre | Syft, ou trivy fs --format cyclonedx --output sbom.cyclonedx.json . | tout outil qui écrit l’un de ces formats, JUnit XML ou TAP |
3. Déposer les deux fichiers
Par l’interface. Onglet Parcours : déposez la SBOM à l’étape ③, puis le rapport à l’étape ② (ou dans l’onglet Exécutions). Le rapport est rattaché à la version choisie en haut de la page.
Par votre CI. Créez une clé dans l’onglet Projets, colonne Clés de CI, puis envoyez les deux fichiers avec curl. Indiquez la version (version=) dans les deux envois : c’est elle qui range vos essais dans le dossier de cette version.
V=1.4.0 # la version que vous livrez
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
Le content-type importe peu : le format est reconnu au contenu (.trx, output.xml, Test.xml, cucumber.json… s’envoient de la même façon). Si vous avez plusieurs fichiers de rapport (un par classe de test chez Maven et Gradle, un par essai chez Allure), envoyez-les un par un, ou réunissez les résultats Allure en un tableau.
La réponse dit le format lu, le nombre d’essais reconnus dans votre plan et ceux qui ne l’ont pas été.
3 bis. Facultatif : le compte rendu scellé, comme en Node.js
Si votre CI a Node.js (version 18 ou plus, présent dans la plupart des images), @mostajs/mjs-unit peut lire le rapport de votre outil. Il ne relance aucun essai. Il en fait le compte rendu de validation scellé, lié à votre SBOM et à votre plan, et l'envoie avec le plan et la SBOM. Vous n'avez aucun JavaScript à écrire.
# Java (Maven) : les rapports Surefire ; .NET : TestResults (les .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 # lit les rapports, écrit le compte rendu scellé
npx -y -p @mostajs/mjs-unit mjs-unit-menu --choix=4 # envoie le plan, la SBOM, puis le compte rendu
Avec le compte rendu, qatrax fait deux vérifications de plus : le rapport n'a pas été retouché après sa lecture, et c'est bien la SBOM déposée qui a été éprouvée.
4. Émettre
C’est la même fin que pour tout client : onglet SBOM/Vulnérabilités, statuez chacune ; puis onglet Livrable → Émettre et sceller.
Ce qui change par rapport à Node.js
Le verdict et le certificat sont les mêmes. Une seule différence : le compte rendu scellé. Si vous envoyez votre JUnit ou votre TAP directement (curl), qatrax ne fait pas les deux vérifications du compte rendu. Il les fait si vous passez par mjs-unit en mode lecteur (§ 3 bis).