- Notetaking & Organization
- Types of Reports
- Components of a Report
- How to Write Up a Finding
- Reporting Tips and Tricks
- HTB Academy Example
Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with theask query parameter:
Notetaking & Organization
π― Overview
Thorough notetaking is critical during assessments. Notes and tool output become the raw inputs for reports - typically the only deliverable clients see. Organized documentation saves time during reporting and provides essential references for client questions and team collaboration.π Essential Notetaking Structure
Core Categories
Folder Structure
π οΈ Recommended Tools
Notetaking Applications
Session Logging
πΊ Tmux Logging Setup
Installation
Usage
Key Bindings
π Evidence Collection
What to Capture
Screenshot Best Practices
Terminal Output Formatting
π Artifact Tracking
Payload Documentation
System Modifications
Sample Tracking Format
π― HTB Academy Lab Solutions
Lab Questions
Practical Exercises
π Assessment Workflow
Pre-Assessment Setup
During Assessment
Post-Assessment
β οΈ Data Handling Guidelines
What NOT to Collect
Compliance Considerations
π‘ Key Takeaways
- Structured approach essential for comprehensive documentation
- Tmux logging provides complete session recording
- Evidence organization saves time during reporting
- Proper redaction protects sensitive information
- Terminal output preferred over screenshots when possible
- Artifact tracking critical for professional assessments
- Tool selection should match company policies and client requirements
Effective notetaking and organization form the foundation of professional penetration testing deliverables and ensure comprehensive evidence collection throughout assessments.
Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with theask query parameter:
Types of Reports
π― Overview
Report structure varies based on assessment type and client requirements. Understanding different assessment methodologies and their corresponding report formats ensures appropriate deliverables for vulnerability assessments, penetration tests, attestation reports, and specialized assessments.π Assessment Types
π Vulnerability Assessment
βοΈ Penetration Testing
π Report Categories
π Internal Penetration Test Report
π External Penetration Test Report
π Vulnerability Assessment Report
π Specialized Assessment Types
π Inter-Disciplinary Assessments
π§ Hardware Penetration Testing
π Additional Deliverables
π Attestation Report/Letter
π Presentation Slide Deck
π Findings Spreadsheet
π¨ Vulnerability Notifications
π Report Lifecycle
π Draft Report Process
π Post-Remediation Testing
π― HTB Academy Lab Solutions
Lab Questions
Assessment Perspective Matrix
β οΈ Professional Considerations
π Client Communication
π Ethical Boundaries
π‘ Key Takeaways
- Assessment type determines report structure and content
- Client perspective (black/grey/white box) affects methodology
- Draft report process enables client collaboration
- Specialized assessments require interdisciplinary expertise
- Post-remediation testing needs strict scope control
- Ethical boundaries must be maintained throughout
- Professional communication essential for client success
Understanding different report types and assessment methodologies ensures appropriate deliverables that meet client needs while maintaining professional standards and ethical boundaries.
Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with theask query parameter:
Components of a Report
π― Overview
The report is the main deliverable clients pay for during penetration tests. It must demonstrate work performed, provide maximum value, and be free of extraneous data. Everything included should have a clear purpose and help clients prioritize remediation efforts.π Core Report Structure
π― Executive Summary
βοΈ Attack Chain
π Findings Section
π Summary of Recommendations
π Executive Summary Best Practices
β DO
β DONβT
π Technical Term Translation
π Sample Attack Chain Structure
π― INLANEFREIGHT.LOCAL Example
π Report Appendices
π Static Appendices (Always Include)
π Dynamic Appendices (Conditional)
π― HTB Academy Lab Solutions
Lab Questions
Executive Summary Principles
β οΈ Professional Considerations
π Finding Prioritization
π Evidence Quality
π‘ Key Takeaways
- Executive Summary is the most critical section for non-technical audiences
- Attack chains demonstrate finding interconnections and impact
- Specific metrics more effective than vague terms
- No vendor recommendations in executive sections
- Appendices provide comprehensive supporting documentation
- Professional language essential for stakeholder communication
- Evidence quality determines report credibility and usefulness
Effective report components balance technical accuracy with business communication, ensuring all stakeholders can understand and act on penetration testing findings.
Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with theask query parameter:
How to Write Up a Finding
π― Overview
Findings are the βmeatβ of penetration testing reports - showcasing discovered vulnerabilities, exploitation evidence, and remediation guidance. Detailed findings help technical teams reproduce issues, validate fixes, and support post-remediation assessments.π Essential Finding Components
π Required Elements
π Finding Structure Template
π Evidence Best Practices
π Reproduction Steps Guidelines
π· Screenshot Standards
π» Terminal Output Presentation
π Remediation Best Practices
β Good Remediation Examples
β Bad Remediation Examples
π― Sample Finding Examples
π Kerberoasting Finding
π Web Application Finding
π Quality Reference Selection
β Good Reference Sources
β Poor Reference Sources
π― HTB Academy Lab Solution
Lab Question
WriteHat Tool Practice
π§ Professional Writing Guidelines
π Language Standards
π― Client Consideration
π‘ Key Takeaways
- Detailed findings enable technical team reproduction and validation
- Evidence quality must be completely defensible
- Remediation recommendations should be specific and actionable
- Professional language essential for client credibility
- Multiple solution options accommodate different budgets and capabilities
- Reference quality affects long-term finding usefulness
- Consistent formatting improves report readability and professionalism
Well-written findings combine technical accuracy with clear communication, providing clients with actionable intelligence for vulnerability remediation and security improvement.
Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with theask query parameter:
Reporting Tips and Tricks
π― Overview
Professional reporting workflow requires templates, automation, and quality processes. Working on reports throughout assessments (not just at the end) ensures comprehensive documentation and prevents rushed deliverables with errors.π Report Development Workflow
π Work-As-You-Go Approach
π Template Management
π οΈ MS Word Professional Techniques
π Essential Features
β¨οΈ Useful Hotkeys
π€ Automation Strategies
π Macro Automation (Windows Word)
ποΈ Findings Database Tools
π Client Communication
π§ Start/Stop Notifications
π¨ Critical Finding Notifications
π¬ Ongoing Communication
π Quality Assurance Process
π QA Checklist
π₯ Review Process
π Professional Presentation Standards
π· Screenshot Quality
π» Terminal Output Standards
π― HTB Academy Lab Practice
WriteHat Tool Access
π Miscellaneous Best Practices
π― Storytelling Approach
π Data Protection
πΎ Backup and Security
π‘ Key Takeaways
- Work-as-you-go prevents rushed final reports
- Templates and automation ensure consistency and efficiency
- Professional MS Word techniques improve document quality
- Strong client communication builds trusted advisor relationships
- Quality assurance process essential for professional deliverables
- Evidence presentation standards affect report credibility
- Continuous improvement through QA feedback and process refinement
Professional reporting combines technical expertise with clear communication, automation, and quality processes to deliver exceptional client value and maintain industry standards.
Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with theask query parameter:
HTB Academy Example
π― Overview
This folder contains a practical example of the professional notetaking structure from HTB Academyβs Documentation & Reporting module. It demonstrates how to organize a real penetration test using Obsidian with the recommended folder structure and note categories.π Structure Overview
π Obsidian Integration
Key Features
- Markdown-based notes for professional documentation
- Linked references between findings and evidence
- Local storage for client data security
- Template consistency across assessments
- Professional presentation ready
Usage Instructions
- Open in Obsidian: Select βOpen folder as vaultβ
- Explore structure: Navigate through folders and notes
- Review examples: See how findings are documented
- Practice workflow: Use as template for real assessments
π― Example Content
Sample Assessment: INLANEFREIGHT.LOCAL
- Domain compromise via Active Directory attacks
- Complete attack chain from LLMNR poisoning to DCSync
- Professional findings with evidence and remediation
- Organized evidence collection and presentation
Learning Objectives
- Practical notetaking structure implementation
- Professional documentation standards
- Evidence organization best practices
- Client-ready presentation format
π‘ Key Takeaways
This example demonstrates:- Structured approach to penetration test documentation
- Professional organization for complex assessments
- Evidence management for comprehensive reporting
- Obsidian integration for efficient notetaking
- Real-world application of HTB Academy methodology
This practical example shows how professional penetration testing documentation should be organized for maximum efficiency and client value.
Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with theask query parameter: