QATrax
Voir en Markdown

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 :

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

LangageNom 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():
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é (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 :

LangageSBOM (CycloneDX JSON)Rapport d’essais (tel quel)
Java — Mavenmvn org.cyclonedx:cyclonedx-maven-plugin:makeAggregateBom → target/bom.jsonmvn test → target/surefire-reports/TEST-*.xml
Java — Gradlegreffon org.cyclonedx.bom, puis ./gradlew cyclonedxBom → build/reports/./gradlew test → build/test-results/test/TEST-*.xml
C# — .NETl’outil CycloneDX (dotnet tool install --global CycloneDX), ou Syftdotnet test --logger trx → TestResults/*.trx (TRX), ou TestResult.xml de NUnit, ou le JUnit de JunitXml.TestLogger
Pythonpip install cyclonedx-bom, puis cyclonedx-py environment --output-format JSON --output-file sbom.cyclonedx.jsonpytest --junitxml=resultats.xml
Java — TestNGcomme Maven ou Gradletestng-results.xml (natif)
GoSyft`go test -v ./... 2>&1 \go-junit-report > resultats.xml`
C, C++ — CMakeSyftctest -T Test → Testing/<date>/Test.xml (ou ctest --output-junit resultats.xml)
Robot FrameworkSyft (ou l’outil CycloneDX de Python)robot … → output.xml
BDD — Cucumber, Behavel’outil du langage--format json:cucumber.json ; behave -f json -o behave.json
Allure (tout langage)l’outil du langageallure-results/ : jq -s . allure-results/*-result.json > allure.json pour un seul dépôt
AutreSyft, 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).