PTah
ef237f345b
Bump version.txt and ScriptVersion for Deploy-LoginMonitor on NETLOGON. Co-authored-by: Cursor <cursoragent@cursor.com>
403 lines
13 KiB
PowerShell
403 lines
13 KiB
PowerShell
<#
|
|
.SYNOPSIS
|
|
Клиент Security Alert Center для RDP-login-monitor.
|
|
.DESCRIPTION
|
|
Dot-source после login_monitor.settings.ps1 и функции Write-Log.
|
|
Ожидает: $UseSAC, $SacUrl, $SacApiKey, $ScriptVersion, $script:InstallRoot.
|
|
Release: 1.2.7-SAC (ingest HTTP 201/409/202).
|
|
#>
|
|
|
|
function Write-SacLog {
|
|
param([string]$Message)
|
|
if (Get-Command Write-Log -ErrorAction SilentlyContinue) {
|
|
Write-Log $Message
|
|
} else {
|
|
Write-Host $Message
|
|
}
|
|
}
|
|
|
|
function Get-SacNormalizedMode {
|
|
$m = if ($null -ne $UseSAC) { [string]$UseSAC } else { 'off' }
|
|
return $m.Trim().ToLowerInvariant()
|
|
}
|
|
|
|
function Test-SacConfigured {
|
|
return (-not [string]::IsNullOrWhiteSpace($SacUrl)) -and (-not [string]::IsNullOrWhiteSpace($SacApiKey))
|
|
}
|
|
|
|
function Get-SacBaseUrl {
|
|
if ([string]::IsNullOrWhiteSpace($SacUrl)) { return $null }
|
|
$url = $SacUrl.Trim().TrimEnd('/')
|
|
if ($url -match '/api/v1/events$') {
|
|
$url = $url -replace '/api/v1/events$', ''
|
|
}
|
|
return $url.TrimEnd('/')
|
|
}
|
|
|
|
function Get-SacIngestUrl {
|
|
$base = Get-SacBaseUrl
|
|
if ([string]::IsNullOrWhiteSpace($base)) { return $null }
|
|
return "$base/api/v1/events"
|
|
}
|
|
|
|
function Get-SacSpoolDirResolved {
|
|
if (-not [string]::IsNullOrWhiteSpace($SacSpoolDir)) {
|
|
return $SacSpoolDir.Trim()
|
|
}
|
|
return (Join-Path $script:InstallRoot 'sac-spool')
|
|
}
|
|
|
|
function Get-SacAgentIdFileResolved {
|
|
if (-not [string]::IsNullOrWhiteSpace($SacAgentIdFile)) {
|
|
return $SacAgentIdFile.Trim()
|
|
}
|
|
return (Join-Path $script:InstallRoot 'agent_instance_id')
|
|
}
|
|
|
|
function Get-SacFailCountFileResolved {
|
|
return (Join-Path $script:InstallRoot 'sac-fail.count')
|
|
}
|
|
|
|
function Get-SacAgentInstanceId {
|
|
$idFile = Get-SacAgentIdFileResolved
|
|
$dir = Split-Path -Parent $idFile
|
|
if (-not (Test-Path -LiteralPath $dir)) {
|
|
New-Item -ItemType Directory -Path $dir -Force | Out-Null
|
|
}
|
|
if (Test-Path -LiteralPath $idFile) {
|
|
$existing = (Get-Content -LiteralPath $idFile -TotalCount 1 -ErrorAction SilentlyContinue)
|
|
if (-not [string]::IsNullOrWhiteSpace($existing)) {
|
|
return $existing.Trim()
|
|
}
|
|
}
|
|
$newId = [guid]::NewGuid().ToString()
|
|
try {
|
|
Set-Content -LiteralPath $idFile -Value $newId -Encoding UTF8 -NoNewline
|
|
} catch { }
|
|
return $newId
|
|
}
|
|
|
|
function Get-SacCategoryForType {
|
|
param([string]$EventType)
|
|
if ($EventType -match '^(ssh\.|auth\.|rdp\.)') { return 'auth' }
|
|
if ($EventType -match '^privilege\.') { return 'privilege' }
|
|
if ($EventType -match '^session\.') { return 'session' }
|
|
if ($EventType -match '^report\.') { return 'report' }
|
|
if ($EventType -match '^rdg\.') { return 'network' }
|
|
return 'agent'
|
|
}
|
|
|
|
function New-SacEventPayload {
|
|
param(
|
|
[Parameter(Mandatory = $true)][string]$EventType,
|
|
[Parameter(Mandatory = $true)][string]$Severity,
|
|
[Parameter(Mandatory = $true)][string]$Title,
|
|
[Parameter(Mandatory = $true)][string]$Summary,
|
|
[hashtable]$Details = $null
|
|
)
|
|
|
|
$payload = [ordered]@{
|
|
schema_version = '1.0'
|
|
event_id = [guid]::NewGuid().ToString()
|
|
occurred_at = (Get-Date).ToString('o')
|
|
source = [ordered]@{
|
|
product = 'rdp-login-monitor'
|
|
product_version = if ($ScriptVersion) { [string]$ScriptVersion } else { 'unknown' }
|
|
agent_instance_id = Get-SacAgentInstanceId
|
|
}
|
|
host = [ordered]@{
|
|
hostname = $env:COMPUTERNAME
|
|
os_family = 'windows'
|
|
}
|
|
category = (Get-SacCategoryForType -EventType $EventType)
|
|
type = $EventType
|
|
severity = $Severity
|
|
title = $Title
|
|
summary = $Summary
|
|
}
|
|
if ($null -ne $Details -and $Details.Count -gt 0) {
|
|
$payload.details = $Details
|
|
}
|
|
return $payload
|
|
}
|
|
|
|
function Get-SacFailCount {
|
|
$f = Get-SacFailCountFileResolved
|
|
if (-not (Test-Path -LiteralPath $f)) { return 0 }
|
|
$raw = (Get-Content -LiteralPath $f -TotalCount 1 -ErrorAction SilentlyContinue) -replace '\D', ''
|
|
if ([string]::IsNullOrWhiteSpace($raw)) { return 0 }
|
|
return [int]$raw
|
|
}
|
|
|
|
function Set-SacFailCount {
|
|
param([int]$Count)
|
|
$f = Get-SacFailCountFileResolved
|
|
$dir = Split-Path -Parent $f
|
|
if (-not (Test-Path -LiteralPath $dir)) {
|
|
New-Item -ItemType Directory -Path $dir -Force | Out-Null
|
|
}
|
|
Set-Content -LiteralPath $f -Value ([string]$Count) -Encoding UTF8 -NoNewline
|
|
}
|
|
|
|
function Reset-SacFailCount {
|
|
Set-SacFailCount -Count 0
|
|
}
|
|
|
|
function Test-SacShouldAttemptSend {
|
|
$mode = Get-SacNormalizedMode
|
|
if ($mode -ne 'fallback') { return $true }
|
|
|
|
$max = if ($SacFallbackFailures) { [int]$SacFallbackFailures } else { 5 }
|
|
$n = Get-SacFailCount
|
|
if ($n -lt $max) { return $true }
|
|
|
|
if (Test-SacHealth) {
|
|
Reset-SacFailCount
|
|
Write-SacLog 'SAC: /health OK, resuming POST (fallback)'
|
|
return $true
|
|
}
|
|
Write-SacLog "WARN: SAC fallback: skip POST ($n>=$max failures), local channels only"
|
|
return $false
|
|
}
|
|
|
|
function Invoke-SacTlsPrep {
|
|
if (-not $SacTlsSkipVerify) { return }
|
|
if (-not $script:SacTlsCallbackRegistered) {
|
|
[System.Net.ServicePointManager]::ServerCertificateValidationCallback = { $true }
|
|
$script:SacTlsCallbackRegistered = $true
|
|
}
|
|
}
|
|
|
|
function Test-SacHealth {
|
|
if (-not (Test-SacConfigured)) { return $false }
|
|
$base = Get-SacBaseUrl
|
|
if ([string]::IsNullOrWhiteSpace($base)) { return $false }
|
|
|
|
$timeout = if ($SacTimeoutSec) { [int]$SacTimeoutSec } else { 12 }
|
|
try {
|
|
Invoke-SacTlsPrep
|
|
$resp = Invoke-WebRequest -Uri "$base/health" -Method Get -UseBasicParsing -TimeoutSec $timeout
|
|
return ($resp.StatusCode -eq 200)
|
|
} catch {
|
|
return $false
|
|
}
|
|
}
|
|
|
|
function Write-SacSpoolFile {
|
|
param(
|
|
[string]$EventId,
|
|
[string]$JsonBody
|
|
)
|
|
$dir = Get-SacSpoolDirResolved
|
|
if (-not (Test-Path -LiteralPath $dir)) {
|
|
New-Item -ItemType Directory -Path $dir -Force | Out-Null
|
|
}
|
|
$path = Join-Path $dir "$EventId.json"
|
|
[System.IO.File]::WriteAllText($path, $JsonBody, (New-Object System.Text.UTF8Encoding $false))
|
|
}
|
|
|
|
function Remove-SacSpoolFile {
|
|
param([string]$EventId)
|
|
$path = Join-Path (Get-SacSpoolDirResolved) "$EventId.json"
|
|
if (Test-Path -LiteralPath $path) {
|
|
Remove-Item -LiteralPath $path -Force -ErrorAction SilentlyContinue
|
|
}
|
|
}
|
|
|
|
function Invoke-SacPostPayload {
|
|
param([string]$JsonBody)
|
|
|
|
if (-not (Test-SacConfigured)) { return $false }
|
|
if (-not (Test-SacShouldAttemptSend)) { return $false }
|
|
|
|
$ingest = Get-SacIngestUrl
|
|
if ([string]::IsNullOrWhiteSpace($ingest)) { return $false }
|
|
|
|
$obj = $JsonBody | ConvertFrom-Json
|
|
$eventId = [string]$obj.event_id
|
|
$eventType = [string]$obj.type
|
|
$timeout = if ($SacTimeoutSec) { [int]$SacTimeoutSec } else { 12 }
|
|
|
|
try {
|
|
Invoke-SacTlsPrep
|
|
$headers = @{
|
|
Authorization = "Bearer $SacApiKey"
|
|
'Content-Type' = 'application/json'
|
|
'Idempotency-Key' = $eventId
|
|
}
|
|
$resp = Invoke-WebRequest -Uri $ingest -Method Post -Headers $headers -Body $JsonBody -UseBasicParsing -TimeoutSec $timeout
|
|
if ($resp.StatusCode -in 201, 409, 202) {
|
|
Remove-SacSpoolFile -EventId $eventId
|
|
Reset-SacFailCount
|
|
Write-SacLog "SAC: accepted event_id=$eventId type=$eventType"
|
|
return $true
|
|
}
|
|
$body = if ($resp.Content) { $resp.Content } else { '' }
|
|
Write-SacLog "WARN: SAC POST HTTP $($resp.StatusCode): $($body.Substring(0, [Math]::Min(200, $body.Length)))"
|
|
} catch {
|
|
$code = 0
|
|
if ($_.Exception.Response) {
|
|
$code = [int]$_.Exception.Response.StatusCode
|
|
}
|
|
$err = $_.Exception.Message
|
|
Write-SacLog "WARN: SAC POST HTTP ${code}: $err"
|
|
}
|
|
|
|
Write-SacSpoolFile -EventId $eventId -JsonBody $JsonBody
|
|
$max = if ($SacFallbackFailures) { [int]$SacFallbackFailures } else { 5 }
|
|
$n = Get-SacFailCount + 1
|
|
Set-SacFailCount -Count $n
|
|
if ($n -ge $max) {
|
|
Write-SacLog "WARN: SAC fallback: SAC_FALLBACK_FAILURES threshold ($max)"
|
|
}
|
|
return $false
|
|
}
|
|
|
|
function Send-SacEvent {
|
|
param(
|
|
[Parameter(Mandatory = $true)][string]$EventType,
|
|
[Parameter(Mandatory = $true)][string]$Severity,
|
|
[Parameter(Mandatory = $true)][string]$Title,
|
|
[Parameter(Mandatory = $true)][string]$Summary,
|
|
[hashtable]$Details = $null
|
|
)
|
|
|
|
if (-not (Test-SacConfigured)) {
|
|
Write-SacLog 'WARN: SAC not configured (SacUrl / SacApiKey)'
|
|
return $false
|
|
}
|
|
|
|
$payload = New-SacEventPayload -EventType $EventType -Severity $Severity -Title $Title -Summary $Summary -Details $Details
|
|
$json = $payload | ConvertTo-Json -Depth 8 -Compress
|
|
return (Invoke-SacPostPayload -JsonBody $json)
|
|
}
|
|
|
|
function Send-SacLocalChannels {
|
|
param(
|
|
[string]$TelegramMessage,
|
|
[string]$EmailSubject
|
|
)
|
|
|
|
if ([string]::IsNullOrWhiteSpace($TelegramMessage)) { return $false }
|
|
|
|
$channels = @(Get-NotifyOrderChannels)
|
|
if ($channels.Count -eq 0) { return $false }
|
|
|
|
$anyOk = $false
|
|
foreach ($ch in $channels) {
|
|
$ok = switch ($ch) {
|
|
'telegram' { Send-TelegramMessage -Message $TelegramMessage }
|
|
'email' { Send-EmailNotification -Message $TelegramMessage -Subject $EmailSubject }
|
|
default { $false }
|
|
}
|
|
if ($ok) { $anyOk = $true }
|
|
}
|
|
return $anyOk
|
|
}
|
|
|
|
function Test-SacHeartbeatOnlyEventType {
|
|
param([string]$EventType)
|
|
return ($EventType -eq 'agent.heartbeat')
|
|
}
|
|
|
|
function Send-NotifyOrSac {
|
|
param(
|
|
[Parameter(Mandatory = $true)][string]$EventType,
|
|
[Parameter(Mandatory = $true)][string]$Severity,
|
|
[Parameter(Mandatory = $true)][string]$Title,
|
|
[Parameter(Mandatory = $true)][string]$Summary,
|
|
[string]$TelegramMessage = '',
|
|
[string]$EmailSubject = 'RDP Login Monitor',
|
|
[hashtable]$Details = $null
|
|
)
|
|
|
|
if ([string]::IsNullOrWhiteSpace($TelegramMessage)) {
|
|
$TelegramMessage = $Summary
|
|
}
|
|
|
|
$mode = Get-SacNormalizedMode
|
|
|
|
# Периодический heartbeat — только SAC (UI), без Telegram/email в любом режиме.
|
|
if (Test-SacHeartbeatOnlyEventType -EventType $EventType) {
|
|
if ($mode -eq 'off') {
|
|
return $false
|
|
}
|
|
return (Send-SacEvent -EventType $EventType -Severity $Severity -Title $Title -Summary $Summary -Details $Details)
|
|
}
|
|
|
|
switch ($mode) {
|
|
'off' {
|
|
return (Send-SacLocalChannels -TelegramMessage $TelegramMessage -EmailSubject $EmailSubject)
|
|
}
|
|
'exclusive' {
|
|
return (Send-SacEvent -EventType $EventType -Severity $Severity -Title $Title -Summary $Summary -Details $Details)
|
|
}
|
|
'dual' {
|
|
Send-SacEvent -EventType $EventType -Severity $Severity -Title $Title -Summary $Summary -Details $Details | Out-Null
|
|
return (Send-SacLocalChannels -TelegramMessage $TelegramMessage -EmailSubject $EmailSubject)
|
|
}
|
|
'fallback' {
|
|
if (Send-SacEvent -EventType $EventType -Severity $Severity -Title $Title -Summary $Summary -Details $Details) {
|
|
return $true
|
|
}
|
|
return (Send-SacLocalChannels -TelegramMessage $TelegramMessage -EmailSubject $EmailSubject)
|
|
}
|
|
default {
|
|
Write-SacLog "WARN: unknown UseSAC=$mode, local channels only"
|
|
return (Send-SacLocalChannels -TelegramMessage $TelegramMessage -EmailSubject $EmailSubject)
|
|
}
|
|
}
|
|
}
|
|
|
|
function Invoke-SacFlushSpool {
|
|
param([int]$MaxFiles = 20)
|
|
|
|
$mode = Get-SacNormalizedMode
|
|
if ($mode -eq 'off') { return }
|
|
if (-not (Test-SacConfigured)) { return }
|
|
|
|
$dir = Get-SacSpoolDirResolved
|
|
if (-not (Test-Path -LiteralPath $dir)) { return }
|
|
|
|
$files = @(Get-ChildItem -LiteralPath $dir -Filter '*.json' -File -ErrorAction SilentlyContinue | Sort-Object LastWriteTime)
|
|
$count = 0
|
|
foreach ($f in $files) {
|
|
$count++
|
|
if ($count -gt $MaxFiles) { break }
|
|
try {
|
|
$json = [System.IO.File]::ReadAllText($f.FullName)
|
|
Invoke-SacPostPayload -JsonBody $json | Out-Null
|
|
} catch { }
|
|
}
|
|
}
|
|
|
|
function Test-SacConnection {
|
|
Write-Host 'SAC check (rdp-login-monitor)'
|
|
Write-Host "UseSAC=$(Get-SacNormalizedMode)"
|
|
switch (Get-SacNormalizedMode) {
|
|
'exclusive' { Write-Host 'Mode exclusive: SAC only' }
|
|
'dual' { Write-Host 'Mode dual: SAC + local channels' }
|
|
'fallback' { Write-Host 'Mode fallback: SAC, then local on failure' }
|
|
}
|
|
Write-Host "SacUrl=$SacUrl"
|
|
if (Test-SacConfigured) {
|
|
Write-Host "SAC ingest URL=$(Get-SacIngestUrl)"
|
|
}
|
|
if (-not (Test-SacConfigured)) {
|
|
Write-Error 'SAC: SacUrl or SacApiKey missing'
|
|
return 1
|
|
}
|
|
if (Test-SacHealth) {
|
|
Write-Host 'SAC health: OK'
|
|
} else {
|
|
Write-Error 'SAC health: FAIL'
|
|
return 1
|
|
}
|
|
if (Send-SacEvent -EventType 'agent.test' -Severity 'info' -Title 'SAC test' -Summary 'rdp-login-monitor CheckSac') {
|
|
Write-Host 'SAC ingest agent.test: OK (expected HTTP 201)'
|
|
return 0
|
|
}
|
|
Write-Error 'SAC ingest agent.test: FAIL'
|
|
return 1
|
|
}
|