OmniVision is a comprehensive network reconnaissance and security assessment tool, inspired by the multi-faceted vision of a bee. Designed to provide a holistic view of network vulnerabilities and risks, this tool combines multiple scanning techniques and intelligence sources.
- Multi-target Analysis: Scan domains, individual IPs, or entire subnets
- DNS Security Checks: Verify SPF, DMARC, and other DNS security configurations
- SSL/TLS Assessment: Evaluate certificate validity and cipher strength
- Port Scanning: Identify open ports and potentially vulnerable services
- Cloud Exposure Detection: Discover exposed cloud assets (S3 buckets, Azure blobs, etc.)
- Typosquatting Detection: Find similar domains that could be used for phishing
- Threat Intelligence Integration: Check targets against known threat databases
- Risk Scoring: Quantify security risks with weighted scoring system
- Multiple Output Formats: Generate reports in text, HTML, or CSV formats
- Progress Tracking: Visual feedback for long-running operations
- Parallel Processing: Configurable concurrent operations for faster scanning
If you enjoy using this app, why not
external_recon_risk_enhanced.py- Main script with all features and enhancements
dns_checks.py- DNS security configuration checks (SPF, DMARC, MX records)cert_checks.py- Certificate transparency log checkscloud_checks.py- Cloud asset exposure detectioncloudflare_checks.py- Cloudflare-specific security checkstyposquatting.py- Typosquatting domain detection
config.py- Original configuration file
debugging_report.md- Detailed report of issues found and fixes implementedssl_compatibility_changes.md- Documentation of changes made for SSL compatibilityssl_installation_instructions.md- Instructions for resolving SSL issues
aiohttp>=3.8.0
shodan>=1.28.0
requests>=2.28.0
typing-extensions>=4.5.0
python-dateutil>=2.8.2
asyncio>=3.4.3
python-whois>=0.8.0
dnspython>=2.3.0
tld>=0.13
idna>=3.4
chardet>=5.1.0
tqdm>=4.65.0
ipaddress>=1.0.23
argparse>=1.4.0
pyOpenSSL>=23.2.0
cryptography>=41.0.5
certifi>=2023.7.22
urllib3>=2.0.0
- Nmap: Required for port scanning functionality
The following API keys enhance functionality but are not strictly required:
- Shodan API key
- AbuseIPDB API key
- AlienVault OTX API key
- Censys API credentials
-
Clone the repository:
git clone https://github.com/yourusername/external-recon-risk.git cd external-recon-risk -
Install dependencies:
pip install -r requirements.txt
-
Install Nmap (if not already installed):
- Linux:
sudo apt-get update sudo apt-get install nmap
- macOS:
brew install nmap
- Windows:
- Download the installer from nmap.org
- Run the installer and follow the installation wizard
- Important: Add Nmap to your system PATH during installation
- During installation, check the option to add Nmap to the PATH
- Alternatively, manually add
C:\Program Files\NmaporC:\Program Files (x86)\Nmapto your system PATH
- Verify installation by opening Command Prompt and running:
nmap -V
- Linux:
If you encounter SSL-related errors on Windows, especially with Anaconda:
-
Install OpenSSL through conda:
conda install -c anaconda openssl
-
If errors persist, set environment variables:
set SSL_CERT_FILE=%CONDA_PREFIX%\Library\ssl\cert.pem set SSL_CERT_DIR=%CONDA_PREFIX%\Library\ssl\certs
-
Alternatively, use the SSL-compatible version of the script (
external_recon_risk_no_ssl.py)
For detailed SSL troubleshooting, refer to the ssl_installation_instructions.md file.
python external_recon_risk_enhanced.py example.com# Scan a domain with verbose output
python external_recon_risk_enhanced.py example.com --verbose
# Scan an IP address
python external_recon_risk_enhanced.py 192.168.1.1
# Scan a subnet (limited to 100 hosts)
python external_recon_risk_enhanced.py 192.168.1.0/24 --max-hosts 100
# Look back 60 days for typosquatting domains
python external_recon_risk_enhanced.py example.com --days 60# Generate HTML report
python external_recon_risk_enhanced.py example.com --output html
# Generate CSV findings
python external_recon_risk_enhanced.py example.com --output csv
# Generate all report formats
python external_recon_risk_enhanced.py example.com --output all# Increase parallel processing (1-5)
python external_recon_risk_enhanced.py example.com --parallel 3
# Disable progress bars
python external_recon_risk_enhanced.py example.com --no-progress# Provide API keys via command line
python external_recon_risk_enhanced.py example.com --shodan-key YOUR_KEY --abuseipdb-key YOUR_KEY
# Or set environment variables
export SHODAN_API_KEY=your_key
export ABUSEIPDB_API_KEY=your_key
export OTX_API_KEY=your_key
export CENSYS_API_ID=your_id
export CENSYS_API_SECRET=your_secretThe tool assigns one of the following risk levels based on the calculated risk score:
- CRITICAL: Score > 100
- HIGH: Score > 70
- MEDIUM: Score > 40
- LOW: Score > 10
- INFO: Score ≤ 10
==================================================
EXTERNAL RECONNAISSANCE REPORT FOR example.com
==================================================
Scan Time: 2025-04-09 08:17:51
Target Type: DOMAIN
Risk Level: MEDIUM
Risk Score: 45
FINDINGS SUMMARY
--------------------------------------------------
HIGH Severity Findings:
1. [Email Security] No DMARC record found
2. [Vulnerabilities] Found 2 known vulnerabilities for 192.168.1.1
MEDIUM Severity Findings:
1. [Email Security] SPF record exists but does not end with a strict or soft fail directive
2. [Exposed Services] Critical service SSH exposed on port 22
IP DETAILS
--------------------------------------------------
IP: 192.168.1.1
Organization: Example Organization
Country: United States
City: New York
Open Ports: 22, 80, 443
Services:
22/tcp - ssh OpenSSH 8.2p1 (protocol 2.0)
80/tcp - http nginx 1.18.0
443/tcp - ssl/http nginx 1.18.0
RECOMMENDATIONS
--------------------------------------------------
1. Implement a DMARC record with at least a quarantine policy
2. Implement a proper SPF record with a strict policy (-all)
3. Patch systems to address known vulnerabilities
4. Restrict access to critical services using firewalls
5. Regularly monitor for new vulnerabilities and security issues
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
- This tool utilizes various security APIs and open-source tools
- Special thanks to the security community for their continuous research and tools
