Skip to content

Commit

Permalink
README & CHANGELOG update
Browse files Browse the repository at this point in the history
  • Loading branch information
PaperMtn committed Aug 14, 2024
1 parent 382ac4a commit eb130d7
Show file tree
Hide file tree
Showing 3 changed files with 28 additions and 1 deletion.
13 changes: 13 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,16 @@
## [3.2.0] - 2024-08-14
### Added
- Functionality to search for users who are using their username as the password
- Converts the users username into the following formats:
- All uppercase
- All lowercase
- Remove dot "."
- camelCase (E.g. johnSmith)
- PascalCase (E.g. JohnSmith)

### Fixed
- SUCCESS level logging not properly working for JSON output

## [3.1.0] - 2024-08-13
### Added
- Added new functionality to enhance the custom passwords passed to lil-pwny
Expand Down
14 changes: 14 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ More information about Lil Pwny can be found [on my blog](https://papermtn.co.uk
- **Custom Password Auditing**: Ability to provide a list of your own custom passwords to check AD users against. This allows you to check user passwords against passwords relevant to your organisation that you suspect people might be using.
- Pass a .txt file with the plaintext passwords you want to search for, these are then NTLM hashed and AD hashes are then compared with this as well as the HIBP hashes.
- **Detect Duplicates**: Return a list of accounts using the same passwords. Useful for finding users using the same password for their administrative and standard accounts.
- **Username as Password**: Detect users that are using their username, or variations of it, as their password.
- **Obfuscated Output**: Obfuscate hashes in output, for if you don't want to handle or store live user NTLM hashes.

### Custom Password List Enhancement
Expand All @@ -29,6 +30,19 @@ Lil Pwny provides the functionality to enhance your custom password list by addi
- Passwords with dates appended starting from the year 1950 up to 10 years from today's date (e.g. `password1950`, `password2034`)

A custom password list of 100 plaintext passwords generates 49848660 variations.

### Usernames in Passwords
Lil Pwny looks for users that are using variations of their username as their password.

It converts the users username into the following formats:
- All uppercase
- All lowercase
- Remove dot "."
- camelCase (E.g. johnSmith)
- PascalCase (E.g. JohnSmith)

These are then converted to NTLM hashes, and audited against the AD hashes

## Resources
This application has been developed to make the most of multiprocessing in Python, with the aim of it working as fast as possible on consumer level hardware.

Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[tool.poetry]
name = "lil-pwny"
version = "3.1.0"
version = "3.2.0"
description = "Fast offline auditing of Active Directory passwords using Python and multiprocessing"
authors = ["PaperMtn <[email protected]>"]
license = "GPL-3.0"
Expand Down

0 comments on commit eb130d7

Please sign in to comment.