Certitude est un package Python permettant de réaliser une classification supervisée d'URL malveillantes en utilisant un ensemble conjoint de caractéristiques lexicographiques et de certificats.

Tous les projets COSSAS sont hébergés sur GitLab avec un miroir push vers GitHub. Pour les problèmes/contributions, consultez CONTRIBUTING.md

Pour commencer

Certitude nécessite whois, qui peut ne pas être disponible sur certains systèmes, et est donc distribué en tant qu'image docker. Si whois est disponible, il peut également être installé en tant que package python, voir la section développement ci-dessous.

# 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

Développement

Pour commencer le développement de ce package, suivez ces étapes :

Démarrer WSL
git clone ce projet, en vous assurant de le faire dans le système de fichiers WSL. Exécutez cd pour vous assurer que vous êtes dans le répertoire personnel WSL
cd dans le répertoire fraîchement cloné
Exécutez code . pour lancer VS Code
Dans un terminal VS Code, exécutez poetry install, poetry shell et enfin poetry run pre-commit install

Flux de code

Consultez le flux de code ici

Démo et test

Pour voir quelques commandes utiles et tester le code, vous pouvez consulter le makefile :

make demo

Contribuer

Les contributions à CERTITUDE sont hautement appréciées et plus que bienvenues. Veuillez lire CONTRIBUTING.md pour plus d'informations sur notre processus de contributions.

Statut de maintenance

Ce projet a été développé jusqu'au TRL4 et n'est pas activement maintenu actuellement. Nous envisageons les étapes suivantes pour passer du TRL4 au TRL6 :

Essais techniques dans les pipelines de sécurité des petites et moyennes entreprises.
Réentraînement du modèle par défaut en utilisant des données de sécurité d'entreprise.
Validation de la précision de la méthode de classification du package dans des circonstances pertinentes.
Amélioration du package sur les lacunes pour les besoins d'une petite ou moyenne entreprise.

Certitude