See the version list below for details.
Install-Package ByteDev.PwnedPasswords -Version 1.0.1
dotnet add package ByteDev.PwnedPasswords --version 1.0.1
<PackageReference Include="ByteDev.PwnedPasswords" Version="1.0.1" />
paket add ByteDev.PwnedPasswords --version 1.0.1
#r "nuget: ByteDev.PwnedPasswords, 1.0.1"
// Install ByteDev.PwnedPasswords as a Cake Addin #addin nuget:?package=ByteDev.PwnedPasswords&version=1.0.1 // Install ByteDev.PwnedPasswords as a Cake Tool #tool nuget:?package=ByteDev.PwnedPasswords&version=1.0.1
Provides client functionality to talk to the pwnedpasswords API and check whether a particular password has been pwned and if so how many occurrences there have been.
Clone the git repository:
git clone https://email@example.com/bytedev/bytedev.pwnedpasswords.git
ByteDev.PwnedPasswords has been written as a .NET Standard 2.0 library, so you can consume it from a .NET Core or .NET Framework 4.6.1 (or greater) application.
Unit tests and integration tests are also provided in the solution.
Once you have a reference to ByteDev.PwnedPasswords there are 3 ways to search for a password:
- Search with clear text password
- Search with SHA1 hash of password
- Search with partial SHA1 hash of password
PwnedPasswordsClient class has two public methods to provide the functionality above:
- GetHasBeenPwnedAsync(string password): Use to search by clear password
- GetHasBeenPwnedAsync(HashedPassword hashedPassword, bool sendPrefixOnly = false): Use to search by SHA1 hash. To search only by the prefix of the hash pass in true for the sendPrefixOnly parameter.
Both of these methods will return a
PwnedPasswordResponse object containing details of whether the password has been pwned and a count of how many times.
PwnedPasswordsClient class has any problems getting the details for a password it will throw an
Further usage examples can be seen in the integration tests project (ByteDev.PwnedPasswords.IntTests).
See the following for more information:
- No dependencies.
This package is not used by any NuGet packages.
This package is not used by any popular GitHub repositories.