mirror of
https://github.com/fleschutz/PowerShell.git
synced 2024-12-15 19:21:04 +01:00
92 lines
2.8 KiB
Markdown
92 lines
2.8 KiB
Markdown
## The *check-password.ps1* Script
|
||
|
||
This PowerShell script checks the security status of the given password by haveibeenpwned.com
|
||
|
||
## Parameters
|
||
```powershell
|
||
/home/mf/Repos/PowerShell/Scripts/check-password.ps1 [[-password] <String>] [<CommonParameters>]
|
||
|
||
-password <String>
|
||
|
||
Required? false
|
||
Position? 1
|
||
Default value
|
||
Accept pipeline input? false
|
||
Accept wildcard characters? false
|
||
|
||
[<CommonParameters>]
|
||
This script supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction,
|
||
WarningVariable, OutBuffer, PipelineVariable, and OutVariable.
|
||
```
|
||
|
||
## Example
|
||
```powershell
|
||
PS> ./check-password qwerty
|
||
⚠️ Bad password, it's already listed in 10584568 known security breaches!
|
||
|
||
```
|
||
|
||
## Notes
|
||
Author: Markus Fleschutz | License: CC0
|
||
|
||
## Related Links
|
||
https://github.com/fleschutz/PowerShell
|
||
|
||
## Source Code
|
||
```powershell
|
||
<#
|
||
.SYNOPSIS
|
||
Checks a password
|
||
.DESCRIPTION
|
||
This PowerShell script checks the security status of the given password by haveibeenpwned.com
|
||
.EXAMPLE
|
||
PS> ./check-password qwerty
|
||
⚠️ Bad password, it's already listed in 10584568 known security breaches!
|
||
.LINK
|
||
https://github.com/fleschutz/PowerShell
|
||
.NOTES
|
||
Author: Markus Fleschutz | License: CC0
|
||
#>
|
||
|
||
param([string]$password = "")
|
||
|
||
function CalculateHashSHA1 ([string]$string) {
|
||
$sha1 = New-Object System.Security.Cryptography.SHA1CryptoServiceProvider
|
||
$encoder = New-Object System.Text.UTF8Encoding
|
||
$bytes = $encoder.GetBytes($string)
|
||
$hash = ($sha1.ComputeHash($bytes) | % { $_.ToString("X2") }) -join ''
|
||
return $hash
|
||
}
|
||
|
||
function Get-PasswordPwnCount { [CmdletBinding()] param([string]$pass)
|
||
$hash = CalculateHashSHA1 $pass
|
||
try {
|
||
$uri = "https://api.pwnedpasswords.com/range/$($hash.Substring(0,5))"
|
||
$list = -split (Invoke-RestMethod $uri -Verbose:($PSBoundParameters['Verbose'] -eq $true) -ErrorAction Stop) # split into separate strings
|
||
$pwn = $list | Select-String $hash.Substring(5,35) # grep
|
||
if ($pwn) { $count = [int] ($pwn.ToString().Split(':')[1]) } else { $count = 0 }
|
||
return $count
|
||
}
|
||
catch {
|
||
Write-Error "Error Calling HIBP API"
|
||
return $null
|
||
}
|
||
}
|
||
|
||
try {
|
||
if ($password -eq "") { $password = Read-Host "Enter the password" }
|
||
$NumBreaches = Get-PasswordPwnCount $password
|
||
if ($NumBreaches -eq 0) {
|
||
"👍 Password seems good, it's not listed in any known security breach (as of today)"
|
||
} else {
|
||
"⚠️ Bad password, it's listed already in $NumBreaches known security breaches!"
|
||
}
|
||
exit 0 # success
|
||
} catch {
|
||
"⚠️ Error in line $($_.InvocationInfo.ScriptLineNumber): $($Error[0])"
|
||
exit 1
|
||
}
|
||
```
|
||
|
||
*Generated by convert-ps2md.ps1 using the comment-based help of check-password.ps1*
|