IoT_Scanner - IoT Scanner by ASA - Scan for active IoT devices a

项目说明

IoT_Scanner v.1.1 (Email App has been updated)

NOTE: This scanner does not work on Windows machines or on Linux systems running on VMs. The scanner has been tested on Raspberry pi 0, 3, and 4 only.

Step by Step instructions:

Download the Setup file from here:

You can either watch the video to see how it's done OR follow the instructions below.

Video Link:

NOTE: Skip the email part from the video as we ha our email app (GO to 3.6).

###########################################################################
###########################################################################

1- General Information

1.1 Introduction
The Internet of Things or IoT is influencing our lifestyle from the way we react to the way we behave. From air conditioners that you can control with your smartphone to Smart Cars pro the shortest route or your Smartwatch which is tracking your daily acti. IoT is a giant network with connected devices. These devices gather and share data about how they are used and the en in which they are operated.

1.2 Why IoT Scanner?
Anybody who is concerned with WIFI security and personal computer/laptop. For Example, Fleming college, McDonald’s, Tim Horton, hotels, and home network. The IoT Tester can help scan the network you are connected to and list all so we can be protected and detect any potential threat. This device offers detailed information (name, range, IP address, etc.) of all connected devices with detected by checking and comparing from the in-built database.

1.3 Why Our IoT Scanner?
What makes this tester superior to most others on the market is its ability to detect Bluetooth devices not just devices on Wi-Fi networks. This tester will be connected to your system and performance will depend on your system specification.
Features:
Easy use - Nice and Simple graphical user interface - Fast responsi - Deli .

#############################################################################
#############################################################################
#############################################################################
#############################################################################
#############################################################################

2- Getting started

2.1 Requirements
You need to ha a Raspberry Pi handed by us OR a setup.sh file That you can download from Dropbox. (Link is Below at 3.1).
- If you get the Raspberry Pi from us, all you need to do is to connect the Raspberry Pi to the Wi-Fi.
o On the upper right corner CLICK the Wi-Fi symbol > Choose your Wi-Fi network > Type your Wi-Fi password.
o You will see a file called “setup.sh” on your Desktop that is ready to run. DOUBLE CLICK the file > Execute OR Execute in Terminal.
- If you have your own Raspberry Pi, you can skip a few steps and go to (3.1).
-
2.2 The Raspberry Pi
In order to use the Raspberry Pi computer, you need the following accessories:
- A power adapter (included).
- SD Card (included and configured).
- A computer monitor, or tele. Most should work as a display for the Raspberry Pi, but for best results, you should use a display with HDMI input. You’ll also need an appropriate display cable, to connect your monitor to your Raspberry Pi.
- A computer keyboard and mouse
o Any standard USB keyboard and mouse will work with your Raspberry Pi.
o Wireless keyboards and mice will work if already paired.
Raspberry Pi Documentation - Getting Started

2.3 Connecting the SD Card
Raspberry Pi computers use a micro-SD card, except for very early models which use a full-sized SD card. This card (64GB) will be included and configured for users, so they don’t have to install an operating system.

2.4 Connecting the Display
Your Raspberry Pi has an HDMI port which you can connect directly to a monitor or TV with an HDMI cable. This is the easiest solution; some modern monitors and TVs have HDMI ports, some do not, but there are other options. (We will include the HDMI cable with the Raspberry Pi).

2.5 Connecting the Keyboard and the Mouse
You will be receiving a Raspberry Pi 4 Model B that has 2x USB 3.0 AND 2x USB 2.0 ports. Connect your keyboard and mouse to two of them.

2.6 Power On the Raspberry Pi
After connecting the accessories, connect the power supply and the Raspberry Pi will start automatically (There is no POWER ON/OFF on the Raspberry Pi). Then, you will be logged in to the machine and directed to the Desktop.

2.7 Running the Setup file
After powering on the machine, you will see our setup file on the desktop. Don’t run it yet. You can skip a few steps and go directly to (3.3).

#############################################################################
#############################################################################
#############################################################################
#############################################################################
#############################################################################

3- Step-by-Step instructions
You can either watch the video to see how it's done OR follow the instructions below.
Video Link:
3.1 setup.sh file
The user needs to have our file "setup.sh". When running this file for the first time, it will install the latest system update (update the packages), Python3, Python-pip3, and some Python modules required to complete the scan and run our app. The modules include Tkinter (used for the GUI), Bluetooth (to scan for Bluetooth devices), and nvdlib (to get info about and CVEs from the N).
You can download the file from the following link:

3.2 Changing the permissions
After downloading the setup.sh file, you will need to change the "Execute permissions" to anyone so you can run the file in your machine.
There are two ways to change the permissions (The first way is much easier):
1- Right Click the file (setup.sh) > Properties > Go to Permissions tab > Change "Execute" to "Anyone".

2- Right Click the file (setup.sh) > Properties > Under General > Copy the location of the file (path) > On the top left corner or down left corner > Click your Raspberry Pi logo > Choose "Accessories" > Terminal > Type without brackets (cd AND_THEN_PASTE_THE_COPIED_LOCATION) > Hit Enter
> Now type without brackets (chmod +x setup.sh) > Hit Enter

3.3 Running the setup.sh file
You can either watch the video to see how it's done OR follow the instructions below.
Video Link:
Now, you can run the setup file.
Double click the setup.sh file and then choose either Execute OR Execute in Terminal.
3.4 Scanning results
After running the setup.sh file, if you choose “Execute in Terminal”, you will see that the scan is started, and it will show your connected devices with their IP and Mac Addresses. Wait for a few minutes till the GUI starts.

3.5 The GUI app
When the completes, our GUI app will start. We’ve made it so simple, so the end users know how to use it.
You will see only 2 buttons on our GUI app. The first one is to see the scanning results in a good and an understandable format, and the second button is to exit the program.
When you click “Click here to see the results”, a second window will open, so you can get full results. You can select all the results, copy them, and paste them in a text file. BUT we’ve made easier for the users. Our tool will save the results in two separate files. The first file named “rev.txt” that would contain a list of all the connected devices with their names, IP addresses, and Mac addresses, and the second file named “results.txt” which is the most important one. It would contain a list of all devices with their product names and CVEs.
Now, you can close the program by clicking “Exit Program” button.

3.6 The Email App

NOTE: We ha the email app. You are no longer required to type the sender email and password. You can skip the EMAIL part on the video and continue here.
When you close the program, our email app will start. You will get two windows.

###########################################################################
###########################################################################
###########################################################################
###########################################################################
###########################################################################

4- Next and Updates:

4.1 How to update?
In order to keep following the latest updates of our IoT Scanner, you need to follow the scanner page on GitHub at
We will keep pushing updates to make sure that our tool ne.
What users need to do is to go to our scanner page, scroll down, and check the README file.
Check the of the scanner. This is 1.0 (v.1.0). If there is a new update, we will post the new on that page and change that to something like “v.1.1” or “v.2.0”.
We will also upload the file to a cloud storage and give the link as well as a new video instruction.
If we were to make big changes, we would most likely make a new user manual and post it on the same page.

4.2 What’s coming?
Our next of the scanner will include:
- Better email delivery method so users don’t have to turn on “less secure apps” on their Google Accounts.
- Better GUI looking app with more buttons so users can choose where to save the results.
- Better results: That includes more details about each CVE and solutions.
- Our next will support Windows machines as well as Linux machines running on en.
- We might add some links to each detected on each device to help you secure your network, that includes, YouTube , articles, and more.

############################################################################
############################################################################
############################################################################
############################################################################
############################################################################

5- Summary:
Scans the network and lists all device IP addresses and MAC addresses. It will then allow the user to select a device and will be able to track this device’s detailed info This could help make the network more secure and be aware of potential threats.
The main objective is to map out the IoT devices and their associated .
List all networks Wi-Fi and Bluetooth devices with name and IP address
Compare scanned results for by looking into the database
We used python3 to create scripts and execute them to achieve the goal
First, we divided the project into parts so we can work on it indi which would be
1. Execution script.
2. Scanning network script Wi-Fi and Bluetooth.
3. Database to store scanned results.
4. Scanning with NVD.
5. Result email delivery.

项目信息

开发语言：Python

Star 数：11

技术要点

该项目属于安全软件方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕IoT Scanner by ASA - Scan for active IoT devices and find their vulnerabilities展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。