cccs/assemblyline-service-lookyloo repository overview

⁠Lookyloo Service

This Assemblyline service extracts artifacts and captures from potentially malicious URLs using Lookyloo.

⁠Overview

This service deploys a local docker instance of Lookyloo⁠ and utilizes PyLookyloo⁠ to extract and return artifacts from URLs to Assembyline.

It is developed to replace the Proof of Concept⁠ module that was created during GeekWeek 10.

PyLookyloo is utilized for all calls to Lookyloo to ensure future compatibility is maintained with feature changes.

⁠Acknowledgements

This service is based on the heavy work done by the following people, which can be found in this repository⁠.

• Government of Yukon/Thomas Dang⁠
• CIRCL/Raphaël Vinot⁠
• CCCS Assemblyline Team⁠

⁠Image variants and tags

Assemblyline services are built from the Assemblyline service base image⁠, which is based on Debian 11 with Python 3.11.

Assemblyline services use the following tag definitions:

⁠Running this service

This is an Assemblyline service. It is designed to run as part of the Assemblyline framework.

If you would like to test this service locally, you can run the Docker image directly from the a shell:

docker run \
    --name Lookyloo \
    --env SERVICE_API_HOST=http://`ip addr show docker0 | grep "inet " | awk '{print $2}' | cut -f1 -d"/"`:5003 \
    --network=host \
    cccs/assemblyline-service-lookyloo

To add this service to your Assemblyline deployment, follow this guide⁠.

⁠Documentation

General Assemblyline documentation can be found at: https://cybercentrecanada.github.io/assemblyline4_docs/⁠

⁠Service Lookyloo

Ce service d'Assemblyline extrait les différents éléments et capture les informations des URLs potentiellement malicieuses en utilisant Lookyloo.

⁠Aperçu

Ce service déploie une instance locale de Lookyloo⁠ et utilise PyLookyloo⁠ pour extraire et renvoyer les artefacts des URLs à Assembyline.

Il est développé pour remplacer la preuve de concept⁠ qui a été créée pendant GeekWeek 10.

PyLookyloo est utilisé pour tous les appels à Lookyloo pour s'assurer que la compatibilité sera maintenue avec les futurs changements de fonctionnalités.

⁠Remerciements

Ce service est basé sur le travail considérable effectué par les personnes suivantes, qui peuvent être trouvées dans ce dépôt⁠.

• Gouvernement du Yukon/Thomas Dang⁠
• CIRCL/Raphaël Vinot⁠
• Équipe d'Assemblyline du CCCS⁠

⁠Variantes et étiquettes d'image

Les services d'Assemblyline sont construits à partir de l'image de base Assemblyline service⁠, qui est basée sur Debian 11 avec Python 3.11.

Les services d'Assemblyline utilisent les définitions d'étiquettes suivantes:

⁠Exécution de ce service

Ce service est spécialement optimisé pour fonctionner dans le cadre d'un déploiement d'Assemblyline.

Si vous souhaitez tester ce service localement, vous pouvez exécuter l'image Docker directement à partir d'un terminal:

docker run \
    --name Lookyloo \
    --env SERVICE_API_HOST=http://`ip addr show docker0 | grep "inet " | awk '{print $2}' | cut -f1 -d"/"`:5003 \
    --network=host \
    cccs/assemblyline-service-lookyloo

Pour ajouter ce service à votre déploiement d'Assemblyline, suivez ceci guide⁠.

⁠Documentation

La documentation générale sur Assemblyline peut être consultée à l'adresse suivante: https://cybercentrecanada.github.io/assemblyline4_docs/⁠