MattandGitHub
3b01d7f172
Provide harvest-report targets, contributions, and hostname-changes with consistent saved-evidence terminology across the CLI, REST API, and HarvestView. Preserve target scope, source-outcome handling, JSONL, and the stored evidence schema. Update onboarding and operator documentation, keep the domain glossary in CONTEXT.md, record behavior rules in docs/architecture.md, and consolidate release preparation in CONTRIBUTING.md. Validation: all eight GitHub checks passed at ed54542a; focused reporting and documentation checks passed. Tracks https://github.com/NotoriousRebel/theHarvester/issues/349.
2.0 KiB
theHarvester wiki
theHarvester gathers open-source intelligence about a domain or organization. It queries search engines, certificate transparency logs, DNS datasets, code repositories, threat-intelligence platforms, and other public sources.
Use it during the early reconnaissance stage of an authorized security assessment. Passive providers still receive the search target.
DNS brute force, DNS resolution, virtual host discovery, takeover checks, screenshots, and API-path scanning create additional network activity. Use these features only on systems you own or are explicitly authorized to test.
Start here
- Install theHarvester.
- Read Responsible Use and Scope before choosing a target or feature.
- Follow the Quick Start for a small passive run.
- Add credentials through Configuration and API Keys when a selected provider requires them.
- Learn where findings are stored in Results and Local Data.
Coming from the 4.11 release line? Read Moving from 4.11 to 5.0 before updating automation or saved-run reports.
Choose an interface
| Interface | Use it for |
|---|---|
| Command line | Interactive reconnaissance and report generation. |
| HarvestView | Creating and inspecting durable local runs in a browser. See REST API. |
| REST API | Authenticated local integrations and the generated Swagger/ReDoc reference. See REST API. |
| Docker Compose | Running HarvestView and the REST API. It does not provide the normal interactive CLI. |
The repository README owns the current feature summary and source/result matrix. The live theHarvester -h output owns the complete CLI reference.
Project credit
Christian Martorella (@laramies) created theHarvester. Contact: cmartorella@edge-security.com.
See the repository README for current maintainers and contributors.