lgandx/PCredz
lgandx/PCredz has 2,601 GitHub stars and 450 forks. GitHot measured 0 stars in 24 hours, +2 in 7 days, and +6 in 15 days. Last checked 2026-11-22 03:21 UTC. Last push 2026-03-02.
측정된 스타 증가
- in 24h
- 0
- in 7 days
- +2
- in 15 days
- +6
- in 1 month
- 기록 수집 중
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
소개
이 도구는 pcap 파일이나 실시간 네트워크 인터페이스에서 신용카드 번호, NTLM(DCE-RPC, HTTP, SQL, LDAP 등), Kerberos(AS-REQ Pre-Auth etype 23), HTTP Basic, SNMP, POP, SMTP, FTP, IMAP 등을 추출합니다.
데이터README.md
OriginalPCredz 2.1.0
PCredz extracts credentials and authentication tokens from network traffic (PCAP files or live capture).
Features
Supported Protocols
Extract credentials from both IPv4 and IPv6 traffic:
- NTLM: NTLMv1/v2 hashes from HTTP, SMB, LDAP, MSSQL, DCE-RPC, and more
- Kerberos: AS-REQ Pre-Auth (etype 23) hashes
- HTTP: Basic authentication, form fields (passwords, API keys, tokens)
- FTP: USER/PASS commands
- IRC: NICK/USER/PASS authentication
- SMTP: AUTH PLAIN and AUTH LOGIN
- IMAP: LOGIN authentication
- POP3: USER/PASS commands
- LDAP: Simple Bind (plaintext passwords)
- SNMP: Community strings (v1/v2c)
- MSSQL: TDS protocol authentication
- Credit Cards: Card number extraction (optional)
Output Formats
- Hashcat compatible: All hashes formatted for direct use with hashcat
- NTLMv1:
-m 5500 - NTLMv2:
-m 5600 - Kerberos:
-m 7500
- NTLMv1:
- Organized logs: Separate files for each credential type in
logs/directory - Session log: Complete timeline in
CredentialDump-Session.log - Deduplication: Same credentials only logged once (unless
-vflag used)
Link Layer Support
- Ethernet (DLT_EN10MB)
- Linux Cooked Capture (DLT_LINUX_SLL)
- Raw IP (DLT_RAW)
- Automatic detection of link layer type
Installation
Docker (Recommended)
# Build the container
docker build -t pcredz .
# Run with current directory mounted
docker run --rm -v $(pwd):/data pcredz -f /data/capture.pcap
# For live capture (requires --net=host)
docker run --rm --net=host -v $(pwd):/data pcredz -i eth0 -v
Linux
Debian/Ubuntu:
sudo apt-get install python3-pip libpcap-dev
pip3 install pcapy-ng
Fedora/RHEL:
sudo dnf install python3-pip libpcap-devel
pip3 install pcapy-ng
Arch Linux:
sudo pacman -S python-pip libpcap
pip3 install pcapy-ng
Usage
Basic Examples
# Parse a single PCAP file
./Pcredz -f capture.pcap
# Parse all PCAP files in a directory (recursive)
./Pcredz -d /path/to/pcap/directory/
# Live capture on an interface (requires root)
sudo ./Pcredz -i eth0
# Verbose mode (show duplicate credentials)
./Pcredz -f capture.pcap -v
# Custom output directory
./Pcredz -f capture.pcap -o /tmp/pcredz-output/
Options
Required (choose one):
-f FILE PCAP file to parse
-d DIR Directory to parse recursively
-i INTERFACE Interface for live capture
Optional:
-v Verbose mode (print duplicate credentials)
-t Print timestamps
-o DIR Output directory for logs (default: ./)
-c Disable credit card scanning
--disable PROTO Disable protocol (can be used multiple times)
Options: NTLM, HTTP, FTP, IRC, LDAP, SMTP, Kerberos, SNMP, MSSQL
--exclude-host IP Exclude host IP from capture (can be used multiple times)
-h Show help message
Output Files
All credentials are saved to the logs/ directory:
logs/
├── NTLMv1.txt # NTLMv1 hashes (hashcat -m 5500)
├── NTLMv2.txt # NTLMv2 hashes (hashcat -m 5600)
├── MSKerb.txt # Kerberos hashes (hashcat -m 7500)
├── HTTP-Basic.txt # HTTP Basic auth credentials
├── HTTP-PasswordFields.txt # HTTP form fields and API keys
├── FTP-Plaintext.txt # FTP credentials
├── IRC-Plaintext.txt # IRC credentials
├── SMTP-Plaintext.txt # SMTP credentials
├── LDAP-Simple.txt # LDAP Simple Bind credentials
├── MSSQL-Plaintext.txt # MSSQL credentials
└── SNMPv1.txt # SNMP community strings
Plus a session log:
CredentialDump-Session.log # Complete session with timestamps
Examples
Extract NTLM Hashes
./Pcredz -f capture.pcap
# Output:
# 192.168.1.10:445 > 192.168.1.20:1024
# NTLMv2 complete hash is: admin::DOMAIN:1122334455667788:ABC123...
# Use with hashcat:
hashcat -m 5600 logs/NTLMv2.txt wordlist.txt
Live Capture
sudo ./Pcredz -i eth0 -v
# Captures and displays credentials in real-time
# Press Ctrl+C to stop
Bulk Processing
# Process all PCAPs in a directory tree
./Pcredz -d /forensics/network-captures/
# Parsing /forensics/network-captures/day1/morning.pcap...
# Parsing /forensics/network-captures/day1/afternoon.pcap...
# ...
Protocol Filtering
# Disable specific protocols (reduce noise)
./Pcredz -f capture.pcap --disable HTTP --disable SNMP
# Only capture NTLM hashes
./Pcredz -f capture.pcap --disable HTTP --disable FTP --disable IRC \
--disable LDAP --disable SMTP --disable Kerberos --disable SNMP --disable MSSQL
# Focus on cleartext credentials only
./Pcredz -f capture.pcap --disable NTLM --disable Kerberos
Host Exclusion
# Exclude your own IP during live capture (common use case)
sudo ./Pcredz -i eth0 --exclude-host 192.168.1.50 -v
# Exclude multiple hosts
./Pcredz -f capture.pcap --exclude-host 192.168.1.100 --exclude-host 10.0.0.5
# Pentesting: capture target credentials, not your own
sudo ./Pcredz -i eth0 --exclude-host $(hostname -I | awk '{print $1}') -v
Performance
Optimizations
- File I/O caching: Avoids redundant file reads (10-100x speedup)
- Regex pre-compilation: Compiled patterns cached (2-5x speedup)
- Smart deduplication: In-memory tracking of seen credentials
- Link layer detection: Auto-detects and caches offset (minimal overhead)
Benchmarks
Typical performance on modern hardware:
- Small files (<10MB): <1 second
- Medium files (100MB): 5-10 seconds
- Large files (1GB+): 1-2 minutes
- Live capture: 5,000-10,000 packets/second
Troubleshooting
pcapy-ng Not Found
pip3 install pcapy-ng
# If that fails:
pip3 install --break-system-packages pcapy-ng
Permission Denied (Live Capture)
Live capture requires root privileges:
sudo ./Pcredz -i eth0
No Credentials Found
- Verify the PCAP contains the expected protocols (use Wireshark)
- Check that traffic isn't encrypted (HTTPS, SSH, etc.)
- Try verbose mode (
-v) to see all activity - Check the link layer type is supported
Contributing
Found a bug or want to add a feature? Contributions welcome!
- Test your changes thoroughly
- Follow the existing code style
- Add examples for new features
- Update documentation
License
GNU General Public License v3.0
Author
Laurent Gaffie
- Email: [email protected]
- X/Twitter: @secorizon
- GitHub: lgandx/PCredz
관련 프로젝트 살펴보기
불러오는 중…