Posh-YBKPIV

0.10.0

Tests/Public/Set-PWSHYBKPIVPin.Tests.ps1

[Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSAvoidUsingConvertToSecureStringWithPlainText', '',
    Justification = 'Test fixture values, not real secrets; SecureString-typed parameters require a real SecureString even in unit tests.')]
param()

BeforeAll {
    Import-Module (Resolve-Path "$PSScriptRoot\..\..\Posh-YBKPIV.psd1") -Force

    $script:RealConfigPath = (Resolve-Path "$PSScriptRoot\..\..\Config\Posh-YBKPIV.json").Path
    InModuleScope Posh-YBKPIV -Parameters @{ ConfigPath = $script:RealConfigPath } {
        param($ConfigPath)
        $script:ConfigPath = $ConfigPath
    }

    $script:SecurePin = ConvertTo-SecureString -String '123456' -AsPlainText -Force
    $script:SecureNewPin = ConvertTo-SecureString -String '654321' -AsPlainText -Force
}

AfterAll {
    Remove-Module Posh-YBKPIV -ErrorAction SilentlyContinue
}

Describe 'Set-PWSHYBKPIVPin' -Tag Unit {
    BeforeEach {
        $script:InstallExePath = 'C:\Program Files\Yubico\Yubico PIV Tool\bin\yubico-piv-tool.exe'
        Mock -ModuleName Posh-YBKPIV Test-Path { $true } -ParameterFilter { $Path -eq $script:InstallExePath }
        Mock -ModuleName Posh-YBKPIV Resolve-PWSHYBKPIVArchitecture { 'win64' }
        Mock -ModuleName Posh-YBKPIV Get-PWSHYBKPIVInstallPath { $script:InstallExePath }
        Mock -ModuleName Posh-YBKPIV Invoke-PWSHYBKPIVTool { [PSCustomObject]@{ ExitCode = 0; Output = @() } }
    }

    It 'Requires the -Pin and -NewPin dynamic parameters' {
        { Set-PWSHYBKPIVPin -Confirm:$false -ErrorAction Stop } | Should -Throw
    }

    It 'Calls Invoke-PWSHYBKPIVTool with the change-pin action when both PINs are supplied' {
        Set-PWSHYBKPIVPin -Pin $script:SecurePin -NewPin $script:SecureNewPin -Confirm:$false
        Should -Invoke -ModuleName Posh-YBKPIV Invoke-PWSHYBKPIVTool -Times 1 -ParameterFilter { $Action -eq 'change-pin' }
    }

    It 'Does not attempt the change when -WhatIf is used' {
        Set-PWSHYBKPIVPin -Pin $script:SecurePin -NewPin $script:SecureNewPin -WhatIf
        Should -Invoke -ModuleName Posh-YBKPIV Invoke-PWSHYBKPIVTool -Times 0
    }

    It 'Throws when Invoke-PWSHYBKPIVTool fails' {
        Mock -ModuleName Posh-YBKPIV Invoke-PWSHYBKPIVTool { throw 'Verify PIN failed' }
        { Set-PWSHYBKPIVPin -Pin $script:SecurePin -NewPin $script:SecureNewPin -Confirm:$false } | Should -Throw -ExpectedMessage '*Verify PIN failed*'
    }

    It 'Throws a clear error when yubico-piv-tool.exe is not installed' {
        Mock -ModuleName Posh-YBKPIV Test-Path { $false } -ParameterFilter { $Path -eq $script:InstallExePath }
        { Set-PWSHYBKPIVPin -Pin $script:SecurePin -NewPin $script:SecureNewPin -Confirm:$false } | Should -Throw -ExpectedMessage '*Install-PWSHYBKPIVTool*'
    }
}