{"id":22097758,"url":"https://github.com/izzuddinafif/iot-vuln-scanner","last_synced_at":"2026-04-14T06:05:17.149Z","repository":{"id":261355904,"uuid":"884066231","full_name":"izzuddinafif/iot-vuln-scanner","owner":"izzuddinafif","description":"IoT Vulnerability Scanner that uses Laravel as the web frontend, Go for the backend HTTP server to handle scan requests, and Python for network scanning (leveraging Nmap).","archived":false,"fork":false,"pushed_at":"2024-11-08T08:08:12.000Z","size":83,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-24T01:25:14.621Z","etag":null,"topics":["go","iot","iot-security","laravel","nmap","php","python","vulnerability-scanner"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/izzuddinafif.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-06T04:31:34.000Z","updated_at":"2024-11-08T08:08:15.000Z","dependencies_parsed_at":"2024-11-06T05:26:59.353Z","dependency_job_id":"d04b167e-3489-432a-8932-dd500ccd3797","html_url":"https://github.com/izzuddinafif/iot-vuln-scanner","commit_stats":null,"previous_names":["izzuddinafif/iot-vuln-scanner"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/izzuddinafif/iot-vuln-scanner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/izzuddinafif%2Fiot-vuln-scanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/izzuddinafif%2Fiot-vuln-scanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/izzuddinafif%2Fiot-vuln-scanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/izzuddinafif%2Fiot-vuln-scanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/izzuddinafif","download_url":"https://codeload.github.com/izzuddinafif/iot-vuln-scanner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/izzuddinafif%2Fiot-vuln-scanner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31784255,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T02:24:21.117Z","status":"ssl_error","status_checked_at":"2026-04-14T02:24:20.627Z","response_time":153,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","iot","iot-security","laravel","nmap","php","python","vulnerability-scanner"],"created_at":"2024-12-01T04:16:40.227Z","updated_at":"2026-04-14T06:05:17.114Z","avatar_url":"https://github.com/izzuddinafif.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IoT Vulnerability Scanner\n\nThis project is an IoT Vulnerability Scanner that uses Laravel as the web frontend, Go for the backend HTTP server to handle scan requests, and Python for network scanning (leveraging Nmap). The setup is designed to scan a network for open ports and services on IoT devices, helping to identify potential security vulnerabilities.\n\n## Project Structure\n```\nIOT-VULN-SCANNER/\n├── go/\n│   ├── go.mod                # Go module file for dependencies\n│   └── app/\n│       └── server.go         # Go HTTP server for handling scan requests\n├── laravel/\n│   ├── app/                  # Laravel application files\n│   ├── routes/               # Routes definition\n│   └── ...                   # Other Laravel directories and config files\n├── python/\n│   ├── requirements.txt      # Python dependencies\n│   └── scanner_service.py    # Python script that performs the scan using Nmap\n├── run.sh                    # Script to start Go, Python, and Laravel services\n├── LICENSE                   # License file\n└── README.md                 # Project documentation\n```\n\n## Requirements\n- **Go**: Version 1.16 or later\n- **Python**: Version 3.7 or later\n- **PHP**: Version 7.4 or later (for Laravel)\n- **Nmap**: Ensure Nmap is installed on the system for network scanning\n- **Composer**: To manage Laravel dependencies\n\n```bash\nsudo apt install nmap php composer\n``` \n\n## Setup Instructions\n\n1. **Clone the Repository**:\n\n   ```bash\n   git clone https://github.com/izzuddinafif/iot-vuln-scanner.git\n   cd iot-vuln-scanner\n   ```\n\n2. **Install Python Dependencies**:\n   Navigate to the `python` directory and install the required packages:\n\n   ```bash\n   pip install -r python/requirements.txt\n   ```\n\n3. **Install Laravel Dependencies**:\n   In the `laravel` directory, install dependencies and set up the `.env` file:\n\n   ```bash\n   cd laravel\n   cp .env.example .env\n   composer install\n   php artisan key:generate\n   ```\n\n4. **Run the Project**:\n   Use the `run.sh` script to start all services (Go, Python, and Laravel).\n\n   ```bash\n   chmod +x run.sh\n   ./run.sh [optional IP range]\n   ```\n\n   - If no IP range is specified, it defaults to `192.168.1.0/24`.\n\n   - Example:\n\n     ```bash\n     ./run.sh 192.168.217.0/24\n     ```\n\n## Usage\n\nOnce the services are running, you can access the Laravel frontend at `https://iot-vuln-scanner.izzuddinafif.com` to initiate network scans and view results.\n\n### Initiating a Scan\n\n1. **From the Web Interface**:\n   - Go to `https://iot-vuln-scanner.izzuddinafif.com` and click on \"Start Scan\" to initiate a scan.\n\n2. **Using CURL**:\n   - Initiate a scan with the default IP range:\n     ```bash\n     curl \"http://localhost:8080/scan\"\n     ```\n   - Specify a target IP range:\n     ```bash\n     curl \"http://localhost:8080/scan?target=192.168.1.0/24\"\n     ```\n\nThe Go server forwards the scan request to the Python service, which performs the scan with Nmap and returns results in JSON format.\n\n## Example JSON Response\n\n```json\n{\n    \"192.168.217.165\": {\n        \"addresses\": {\n            \"ipv4\": \"192.168.217.165\"\n        },\n        \"hostnames\": [],\n        \"ports\": [\n            {\n                \"port\": 53,\n                \"service\": \"domain\",\n                \"state\": \"open\"\n            }\n        ]\n    },\n    \"192.168.217.32\": {\n        \"addresses\": {\n            \"ipv4\": \"192.168.217.32\"\n        },\n        \"hostnames\": [],\n        \"ports\": [\n            {\n                \"port\": 21,\n                \"service\": \"ftp\",\n                \"state\": \"open\"\n            },\n            {\n                \"port\": 80,\n                \"service\": \"http\",\n                \"state\": \"open\"\n            }\n        ]\n    }\n}\n```\n\n## Customization\n\n- **Change Default IP Range**: Modify the default range in `server.go` or pass a range to `run.sh` when starting.\n- **Adjust Laravel Frontend**: Customize `laravel/resources` for frontend adjustments.\n- **Add Scanning Options**: Modify `scanner_service.py` to add more Nmap options or use Nmap’s scripting engine for specific vulnerability checks.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.\n\n## Contributing\n\nContributions are welcome! Feel free to submit issues or pull requests to improve the project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fizzuddinafif%2Fiot-vuln-scanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fizzuddinafif%2Fiot-vuln-scanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fizzuddinafif%2Fiot-vuln-scanner/lists"}