forked from mtusi2026/mtusi2026lab7
231 lines
14 KiB
PowerShell
231 lines
14 KiB
PowerShell
<#
|
||
.SYNOPSIS
|
||
Лабораторная 7 (мессенджер): развернуть стенд и проверить всё — одной командой в PowerShell.
|
||
|
||
.DESCRIPTION
|
||
Запуск из корня репозитория:
|
||
powershell -ExecutionPolicy Bypass -File .\run.ps1 # всё: up + все проверки
|
||
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action up # только развернуть
|
||
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action test # публичные тесты lab7 (HTTPS)
|
||
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action security
|
||
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action resilience
|
||
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action lifecycle
|
||
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action extra
|
||
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action scan
|
||
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action down # остановить, данные сохраняются
|
||
powershell -ExecutionPolicy Bypass -File .\run.ps1 -Action destroy # НАМЕРЕННО удалить данные стенда
|
||
|
||
Нужно: Docker Desktop (Compose v2), Python 3.9+ (только стандартная библиотека; PKI создаётся
|
||
в контейнере, если на хосте нет пакета cryptography), свободные порты 127.0.0.1:8443 и :3000.
|
||
Вывод каждого шага сохраняется в evidence\run\<шаг>.txt, итоговая таблица — в конце.
|
||
#>
|
||
[CmdletBinding()]
|
||
param(
|
||
[ValidateSet('all', 'check', 'up', 'test', 'security', 'resilience', 'lifecycle', 'extra', 'scan', 'down', 'destroy')]
|
||
[string]$Action = 'all',
|
||
# Не разворачивать стенд в режиме all (если он уже запущен)
|
||
[switch]$SkipUp,
|
||
# Остановиться на первом проваленном шаге
|
||
[switch]$StopOnFailure
|
||
)
|
||
|
||
$ErrorActionPreference = 'Continue'
|
||
Set-StrictMode -Version 2.0
|
||
$Root = Split-Path -Parent $MyInvocation.MyCommand.Path
|
||
Set-Location $Root
|
||
try { [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 } catch { }
|
||
$env:PYTHONIOENCODING = 'utf-8'
|
||
$env:PYTHONUTF8 = '1'
|
||
$env:COMPOSE_PROJECT_NAME = 'messenger-lab7'
|
||
|
||
$CaFile = Join-Path $Root 'secrets\pki\ca.crt'
|
||
$HttpsPort = 8443
|
||
if (Test-Path (Join-Path $Root '.env')) {
|
||
foreach ($line in Get-Content (Join-Path $Root '.env')) {
|
||
if ($line -match '^\s*HTTPS_PORT\s*=\s*(\d+)') { $HttpsPort = [int]$Matches[1] }
|
||
}
|
||
}
|
||
$BaseUrl = "https://localhost:$HttpsPort"
|
||
$EvidenceDir = Join-Path $Root 'evidence\run'
|
||
New-Item -ItemType Directory -Force -Path $EvidenceDir | Out-Null
|
||
$Results = New-Object System.Collections.Generic.List[object]
|
||
|
||
# ------------------------------------------------------------------ Python
|
||
$Py = $null
|
||
$PyArgs = @()
|
||
foreach ($candidate in @(@('python'), @('py', '-3'), @('python3'))) {
|
||
$exe = Get-Command $candidate[0] -ErrorAction SilentlyContinue
|
||
if (-not $exe) { continue }
|
||
$extra = @()
|
||
if ($candidate.Count -gt 1) { $extra = @($candidate[1..($candidate.Count - 1)]) }
|
||
$ver = & $candidate[0] @extra -c "import sys; print('%d.%d' % sys.version_info[:2])" 2>$null
|
||
if ($LASTEXITCODE -eq 0 -and $ver -and ([version]"$ver" -ge [version]'3.9')) {
|
||
$Py = $candidate[0]; $PyArgs = $extra; break
|
||
}
|
||
}
|
||
|
||
function Write-Title([string]$Text) {
|
||
Write-Host ''
|
||
Write-Host ('=' * 78) -ForegroundColor DarkCyan
|
||
Write-Host " $Text" -ForegroundColor Cyan
|
||
Write-Host ('=' * 78) -ForegroundColor DarkCyan
|
||
}
|
||
|
||
function Invoke-Step {
|
||
<# Выполнить внешнюю команду, показать вывод построчно и сохранить его в evidence\run\<Name>.txt #>
|
||
param([string]$Name, [string]$Title, [string]$Exe, [string[]]$Arguments, [hashtable]$EnvVars = @{})
|
||
Write-Title "$Name — $Title"
|
||
$file = Join-Path $EvidenceDir ($Name + '.txt')
|
||
"# $Title`r`n# $Exe $($Arguments -join ' ')`r`n# $(Get-Date -Format o)" | Out-File -FilePath $file -Encoding utf8
|
||
$saved = @{}
|
||
foreach ($k in $EnvVars.Keys) { $saved[$k] = [Environment]::GetEnvironmentVariable($k); [Environment]::SetEnvironmentVariable($k, $EnvVars[$k]) }
|
||
$sw = [Diagnostics.Stopwatch]::StartNew()
|
||
& $Exe @Arguments 2>&1 | ForEach-Object {
|
||
$line = "$_"
|
||
Write-Host $line
|
||
Add-Content -Path $file -Value $line -Encoding UTF8
|
||
}
|
||
$code = $LASTEXITCODE
|
||
$sw.Stop()
|
||
foreach ($k in $saved.Keys) { [Environment]::SetEnvironmentVariable($k, $saved[$k]) }
|
||
$ok = ($code -eq 0)
|
||
$Results.Add([pscustomobject]@{ Step = $Name; Result = $(if ($ok) { 'PASS' } else { "FAIL ($code)" });
|
||
Seconds = [int]$sw.Elapsed.TotalSeconds; Evidence = "evidence\run\$Name.txt" }) | Out-Null
|
||
if ($ok) { Write-Host "[PASS] $Name" -ForegroundColor Green } else { Write-Host "[FAIL] $Name (exit $code)" -ForegroundColor Red }
|
||
if (-not $ok -and $StopOnFailure) { Show-Summary; exit 1 }
|
||
return $ok
|
||
}
|
||
|
||
function Invoke-Py {
|
||
param([string]$Name, [string]$Title, [string[]]$Arguments, [hashtable]$EnvVars = @{})
|
||
return Invoke-Step -Name $Name -Title $Title -Exe $Py -Arguments (@($PyArgs) + @($Arguments)) -EnvVars $EnvVars
|
||
}
|
||
|
||
function Show-Summary {
|
||
Write-Title 'Итог'
|
||
$Results | Format-Table -AutoSize | Out-String -Width 200 | Write-Host
|
||
$failed = @($Results | Where-Object { $_.Result -ne 'PASS' }).Count
|
||
$summary = Join-Path $EvidenceDir 'SUMMARY.txt'
|
||
$Results | Format-Table -AutoSize | Out-String -Width 200 | Out-File -FilePath $summary -Encoding utf8
|
||
if ($failed -eq 0) { Write-Host "Все шаги пройдены. Сводка: evidence\run\SUMMARY.txt" -ForegroundColor Green }
|
||
else { Write-Host "Провалено шагов: $failed. Подробности — в файлах evidence\run\*.txt" -ForegroundColor Red }
|
||
}
|
||
|
||
# ------------------------------------------------------------------ шаги
|
||
function Step-Check {
|
||
Write-Title 'Проверка окружения'
|
||
$ok = $true
|
||
if (-not $Py) { Write-Host 'Нужен Python 3.9+ (python или py -3 в PATH)' -ForegroundColor Red; $ok = $false }
|
||
else { Write-Host "Python: $Py $($PyArgs -join ' ') ($(& $Py @PyArgs --version 2>&1))" }
|
||
if (-not (Get-Command docker -ErrorAction SilentlyContinue)) { Write-Host 'Нужен Docker Desktop' -ForegroundColor Red; $ok = $false }
|
||
else {
|
||
docker info --format '{{.ServerVersion}}' 1>$null 2>$null
|
||
if ($LASTEXITCODE -ne 0) { Write-Host 'Docker daemon не запущен (запустите Docker Desktop)' -ForegroundColor Red; $ok = $false }
|
||
$cv = docker compose version --short 2>$null
|
||
if ($LASTEXITCODE -ne 0) { Write-Host 'Нужен Docker Compose v2 (docker compose)' -ForegroundColor Red; $ok = $false }
|
||
else { Write-Host "Docker Compose: $cv" }
|
||
}
|
||
foreach ($port in @($HttpsPort, 3000)) {
|
||
$busy = $false
|
||
try { $busy = @(Get-NetTCPConnection -LocalPort $port -State Listen -ErrorAction Stop).Count -gt 0 } catch { }
|
||
if ($busy) {
|
||
$own = docker ps --filter "label=com.docker.compose.project=messenger-lab7" -q 2>$null
|
||
if (-not $own) { Write-Host "Порт $port занят другим процессом" -ForegroundColor Yellow }
|
||
}
|
||
}
|
||
if (-not $ok) { Write-Host 'Окружение не готово.' -ForegroundColor Red; exit 2 }
|
||
Invoke-Py 'check-contract' 'make check: структура skeleton, контракт, синтаксис тестов' @('scripts/check_contract.py') | Out-Null
|
||
Invoke-Step 'compose-config' 'docker compose config --quiet' 'docker' @('compose', 'config', '--quiet') | Out-Null
|
||
}
|
||
|
||
function Step-Up {
|
||
Invoke-Py 'up' 'Bootstrap: secrets -> образ -> PKI -> OpenBao init/unseal/configure -> стенд -> ожидание готовности' `
|
||
@('scripts/ops.py', 'up') | Out-Null
|
||
Invoke-Py 'ps' 'Реплики API: alias, health, статус в LB' @('scripts/ops.py', 'ps') | Out-Null
|
||
}
|
||
|
||
function Step-Test {
|
||
Invoke-Py 'test-smoke' "make test BASE_URL=$BaseUrl CA_FILE=secrets\pki\ca.crt" `
|
||
@('tests/smoke.py', '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
|
||
Invoke-Py 'test-security' 'make test-security: доверенный CA работает, недоверенный — ошибка проверки сертификата' `
|
||
@('tests/security.py', '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
|
||
}
|
||
|
||
function Step-Security {
|
||
Invoke-Py 'tls-audit' 'Вся trust matrix: TLS/mTLS (нет cert / чужой CA / чужая identity / верная), имена, plaintext, ACL' `
|
||
@('scripts/ops.py', 'tls-audit') | Out-Null
|
||
Invoke-Py 'security-http' 'ACL/вложения, X-User-Id, logout, 429 + Retry-After (общий), 413, ошибки без утечек, TLS снаружи' `
|
||
@('scripts/ops.py', 'security-http') | Out-Null
|
||
Invoke-Py 'bao-policy' 'OpenBao: allow/deny политик реальными токенами AppRole, CIDR, TTL' `
|
||
@('scripts/ops.py', 'bao-policy') | Out-Null
|
||
Invoke-Py 'hardening' 'Hardening: non-root, read_only, cap_drop, no-new-privileges, лимиты, порты, сегментация, egress' `
|
||
@('scripts/ops.py', 'hardening') | Out-Null
|
||
Invoke-Py 'rehash' 'Argon2id: старый hash пересчитывается при успешном входе' @('scripts/ops.py', 'rehash-demo') | Out-Null
|
||
Invoke-Py 'leak-check' 'В Loki/Tempo/Prometheus нет паролей, токенов, секретов ролей' @('scripts/ops.py', 'leak-check') | Out-Null
|
||
Invoke-Py 'expiry' 'Истечение сессии (экземпляр с TTL 2 с, mTLS напрямую к реплике)' @('scripts/ops.py', 'in-network', 'expiry') | Out-Null
|
||
}
|
||
|
||
function Step-Resilience {
|
||
$restart = Join-Path $Root 'scripts\restart.cmd'
|
||
$stopOne = Join-Path $Root 'scripts\stop-one.cmd'
|
||
Invoke-Py 'test-persistence' 'make test-persistence: рестарт API и всех хранилищ (вкл. OpenBao + unseal), данные и токен живы' `
|
||
@('tests/resilience.py', '--mode', 'persistence', '--action-script', $restart, '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
|
||
Invoke-Py 'test-failover-1' 'make test-failover: отказ одной API-реплики по HTTPS' `
|
||
@('tests/resilience.py', '--mode', 'failover', '--action-script', $stopOne, '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
|
||
Invoke-Py 'restore-1' 'Восстановление реплики' @('scripts/ops.py', 'restore') | Out-Null
|
||
Invoke-Py 'test-failover-2' 'Отказ другой реплики (последовательно)' `
|
||
@('tests/resilience.py', '--mode', 'failover', '--action-script', $stopOne, '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
|
||
Invoke-Py 'restore-2' 'Восстановление реплики' @('scripts/ops.py', 'restore') | Out-Null
|
||
}
|
||
|
||
function Step-Lifecycle {
|
||
Invoke-Py 'rotate-db-password' 'Ротация рабочего секрета (пароль роли БД) без пересборки и рестарта API' `
|
||
@('scripts/ops.py', 'rotate-db-password', 'api') | Out-Null
|
||
Invoke-Py 'rotate-lb-cert' 'Ротация leaf LB->API + отзыв старого сертификата (CRL), проверка старым и новым' `
|
||
@('scripts/ops.py', 'rotate-lb-cert') | Out-Null
|
||
Invoke-Py 'rotate-secret-id' 'Новый SecretID агента API, старый уничтожен' @('scripts/ops.py', 'rotate-secret-id', 'api') | Out-Null
|
||
Invoke-Py 'revoke-identity' 'Отзыв identity worker в OpenBao -> агент без доступа -> восстановление' `
|
||
@('scripts/ops.py', 'revoke-identity', 'worker') | Out-Null
|
||
Invoke-Py 'bao-sealed' 'OpenBao sealed: API работает и перезапускается на отрисованных секретах, затем unseal' `
|
||
@('scripts/ops.py', 'bao-sealed') | Out-Null
|
||
Invoke-Py 'smoke-after-lifecycle' 'Smoke после всех ротаций' @('tests/smoke.py', '--base-url', $BaseUrl, '--ca-file', $CaFile) | Out-Null
|
||
}
|
||
|
||
function Step-Extra {
|
||
Invoke-Py 'student-tests' 'Собственные HTTP-тесты lab2-6 через HTTPS' `
|
||
@('student-tests/run_all.py', '--base-url', $BaseUrl) -EnvVars @{ CA_FILE = $CaFile } | Out-Null
|
||
Invoke-Py 'storage-tests' 'White-box тесты хранилища внутри сети (identity администратора БД)' `
|
||
@('scripts/ops.py', 'in-network', 'storage') | Out-Null
|
||
Invoke-Py 'login-budget' 'Бюджет login DoS: Argon2id на стенде + поток входов' @('scripts/ops.py', 'login-budget') | Out-Null
|
||
Invoke-Py 's3-check' 'Приватность бакета и права ключа API вне API' @('scripts/ops.py', 's3-check') | Out-Null
|
||
}
|
||
|
||
# ------------------------------------------------------------------ main
|
||
switch ($Action) {
|
||
'check' { Step-Check }
|
||
'up' { Step-Check; Step-Up }
|
||
'test' { Step-Test }
|
||
'security' { Step-Security }
|
||
'resilience' { Step-Resilience }
|
||
'lifecycle' { Step-Lifecycle }
|
||
'extra' { Step-Extra }
|
||
'scan' { Invoke-Py 'scan' 'pip-audit + trivy образов (разбор: docs/security/SCAN_TRIAGE.md)' @('scripts/ops.py', 'scan') | Out-Null }
|
||
'down' { Invoke-Py 'down' 'Остановка стенда (volumes сохраняются)' @('scripts/ops.py', 'down') | Out-Null }
|
||
'destroy' {
|
||
$answer = Read-Host 'Удалить ВСЕ данные стенда (БД, S3, broker, OpenBao, телеметрия)? Введите yes'
|
||
if ($answer -eq 'yes') { Invoke-Py 'destroy' 'Удаление volumes стенда' @('scripts/ops.py', 'destroy') | Out-Null }
|
||
}
|
||
'all' {
|
||
Step-Check
|
||
if (-not $SkipUp) { Step-Up }
|
||
Step-Test
|
||
Step-Security
|
||
Step-Resilience
|
||
Step-Lifecycle
|
||
Step-Extra
|
||
}
|
||
}
|
||
if ($Results.Count -gt 0) { Show-Summary }
|
||
if (@($Results | Where-Object { $_.Result -ne 'PASS' }).Count -gt 0) { exit 1 }
|
||
exit 0
|