Go to file
2020-11-24 19:45:03 +01:00
analysis First commit 2020-11-24 19:45:03 +01:00
app First commit 2020-11-24 19:45:03 +01:00
assets First commit 2020-11-24 19:45:03 +01:00
server First commit 2020-11-24 19:45:03 +01:00
.gitignore First commit 2020-11-24 19:45:03 +01:00
config.yaml First commit 2020-11-24 19:45:03 +01:00
install.sh First commit 2020-11-24 19:45:03 +01:00
kiosk.sh First commit 2020-11-24 19:45:03 +01:00
LICENSE.txt First commit 2020-11-24 19:45:03 +01:00
NOTICE.txt First commit 2020-11-24 19:45:03 +01:00
README.md First commit 2020-11-24 19:45:03 +01:00
update.sh First commit 2020-11-24 19:45:03 +01:00

TinyCheck

Description

TinyCheck allows you to easily capture network communications from a smartphone or any device which can be associated to a Wi-Fi access point in order to quickly analyze them. This can be used to check if any suspect or malicious communication is outgoing from a smartphone, by using heuristics or specific Indicators of Compromise (IoCs).

Architecture

In order to make it working, you need a computer with a Debian-like operating system and two Wi-Fi interfaces. The best choice is to use a Raspberry Pi (3+) with a Wi-Fi dongle and a small touch screen. This tiny configuration (for less than $50) allows you to tap any Wi-Fi device, anywhere.

History

The idea of TinyCheck came to me in a meeting about stalkerwares with a French women's shelter. During this meeting we talked about how to easily detect easily stalkerwares without installing very technical apps nor doing forensic analysis on them. The initial concept was to develop a tiny kiosk device based on Raspberry Pi which can be used by non-tech people to test their smartphones against malicious communications issued by stalkerwares or any spyware.

Of course, TinyCheck can also be used to spot any malicious communications from cybercrime or state-sponsored implants. It allows the end-user to push his own extended Indicators of Compromise via a backend in order to detect some ghosts over the wire.

Use cases

TinyCheck can be used in several ways by individuals and entities:

  • Over a network - TinyCheck is installed on a network and can be accessed from a workstation via a browser.
  • In kiosk mode - TinyCheck can be used as a kiosk to allow visitors to test their own devices.
  • Fully standalone - By using a powerbank, you can tap any device anywhere.

How to analyze your smartphone

  1. Disable mobile aka. cellular data Disable the 3G/4G data link in your smartphone configuration.
  2. Connect your smartphone to the WiFi network generated by TinyCheck Once connected to the Wi-Fi network, its advised to wait like 10-20 minutes.
  3. Interact with your smartphone Send an SMS, make a call, take a photo, restart your phone - some implants might react to such events.
  4. Stop the capture Stop the capture by clicking on the button.
  5. Analyze the capture Analyze the captured communication, enjoy (or not).
  6. Save the capture Save the capture on an USB key or by direct download.

Architecture

TinyCheck is divided in three independent parts:

  • A backend: where the user can add his own extended IOCs, whitelist elements, edit the configuration etc.
  • A frontend: where the user can analyze the communication of his device by creating an ephemeral WiFi AP.
  • An analysis engine: used to analyze the pcap by using Zeek, Suricata, extended IOCs and heuristics.

The backend and the frontend are quite similar. Both consist of a VueJS application (sources stored under /app/) and an API endpoint developed in Flask (stored under /server/). The data shared between the backend and the frontend are stored under the config.yaml file for configuration and tinycheck.sqlite3 database for the whitelist/IOCs.

It is worthy to note that not all configuration options are editable from the frontend (such as default ports, Free certificates issuers etc.). Don't hesitate to take a look at the config.yaml file to tweak some configuration options.

Installation

Prior the TinyCheck installation, you need to have:

  • A Raspberry Pi with Raspberry Pi OS (or any computer with a Debian-like system)
  • Two working Wi-Fi interfaces (check their number with ifconfig | grep wlan | wc -l).
  • A working internet connection
  • (Adviced) A small touchscreen previously installed for the kiosk mode of TinyCheck.
$ cd /tmp/
$ git clone https://github.com/KasperskyLab/TinyCheck
$ cd TinyCheck
$ sudo bash install.sh

By executing install.sh, all the dependencies associated to the project will be installed and it can take several minutes depending of your internet speed. Four services are going to be created:

  • tinycheck-backend executing the backend server & interface;
  • tinycheck-frontend executing the frontend server & interface;
  • tinycheck-kiosk to handle the kiosk version of TinyCheck;
  • tinycheck-watchers to handle the watchers which update automatically IOCs / whitelist from external URLs;

Once installed, the operating system is going to reboot.

Meet the frontend

The frontend - which can be accessed from http://tinycheck.local - is a kind of tunnel which help the user throughout the process of network capture and reporting. It allows the user to setup a Wi-Fi connection to an existing Wi-Fi network, create an ephemeral Wi-Fi network, capture the communications and show a report to the user... in less than one minute, 5 clicks and without any technical knowledge.

Frontend

Meet the backend

Once installed, you can connect yourself to the TinyCheck backend by browsing the URL https://tinycheck.local and accepting the SSL self-signed certificate. The default credentials are tinycheck / tinycheck.

Backend

The backend allows you to edit the configuration of TinyCheck, add extended IOCs and whitelisted elements in order to prevent false positives. Several IOCs are already stored in the database such as few suricata rules, FreeDNS, Name servers, CIDRs known to host malicious servers and so on. In term of extended IOCs, this first version of TinyCheck includes:

  • Suricata rules
  • CIDRs
  • Domains & FQDNs (named generically "Domains")
  • IPv4 / IPv6 Addresses
  • Certificates sha1
  • Nameservers
  • FreeDNS
  • Fancy TLDs

Meet the analysis engine

The analysis engine is pretty straightforward. For this first version, the network communications are not analyzed in real time during the capture. The engine executes Zeek and Suricata against the previously saved network capture. Zeek is a well-known network dissector which stores in several logs the captured session.

Once saved, these logs are analysed to find extended IOCs (listed above) or to match heuristics rules (which can be deactivated through the backend). The heuristics rules are hardcoded in zeekengine.py, and they are listed below. As only one device is analyzed at a time, there is a low probability to see heuristic alerts leveraged.

  • UDP/ICMP going outside the local network
  • UDP/TCP connection with a destination port >1024
  • Remote host not resolved by DNS during the session
  • Use of self-signed certificate by the remote host
  • SSL connection done on a non standard port
  • Use of specific SSL certificates issuers by the remote host (such as Let's Encrypt)
  • HTTP requests done during the session
  • HTTP requests done on a non standard port
  • ...

On the Suricata part, the network capture is analysed against suricata rules saved as IOCs. Few rules are dynamics such as:

  • Device name exfiltred in clear-text;
  • Access point SSID exfiltred in clear-text;

Possible updates for next releases

  • Centralized server for IOC/whitelist management (aka. Remote Analysis).
  • Possibility to add watchers from the backend interface.
  • Encryption of reports.
  • Better frontend GUI/JS (use of websockets / better animations).
  • More OpSec (TOR integration etc.)

Special thanks

Guys who provided some IOCs

Code review

  • Dan Demeter
  • Maxime Granier
  • Florian Pires

Others

  • GReAT colleagues.
  • Zeek and Suricata awesome maintainers.
  • virtual-keyboard.js.org guys.
  • Loading.io guys.