Private/Set-BreakGlassAccount.ps1
|
<#
.SYNOPSIS Selects or keeps the lab's break-glass account. .DESCRIPTION Selects or keeps the lab's break-glass account. This account is excluded from all attack scenarios and is not considered in any attack path or risk evaluation. .FUNCTIONALITY Stores the selected account DN so the account can be excluded from attack scenarios. .COMPONENT Category: Main Function #> function Set-BreakGlassAccount { $Info = Measure-FunctionRuntime -Begin Write-AS2GoOutput -Type Header -Message "Define a Break Glass Account" Write-AS2GoOutput -Type H1 -Message $((get-help (Get-FunctionName)).Functionality) $previousDN = Get-ASConfig -Setting "BreakGlassAccount" If ($previousDN -match 'OU=|CN=|DC=' ) { $previousCN = Convert-FromDNToCN -DistinguishedName $previousDN $HelpP = "Use the scope from previous selection/attack." $message = "Use current account ($previousCN) or select new:" Write-AS2GoOutput -Type TextMaker -Message "Current Break Glass Account:" -Tm $previousCN } else { $message = "Select new Break Glass Account:" $HelpP = $null } $Title = "Break Glass Account - Define Target Account" $Options = @( [pscustomobject] @{ Label = "&Previous Break Glass Account"; Help = $HelpP ; Value = "Previous" }, [pscustomobject] @{ Label = "Select &new Break Glass Account"; Help = "Choose a dedicated Break Glass Account."; Value = "New" }, [pscustomobject] @{ Label = "&Skip"; Help = "Skip selecting a Break Glass Account."; Value = "Skip" } ) $Decision = Show-DecisionPrompt -Message $message -Options $Options -Default 0 -Title $Title If ($Decision -eq "New") { $result = Select-ADObject -Title $Title -IncludeUsers -MarkTier0 -OnlyUserSelectionPossible if (-not $result) { Write-AS2GoOutput -Type Error -Message "No account selected." return } Set-ASConfig -Setting "BreakGlassAccount" -Value $result $result = Convert-FromDNToCN -DistinguishedName $result Write-AS2GoOutput -Type TextMaker -Message "New Break Glass Account:" -Tm $result } elseif ($Decision -eq "Previous") { Write-AS2GoOutput -Type Info -message "Keep previous Break Glass Account!" } else { Write-AS2GoOutput -Type Info -message "Skipping Break Glass Account selection!" } #end main code Measure-FunctionRuntime -End -Details $Info } |