A Context By Signal

Index → Tutorial

Tutorial

Get started with packet analysis.

IMPORTANT

Before you get started

This short tutorial explains how to do a packet capture. To keep it simple, we use a Mac computer that has a built-in WiFi adapter. This method produces a Wireshark-formatted capture file that you can upload to Context By Signal.

Requirements

  • Mac computer. Most Mac computers satisfy the basic requirement for a host with a wireless adapter that can be put into monitor mode. If you're not sure your Mac has a built-in adapter, see [link].
  • Airtool 2. A capture application that disconnects the built-in adapter from the wireless network and puts it into monitor mode. When the adapter is in monitor mode, it passes all the frames it receives to Airtool. Normally, the adapter only accepts packets addressed to the host computer.

The process of packet capture is both complex and imperfect. The tools you select for your captures vary based on hardware, software, and network protocol. The results you get vary based not only on the combination of tools and settings you select, but on factors that extend to the site of the capture and ambient conditions.

If you're already acquainted with the in's and out's of wireless capture and have a few captures on hand, go ahead and create a job on the Analyze page. To learn more about the hardware and software that is used to collect wireless network information on different generations of WiFi networks, see Observation constraints.

Make a frame capture

The best way to get a capture file to analyze is to make it yourself. When you do your own captures, you know the hardware and software that was used to make the capture and the environment where the capture was made. This means that the observation summary you get from the analysis will make more sense.

You can also try creating captures in different environments across different versions of WiFi and use CBS to compare the observation records. Soon you'll be able to create batch jobs and aggregate your analysis across capture files to create site fingerprints and understand the wireless context of your site.

Step 1

Sign in

You'll need to sign in before creating an analysis job.

To sign in

  1. Go to the Analyze page.
  2. In Sign in, enter your name and email address. We use this information to notify you when your analysis job is complete.
  3. Enter the city and postal code of the location of your capture.
  4. Select the options that describe the location.

Step 2

Step 2. Upload files

To upload files

  1. Click Choose file.
  2. From your desktop, select the Wireshark format file you want to upload. CBS accepts capture files in Wireshark PCAP and PCAPNG formats.
  3. Click UPLOAD. To remove a selected file, click CLEAR.

Step 3

Step 3. Select options

When analysis is complete, CBS sends a link to the observation summary to your email address.

To receive an additional copy of the report in CSV format, select CSV FILE.

To receive an additional copy of the report as a JavaScript Object Notation (JSON) file, select JSON. This format is commonly used for data exchange in software applications.

For an additional report with anonymized MAC addresses, select ANONYMIZE.

Step 4

Step 4. Review your observation summary

For reference information on the descriptive tables that are contained in the observation summary, see Data Tables.

For a walk-through of an observation summary, see Example summary.