Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
88 lines (66 loc) · 3.73 KB

CONTRIBUTING.md

File metadata and controls

88 lines (66 loc) · 3.73 KB
Raw

Come contribuire

Grazie per l'interesse verso DigitalValut Controller. I contributi sono benvenuti: segnalazioni di bug, nuove firme di rilevamento, traduzioni, miglioramenti alla documentazione.

Prima di iniziare

Leggi DISCLAIMER.md e LICENSE. Contribuendo, accetti che il tuo contributo sia distribuito sotto Licenza Apache 2.0, alle stesse condizioni del resto del progetto (sezione 5 della Licenza), e confermi di averne il diritto.

Il progetto è mantenuto su base volontaria: le revisioni possono richiedere tempo e non c'è garanzia che ogni proposta venga accolta.

Segnalare un bug

Apri una issue includendo:

  • versione di Windows e di PowerShell ($PSVersionTable.PSVersion);
  • se l'esecuzione era con privilegi amministrativi;
  • comportamento atteso e comportamento osservato;
  • eventuali messaggi di errore.

⚠️ Non allegare mai report generati contenenti dati reali. I report includono nome macchina, nome utente, dominio, indirizzi IP ed elenco dei processi. Anonimizza sempre prima di condividere qualsiasi output.

Aggiungere una regola di rilevamento (non serve una pull request)

Dalla v4.2 le firme sono file .json in core/rules/. Puoi aggiungere i tuoi rilevamenti in locale senza aprire una pull request e senza aspettare che qualcuno li approvi: crea un file in core/rules/custom/ e funziona subito. Guida: RULES.md.

Se vuoi proporre una regola per la distribuzione ufficiale, apri pure una PR con il file .json — ma non è necessario perché la tua regola funzioni.

Segnalare un falso positivo o un falso negativo

Sono i contributi più utili. Indica il nome esatto del processo, servizio o software, il produttore e il motivo per cui la classificazione è errata. Le firme ufficiali si trovano in core/rules/; il database interno di riserva è in core/modules/ThreatDatabase.psm1.

Vulnerabilità di sicurezza

Non aprire una issue pubblica. Segui la procedura descritta in SECURITY.md.

Pull request

  1. Fai un fork del repository e crea un branch descrittivo (fix/rilevamento-anydesk, feat/traduzione-en).
  2. Mantieni lo stile del codice esistente: PowerShell 5.1 compatibile, nessuna dipendenza esterna, commenti in italiano.
  3. Non introdurre connessioni di rete in uscita. Il funzionamento totalmente offline è un requisito architetturale non negoziabile del progetto: è ciò che ne rende verificabile la neutralità.
  4. Non aggiungere binari precompilati, né file di report o dati reali.
  5. Verifica che lo script si esegua correttamente sia con sia senza privilegi amministrativi.
  6. Descrivi nella PR cosa cambia e perché.

Principi del progetto

Ogni contributo deve rispettare la natura dello strumento:

  • Sola lettura: il Software non modifica il sistema analizzato, non rimuove né disattiva alcun componente.
  • Nessuna telemetria: nessun dato lascia la macchina dell'utente.
  • Difensivo, mai offensivo: non saranno accettati contributi che aggiungano funzionalità di sorveglianza, di raccolta dati su terzi, di attacco o di elusione di controlli legittimi.
  • Onestà nelle affermazioni: non saranno accettate modifiche che presentino i risultati come prova legale o perizia forense, o che sopravvalutino le capacità di rilevamento. Vedi la sezione 4 del DISCLAIMER.md.

Traduzioni

La documentazione è in italiano, con una guida rapida in inglese (docs/README.txt). Traduzioni in altre lingue sono benvenute; i riferimenti normativi sono specifici dell'ordinamento italiano e vanno adattati o chiaramente contestualizzati.