Functions/Public/Find-FIDOKey.ps1
|
<# .SYNOPSIS Finds and displays FIDO keys based on specified criteria. .DESCRIPTION The Find-FIDOKey function filters and displays FIDO keys from a JSON file based on specified Brand, Type, View, and TypeFilterMode parameters. It supports filtering by multiple types and allows the results to be displayed in either a table or list format. .PARAMETER Brand Specifies the brand of FIDO keys to filter by. Accepts multiple values from a predefined set of brands. .PARAMETER Type Specifies the type(s) of FIDO keys to filter by. Accepts multiple values from a predefined set of types: Bio, USB, NFC, BLE. .PARAMETER View Specifies the format in which to display the results. Accepts either "Table" or "List". Default is "List". .PARAMETER TypeFilterMode Specifies the mode for filtering by type. Accepts one of the following values: - AtLeastTwo: At least two of the specified types must match. - AtLeastOne: At least one of the specified types must match. (Default) - AtLeastThree: At least three of the specified types must match. - All: All specified types must match. .EXAMPLE Find-FIDOKey -Brand "Yubico" -Type "USB" -View "Table" Finds and displays all Yubico FIDO keys that support USB in a table format. .EXAMPLE Find-FIDOKey -Type "Bio", "NFC" -TypeFilterMode "AtLeastTwo" Finds and displays all FIDO keys that support at least Bio and NFC. .NOTES The function reads FIDO key data from a JSON file located at "../Assets/FidoKeys.json". #> function Find-FIDOKey { [CmdletBinding()] param ( # Parameter for filtering by Brand [Parameter()] [ValidateSet("ACS", "Allthenticator", "Arculus", "AuthenTrend", "Atos", "authenton1", "Chunghwa Telecom", "Crayonic", "Cryptnox", "Egomet", "Ensurity", "eWBM", "Excelsecu", "Feitian", "FIDO KeyPass", "FT-JCOS", "Google", "GoTrust", "HID Global", "Hideez", "Hypersecu", "HYPR", "IDCore", "IDEMIA", "IDmelon", "Thales", "ImproveID", "KEY-ID", "KeyXentic", "KONAI", "NEOWAVE", "NXP Semiconductors", "Nymi", "OCTATCO", "OneSpan", "OnlyKey", "OpenSK", "Pone Biometrics", "Precision", "RSA", "SafeNet", "Yubico", "Sentry Enterprises", "SmartDisplayer", "SoloKeys", "Swissbit", "Taglio", "Token Ring", "TOKEN2", "Identiv", "VALMIDO", "Kensington", "VinCSS", "WiSECURE")] [string[]]$Brand, # Parameter for filtering by Type (Bio, USB, NFC, BLE) [Parameter()] [ValidateSet("Bio", "USB", "NFC", "BLE")] [string[]]$Type, # Parameter for specifying the view format (Table or List) [Parameter()] [ValidateSet("Table", "List")] [string]$View = "List", # Parameter for specifying the type filter mode (AtLeastTwo, AtLeastOne, AtLeastThree, All) [Parameter()] [ValidateSet("AtLeastTwo", "AtLeastOne", "AtLeastThree", "All")] [string]$TypeFilterMode = "AtLeastOne" ) # Construct the path to the JSON file in the assets folder two levels up $parentDir = Split-Path -Path (Split-Path -Path $PSScriptRoot -Parent) -Parent $jsonFilePath = Join-Path -Path $parentDir -ChildPath "Assets/FidoKeys.json" # Check if the file exists if (-Not (Test-Path -Path $jsonFilePath)) { Write-Error "The JSON file was not found at path: $jsonFilePath" return } # Start with all devices $data = Get-Content -raw $jsonFilePath | ConvertFrom-Json # Extract metadata and keys $metadata = $data.metadata $results = $data.keys # Filter by Brand if provided if ($Brand) { $results = $results | Where-Object { $Brand -contains $_.Vendor -or ($Brand | ForEach-Object { $_ -in $_.Description }) } } # Filter by Type if provided if ($Type) { $results = $results | Where-Object { $typeCount = 0 if ($Type -contains "Bio" -and $_.Bio -eq "Yes") { $typeCount++ } if ($Type -contains "USB" -and $_.USB -eq "Yes") { $typeCount++ } if ($Type -contains "NFC" -and $_.NFC -eq "Yes") { $typeCount++ } if ($Type -contains "BLE" -and $_.BLE -eq "Yes") { $typeCount++ } switch ($TypeFilterMode) { "AtLeastTwo" { $typeCount -ge 2 } "AtLeastThree" { $typeCount -ge 3 } "All" { $typeCount -eq $Type.Count } default { $typeCount -ge 1 } } } } # Sort the results by Vendor in alphabetical order $results = $results | Sort-Object -Property Vendor # Create a PSCustomObject for the results $output = [PSCustomObject]@{ Count = $results.Count Devices = $results LastUpdated = $metadata.databaseLastUpdated } # Output results based on the specified view format if ($output.Count -gt 0) { Write-Host "FIDO Devices eligible for attestation with Entra ID: $($output.Count)" Write-Host "Database Last Updated: $($output.LastUpdated)" if ($View -eq "Table") { $output.Devices | Format-Table -AutoSize } else { $output.Devices } } else { Write-Host "No devices found matching the criteria." } # Return the PSCustomObject # return $output } |