Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Aidennnn33/sherlocksight
Use security OSINT tool Criminal IP (criminalip.io) to identify IoT equipment connected to the internet.
https://github.com/Aidennnn33/sherlocksight
criminalip criminalip-api iot osint osint-python security-scanner security-tools
Last synced: about 7 hours ago
JSON representation
Use security OSINT tool Criminal IP (criminalip.io) to identify IoT equipment connected to the internet.
- Host: GitHub
- URL: https://github.com/Aidennnn33/sherlocksight
- Owner: Aidennnn33
- License: gpl-3.0
- Created: 2022-12-13T09:54:55.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-23T03:50:46.000Z (about 1 year ago)
- Last Synced: 2023-08-23T06:45:04.637Z (about 1 year ago)
- Topics: criminalip, criminalip-api, iot, osint, osint-python, security-scanner, security-tools
- Language: Python
- Homepage:
- Size: 257 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ip-search-engines - SherlockSight (Criminal IP)
README
# Introduction
I hope you can explore the functionality of Criminal IP's security OSINT tool for identifying internet-connected IoT devices and utilizing the CLI to search and access detailed information about specific IP addresses from the obtained data.
# Prerequisites
* [criminalip.io](https://www.criminalip.io) API Key
You need to create an account and receive an API key at https://www.criminalip.io in order to use sherlocksigth.
Even if you have just a free account, you can access an API key. You can find and use the API key that is assigned to your account at https://www.criminalip.io/mypage/information.
# Installation
Clone repository:
```
$ git clone https://github.com/Aidennnn33/sherlocksight.git
```
```
$ cd sherlocksight
```
```
$ python3 -m venv .venv
$ source .venv/bin/activate
```
```
$ pip3 install -r requirements.txt
```
# Getting started
```
$ chmod +x sherlocksight
```
```
$ ./sherlocksight --auth [your-criminalip-api-key]
```
# Optional Arguments
| Flag | MetaVar | Usage |
| ------------- | ------------- | ------------------------------------------------------------ |
| `-A/--auth` | **API key** | api authentication with a valid [criminalip.io](http://criminalip.io/) api key |
| `-I/--ip` | **IP** | return information of a target IP |
| `-Q/--query` | **Query** | text search query |
| `-F/--full` | **Y/N** | return full(Y) or short information(N) of a target IP |
| `-O/--output` | **File Path** | write output to a file |
| `-S/--start` | **Number** | start number for search query |
| `-L/--list` | **Y/N** | return IoT search query |
| `-R/--read` | **File Path** | read file and pretty print the information |