SCCMHunter requires Python 3.6+ and various dependencies for LDAP, SMB, and HTTP functionality.
Prerequisites
System Requirements
- Operating System: Linux (preferred), Windows, or macOS
- Python Version: Python 3.6 or higher
- Network Access: Connectivity to target Active Directory environment
- Credentials: Valid domain user account (minimum privileges)
Installation Methods
Method 1: Git Clone (Recommended)
Method 2: Direct Download
Dependencies
SCCMHunter relies on several Python libraries for its functionality:Core Dependencies
Core Dependencies
- impacket: For SMB, LDAP, and authentication protocols
- ldap3: Enhanced LDAP operations and queries
- requests: HTTP client enrollment and web service interactions
- colorama: Terminal output formatting and colors
- click: Command-line interface framework
Optional Dependencies
Optional Dependencies
- pyopenssl: For certificate handling in HTTP modules
- cryptography: Enhanced cryptographic operations
- neo4j: For data export to BloodHound/Neo4j (if using —neo4j flag)
Manual Dependency Installation
If you encounter issues with requirements.txt:Configuration
Environment Setup
Kerberos Configuration
For Kerberos authentication, ensure proper krb5.conf setup:Verification
Basic Functionality Test
Connectivity Test
Common Installation Issues
ImportError: No module named 'impacket'
ImportError: No module named 'impacket'
Solution: Install impacket properly
Permission Denied Errors
Permission Denied Errors
Solution: Use virtual environment or user installation
SSL/TLS Certificate Errors
SSL/TLS Certificate Errors
Solution: Disable certificate verification for testing
Performance Optimization
Optimization Tips
- Use LDAPS: Enable LDAPS with
-ldapsfor encrypted communication - Targeted Scans: Use specific IP ranges rather than full domain scans
- Parallel Processing: Consider running multiple instances for large environments
- Network Tuning: Adjust timeouts for slow network conditions
Next Steps
Quick Start Guide
Begin your first SCCM assessment with a guided walkthrough
LDAP Enumeration
Start discovering SCCM infrastructure with the find module
SMB Profiling
Profile identified targets for attack surface analysis
Troubleshooting
Resolve common installation and configuration issues
Support and Resources
Getting Help
- GitHub Issues: Report bugs and feature requests
- Documentation: This documentation covers all modules and use cases
- Community: Follow @garrfoster for updates
- Lab Environment: Test in a controlled lab before production assessments