Dictionary-based attack detection with advanced normalization
This guide explains how to use PWDValidator, our high-precision password auditing tool.
It detects weak passwords by scanning them against multiple dictionaries β including standard dictionaries we already provide, plus any custom dictionaries the user wishes to add.
π 1. What PWDValidator Does
PWDValidator checks whether a password is weak by searching for:
-
β Exact dictionary matches
-
β Case-insensitive matches
-
β Substring matches (if meaningful length β₯ 4)
-
β Reversed-password matches
-
β Leet-speak equivalents (e.g.,
p4ssw0rd β password) -
β Stripped-digits edges (
123Tiger99 β Tiger)
If any dictionary match occurs, the password is classified as WEAK.
Useful for:
-
Enterprise onboarding
-
Password policy enforcement
-
Auditing user-submitted passwords
-
Pre-flight checks before storing credentials
π¦ 2. Usage
Basic syntax
Exit codes
-
0β Password OK -
1β Invalid usage -
2β Weak password (dictionary match detected)
π§ 3. What Dictionaries Are Included
We ship standard dictionaries by default, including:
-
π€ English common words
-
π€ Weak-password lists
-
π€ Known breach wordlists
-
π€ Common name lists
-
π€ Basic leetspeak variants
π Clients may add unlimited custom dictionaries simply by specifying them in the command line.
Example:
π οΈ 4. Matching Logic (explained simply)
PWDValidator evaluates multiple transformations of the password:
| Transformation | Example | Purpose |
|---|---|---|
| Lowercase normalized | Password β password |
Case-insensitive matching |
| Digit-stripped | 123Tiger99 β Tiger |
Detect padding |
| Reversed | wolf β flow |
Reverse-based guess attacks |
| Leet normalization | p4ssw0rd β password |
Real attacker behavior |
| Substring detection | sunshine1984 β sunshine |
Embedded weak words |
Each word in each dictionary is compared against several password variants β exactly like real attackers do during dictionary cracking attempts.
π 5. Real Client Examples
Check a password using our standard dictionaries
Add your own corporate dictionary
Massive dictionary check (multi-GB compatible)
π 6. Progress Indicators
Large dictionaries show a real-time progress bar:
Useful for:
-
Big corporate dictionaries
-
Multi-GB breach lists
-
Monitoring long scans
π‘οΈ 7. Recommended Customer Workflow
Step 1 β Choose dictionaries
Use the ones we provide + add your own sensitive-term dictionary.
Step 2 β Run the validator
Step 3 β Interpret the result
β Strong
β Weak
π 8. Best Practices for Enterprises
-
Add dictionaries containing:
-
internal project names
-
employee names
-
company acronyms
-
common internal terms
-
-
Keep dictionary files UTF-8 encoded
-
Avoid single-character or trivial entries
-
Never store passwords in dictionaries
-
Use strong passwords generated by PWDGenerator
π§ 9. Client Summary (Executive View)
-
β We include standard dictionary sets
-
β Client may add unlimited custom dictionaries
-
β Detects: exact matches, substrings, leet variants, reversed text, digit padding removal
-
β Works with UTF-8 passwords and massive dictionaries
-
β Produces a clear PASS/FAIL classification
-
β Enterprise-grade and attacker-realistic validation