Skip to content

A collection of scripts and tools that tracks the availability of hotspot 2.0, passpoint, and openroaming networks in the wild from the Wigle Dataset. Updates every 24 hours. Resets and archives yearly.

License

Notifications You must be signed in to change notification settings

simeononsecurity/track-openroaming-passpoint

Repository files navigation

Track OpenRoaming Passpoint

Sponsor Interactive Map Dune Dashboard

A collection of scripts and tools that tracks the availability of Hotspot 2.0, Passpoint, and OpenRoaming networks in the wild.

Pulls from the Wigle.net dataset.

Note: Information here may not be entirely accurate or complete, but it's the best semi-public dataset available for tracking this kind of information. The stats are dynamic, we only pull year to date stats. But ultimately we'll update it to do devices mapped in the last 365 days.

Note:: All of the categorizations and identifiers were discovered from public documentation and research that is repeatable with google searches.

OpenRoaming and Hotspot 2.0 Stats Table

Statistic Count Description
Total Hotspot 2.0 APs 26240 Total count of all Hotspot 2.0 access points
OpenRoaming Unsettled 7001 Count of devices with RCOI matching any OpenRoaming unsettled RCOI
OpenRoaming Settled 299 Count of devices with RCOI matching any OpenRoaming settled RCOI
EDUROAM Devices 629 Count of devices with RCOI containing either '5A03BA0800' or '1BC50460' or with an SSID matching "eduroam"
Google Orion Devices 11742 Count of devices with RCOI containing 'f4f5e8f5f4'
IronWiFi Devices 165 Count of devices with RCOI containing 'aa146b0000'
XNET Devices 237 Count of devices with SSID containing 'XNET'
Helium Devices 16 Count of devices with SSID containing 'Helium Mobile'
Wayru Devices 0 Count of devices with SSID containing 'Wayru'
MetaBlox Devices 8 Count of devices with SSID containing 'MetaBlox'
CityRoam Devices 911 Count of devices with SSID containing 'cityroam'
Other Devices 12419 Count of devices that do not match any of the above categories

Most Common RCOI Enabled SSIDs

SSID Count
BoldynPasspoint 3580
LiveBetter 3034
Cellular Wi-Fi Passthrough 2110
Xfinity Mobile 2003
.p 1692
adco 1067
Passpoint WiFi 972
GPGMS_CarrierOffloading 958
Orion 923
cityroam 909

Unique RCOIs

RCOI Definition Count
f4f5e8f5f4 Google Orion Devices 11742
5a03ba0000 OpenRoaming Unsettled (All) 6814
4096 OpenRoaming Unsettled Legacy / Samsung OneUI (All) 6802
cae505 Unknown 4008
310410 ATT Offload ? 3895
313100 ATT Offload ? 3895
310280 ATT Offload ? 3873
2233445566 Unknown 1314
21122 Unknown 1220
3af521 SingleDigits Testing RCOI 989
f4f5e8f5c4 Unknown 920
1bc50460 Eduroam Legacy 614
6a1f6c Unknown 533
5a03ba Unknown 451
1834af Unknown 290
baa2d00000 Unknown 283
aa146b0000 IronWiFi Devices 165
c6f9c Unknown 134
baa2d0 Unknown 99
500f OpenRoaming Settled Legacy (All paid members) 97
8c1f6467b4 Unknown 54
1bc504bd Unknown 50
506f9a Unknown 50
3213445172 Unknown 44
baa2d00100 OpenRoaming Settled (SP paid Bronze QoS) 39
24e4ce Unknown 29
5a03ba1000 OpenRoaming Unsettled (All with real ID) 29
1bc5046f Unknown 28
aa146b Unknown 27
c Unknown 25
1122330000 Unknown 18
500b OpenRoaming Unsettled Legacy (All with real ID) 13
3af050201 Unknown 11
5a03ba0800 OpenRoaming Unsettled (Education or Research ID free) 7
5a03ba0100 OpenRoaming Unsettled (SP free Bronze QoS) 4
743aef Unknown 2
5a03ba0600 OpenRoaming Unsettled (Loyalty Hospitality) 2
40202 Unknown 2
840112 Unknown 2
baa2d06000 Unknown 2
583039 Unknown 2
da9d490000 Unknown 1
112233 Unknown 1
445566 Unknown 1
f4f5e8f5d4 Alternative Orion Offload? 1
f4f5e8f5e4 Alternative Orion Offload? 1
a43 Unknown 1
da9d490005 Unknown 1

OpenRoaming and Hotspot 2.0 Table Mapped

OpenRoaming and Hotspot 2.0 Table Map

Table of Contents

Introduction

This project aims to track the availability of Hotspot 2.0, Passpoint, and OpenRoaming networks using data collected from WiGLE and other sources. The collected data is processed and visualized using various scripts.

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/track-openroaming-passpoint.git
    cd track-openroaming-passpoint
  2. Set up a virtual environment and activate it:

    python -m venv venv
    source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
  3. Install the required dependencies:

    pip install -r requirements.txt
  4. Create a .env file in the root directory with your API credentials:

    API_NAME=your_api_name
    API_TOKEN=your_api_token
    AUTH_HEADER=your_auth_header

Usage

Scripts

map_wigle_devices.py

Fetches data from the WiGLE API and saves it to a CSV file.

filter_sort_wigle_results.py

Filters and sorts the fetched WiGLE results and processes them for further analysis.

generate_map_html.py

Generates an interactive HTML map using Folium, displaying WiGLE data points. The HTML map files are saved to the Output directory and an archive subdirectory with the current year appended.

generate_map_png.py

Generates a static PNG map using Matplotlib and Basemap, displaying WiGLE data points. The PNG map files are saved to the Output directory and an archive subdirectory with the current year appended.

update_readme_stats.py

Updates the README.md file with statistics about the WiGLE data.

classify_locations.py

Classifies SSIDs from the WiGLE data as Residential, Business, or Public based on heuristics and performs reverse geocoding to add location information. The results are saved to a new CSV file.

Running the Scripts

  1. Fetch data from WiGLE:

    python scripts/map_wigle_devices.py
  2. Filter and sort the results:

    python scripts/filter_sort_wigle_results.py
  3. Generate the HTML map:

    python scripts/generate_map_html.py
  4. Generate the PNG map:

    python scripts/generate_map_png.py
  5. Update the README with statistics:

    python scripts/update_readme_stats.py
  6. Classify SSIDs and perform reverse geocoding:

    python scripts/classify_locations.py

Automated Workflow

The project includes a GitHub Actions workflow that runs the scripts automatically every 24 hours and updates the repository.

Workflow: .github/workflows/update_statistics.yml

  • Installs the pip requirements.
  • Runs the scripts in order:
    • map_wigle_devices.py
    • generate_map_html.py
    • generate_map_png.py
    • update_readme_stats.py
  • Commits the changes back to the repository.

GitHub Pages

The HTML maps are made available through GitHub Pages. The workflow ensures the HTML files are copied to the docs folder, which is configured for GitHub Pages.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.