# 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](/verifier).

## I cinque gesti

**1. Aprire il Suo spazio** — [Crea un account](/aller/parcours): dieci giorni di prova, senza carta di credito.

**2. Creare la Sua chiave** — nel Suo spazio: scheda [Progetti](/aller/projets), colonna **Chiavi CI**. La conservi segreta; vale solo per
il Suo progetto.

**3. Una volta sola: i Suoi requisiti** — scheda [Requisiti](/aller/exigences). Tre fonti, da combinare: il
[catalogo CRA](/aller/catalogue) (allegato I, pulsante **Importa**), il Suo piano di test (scheda [Piano Dev+Test](/aller/plan),
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):

```bash
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](/docs/autres-langages).

**5. Emettere** — nel Suo spazio: scheda [SBOM/Vulnerabilità](/aller/vulnerabilites), valuti ciascuna (interessata, non interessata,
corretta); poi scheda [Consegna](/aller/livrable) → **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](/aller/parcours) (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](/aller/exigences) — oppure direttamente [Catalogo CRA](/aller/catalogue) e [Piano Dev+Test](/aller/plan) | 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](/aller/parcours), passo ② — oppure la scheda [Esecuzioni](/aller/executions) | 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](/aller/parcours), passo ③ — oppure la scheda [SBOM/Vulnerabilità](/aller/vulnerabilites) | 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à](/aller/vulnerabilites) | qatrax ha cercato le vulnerabilità della Sua SBOM. Per ciascuna, scelga: interessata, non interessata (con la ragione) o corretta. | — |
| **6. Avviare l’elaborazione** | [Consegna](/aller/livrable) | 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](/aller/livrable), 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](/aller/signatures) | 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](/aller/parcours) → [Requisiti](/aller/exigences) → [Esecuzioni](/aller/executions) → [SBOM/Vulnerabilità](/aller/vulnerabilites) → [Consegna](/aller/livrable)**.
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](/docs/signatures).

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