In breve — dal Suo codice al certificato
Da dove parte, i quattro gesti da compiere, dove arriva. La via più breve verso un certificato CRA.
Da dove parte
Il Suo software, i suoi test automatici e una versione che sta per consegnare.
Dove arriva
Un certificato CRA di questa versione: i suoi requisiti, i suoi test, la sua distinta dei componenti (SBOM) e le sue vulnerabilità note, sigillato e verificabile da chiunque su qatrax.dev/verifier.
I cinque gesti
1. Aprire il Suo spazio — Crea un account: dieci giorni di prova, senza carta di credito.
2. Creare la Sua chiave — nel Suo spazio: scheda Progetti, colonna Chiavi CI. La conservi segreta; vale solo per il Suo progetto.
3. Una volta sola: i Suoi requisiti — scheda Requisiti. Tre fonti, da combinare: il catalogo CRA (allegato I, pulsante Importa), il Suo piano di test (scheda Piano Dev+Test, pulsante Verifica e importa), oppure il Suo ALM (Jira, Polarion: CSV o ReqIF). Il piano collega ogni requisito ai test che lo provano: senza di esso, un test ricevuto non prova nulla.
4. A ogni versione, un comando — nel Suo progetto (Node.js):
npm i -D @mostajs/mjs-unit @mostajs/mjs-sbom # una volta
npx mjs-unit-menu # poi: 2 (SBOM) · 3 (rapporto di validazione) · 4 (invio)
Per l’invio (scelta 4), tre variabili: QATRAX_URL (l’indirizzo del Suo spazio), QATRAX_CLE (la Sua chiave), QATRAX_PROJET (la chiave del Suo progetto). In integrazione continua, le tre in sequenza: npx mjs-unit-menu --choix=2 && npx mjs-unit-menu --choix=3 && npx mjs-unit-menu --choix=4. Java, C#, Python, C++, Go…? Bastano la Sua SBOM e il report del Suo strumento di test, così com’è — JUnit XML, NUnit, TRX, TestNG, Robot Framework, CTest, Cucumber, Behave, Allure, CTRF o TAP: veda QATrax senza Node.js.
5. Emettere — nel Suo spazio: scheda SBOM/Vulnerabilità, valuti ciascuna (interessata, non interessata, corretta); poi scheda Consegna → Emetti e sigilla. Il certificato è sigillato.
Senza riga di comando: dall’interfaccia, scheda per scheda
Le schede si trovano in alto in ogni pagina del Suo spazio. Scelga prima il Suo progetto e la versione che consegna.
| Passo | Scheda | Che cosa fa | Pulsante |
|---|---|---|---|
| 1. Iniziare | Percorso (la prima) | Mostra i cinque passi della Sua versione e ciò che manca ancora a ciascuno. Vi ritorni dopo ogni passo. | — |
| 2. Definire i Suoi requisiti (una volta) | Requisiti — oppure direttamente Catalogo CRA e Piano Dev+Test | Importi il catalogo CRA e il Suo piano di test: indica quale test prova quale requisito. | Importa · Verifica e importa |
| 3. Caricare il report dei test | Percorso, passo ② — oppure la scheda Esecuzioni | Scelga il file prodotto dai Suoi test: rapporto di validazione o report JSON di mjs-unit, JUnit XML, TAP, CTRF. | Carica i risultati |
| 4. Caricare la SBOM | Percorso, passo ③ — oppure la scheda SBOM/Vulnerabilità | Scelga il Suo file SBOM (CycloneDX o SPDX, JSON) e indichi la versione. | Carica la SBOM (in Vulnerabilità: Carica) |
| 5. Valutare le vulnerabilità | SBOM/Vulnerabilità | qatrax ha cercato le vulnerabilità della Sua SBOM. Per ciascuna, scelga: interessata, non interessata (con la ragione) o corretta. | — |
| 6. Avviare l’elaborazione | Consegna | qatrax riunisce i requisiti, i test, la SBOM e le vulnerabilità, poi mostra il verdetto. Lo legga. Se Le va bene, emetta. | Emetti e sigilla |
| 7. Ritrovare i certificati | Consegna, in fondo alla pagina: l’elenco Consegne emesse | Ogni consegna emessa ha il suo numero, la sua versione e il suo verdetto. Si scarica come PDF firmato, JSON sigillato e certificato HTML, e si verifica. | — |
| 8. Far firmare | Firme | Con un pacchetto di firme: selezioni le consegne da far marcare temporalmente dal fornitore qualificato, poi confermi: si scala una firma per consegna. Ritornano in Firmate. | Invia al fornitore qualificato |
In sintesi: Percorso → Requisiti → Esecuzioni → SBOM/Vulnerabilità → Consegna. Ogni scheda riporta in testa una riga Aiuto che riporta alla pagina di questa documentazione che la spiega.
Per impostazione predefinita, la barra mostra le schede di questi passi: Percorso, Requisiti, Catalogo CRA, Esecuzioni, SBOM/Vulnerabilità, Consegna, Documentazione tecnica e Dichiarazioni. Le altre (Test manuali, Firme, Progetti, Squadra, Piano Dev+Test…) sono sotto Altro ▾. Per cambiare la posizione di una scheda (nella barra, sotto «Altro» o nascosta) o il loro ordine: ⚙ Impostazioni → Schede, sceglietene la posizione, trascinatele (oppure usate ↑ ↓), poi salvate. Ordine predefinito ripristina l’ordine; Ripristina tutto anche la barra e «Altro».
Il titolare dello spazio imposta la barra di tutto lo spazio; ogni membro del team può impostare la propria e poi tornare a quella dello spazio. Ciò che ciascuno può modificare dipende dal suo ruolo nel progetto (Team → Cosa può fare ogni ruolo): un lettore può solo leggere.
La firma da parte di un fornitore qualificato. Il PDF del passo 7 è già firmato e marcato temporalmente da qatrax. Al passo 8, Lei lo fa marcare temporalmente, in aggiunta, dal nostro prestatore di servizi fiduciari qualificato (eIDAS), grazie al Suo pacchetto di firme. Sceglie Lei stesso i certificati da inviare; ogni invio scala una firma, e un errore del fornitore gliela restituisce. Dettagli: Firme e pacchetti.
Che cosa aspettarsi
- Nulla va perso: ogni invio è registrato, anche se incompleto; ciò che manca è detto chiaramente.
- Una versione, un fascicolo: contano solo i test di questa versione.
- Le vulnerabilità della Sua SBOM sono cercate subito, poi ogni giorno (basi OSV, NVD, CISA KEV, EUVD).
- Il verdetto, in una parola:
| Verdetto | Che cosa significa |
|---|---|
| Conforme | tutto è provato, nessuna vulnerabilità sfruttabile nota |
| Conforme con riserve | provato, ma alcuni punti sono da completare (sono elencati) |
| Non conforme | un requisito non è provato, oppure una vulnerabilità è dichiarata sfruttabile |
| Bloccato | una vulnerabilità attivamente sfruttata è da valutare, oppure un documento non corrisponde (test ritoccati, altra SBOM) |
Una domanda? Ci scriva dal Suo spazio.