Analysis Information Leak framework
 
 
 
 
 
Go to file
fukusuket e35924ec22 fix: [crawler] add exception handing for ping_lacus 2023-07-08 12:11:25 +09:00
.github/workflows fix: [tests] github workflow 2023-05-22 15:36:51 +02:00
bin fix: [crawler] add exception handing for ping_lacus 2023-07-08 12:11:25 +09:00
configs fix: [module.cfg] fix templateModule example 2023-05-30 14:49:17 +02:00
doc chg: [doc] add AIL v5.0 + objects + Importers + sync 2023-06-05 16:14:29 +02:00
files Update Mail 2023-06-07 15:14:46 +03:00
logs
other_installers chg: [cleanup] 2023-04-13 16:36:45 +02:00
samples/2021/01/01 chg: [modules + tests] fix modules + test modules on samples 2021-06-08 16:46:36 +02:00
tests fix: [tests] replace unmaintened nose by nose2 2023-05-23 14:47:02 +02:00
tools chg: [importers] add Dir/File Importer 2023-05-22 15:31:48 +02:00
update fix: [updater] fix db checker 2023-06-30 16:19:38 +02:00
var/www chg: [correlation] correlation graph, add an option to hide an object/node by pressing H + reset correlation graph 2023-07-07 16:29:32 +02:00
.gitchangelog.rc chg: [gitchangelog.rc] updated to output Markdown 2021-07-14 16:20:29 +02:00
.gitignore fix: [tests] fix tests 2023-05-23 13:38:33 +02:00
.gitmodules chg: [tags] refactor tags + cleanup 2022-11-22 10:47:15 +01:00
HOWTO.md chg: [kvrocks migration] mv update/v.50 2023-06-07 10:33:45 +02:00
LICENSE
README.md chg: [doc] add AIL v5.0 + objects + Importers + sync 2023-06-05 16:14:29 +02:00
SECURITY.md Create SECURITY.md 2022-02-03 10:15:12 +01:00
install_virtualenv.sh chg: [DB] remove ARDB + temp disable MISP import and auto export 2023-04-04 10:25:01 +02:00
installing_deps.sh fix: [tests] replace unmaintened nose by nose2 2023-05-23 14:47:02 +02:00
requirements.txt chg: [redis] update minimal version 2023-06-06 10:24:33 +02:00
reset_AIL.sh chg: [config] Kvrocks config + reset DB 2023-04-04 11:50:48 +02:00

README.md

AIL framework

Latest Release
CI
Gitter
Contributors
License

AIL framework - Framework for Analysis of Information Leaks

AIL is a modular framework to analyse potential information leaks from unstructured data sources like pastes from Pastebin or similar services or unstructured data streams. AIL framework is flexible and can be extended to support other functionalities to mine or process sensitive information (e.g. data leak prevention).

Dashboard

Finding webshells with AIL

AIL V5.0 Version:

AIL v5.0 introduces significant improvements and new features:

  • Codebase Rewrite: The codebase has undergone a substantial rewrite, resulting in enhanced performance and speed improvements.
  • Database Upgrade: The database has been migrated from ARDB to Kvrocks.
  • New Correlation Engine: AIL v5.0 introduces a new powerful correlation engine with two new correlation types: CVE and Title.
  • Enhanced Logging: The logging system has been improved to provide better troubleshooting capabilities.
  • Tagging Support: AIL objects now support tagging, allowing users to categorize and label extracted information for easier analysis and organization.
  • Trackers: Improved objects filtering, PGP and decoded tracking added.
  • UI Content Visualization: The user interface has been upgraded to visualize extracted and tracked information.
  • New Crawler Lacus: improve crawling capabilities.
  • Modular Importers and Exporters: New importers (ZMQ, AIL Feeders) and exporters (MISP, Mail, TheHive) modular design. Allow easy creation and customization by extending an abstract class.
  • Module Queues: improved the queuing mechanism between detection modules.
  • New Object CVE and Title: Extract an correlate CVE IDs and web page titles.

Features

  • Modular architecture to handle streams of unstructured or structured information
  • Default support for external ZMQ feeds, such as provided by CIRCL or other providers
  • Multiple Importers and feeds support
  • Each module can process and reprocess the information already analyzed by AIL
  • Detecting and extracting URLs including their geographical location (e.g. IP address location)
  • Extracting and validating potential leaks of credit card numbers, credentials, ...
  • Extracting and validating leaked email addresses, including DNS MX validation
  • Module for extracting Tor .onion addresses for further analysis
  • Keep tracks of credentials duplicates (and diffing between each duplicate found)
  • Extracting and validating potential hostnames (e.g. to feed Passive DNS systems)
  • A full-text indexer module to index unstructured information
  • Terms, Set of terms, Regex, typo squatting and YARA tracking and occurrence
  • YARA Retro Hunt
  • Many more modules for extracting phone numbers, credentials, and more
  • Alerting to MISP to share found leaks within a threat intelligence platform using MISP standard
  • Detecting and decoding encoded file (Base64, hex encoded or your own decoding scheme) and storing files
  • Detecting Amazon AWS and Google API keys
  • Detecting Bitcoin address and Bitcoin private keys
  • Detecting private keys, certificate, keys (including SSH, OpenVPN)
  • Detecting IBAN bank accounts
  • Tagging system with MISP Galaxy and MISP Taxonomies tags
  • UI submission
  • Create events on MISP and cases on The Hive
  • Automatic export on detection with MISP (events) and The Hive (alerts) on selected tags
  • Extracted and decoded files can be searched by date range, type of file (mime-type) and encoding discovered
  • Correlations engine and Graph to visualize relationships between decoded files (hashes), PGP UIDs, domains, username, and cryptocurrencies addresses
  • Websites, Forums and Tor Hidden-Services hidden services crawler to crawl and parse output
  • Domain availability monitoring to detect up and down of websites and hidden services
  • Browsed hidden services are automatically captured and integrated into the analyzed output, including a blurring screenshot interface (to avoid "burning the eyes" of security analysts with sensitive content)
  • Tor hidden services is part of the standard framework, all the AIL modules are available to the crawled hidden services
  • Crawler scheduler to trigger crawling on demand or at regular intervals for URLs or Tor hidden services

Installation

To install the AIL framework, run the following commands:

# Clone the repo first
git clone https://github.com/ail-project/ail-framework.git
cd ail-framework

# For Debian and Ubuntu based distributions
./installing_deps.sh

# Launch ail
cd ~/ail-framework/
cd bin/
./LAUNCH.sh -l

The default installing_deps.sh is for Debian and Ubuntu based distributions.

Requirement:

  • Python 3.7+

Installation Notes

For Lacus Crawler installation instructions, refer to the HOWTO

Starting AIL

To start AIL, use the following commands:

cd bin/
./LAUNCH.sh -l

You can access the AIL framework web interface at the following URL:

https://localhost:7000/

The default credentials for the web interface are located in the DEFAULT_PASSWORDfile, which is deleted when you change your password.

Training

CIRCL organises training on how to use or extend the AIL framework. AIL training materials are available at https://github.com/ail-project/ail-training.

API

The API documentation is available in doc/README.md

HOWTO

HOWTO are available in HOWTO.md

Privacy and GDPR

For information on AIL's compliance with GDPR and privacy considerations, refer to the AIL information leaks analysis and the GDPR in the context of collection, analysis and sharing information leaks document.

this document provides an overview how to use AIL in a lawfulness context especially in the scope of General Data Protection Regulation.

Research using AIL

If you use or reference AIL in an academic paper, you can cite it using the following BibTeX:

@inproceedings{mokaddem2018ail,
  title={AIL-The design and implementation of an Analysis Information Leak framework},
  author={Mokaddem, Sami and Wagener, G{\'e}rard and Dulaunoy, Alexandre},
  booktitle={2018 IEEE International Conference on Big Data (Big Data)},
  pages={5049--5057},
  year={2018},
  organization={IEEE}
}

Screenshots

Websites, Forums and Tor Hidden-Services

Domain CIRCL

Login protected, pre-recorded session cookies:

Domain cookiejar

Extracted encoded files from items

Extracted files

Correlation Engine

Correlation decoded image

Investigation

Investigation

Tagging system

Tags

Tags search

MISP Export

misp_export

MISP and The Hive, automatic events and alerts creation

tags_misp_auto

UI submission

ui_submit

Trackers

tracker-create

tracker-yara

retro-hunt

License

    Copyright (C) 2014 Jules Debra
    Copyright (c) 2021 Olivier Sagit
    Copyright (C) 2014-2023 CIRCL - Computer Incident Response Center Luxembourg (c/o smile, security made in Lëtzebuerg, Groupement d'Intérêt Economique)
    Copyright (c) 2014-2023 Raphaël Vinot
    Copyright (c) 2014-2023 Alexandre Dulaunoy
    Copyright (c) 2016-2023 Sami Mokaddem
    Copyright (c) 2018-2023 Thirion Aurélien

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.