Skip to content
KitploitKITPLOIT
StrumentiExploitsBlog
Log in
Invia
StrumentiExploitsBlog
Invia

Strumenti di Hacking, PenTest e Cybersecurity per il tuo Arsenale di Sicurezza!

Kitploit è una directory di strumenti di hacking, cybersecurity e pentesting. Scopri gli ultimi aggiornamenti dei progetti per trovare vulnerabilità, analizzare sistemi, automatizzare i test e rafforzare la tua sicurezza.

FeedContattoPrivacy© 2026 Kitploit

Directory degli strumenti

Categorie

Vedi tutte le categorie
Loading categories
Strumenti/GitHubGitHub/coolstartnow/isms-builder
Apprendimento e FormazioneRisposta agli IncidentiRisorse CuratePercorsi e Corsi
GitHubcoolstartnow/isms-builder

isms-builder

Sistema di Gestione della Sicurezza delle Informazioni self-hosted — ISO 27001, NIS2, GDPR/DSGVO, BSI IT-Grundschutz

Vedi Repository
20447665 giorni faRevisionato da Kitploit
Condividi
Sito web
<!-- © 2026 Claude Hecker — ISMS Builder V 1.76 — AGPL-3.0 -->
![Banner di ISMS Builder](https://assets.kitploit.com/production/public/readmes/12462/26d3b00b65a4f94cc34514132f1ee5f5c9036e45516880da99fb9501dd79bead.png)
# ISMS Builder

**Sistema di gestione della sicurezza delle informazioni self-hosted — open source, nessun cloud richiesto**

[![CI](https://github.com/coolstartnow/isms-builder/actions/workflows/ci.yml/badge.svg)](https://github.com/coolstartnow/isms-builder/actions/workflows/ci.yml)
[![Tests](https://img.shields.io/badge/tests-423%20passing-brightgreen)](https://github.com/coolstartnow/isms-builder/actions)
[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
[![Node.js](https://img.shields.io/badge/Node.js-18+-339933?logo=node.js&logoColor=white)](https://nodejs.org)
[![Version](https://raw.githubusercontent.com/coolstartnow/isms-builder/HEAD/docs/badges/version.svg)](CHANGELOG.md)

📖 **[Wiki](https://github.com/coolstartnow/isms-builder/wiki)** — Utilizzo dell'immagine Docker e
variabili d'ambiente, architettura e moduli, FAQ, contribuire (DE/EN)

<!-- GDPR NOTE: The four badges above (CI, Tests, License, Node.js) load resources
     from external servers (github.com, shields.io/Cloudflare, img.shields.io).
     When this README is rendered in a browser, these requests transmit the viewer's
     IP address to third parties (incl. US-based servers — GDPR Art. 44 ff.).
     For 100% GDPR-compliant self-hosted documentation, replace these four badge
     lines with their local equivalents from docs/badges/ or remove them entirely. -->

---

> ## ⚠️ Avviso di sicurezza: repository falsi e copie che distribuiscono malware
> ISMS Builder **non ha "release" pacchettizzate, installer o file ZIP scaricabili** — l'unica
> fonte legittima è questo repository, clonato o scaricato direttamente da GitHub come semplice
> codice sorgente. Siamo a conoscenza di almeno un **repository malevolo che si spaccia per questo progetto**
> (README falso, falso pulsante "Download" che rimanda a uno ZIP camuffato da screenshot, contenente un
> loader malware per Windows — catena di payload `.cmd` → `.exe` → DLL Lua). **Non scaricare né eseguire alcun
> ZIP/installer/exe "isms_builder" da fonti diverse da questo repository.**
> Se trovi un repository o un sito sospetto che si spaccia per questo progetto, apri una
> [issue](https://github.com/coolstartnow/isms-builder/issues) o una
> [discussion](https://github.com/coolstartnow/isms-builder/discussions) così possiamo segnalarlo.

---

> **Stato: sviluppo attivo — non ancora un prodotto finito.**
> I moduli principali sono funzionanti e in uso, ma alcune funzionalità sono incomplete
> e la piattaforma è ancora in crescita. Contributi, feedback e test
> nel mondo reale sono molto benvenuti — è esattamente per questo che il progetto è stato reso open source.

---

> 🛡️ **Progetto correlato: [NIS2 Quick-Check](https://github.com/coolstartnow/nis2-quickcheck)** —
> un autocheck NIS2 gratuito e autonomo (10 domini × 5 domande, tutti i 27 Stati membri dell'UE, tutte le 24
> lingue ufficiali dell'UE). Funziona interamente nel browser, senza backend, senza installazione. Non fa parte di
> ISMS Builder e non è necessario per utilizzarlo — solo uno strumento complementare per un primo rapido orientamento.

---

## Che cos'è ISMS Builder?

ISMS Builder è una **piattaforma web self-hosted** per la gestione di un Sistema di Gestione della Sicurezza delle Informazioni (ISMS).
Copre l'intero ciclo di vita della conformità — dalla redazione delle policy alle evidenze di audit — per ISO 27001:2022, NIS2, GDPR/DSGVO, BSI IT-Grundschutz e altri framework.

**Nessun cloud. Nessun costo SaaS. I tuoi dati restano sul tuo server.**

> Pensato per PMI, team IT e consulenti che necessitano di un vero strumento ISMS senza un contratto con un fornitore a cinque cifre.

---

## Uso previsto e ambito

Questo progetto è nato come strumento di lavoro per un singolo professionista ISMS e da lì è cresciuto. È
open source perché il lavoro può essere utile ad altri — non perché sia un prodotto commerciale
mascherato. Essere espliciti su questo ti aiuta a decidere se fa al caso tuo.

**A cosa serve.** Un piccolo team ISMS — spesso una sola persona, a volte una manciata — che
redige e mantiene la documentazione di un sistema di gestione: politiche, rischi, asset,
controlli, evidenze. Si prevede che il numero di persone che *necessitano di un account* rimanga contenuto.
Raggiungere un vasto pubblico funziona senza account: le prese visione delle politiche vengono inviate come
link basati su token, così i destinatari leggono e confermano un documento senza mai effettuare l'accesso, e
senza comparire in alcun elenco utenti.

**Cosa si aspetta da te.** ISMS Builder è self-hosted, e tutto ciò che ne consegue
è a tuo carico: deployment, TLS, hardening, backup, aggiornamenti, controllo degli accessi e gli obblighi
di protezione dei dati per qualunque cosa tu vi memorizzi. Il progetto fornisce una configurazione
predefinita ragionevole, non un servizio gestito.

**Cosa non è.** Non esiste un'offerta SaaS ospitata, né un contratto di supporto commerciale, né un
accordo sul livello di servizio. Non è un prodotto di hosting multi-tenant. Non ti certifica
rispetto ad alcuno standard e non è consulenza legale — ti aiuta a organizzare e documentare il lavoro,
ma la valutazione resta tua e del tuo auditor.

**Chi lo mantiene.** Una persona, accanto a un lavoro a tempo pieno. Le issue e le discussioni vengono lette e
ricevono risposta, di solito entro pochi giorni; le segnalazioni di sicurezza hanno priorità. Le richieste di funzionalità sono benvenute e
influenzano davvero la roadmap, ma competono per serate limitate. Se la tua organizzazione dipende
da una tempistica fissa o da una risposta garantita, un fornitore commerciale è la raccomandazione onesta —
e non è un motivo per evitare il progetto, solo un motivo per pianificare in modo realistico.

---

## Screenshot

| Login | Dashboard |
|---|---|
| ![Login](https://assets.kitploit.com/production/public/readmes/12462/dad90b27558016928f149aa956d5b5ecef78f7639fe00117fa6e7b6b9c610884.png) | ![Dashboard](https://assets.kitploit.com/production/public/readmes/12462/ad427999a2d247f7b486faff089572c213b6bf809d64946438305c1519e54566.png) |

| Dichiarazione di applicabilità | Gestione dei rischi |
|---|---|
| ![SoA](https://assets.kitploit.com/production/public/readmes/12462/19133912a32d643c4db93e977047aa6f93cc85889555a63dc29b986f5290d196.png) | ![Rischi](https://assets.kitploit.com/production/public/readmes/12462/19133912a32d643c4db93e977047aa6f93cc85889555a63dc29b986f5290d196.png) |

| GDPR e protezione dei dati | Gestione degli asset |
|---|---|
| ![GDPR](https://assets.kitploit.com/production/public/readmes/12462/453b4e84b6c08241d87e8edd96d803a68b5d56565aee2b317444f30db8d9ffb5.png) | ![Assets](https://assets.kitploit.com/production/public/readmes/12462/053332b35c995bc3a672be7bfd193ca3789f3245e7cdffaa456833fabdec309e.png) |

| Guida e documentazione | Report |
|---|---|
| ![Guida](https://assets.kitploit.com/production/public/readmes/12462/2eb44e0df23e8eba8d70e09a14a18028d1d9dc37e8e734d0c837f2b7fe6ec787.png) | ![Report](https://assets.kitploit.com/production/public/readmes/12462/765395a2a3cf39ec72a00ad53df464bc79d54a69ca34738bdeb775ff7e1584f3.png) |

| Registro delle misure | Misure per un controllo |
|---|---|
| ![Registro delle misure](https://assets.kitploit.com/production/public/readmes/12462/eedf38aaab6650767b438c237699536ef4edd1540ec513879d3dba3bc3ddcd53/fb9df24fa7d347305c9d2bdf49a2bd043b1e22f82c1ce8b441ba3fafbb99cc4e-display-v1.webp) | ![Misure nella SoA](https://assets.kitploit.com/production/public/readmes/12462/48a0e181c7c9b9597d1962bbf77a1118c564eedc42d802eec2d51eb1b1ff72f1/b34d065f2e668a35c18a545d0c63a64dc59978729f6998631c7b09a574283ca6-display-v1.webp) |

> Esegui `npm start` e apri `https://localhost:3000` per esplorare localmente l'intero dataset dimostrativo.

---

## Panoramica delle funzionalità

| Modulo | Descrizione | Standard |
|---|---|---|
| **Gestione delle policy** | CRUD dei template, versionamento, ciclo di vita (bozza → revisione → approvato → archiviato), gerarchia degli spazi, allegati | ISO 27001 §5 |
| **Dichiarazione di applicabilità** | 147 controlli integrati in 5 framework (BSI IT-Grundschutz, EU NIS2, EUCS, EU AI Act, CRA) più i controlli ISO 27001 / 9000 / 9001 che importi tu stesso (mai forniti), la scheda **Controlli personalizzati** e ogni altra scheda di framework possono essere disattivate in Amministrazione → Moduli quando non le utilizzi (i controlli esistenti vengono conservati), **gruppi propri** (i tuoi framework come NEN 7510, TISAX o un requisito del cliente, con una scheda dedicata: creali e importa i controlli da un file JSON con anteprima e unione — nessun testo di standard fornito; [docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/template-type-soa.md)), modifica in linea, analisi dei gap, cross-mapping | ISO 27001 A / BSI / NIS2 / EUCS / EUAI / ISO 9001 / CRA |
| **Registro delle misure** | Un unico registro per i trattamenti dei rischi, le azioni per le risultanze di audit, le misure di governance e le TOM — persona responsabile, scadenza, stato, evidenze; assegnabile ai controlli SoA, alle risultanze e ai rischi; visualizzato in SoA, rischi, risultanze, governance e GDPR, aggiornato automaticamente dalle versioni precedenti ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-measures.en.md)) | ISO 27001 §6.1.3 / GDPR Art. 32 |
| **Gestione dei rischi** | Registro dei rischi, piani di trattamento (conservati nel registro delle misure), ruolo di auditor | ISO 27001 §6.1 |
| **Obiettivi di sicurezza** | Monitoraggio dei KPI con barre di avanzamento, integrazione con il calendario | ISO 27001 §6.2 |
| **GDPR e privacy** | VVT, contratti AV, DSFA, TOM, coda DSAR, timer 72h, registro delle cancellazioni con avvisi email | DSGVO Art. 13–35 |
| **Gestione degli asset** | Registro degli asset ordinato per categoria, tipo e nome con colonne ordinabili, tipi di asset modificabili, obiettivi di protezione (CIA + autenticità) con ereditarietà delle dipendenze, livelli di classificazione, monitoraggio EoL | ISO 27001 A.5.9–5.12 |
| **BCM / BCP** | Business Impact Analysis, piani di continuità, esercitazioni, template per tutti e tre, registro dei requisiti ISO 22301 (importa dalla tua edizione con licenza) | ISO 27001 A.5.29–5.30 / NIS2 |
| **Registri di formazione** | Catalogo delle formazioni, monitoraggio del completamento, file di evidenza, conferma di partecipazione (PDF) | ISO 27001 A.6.3 |
| **Gestione dei fornitori** | Registro dei fornitori, pianificazione degli audit, valutazione del rischio | ISO 27001 A.5.19–5.22 |
| **Legale e contratti** | Contratti, NDA, informative sulla privacy, calendario delle scadenze | |
| **Casella degli incidenti** | Casella CISO + **modulo di segnalazione pubblico** (nessun login richiesto) | NIS2 / BSI |
| **Governance** | Riesami della direzione, verbali delle riunioni, misure di governance (conservate nel registro delle misure) | ISO 27001 §9.3 |
| **Report** | Matrice di conformità (Controllo × Entità), report dei gap, cicli di revisione, esportazione CSV | |
| **Risultanze di audit** | Registro delle risultanze (IST→SOLL→Rischio→Raccomandazione), piani d'azione, monitoraggio di gravità/stato, riferimento FIND-YYYY-NNNN | ISO 27001 §9.2 |
| **Gestione degli audit** | Audit con checklist, risultanze create dalle non conformità, programma annuale di audit (piano trimestrale, approvazione), integrazione con calendario e dashboard, esportazione CSV/PDF | ISO 27001 §9.2, ISO 19011 |
| **Presa visione delle policy** | Distribuzione verificabile delle policy al personale e conferma della comprensione, evidenza di audit centralizzata ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-policy-acknowledgements.en.md)) | ISO 27001 7.3, A.6.3 |
| **NIS2** | Checklist di governance Art. 21 (30 voci) e scadenze di segnalazione Art. 23 con avvisi automatici | NIS2 Art. 21 / 23 |
| **Calendario** | Un unico calendario per le scadenze di tutti i moduli: misure, trattamenti dei rischi, audit, revisioni, contratti, formazioni, scadenze | |
| **Guida** | Manuale e knowledge base integrati (guide dei moduli, guide dei ruoli, documenti propri) con ricerca, in sei lingue | |
| **Organizzazione e logo aziendale** | Impostazioni dell'organizzazione (responsabilità, lingue, notifiche, SMTP, WebDAV, ordine dei menu, unità organizzative) e un logo aziendale caricabile mostrato nella pagina di login, nei PDF delle policy e nelle viste di stampa; il logo di ISMS Builder è incluso nel set demo ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-organisation.en.md)) | |
| **Valutazione d'impatto sulla protezione dei dati (DPIA)** | Nove modelli pronti all'uso (HR nel cloud, videosorveglianza, monitoraggio dei dipendenti, servizi AI, profilazione, dati sanitari, biometria, whistleblowing, selezione del personale), un pre-check "è necessaria una DPIA?", una revisione del DPO prima dell'approvazione e una vista di stampa; l'azienda la prepara, il DPO la revisiona ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-dsfa.en.md)) | GDPR Art. 35 |
| **Modelli GDPR** | Modelli pronti all'uso per registri delle attività di trattamento (14), accordi sul trattamento (12), violazioni dei dati (10), risposte agli interessati (10) e misure tecniche e organizzative (24), in sei lingue; precompila il modulo, da adattare con attenzione alla propria azienda, non è consulenza legale ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-gdpr.en.md)) | GDPR Art. 30, 28, 33, 12–22, 32 |
| **Bozze AI (Policy Assistant)** | Redigi un documento da un elenco fisso di titoli con l'AI connessa (Ollama) oppure tramite copia e incolla con l'AI che preferisci; un filtro blocca i dati personali e tecnici, i segnaposto vengono compilati localmente dai dati dell'organizzazione ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-ai-drafts.en.md)) | |
| **App Mobile (Android)** | App Android separata che funziona offline con un proprio set di dati e si sincronizza con il server tramite Wi-Fi o un bundle di file: sincronizza account con diritti per modulo, configurazione tramite codice QR, modelli, SoA, rischi, asset, risultanze e linee guida (sola lettura); richiede `STORAGE_BACKEND=json` ([docs](https://github.com/coolstartnow/isms-builder/blob/main/docs/module-mobile-sync.en.md)). Non ancora rilasciata pubblicamente: se desideri provarla in anteprima, contattaci tramite il [sito del progetto](https://www.isms-builder.com/#contact) | |
| **Tracciabilità** | Ogni record è collegato ai controlli SoA + ai documenti di policy — in modo bidirezionale | |
| **Ricerca semantica** | Ricerca AI locale tramite Ollama (nomic-embed-text) con fallback per parole chiave; l'indirizzo dell'AI, i modelli e una **chiave API opzionale** (inviata come `Authorization: Bearer`, ad es. a un gateway davanti a Ollama, così che il suo log identifichi le richieste di ISMS Builder) sono impostati in Amministrazione; la chiave non viene mai più mostrata, registrata nei log o esportata | |
| **Multi-Entità** | Albero della struttura aziendale, applicabilità per entità per controlli e policy | |
| **Interfaccia multilingue e dati demo** | Interfaccia completa, contenuti demo e documentazione dei moduli in 🇩🇪 DE / 🇬🇧 EN / 🇫🇷 FR / 🇳🇱 NL / 🇭🇺 HU / 🇪🇪 ET; l'amministratore controlla le lingue disponibili. I testi FR, NL, HU ed ET sono traduzioni proprie — si raccomanda una revisione da parte di madrelingua | |

### ⚠ IMPORTANTE: i controlli ISO richiedono l'installazione manuale da parte dell'amministratore

> **ISO 27001:2022, ISO 9000:2015 e ISO 9001:2015** sono standard protetti da copyright pubblicati
> dall'International Organization for Standardization (ISO, © ISO). Le definizioni dei controlli
> (titoli, descrizioni, testo dei requisiti) **non sono incluse** in questo software e **non devono**
> essere ridistribuite senza una licenza ISO valida.

**Cosa significa in pratica:**
I moduli SoA per ISO 27001, ISO 9000 e ISO 9001 vengono distribuiti senza il contenuto dei controlli.
L'amministratore **deve importare manualmente** i controlli prima che questi framework siano utilizzabili:

1. Ottenere una copia con licenza dello standard da [iso.org](https://www.iso.org/) o da un ente nazionale autorizzato
2. Preparare un file JSON con le definizioni dei controlli (formato documentato in `scripts/import-iso-controls.sh`)
3. Eseguire lo script di importazione:
   ```bash
   bash scripts/import-iso-controls.sh path/to/iso-controls.json
   ```
4. Riavviare il server ISMS Builder

> **Framework inclusi di serie (nessuna licenza ISO richiesta):**
> BSI IT-Grundschutz, EU NIS2, EUCS, EU AI Act e CRA si basano su legislazione UE e pubblicazioni
> federali tedesche disponibili pubblicamente e sono completamente preinstallati.
>
> **Altri framework (NEN 7510, TISAX, requisiti del cliente, …):** un amministratore crea un *gruppo proprio* nella SoA
> (pulsante **+ Gruppo proprio**) e importa i controlli da un file JSON — con un'anteprima, uniti anziché sostituiti, e senza
> che venga distribuito alcun testo standard. Importare solo contenuti per i quali si è in possesso di licenza
> (file di esempio: `docs/examples/soa-custom-framework.example.json`). L'importazione ISO di cui sopra resta limitata a ISO 27001, 9000 e 9001.
>
> **Avviso legale:** i testi standard di ISO 27001/9000/9001, NEN 7510 e i cataloghi di valutazione TISAX (VDA ISA) sono soggetti ai diritti dei rispettivi editori (diritto d'autore e diritto dei marchi) e non sono distribuiti con ISMS Builder. I controlli di esempio nei dati demo sono testi segnaposto di nostra invenzione, senza alcun collegamento alla formulazione degli standard — incompleti e utilizzabili né per certificazioni né per valutazioni TISAX. Importare solo testi per i quali si è in possesso di licenza. Questo non costituisce consulenza legale.

L'utilizzo dei moduli del framework ISO senza una valida licenza per il rispettivo standard è
di esclusiva responsabilità dell'operatore. Il progetto ISMS Builder e i suoi contributori non si assumono alcuna
responsabilità per l'uso non autorizzato di contenuti protetti da ISO.

---

## Avvio rapido

```bash
git clone https://github.com/coolstartnow/isms-builder.git
cd isms-builder
npm install
cp .env.example .env          # set JWT_SECRET to a long random string
npm start                     # http://localhost:3000
```

Accedi con **`[email protected]` / `adminpass`**. Al primo accesso ti verrà chiesto di scegliere la **lingua dei dati demo** (🇩🇪 DE / 🇬🇧 EN / 🇫🇷 FR / 🇳🇱 NL / 🇭🇺 HU / 🇪🇪 ET) oppure di iniziare con un sistema vuoto. Cambia immediatamente la password dell'amministratore subito dopo. Vedi [Account demo](#demo-accounts) per gli altri account di test.


Per l'uso in produzione con HTTPS:

```bash
# .env
JWT_SECRET=<output of: openssl rand -hex 32>   # required; production refuses a missing, short or placeholder secret
STORAGE_BACKEND=json
SSL_CERT_FILE=/etc/ssl/certs/your.crt
SSL_KEY_FILE=/etc/ssl/private/your.key
```

**Andare in produzione?** La produzione è sempre una **nuova installazione** – demo e produzione non vengono mai mescolate.
Non trasformare un'istanza demo (o i suoi dati) in un sistema di produzione: installa una nuova istanza
(`STORAGE_BACKEND=json` è il valore predefinito consigliato, vedi `.env.example`), crea il tuo amministratore
e imposta i tuoi segreti. Le funzioni *Demo Reset* e *Demo Import* all'interno dell'app sono funzioni esclusive
dell'istanza demo: non sono uno strumento di backup, ripristino o migrazione, e *Demo Import* funziona solo con
`STORAGE_BACKEND=json`.

I framework SoA integrati (BSI IT-Grundschutz, EU NIS2, EUCS, EU AI Act, CRA) vengono creati
automaticamente su ogni backend di archiviazione. I testi dei controlli di ISO 27001 / 9000 / 9001 sono
protetti da copyright ISO e **non** vengono mai distribuiti – forniscili tu stesso in `data/iso-controls.json`
(vedi `scripts/import-iso-controls.sh`).

---

### Account demo

Il set demo contiene questi account, così ogni ruolo e funzione può essere provato. **Le password sono pubbliche e solo per uso demo.**

| Utente | Login (e-mail) | Password | Ruolo | Funzione | Usalo per testare |
|---|---|---|---|---|---|
| admin | `[email protected]` | `adminpass` | Amministratore | CISO + DPO | tutto, inclusa l'amministrazione |
| ciso | `[email protected]` | `cisopass` | Content Owner | **CISO** | la funzione CISO senza diritti di amministratore (come carla) |
| dsb | `[email protected]` | `dsbpass` | Content Owner | **DPO** | la funzione DPO senza diritti di amministratore (come dana) |
| alice | `[email protected]` | `alicepass` | Responsabile di dipartimento | nessuna | policy, rischi e linee guida (lettura e scrittura) |
| bob | `[email protected]` | `bobpass` | Lettore | nessuna | accesso in sola lettura |
| carla | `[email protected]` | `carlapass` | Content Owner | **CISO** | preparare e approvare una DPIA; lei **non** può inserire il parere del DPO |
| dana | `[email protected]` | `danapass` | Content Owner | **DPO** | inserire il parere del DPO su una DPIA |

carla e dana sono due persone distinte senza diritti di amministratore, così la revisione della DPIA può essere testata come previsto: carla prepara la DPIA, dana inserisce il parere, carla approva. ciso e dsb sono le stesse due funzioni come account separati.

**Quali account esistono dipende da come avvii:**

- **Immagine Docker / nuova installazione senza una directory dati:** admin, alice, bob, carla, dana.
- **Checkout del sorgente (`git clone`):** il repository include `data/rbac_users.json` con admin, ciso, dsb, alice, bob. carla e dana vengono aggiunti dall'import demo o caricando un bundle demo (2FA disattivata).
- **Demo pubblica (`DEMO_HOSTING`):** le password di tutti e sette gli account elencati sopra sono mantenute a questi valori pubblici; gli account che non esistono in quel set di dati vengono saltati.
- Il passaggio alla produzione (Admin → Maintenance → Demo reset) li elimina tutti tranne `admin`. Cambia la password di admin immediatamente dopo.


## Docker

Ogni release è pubblicata come GitHub Package nel GitHub Container Registry, per
`linux/amd64` e `linux/arm64` — con tag `:latest` e `:<version>` (ad es. `:1.37.5.2`):

```bash
docker compose up -d
# App runs at http://localhost:3000
```

Oppure senza Compose (`data/` deve essere un bind mount — i dati non vengono mai incorporati nell'immagine):

```bash
docker run -d --name isms-builder -p 3000:3000 \
  -e JWT_SECRET="$(openssl rand -hex 32)" \
  -v "$PWD/data:/app/data" \
  ghcr.io/coolstartnow/isms-builder:latest
```

Questo è il default, memorizza i dati come file JSON semplici in `./data` — non serve alcun container per il database. È la configurazione consigliata per i piccoli team ed è quella usata dai due comandi sopra.

**Usare PostgreSQL (o MariaDB) invece di JSON.** L'immagine lo supporta nativamente, ma — a differenza della configurazione JSON sopra — richiede un secondo container (il database vero e proprio) più una manciata di variabili d'ambiente che indicano all'app come raggiungerlo. Se hai scaricato solo l'immagine (`docker pull ghcr.io/coolstartnow/isms-builder`) senza mai clonare questo repository, quei nomi di variabili non sono visibili da nessuna parte per impostazione predefinita — `docker-compose.yml` e `.env.example`, dove sono documentati, sono file di questo repository Git, non parte dell'immagine. Questa sezione esiste proprio perché quell'informazione non sia un segreto riservato al repo.

L'immagine `isms-builder` stessa non include mai un server database — `postgres:17` (o `mariadb:11`) è un motore database completamente generico e vuoto da Docker Hub, che non conosce nulla delle tabelle di questo progetto. Quelle tabelle (rischi, asset, controlli SoA e così via) vengono create automaticamente dall'applicazione stessa nel momento in cui si avvia e trova un database vuoto — nessun import SQL manuale, nessuno step di migrazione separato da eseguire. Vedi "Come viene creato lo schema del database?" qui sotto se vuoi i dettagli completi del meccanismo.

Due container, una rete Docker condivisa, poi all'app viene indicato dove trovare il database:

```bash
# 1) An isolated network so the two containers can reach each other by name
docker network create isms-net

# 2) The database — empty until the app first connects and creates its tables
docker run -d --name isms-postgres --network isms-net \
  -e POSTGRES_DB=isms_builder \
  -e POSTGRES_USER=isms \
  -e POSTGRES_PASSWORD="$(openssl rand -hex 16)" \
  -v isms-postgres-data:/var/lib/postgresql/data \
  postgres:17-alpine

# 3) The app, pointed at that database by container name (isms-postgres) via
#    Docker's built-in DNS on the shared network — no host/port juggling needed
docker run -d --name isms-builder --network isms-net -p 3000:3000 \
  -e JWT_SECRET="$(openssl rand -hex 32)" \
  -e STORAGE_BACKEND=postgres \
  -e DB_HOST=isms-postgres \
  -e DB_PORT=5432 \
  -e DB_USER=isms \
  -e DB_PASS="<same password as POSTGRES_PASSWORD above>" \
  -e DB_NAME=isms_builder \
  ghcr.io/coolstartnow/isms-builder:latest
```

Cosa significa ciascuna variabile:

| Variabile | Scopo |
|---|---|
| `STORAGE_BACKEND` | `postgres` (o `pg`) per PostgreSQL, `mariadb` per MariaDB/MySQL. Lasciare non impostato (o `json`) per la configurazione JSON predefinita. |
| `DB_HOST` | Nome host del container del database. Su una rete Docker condivisa, è semplicemente il `--name` del container — Docker lo risolve automaticamente. |
| `DB_PORT` | `5432` per PostgreSQL, `3306` per MariaDB. |
| `DB_USER` / `DB_PASS` / `DB_NAME` | Devono corrispondere a quanto impostato sul container del database (`POSTGRES_USER`/`POSTGRES_PASSWORD`/`POSTGRES_DB` sopra, o gli equivalenti MariaDB). |

Per MariaDB, sostituire `postgres:17-alpine` con `mariadb:11`, usare le sue variabili `MARIADB_DATABASE` /
`MARIADB_USER` / `MARIADB_PASSWORD` nel passaggio 2, e `STORAGE_BACKEND=mariadb` /
`DB_PORT=3306` nel passaggio 3. L'elenco completo e con riferimenti incrociati di ogni variabile d'ambiente
compresa da questo progetto — incluse quelle non trattate qui (SSL, trust del reverse-proxy, SMTP,
2FA, …) — si trova in [`.env.example`](https://github.com/coolstartnow/isms-builder/blob/main/.env.example) in questo repository.

Gli utenti di Compose ottengono tutto questo gratuitamente: `docker-compose.yml` include già i profili
di servizio `mariadb` e `postgres` (commentati per impostazione predefinita, insieme alle spiegazioni equivalenti delle variabili d'ambiente) —
`docker compose --profile postgres up -d` avvia entrambi i container collegati automaticamente,
senza necessità di configurare manualmente la rete o copiare e incollare password.

**Come viene creato lo schema del database?** Né l'immagine `postgres:17` né la `mariadb:11`
sanno qualcosa di questo progetto — sono motori di database generici e vuoti direttamente da
Docker Hub. Non c'è alcun file di dump SQL da importare né alcun comando di migrazione separato da eseguire manualmente.
Invece, nel momento in cui il container `isms-builder` si avvia e si connette a un database vuoto, il suo
stesso codice applicativo (non l'immagine del database) crea ogni tabella necessaria sul momento — vedere
[`server/db/knexDatabase.js`](https://github.com/coolstartnow/isms-builder/blob/main/server/db/knexDatabase.js): un elenco di definizioni di tabelle, ciascuna
verificata con `hasTable()` e creata con `createTable()` se mancante, tutto prima che l'app inizi
ad accettare richieste HTTP. Questo lo rende idempotente — il primissimo avvio costruisce lo schema completo
dal nulla, e ogni riavvio successivo sullo stesso database è un no-op silenzioso perché le
tabelle esistono già. È lo stesso meccanismo, non modificato, che è stato verificato dal vivo su
SQLite, MariaDB 11 e PostgreSQL 17 (vedere [#70](https://github.com/coolstartnow/isms-builder/issues/70)).

Per compilare dai sorgenti, invece, decommentare il blocco `build:` in `docker-compose.yml` ed eseguire
`docker compose up -d --build`.

Le immagini includono un'attestazione firmata di provenienza della build:

```bash
gh attestation verify oci://ghcr.io/coolstartnow/isms-builder:latest --owner coolstartnow
```

## Requisiti

- **Node.js 18+** (testato: 18, 20, 22)
- npm 9+
- (Opzionale) Docker + Docker Compose
- (Opzionale) [Ollama](https://ollama.ai) per la ricerca semantica AI locale

---

## Configurazione (`.env`)

| Variabile | Predefinito | Descrizione |
|---|---|---|
| `JWT_SECRET` | *(obbligatorio)* | Segreto per la firma JWT — almeno 32 caratteri casuali (`openssl rand -hex 32`). Con `NODE_ENV=production` (sempre il caso nell'immagine Docker) il server non si avvia con un segreto mancante, troppo corto o segnaposto |
| `PORT` | `3000` | Porta di ascolto HTTP/HTTPS |
| `STORAGE_BACKEND` | `json` | `json` (predefinito e raccomandazione attuale; richiesto dall'app mobile), `sqlite`, `mariadb` o `postgres` |
| `SSL_CERT_FILE` | — | Percorso del certificato TLS → abilita HTTPS |
| `SSL_KEY_FILE` | — | Percorso della chiave privata TLS |
| `DATA_DIR` | `./data` | Sovrascrive la directory dei dati (volumi Docker) |
| `SMTP_HOST` | — | Server SMTP per gli avvisi email |
| `SMTP_PORT` | `587` | Porta SMTP |
| `SMTP_USER` | — | Nome utente SMTP |
| `SMTP_PASS` | — | Password SMTP |
| `SMTP_FROM` | — | Indirizzo mittente per le notifiche |

---

## Architettura

```
server/
  index.js          — Express app setup, router mounts
  auth.js           — JWT auth, RBAC ranks, session
  routes/           — 17 Express route modules (one per domain)
  db/               — Data stores (jsonStore / sqliteStore / orgSettingsStore / …)
  ai/               — Semantic search (embedder, embeddingStore, lexicalSearch)
  reports.js        — Report generation logic
ui/
  index.html        — SPA shell (Atlassian Dark Theme)
  app.js            — All render functions, ~6000 lines vanilla JS
  style.css         — CSS variables, dark theme
data/               — JSON files / SQLite DB (gitignored)
docs/
  ISMS-build-documentation.md  — Full architecture reference
  architecture/                — C4 diagrams, data model, OpenAPI 3.0.3 spec
tests/              — Jest + Supertest (176 tests, --runInBand)
```

- **Autenticazione:** cookie JWT (`sm_session`), password bcrypt, 2FA TOTP (applicabile a livello di organizzazione)
- **RBAC:** `reader` → `editor` / `dept_head` → `contentowner` / `auditor` → `admin`
- **Persistenza:** file JSON (predefinito, consigliato) o database SQL: SQLite tramite `better-sqlite3`, MariaDB/MySQL, PostgreSQL
- **AI:** Ollama locale opzionale (nomic-embed-text); ricerca per parole chiave sempre disponibile come fallback
- **Registro di audit:** ogni azione di creazione/aggiornamento/eliminazione/login registrata, filtrabile, esportabile

Vedi [`docs/architecture/`](https://github.com/coolstartnow/isms-builder/blob/main/docs/architecture) per i diagrammi C4, il modello dati completo e la specifica OpenAPI 3.0.3 (oltre 80 endpoint).

---

## Esecuzione dei test

> **Nota:** la suite di test in `tests/` è costituita dai test di sviluppo personali dell'autore ed è
> distribuita insieme al progetto per trasparenza. **Non** fa parte dell'applicazione stessa
> e **non è necessaria** per eseguire l'app. I test coprono il comportamento interno dell'API e utilizzano
> credenziali di test hardcoded che esistono solo nell'ambiente di test isolato — non hanno alcuna
> relazione con dati di produzione o demo.

```bash
npm test                  # runs all 423 tests
npm run preflight         # exactly what CI gates on (tests + pinning + audit)
npm test -- --verbose     # with test names
```

I test utilizzano una directory temporanea isolata — nessun dato di produzione viene toccato.

---

## Contribuire

I contributi sono molto benvenuti! Consulta [CONTRIBUTING.md](https://github.com/coolstartnow/isms-builder/blob/main/CONTRIBUTING.md) per:

- Configurazione dello sviluppo (5 minuti per la prima esecuzione dei test)
- Stile del codice e convenzioni
- Come aprire una buona issue o PR

---

[Read more](https://github.com/coolstartnow/isms-builder)
Scarica lo strumento

Più Popolari

Vedi tutti →

Scopri gli strumenti più utilizzati dalla nostra community.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 Il toolkit OSINT definitivo: grafo di indagine, punteggio di affidabilità, famiglie di alias, mappa, timeline e report. 49 moduli, oltre 400 siti, nessuna chiave API richiesta.

    1.0k
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    # App di esecuzione con un tocco GhostLock (CVE-2026-43499)

    627
  • 3

    looking-glass

    anonghosty/looking-glass

    Piattaforma CSIRT che importa i report di Shadowserver in MongoDB e li riproduce come mappe interattive, analisi, risultati, avvisi e dashboard executive.

    416
  • 4

    jumpserver

    jumpserver/jumpserver

    JumpServer è una piattaforma open-source di gestione degli accessi privilegiati (PAM) che fornisce ai team DevOps e IT un accesso sicuro e on-demand a endpoint SSH, RDP, Kubernetes, database e RemoteApp tramite un browser web.

    379
  • 5

    ARTEX

    baarai/artex

    Piattaforma di penetration testing autonoma multi-agente basata su LLM con agenti planner/worker, grafi di asset e di esplorazione, registrazione del traffico MITM e retesting delle vulnerabilità.

    330
  • 6

    Aliens_eye

    arxhr007/aliens_eye

    Motore OSINT basato sull'IA per scoprire e mappare oltre 7.700 identità sui social media in tutto il web

    288

Esplora tutti gli strumenti

Sfoglia la nostra collezione di strumenti

Vedi tutti gli strumenti →