Certitude ist ein Python-Paket zur überwachten Klassifizierung bösartiger URLs unter Verwendung einer gemeinsamen Menge lexikografischer und Zertifikatsmerkmale.

Alle COSSAS-Projekte werden auf GitLab gehostet, mit einem Push-Mirror auf GitHub. Für Probleme/Beiträge siehe CONTRIBUTING.md

Erste Schritte

Certitude benötigt whois, das auf manchen Systemen nicht verfügbar sein kann, und wird daher als Docker-Image verteilt. Falls whois verfügbar ist, kann es auch als Python-Paket installiert werden – siehe den Entwicklungsabschnitt weiter unten.

# docker image aus der Registry pullen
docker pull registry.gitlab.com/cossas/certitude:latest

# Hilfe anzeigen
docker run -it registry.gitlab.com/cossas/certitude:latest

# Beispiel: Training mit Daten aus einem lokalen Verzeichnis durchführen
docker run -it -v $(pwd)/tests/data:/data registry.gitlab.com/cossas/certitude:latest --train /data/newmodel -d /data/testset_labeled.csv

# Beispiel: Klassifikation einer URL mit dem trainierten Modell
docker run -it -v $(pwd)/tests/data:/data registry.gitlab.com/cossas/certitude:latest --model /data/newmodel --url https://www.tno.nl

Entwicklung

Um mit der Entwicklung dieses Pakets zu beginnen, gehen Sie wie folgt vor:

WSL starten
git clone dieses Projekts (stellen Sie sicher, dass Sie dies im WSL-Dateisystem tun). Führen Sie cd aus, um sicherzustellen, dass Sie sich im WSL-Home-Verzeichnis befinden
Wechseln Sie mit cd in das gerade geklonte Verzeichnis
Führen Sie code . aus, um VS Code zu starten
Führen Sie in einem VS Code-Terminal poetry install, poetry shell und schließlich poetry run pre-commit install aus

Code-Flow

Schauen Sie sich den Code-Flow hier an.

Demo & Test

Um einige nützliche Befehle zu sehen und den Code zu testen, können Sie das Makefile überprüfen:

make demo

Mitarbeit

Beiträge zu CERTITUDE werden sehr geschätzt und sind mehr als willkommen. Bitte lesen Sie CONTRIBUTING.md für weitere Informationen über unseren Beitragsprozess.

Wartungsstatus

Dieses Projekt wurde bis TRL4 entwickelt und wird derzeit nicht aktiv gewartet. Wir sehen die folgenden Schritte vor, um den TRL von 4 auf 6 zu erhöhen:

Technische Erprobung in Sicherheitspipelines kleiner und mittelständischer Unternehmen.
Nachschulung des Standardmodells mit Unternehmenssicherheitsdaten.
Validierung der Genauigkeit der Klassifizierungsmethode des Pakets unter relevanten Bedingungen.
Verbesserung des Pakets hinsichtlich Schwachstellen für die Bedürfnisse kleiner und mittelständischer Unternehmen.

Certitude