Entdecken Sie Search Engine Tool Cheat Sheet¶
Im Überblick
Uncover ist eine leistungsstarke Suchmaschinen-Wrapper von Project Discovery entwickelt, die es ermöglicht, exponierte Hosts im Internet mit mehreren Suchmaschinen schnell zu entdecken. Es bietet eine einheitliche Schnittstelle zur Abfrage beliebter Suchmaschinen wie Shodan, Censys, Fofa, Hunter, Zoomeye, Netlas und mehr, so dass es ein wesentliches Werkzeug für die Aufklärung und Angriff Oberflächenkartierung.
Was ist los? Abgesehen von der direkten Nutzung dieser Suchmaschinen ist seine Fähigkeit, mehrere Anbieter gleichzeitig abzufragen, die Ergebnisse zu normalisieren und in einem konsistenten Format bereitzustellen. Dies beschleunigt den Prozess der Entdeckung von internetbasierten Vermögenswerten deutlich und hilft Sicherheitsexperten, potenzielle Sicherheitsrisiken effizienter zu identifizieren. Uncover ist mit Automatisierung im Denken entworfen, so dass es einfach in Sicherheits-Workflows und Pipelines zu integrieren.
Uncover wird häufig von Sicherheitsforschern, Bug-Bounty-Jägern und Penetration-Testern verwendet, um exponierte Dienste, verletzliche Anwendungen und falsche Systeme zu entdecken. Seine Fähigkeit, mehrere Suchmaschinen zu nutzen, bietet einen umfassenderen Blick auf die Angriffsfläche und erhöht die Chancen, Sicherheitsprobleme zu finden, die bei der Verwendung einer Hand verpasst werden könnten.
• Installation
Verwenden von Go¶
# Install using Go (requires Go 1.20 or later)
go install -v github.com/projectdiscovery/uncover/cmd/uncover@latest
# Verify installation
uncover -version
Verwenden von Docker¶
# Pull the latest Docker image
docker pull projectdiscovery/uncover:latest
# Run Uncover using Docker
docker run -it projectdiscovery/uncover:latest -h
Verwendung von Homebrew (macOS)¶
Verwenden von PDTM (Projekt Discovery Tools Manager)¶
# Install PDTM first if not already installed
go install -v github.com/projectdiscovery/pdtm/cmd/pdtm@latest
# Install Uncover using PDTM
pdtm -i uncover
# Verify installation
uncover -version
Auf Kali Linux
oder Basisnutzung
Suchen mit Queries¶
# Search using a basic query
uncover -q "apache"
# Search using multiple queries
uncover -q "apache,nginx"
# Search from a file containing queries
uncover -qf queries.txt
# Search from STDIN
echo "apache"|uncover
Provider Selection¶
# Search using a specific provider
uncover -q "apache" -e shodan
# Search using multiple providers
uncover -q "apache" -e shodan,censys
# List available providers
uncover -list-engines
Ausgabeoptionen¶
# Save results to a file
uncover -q "apache" -o results.txt
# Output in JSON format
uncover -q "apache" -json -o results.json
# Silent mode (only results)
uncover -q "apache" -silent
Konfiguration des Anbieters
API Schlüsselkonfiguration¶
# Set Shodan API key
uncover -shodan-key YOUR_SHODAN_API_KEY
# Set Censys API credentials
uncover -censys-id YOUR_CENSYS_ID -censys-secret YOUR_CENSYS_SECRET
# Set Fofa API credentials
uncover -fofa-email YOUR_FOFA_EMAIL -fofa-key YOUR_FOFA_KEY
# Set ZoomEye API key
uncover -zoomeye-key YOUR_ZOOMEYE_API_KEY
# Set Hunter API key
uncover -hunter-key YOUR_HUNTER_API_KEY
# Set Netlas API key
uncover -netlas-key YOUR_NETLAS_API_KEY
# Set Quake API key
uncover -quake-key YOUR_QUAKE_API_KEY
# Set Criminalip API key
uncover -criminalip-key YOUR_CRIMINALIP_API_KEY
Provider-spezifische Optionen¶
# Set maximum results per provider
uncover -q "apache" -limit 100
# Set timeout for provider requests
uncover -q "apache" -timeout 60
/ Fortgeschrittene Nutzung
Erweiterte Suchanfragen¶
# Search for specific ports
uncover -q "port:80"
# Search for specific services
uncover -q "product:nginx"
# Search for specific vulnerabilities
uncover -q "vuln:cve-2021-44228"
# Search for specific countries
uncover -q "country:US"
# Search for specific organizations
uncover -q "org:\"Example Inc\""
# Combine multiple filters
uncover -q "port:443 product:nginx country:US"
ASN Syntax herunterladen¶
# Search using ASN query syntax
uncover -asq "asn:AS15169 product:nginx"
# Search for specific ASN
uncover -asq "asn:AS15169"
# Search for specific organization
uncover -asq "org:Google"
# Search for specific IP range
uncover -asq "ip:8.8.8.0/24"
Feldauswahl¶
# Select specific fields to display
uncover -q "apache" -f ip,port,host
# Available fields: ip, port, host, country, city, org, isp, asn, product, version
Integration mit anderen Tools
Pipeline mit HTTPX¶
# Discover hosts and probe for HTTP services
uncover -q "apache" -silent|httpx -silent
# Discover hosts, filter by port, and probe for HTTP services
uncover -q "port:443" -silent|httpx -silent
Pipeline mit Nuclei¶
# Discover hosts and scan for vulnerabilities
uncover -q "apache" -silent|nuclei -t cves/
# Discover hosts with specific product and scan for related vulnerabilities
uncover -q "product:nginx" -silent|nuclei -t exposures/
Pipeline mit Naabu¶
# Discover hosts and scan for open ports
uncover -q "apache" -silent|naabu -silent
# Discover hosts and scan for specific ports
uncover -q "apache" -silent|naabu -p 80,443,8080 -silent
/ Output Customization
Individuelle Ausgabeformat¶
# Output only IP addresses
uncover -q "apache" -silent -f ip
# Output IP:port format
uncover -q "apache" -silent -f ip,port|awk '\\\\{print $1":"$2\\\\}'
# Count results
uncover -q "apache" -silent|wc -l
# Sort output by IP
uncover -q "apache" -silent|sort
Filterausgang¶
# Filter by specific pattern
uncover -q "apache" -silent|grep "8.8.8"
# Filter by port
uncover -q "apache" -silent -f ip,port|grep ":443$"
# Find unique IPs
uncover -q "apache" -silent -f ip|sort -u
Erweiterte Filterung
Provider-Specific Filtering¶
# Filter Shodan results by port
uncover -q "apache" -e shodan -silent|grep ":80$"
# Filter Censys results by country
uncover -q "apache" -e censys -silent -f ip,country|grep "US$"
# Filter Fofa results by title
uncover -q "apache" -e fofa -silent|grep "Dashboard"
Mehrere Abfragen kombinieren¶
# Search for multiple products
uncover -q "product:nginx,product:apache" -silent
# Search for multiple ports
uncover -q "port:80,port:443" -silent
# Search for multiple vulnerabilities
uncover -q "vuln:cve-2021-44228,vuln:cve-2021-40438" -silent
Anbieter-Specific Syntax
Shodan Syntax¶
# Basic Shodan query
uncover -q "apache" -e shodan
# Shodan port filter
uncover -q "port:80" -e shodan
# Shodan product filter
uncover -q "product:nginx" -e shodan
# Shodan country filter
uncover -q "country:US" -e shodan
# Shodan organization filter
uncover -q "org:\"Example Inc\"" -e shodan
# Shodan ASN filter
uncover -q "asn:AS15169" -e shodan
# Shodan vulnerability filter
uncover -q "vuln:cve-2021-44228" -e shodan
Censys Syntax
# Basic Censys query
uncover -q "apache" -e censys
# Censys port filter
uncover -q "services.port=80" -e censys
# Censys product filter
uncover -q "services.software.product=nginx" -e censys
# Censys country filter
uncover -q "location.country_code=US" -e censys
# Censys ASN filter
uncover -q "autonomous_system.asn=15169" -e censys
Fofa Syntax¶
# Basic Fofa query
uncover -q "apache" -e fofa
# Fofa port filter
uncover -q "port=80" -e fofa
# Fofa product filter
uncover -q "app=\"nginx\"" -e fofa
# Fofa country filter
uncover -q "country=\"US\"" -e fofa
# Fofa ASN filter
uncover -q "asn=\"AS15169\"" -e fofa
Zoom Augen Syntax¶
# Basic ZoomEye query
uncover -q "apache" -e zoomeye
# ZoomEye port filter
uncover -q "port:80" -e zoomeye
# ZoomEye product filter
uncover -q "app:nginx" -e zoomeye
# ZoomEye country filter
uncover -q "country:US" -e zoomeye
# ZoomEye ASN filter
uncover -q "asn:15169" -e zoomeye
Fehlerbehebung
Häufige Fragen¶
ANHANG API Schlüsselfragen
# Verify API key configuration
uncover -list-keys
# Update API key
uncover -shodan-key YOUR_NEW_SHODAN_API_KEY
```_
2. **Beschränkung**
```bash
# Reduce number of queries
uncover -q "apache" -limit 10
# Increase timeout
uncover -q "apache" -timeout 60
```_
3. ** Keine Ergebnisse**
```bash
# Try a different provider
uncover -q "apache" -e censys
# Try a more general query
uncover -q "web" -e shodan
```_
4. ** Anfragen*
```bash
# Check internet connection
ping 8.8.8.8
# Increase timeout
uncover -q "apache" -timeout 60
```_
### Debugging
```bash
# Enable verbose mode
uncover -q "apache" -v
# Show debug information
uncover -q "apache" -debug
# Check provider status
uncover -list-engines
Konfiguration
Konfigurationsdatei¶
Uncover verwendet eine Konfigurationsdatei unter $HOME/.config/uncover/provider-config.yaml_. Sie können verschiedene Einstellungen in dieser Datei anpassen:
# Example configuration file
shodan:
key: YOUR_SHODAN_API_KEY
censys:
id: YOUR_CENSYS_ID
secret: YOUR_CENSYS_SECRET
fofa:
email: YOUR_FOFA_EMAIL
key: YOUR_FOFA_KEY
zoomeye:
key: YOUR_ZOOMEYE_API_KEY
hunter:
key: YOUR_HUNTER_API_KEY
netlas:
key: YOUR_NETLAS_API_KEY
quake:
key: YOUR_QUAKE_API_KEY
criminalip:
key: YOUR_CRIMINALIP_API_KEY
Umgebungsvariablen¶
# Set Uncover configuration via environment variables
export SHODAN_API_KEY=YOUR_SHODAN_API_KEY
export CENSYS_API_ID=YOUR_CENSYS_ID
export CENSYS_API_SECRET=YOUR_CENSYS_SECRET
export FOFA_EMAIL=YOUR_FOFA_EMAIL
export FOFA_KEY=YOUR_FOFA_KEY
export ZOOMEYE_API_KEY=YOUR_ZOOMEYE_API_KEY
export HUNTER_API_KEY=YOUR_HUNTER_API_KEY
export NETLAS_API_KEY=YOUR_NETLAS_API_KEY
export QUAKE_API_KEY=YOUR_QUAKE_API_KEY
export CRIMINALIP_API_KEY=YOUR_CRIMINALIP_API_KEY
Referenz
Kommandozeilenoptionen¶
| Flag | Description |
|---|---|
| INLINE_CODE_32 | Query to search |
| INLINE_CODE_33 | File containing queries to search |
| INLINE_CODE_34 | Search engine(s) to use |
| INLINE_CODE_35 | File to write output to |
| INLINE_CODE_36 | Write output in JSON format |
| INLINE_CODE_37 | Show only results in output |
| INLINE_CODE_38 | Show verbose output |
| INLINE_CODE_39 | Show debug information |
| INLINE_CODE_40 | Fields to display in output |
| INLINE_CODE_41 | Maximum number of results per provider |
| INLINE_CODE_42 | Timeout for provider requests in seconds |
| INLINE_CODE_43 | Use ASN query syntax |
| INLINE_CODE_44 | List available search engines |
| INLINE_CODE_45 | List configured API keys |
| INLINE_CODE_46 | Shodan API key |
| INLINE_CODE_47 | Censys API ID |
| INLINE_CODE_48 | Censys API secret |
| INLINE_CODE_49 | Fofa email |
| INLINE_CODE_50 | Fofa API key |
| INLINE_CODE_51 | ZoomEye API key |
| INLINE_CODE_52 | Hunter API key |
| INLINE_CODE_53 | Netlas API key |
| INLINE_CODE_54 | Quake API key |
| INLINE_CODE_55 | Criminalip API key |
| INLINE_CODE_56 | Show Uncover version |
| _ | |
| ### Unterstützte Anbieter |
| Provider | Description | API Key Required |
|---|---|---|
| INLINE_CODE_57 | Shodan search engine | Yes |
| INLINE_CODE_58 | Censys search engine | Yes |
| INLINE_CODE_59 | Fofa search engine | Yes |
| INLINE_CODE_60 | ZoomEye search engine | Yes |
| INLINE_CODE_61 | Hunter search engine | Yes |
| INLINE_CODE_62 | Netlas search engine | Yes |
| INLINE_CODE_63 | Quake search engine | Yes |
| INLINE_CODE_64 | Criminalip search engine | Yes |
| _ | ||
| ### Common Search Fields |
| Field | Description |
|---|---|
| INLINE_CODE_65 | IP address |
| INLINE_CODE_66 | Port number |
| INLINE_CODE_67 | Hostname |
| INLINE_CODE_68 | Country code |
| INLINE_CODE_69 | City name |
| INLINE_CODE_70 | Organization name |
| INLINE_CODE_71 | Internet service provider |
| INLINE_CODE_72 | Autonomous system number |
| INLINE_CODE_73 | Product name |
| INLINE_CODE_74 | Product version |
| _ | |
| Ressourcen |
- offizielle Dokumentation
- (GitHub Repository)(https://github.com/projectdiscovery/uncover)
- Project Discovery Discord
--
*Dieses Betrügereiblatt bietet eine umfassende Referenz für die Verwendung von Uncover, von der Grundsuche bis zur erweiterten Filterung und Integration mit anderen Werkzeugen. Für die aktuellsten Informationen finden Sie immer die offizielle Dokumentation. *