Public/Get-PwnedHash.ps1
|
function Get-PwnedHash { [CmdletBinding()] [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingPlainTextForPassword','')] param( [Parameter(Mandatory,Position=0,ValueFromPipeline,ValueFromPipelineByPropertyName)] [ValidateScript({Test-ValidHash $_ -ThrowOnFail})] [string]$PasswordHash, [Parameter(ValueFromPipelineByPropertyName)] [Alias('SamAccountName')] [string]$Label, [ValidateNotNullOrEmpty()] [string]$ApiRoot = "https://api.pwnedpasswords.com/range/", [switch]$RequestPadding ) Begin { $headers = @{} if ($RequestPadding) { $headers.Headers = @{ 'Add-Padding' = 'true' } } } Process { # split the hash into its 5 char prefix and remaining suffix $hashPrefix = $PasswordHash.Substring(0,5) $hashSuffix = $PasswordHash.Substring(5) if ($ApiRoot -like 'http*') { # query the appropriate web URL try { $results = (Invoke-WebRequest "$($ApiRoot)$($hashPrefix)" @script:IWR_PARAMS @headers).Content } catch { throw } } else { # must be filesystem path, so try to get contents $results = Get-Content "$($ApiRoot)$($hashPrefix)" -Raw -EA Stop } # check for the suffix in the results $SeenCount = 0 if ($results -match "(?m:^$($hashSuffix):(?<SeenCount>\d+))") { $SeenCount = [int]$matches.SeenCount } # return the hash and found count $result = [pscustomobject]@{ Hash = $PasswordHash SeenCount = $SeenCount } # add the label if it was specified if (-not [String]::IsNullOrWhiteSpace($Label)) { $result | Add-Member 'Label' $Label -Force } return $result } <# .SYNOPSIS Checks a SHA1 or NTLM hash string against a haveibeenpwned.com compatible Pwned Passwords API endpoint. .DESCRIPTION The Pwned Passwords API is a way to check a password hash against a list of more than half a billion passwords which have been previously exposed in data breaches. The API implements a k-Anonymity model that allows a password to be searched for by partial hash. This means your full password hash never leaves your machine and ensures your privacy. This function will check the specified hash against the API and return a number that indicates the amount of times that password was found in known data breaches. A high count indicates that password has been heavily used and should not be considered safe. TO BE CLEAR, only the first 5 characters of the password hash are submitted to the API. See https://haveibeenpwned.com/API/v3#PwnedPasswords for more detail. .PARAMETER PasswordHash The hash to check. UTF8 encoded SHA1 hashes are expected with the official (default) pwnedpasswords.com API. Some third parties host NTLM (UTF16-LE encoded) versions of the API as well. .PARAMETER Label This adds an optional Label field to the output to more easily identifiy this hash. .PARAMETER ApiRoot If specified, overrides the default pwnedpasswords.com API URL. URLs or filesystem paths can both be used as an alternative. The URL\Path should include everything preceding the 5 character hash prefix (e.g. 'https://example.com/range/' or 'C:\temp\'). .PARAMETER RequestPadding If specified, HTTP based queries will add the 'Add-Padding: true' header to the request which signals to the server to return a randomly padded response. See https://www.troyhunt.com/enhancing-pwned-passwords-privacy-with-padding for details. .EXAMPLE $hash = '5BAA61E4C9B93F3F0682250B6CF8331B7EE68FD8' # UTF8 SHA1 hash of 'password' PS C:\>Get-PwnedHash $hash Test a password hash against the official pwnedpasswords.com API .EXAMPLE $hash = '8846F7EAEE8FB117AD06BDD830B7586C' # NTLM hash of 'password' PS C:\>$hash | Get-PwnedHash -ApiRoot 'http://internal.example.com/range/' Test a password hash against an internal NTLM Pwned Passwords API endpoint. .LINK Get-SHA1Hash .LINK Get-NTLMHash .LINK https://haveibeenpwned.com/API/v3#PwnedPasswords .LINK https://new.blog.cloudflare.com/validating-leaked-passwords-with-k-anonymity/ #> } |