Certitude es un paquete Python para realizar clasificación supervisada de URL maliciosas utilizando un conjunto conjunto de características lexicográficas y de certificados.

Todos los proyectos COSSAS están alojados en GitLab con un mirror push a GitHub. Para problemas/contribuciones consulta CONTRIBUTING.md

Primeros pasos

Certitude requiere whois, que puede no estar disponible en algunos sistemas, y por lo tanto se distribuye como una imagen Docker. Si whois está disponible, también se puede instalar como paquete Python; consulta la sección de desarrollo a continuación.

# 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

Desarrollo

Para comenzar a desarrollar este paquete, sigue estos pasos:

Inicia WSL
git clone este proyecto, asegurándote de hacerlo en el sistema de archivos de WSL. Ejecuta cd para asegurarte de estar en el directorio home de WSL
cd al directorio recién clonado
Ejecuta code . para iniciar VS Code
En una terminal de VS Code, ejecuta poetry install, poetry shell y finalmente poetry run pre-commit install

Flujo del código

Consulta el flujo del código aquí

Demo y prueba

Para ver algunos comandos útiles y probar el código, puedes consultar el makefile:

make demo

Contribuciones

Las contribuciones a CERTITUDE son muy apreciadas y más que bienvenidas. Por favor, lee CONTRIBUTING.md para obtener más información sobre nuestro proceso de contribuciones.

Estado de mantenimiento

Este proyecto se ha desarrollado hasta TRL4 y actualmente no se mantiene de forma activa. Imaginamos los siguientes pasos para elevar el TRL de 4 a 6:

Pruebas técnicas en pipelines de seguridad de pequeñas y medianas empresas.
Reentrenamiento del modelo predeterminado utilizando datos de seguridad de empresas.
Validación de la precisión del método de clasificación del paquete en circunstancias relevantes.
Mejora del paquete en las deficiencias para las necesidades de una pequeña o mediana empresa.

Certitude