Certitude è un pacchetto Python per eseguire la classificazione supervisionata di URL dannosi utilizzando un insieme congiunto di caratteristiche lessicografiche e dei certificati.

Tutti i progetti COSSAS sono ospitati su GitLab con un mirror push su GitHub. Per problemi/contributi consultare CONTRIBUTING.md

Per Iniziare

Certitude richiede whois, che potrebbe non essere disponibile su alcuni sistemi, ed è quindi distribuito come immagine docker. Se whois è disponibile, può anche essere installato come pacchetto python, vedere la sezione sviluppo di seguito.

# pull image from registry
docker pull registry.gitlab.com/cossas/certitude:latest

# print help
docker run -it registry.gitlab.com/cossas/certitude:latest

# example perform training from data in local directory
docker run -it -v $(pwd)/tests/data:/data registry.gitlab.com/cossas/certitude:latest --train /data/newmodel -d /data/testset_labeled.csv

# example performing classification of a url with the trained model
docker run -it -v $(pwd)/tests/data:/data registry.gitlab.com/cossas/certitude:latest --model /data/newmodel --url https://www.tno.nl

Sviluppo

Per iniziare a sviluppare questo pacchetto, segui questi passaggi:

Avvia WSL
git clone questo progetto, assicurandoti di farlo nel filesystem WSL. Esegui cd per assicurarti di essere nella home directory di WSL
cd nella directory appena clonata
Esegui code . per avviare VS Code
In un terminale VS Code, esegui poetry install, poetry shell e infine poetry run pre-commit install

Flusso del codice

Scopri il flusso del codice qui

Demo e Test

Per vedere alcuni comandi utili e testare il codice, puoi controllare il makefile:

make demo

Contribuire

I contributi a CERTITUDE sono molto apprezzati e più che benvenuti. Si prega di leggere CONTRIBUTING.md per maggiori informazioni sul nostro processo di contribuzione.

Stato di manutenzione

Questo progetto è stato sviluppato fino a TRL4 e attualmente non è mantenuto attivamente. Prevediamo i seguenti passaggi per elevare il TRL da 4 a 6:

Prove tecniche nelle pipeline di sicurezza di piccole e medie imprese.
Riaddestramento del modello predefinito utilizzando dati di sicurezza aziendali.
Validazione dell'accuratezza del metodo di classificazione del pacchetto in circostanze rilevanti.
Miglioramento del pacchetto sulle carenze per le esigenze di una piccola e media impresa.

Certitude