O Certitude é um pacote Python para realizar classificação supervisionada de URLs maliciosas usando um conjunto conjunto de características lexicográficas e de certificados.

Todos os projetos COSSAS estão hospedados no GitLab com um espelho push para o GitHub. Para problemas/contribuições, consulte CONTRIBUTING.md

Começando

O Certitude requer whois, que pode não estar disponível em alguns sistemas e, portanto, é distribuído como uma imagem docker. Se whois estiver disponível, também pode ser instalado como um pacote Python, consulte a seção de desenvolvimento abaixo.

# puxar imagem do registro
docker pull registry.gitlab.com/cossas/certitude:latest

# imprimir ajuda
docker run -it registry.gitlab.com/cossas/certitude:latest

# exemplo de treinamento a partir de dados no diretório local
docker run -it -v $(pwd)/tests/data:/data registry.gitlab.com/cossas/certitude:latest --train /data/newmodel -d /data/testset_labeled.csv

# exemplo de classificação de uma URL com o modelo treinado
docker run -it -v $(pwd)/tests/data:/data registry.gitlab.com/cossas/certitude:latest --model /data/newmodel --url https://www.tno.nl

Desenvolvimento

Para começar a desenvolver este pacote, siga estes passos:

Inicie o WSL
Faça git clone deste projeto, garantindo que o faça no sistema de arquivos do WSL. Execute cd para garantir que você esteja no diretório home do WSL
cd para o diretório recém-clonado
Execute code . para iniciar o VS Code
Em um terminal do VS Code, execute poetry install, poetry shell e, finalmente, poetry run pre-commit install

Fluxo de código

Confira o fluxo de código aqui

Demonstração & Teste

Para ver alguns comandos úteis e testar o código, você pode verificar o makefile:

make demo

Contribuindo

Contribuições para o CERTITUDE são altamente apreciadas e mais que bem-vindas. Por favor, leia CONTRIBUTING.md para mais informações sobre nosso processo de contribuições.

Status de Manutenção

Este projeto foi desenvolvido até o TRL4 e atualmente não está sendo mantido ativamente. Envisionamos os seguintes passos para elevar o TRL de 4 para 6:

Testes técnicos em pipelines de segurança de pequenas e médias empresas.
Re-treinamento do modelo padrão usando dados de segurança da empresa.
Validação da precisão do método de classificação do pacote em circunstâncias relevantes.
Melhoria do pacote em lacunas para as necessidades de uma pequena ou média empresa.

Certitude