Aggiunta progetto "PARSER WIRESHARK FOR CHRONICLES" - Gruppo 17

group17/README.md

@@ -0,0 +1,41 @@
+# Parser Wireshark for Chronicles
+
+Questo documento descrive lo sviluppo di un parser progettato per convertire file PCAP, generati da Wireshark, in un formato JSON strutturato compatibile con Google Chronicle. Wireshark è uno strumento open-source per l'analisi del traffico di rete, mentre Chronicle è una piattaforma di sicurezza basata su cloud, ottimizzata per l'elaborazione di dati in formato JSON, che consente l'analisi avanzata delle minacce e la gestione degli eventi.
+
+Il parser supera il divario tra il formato binario PCAP e il formato JSON leggibile richiesto da Chronicle. Il progetto comprende:
+
+* Lo studio delle complessità del formato PCAP.
+* L'utilizzo di Python e di librerie come Pyshark per un'efficace estrazione dei dati.
+* L'implementazione di funzionalità avanzate come la validazione dei timestamp, la gestione dei batch di eventi e l'integrazione con le API di Google Cloud.
+
+Sono stati sviluppati quattro prototipi iterativi, che affrontano problematiche come l'ottimizzazione della memoria, la gestione degli errori e la validazione dei dati. Gli obiettivi futuri includono l'integrazione completa con le API di Chronicle, l'espansione delle funzionalità per analizzare ulteriori tipi di dati di rete e miglioramenti dell'efficienza per gestire dati su larga scala.
+
+# Utilizzo del parser
+```
+python parser.py <pcap file> <time of first packet - ISO8601 format>
+```
+
+Ad esempio
+
+```
+python parser.py ./test_7k.pcap 2020-12-30T12:34:56
+```
+
+## Struttura repository
+```
+* code : contiene il codice Python del parser e un file di configurazione di esempio
+* docs : presentazione e report del progetto
+```
+
+## Link utili
+Repository originale: [GitHub](https://github.com/securityresearchlab/Cybersecurity-projects-2024)
+File di test: [OneDrive (Unibo account required)](https://liveunibo-my.sharepoint.com/:f:/g/personal/iacopo_sbalchiero_studio_unibo_it/EuY7TXE7wgVKq-uQf34obAoBRHEfOYg3BqH-53kXEfLvbQ?e=oEV7ZF)
+
+## Autori
+
+| Nome                                                  | Profilo GitHub                              |
+| ----------------------------------------------------- | ------------------------------------------- |
+| <div align="center"><img src="https://github.com/PietroColoretti01.png" width="50" style="border-radius: 50%;"><br>Pietro Coloretti</div> | [GitHub](https://github.com/PietroColoretti01) |
+| <div align="center"><img src="https://github.com/leonardo-gennaioli.png" width="50" style="border-radius: 50%;"><br>Leonardo Gennaioli</div> | [GitHub](https://github.com/leonardo-gennaioli) |
+| <div align="center"><img src="https://github.com/IacopoSb.png" width="50" style="border-radius: 50%;"><br>Iacopo Sbalchiero</div> | [GitHub](https://github.com/IacopoSb)       |
+

group17/code/config.conf

@@ -0,0 +1,4 @@
+{
+  "CUSTOMER_ID": "01234567-89ab-cdef-0123-456789abcdef",
+  "SERVICE_ACCOUNT_FILE": "path/to/your/service-account-key.json"
+}