Mark-of-the-Web (MOTW) adalah mekanisme keamanan Windows berbasis NTFS Alternate Data Streams (ADS) bernama Zone.Identifier. Mekanisme ini menandai file yang diunduh dari internet (Zone 3) agar fitur keamanan seperti Windows SmartScreen dan Defender SmartScreen melakukan inspeksi sebelum eksekusi. Namun, MOTW memiliki celah operasional ketika mendistribusikan installer Command Line Interface (CLI) melalui file arsip seperti ZIP, tarball, atau perkakas ekstraksi pihak ketiga.
Kelemahan Mekanisme MOTW pada Distribusi Binary CLI
Windows Explorer secara default menyematkan flag Zone.Identifier ke dalam file yang diunduh dari browser. Saat pengguna mengekstrak arsip ZIP menggunakan utilitas bawaan Windows Explorer, atribut MOTW disalin ke file hasil ekstraksi. Namun, model keamanan ini rapuh terhadap beberapa kondisi:
- Alat Ekstraksi Pihak Ketiga: Utilitas populer seperti 7-Zip versi lama atau perkakas CLI eksternal tidak selalu menyalin stream
Zone.Identifierke file target. Binary yang diekstrak kehilangan atribut zona dan langsung dieksekusi tanpa peringatan SmartScreen. - Bypass Pengembang Otomatis: Administrator atau developer terbiasa menjalankan perintah seperti
Unblock-Fileuntuk menghindari dialog peringatan interaktif, yang secara efektif menghapus metadata ADS sepenuhnya. - Format Non-ZIP: Format seperti
.tar.gzyang lazim digunakan untuk utility developer sering kali tidak didukung langsung oleh Windows Explorer shell lama, memaksa ekstraksi via CLI yang mengabaikan ADS.
Mengandalkan MOTW sebagai kontrol keamanan tunggal adalah kesalahan arsitektur. Pipeline rilis harus mengombinasikan penandatanganan digital Authenticode, checksum manifest cryptographically secure, serta wrapper eksekusi lokal yang memvalidasi integritas sebelum eksekusi.
Implementasi Pipeline CI/CD: Authenticode Signing dan Hash Manifest
Langkah pertahanan pertama dilakukan pada tahap packaging di CI/CD. Binary CLI (misalnya mycli.exe) harus ditandatangani menggunakan sertifikat Authenticode dengan algoritma hashing SHA-256 dan RFC 3161 timestamping. Setelah itu, manifest checksum dibuat dan ditandatangani secara terpisah.
Berikut contoh job GitHub Actions menggunakan runner Windows:
name: Release Pipeline
on:
push:
tags:
- 'v*.*.*'
jobs:
build-and-sign:
runs-on: windows-2022
steps:
- name: Checkout Code
uses: actions/checkout@v4
- name: Build Binary
run: |
go build -ldflags="-s -w" -o dist/mycli.exe ./cmd/mycli
- name: Authenticode Signing
shell: pwsh
env:
CERT_PFX: ${{ secrets.CODE_SIGNING_CERT_BASE64 }}
CERT_PASS: ${{ secrets.CODE_SIGNING_PASSWORD }}
run: |
$pfxBytes = [System.Convert]::FromBase64String($env:CERT_PFX)
$certPath = "$env:TEMP\signing-cert.pfx"
[System.IO.File]::WriteAllBytes($certPath, $pfxBytes)
try {
$signTool = "C:\Program Files (x86)\Windows Kits\10\bin\10.0.22621.0\x64\signtool.exe"
& $signTool sign /f $certPath /p $env:CERT_PASS /fd SHA256 /tr http://timestamp.digicert.com /td SHA256 dist/mycli.exe
if ($LASTEXITCODE -ne 0) { throw "Signtool signing failed" }
}
finally {
Remove-Item -Path $certPath -Force -ErrorAction SilentlyContinue
}
- name: Generate Checksum Manifest
shell: pwsh
run: |
$hash = (Get-FileHash -Path dist/mycli.exe -Algorithm SHA256).Hash
"$hash mycli.exe" | Out-File -FilePath dist/SHA256SUMS -Encoding ascii -NoNewline
- name: Archive Artifacts
shell: pwsh
run: |
Compress-Archive -Path dist/mycli.exe, dist/SHA256SUMS -DestinationPath dist/mycli-windows-amd64.zip
- name: Publish Artifacts
uses: softprops/action-gh-release@v2
with:
files: |
dist/mycli-windows-amd64.zip
dist/SHA256SUMS
Verifikasi Lokal: Validasi Signature Sebelum Eksekusi
Karena pengguna sering mengekstrak binary menggunakan alat yang menghapus atribut MOTW, installer berbasis PowerShell script (seperti mekanisme irm https://... | iex) wajib melakukan validasi integritas secara lokal sebelum meletakkan file ke direktori sistem atau eksekusi awal.
Skrip berikut mengecek status Authenticode menggunakan cmdlet Get-AuthenticodeSignature dan memeriksa publisher identity untuk mencegah binary yang ditandatangani menggunakan sertifikat ad-hoc/self-signed yang tidak tepercaya:
# install.ps1
[CmdletBinding()]
param(
[Parameter(Mandatory=$false)]
[string]$TargetDir = "$env:LOCALAPPDATA\Programs\MyCLI"
)
$ErrorActionPreference = 'Stop'
$ExpectedSubject = 'CN=Example Tech Corp, O=Example Tech Corp, L=Jakarta, C=ID'
$ZipUrl = 'https://github.com/example/mycli/releases/latest/download/mycli-windows-amd64.zip'
$TempZip = Join-Path $env:TEMP 'mycli-download.zip'
$TempExtract = Join-Path $env:TEMP ('mycli-temp-' + [System.Guid]::NewGuid().ToString())
try {
Write-Host "Mengunduh installer binary..."
Invoke-WebRequest -Uri $ZipUrl -OutFile $TempZip -UseBasicParsing
Write-Host "Mengekstrak package..."
Expand-Archive -Path $TempZip -DestinationPath $TempExtract -Force
$binaryPath = Join-Path $TempExtract 'mycli.exe'
if (-not (Test-Path $binaryPath)) {
throw "Binary executable tidak ditemukan dalam paket."
}
Write-Host "Memvalidasi digital signature Authenticode..."
$sig = Get-AuthenticodeSignature -FilePath $binaryPath
if ($sig.Status -ne 'Valid') {
throw "Integritas binary gagal: Status signature $($sig.Status). Eksekusi dibatalkan."
}
if ($sig.SignerCertificate.Subject -ne $ExpectedSubject) {
throw "Sertifikat tidak cocok! Ditemukan: $($sig.SignerCertificate.Subject). Diharapkan: $ExpectedSubject"
}
Write-Host "Verifikasi berhasil. Melakukan deployment ke $TargetDir..."
if (-not (Test-Path $TargetDir)) {
New-Item -ItemType Directory -Path $TargetDir -Force | Out-Null
}
Copy-Item -Path $binaryPath -Destination (Join-Path $TargetDir 'mycli.exe') -Force
Write-Host "Instalasi selesai."
}
finally {
Remove-Item -Path $TempZip -Force -ErrorAction SilentlyContinue
Remove-Item -Path $TempExtract -Recurse -Force -ErrorAction SilentlyContinue
}
Troubleshooting dan Error Handling Praktis
Saat menerapkan alur verifikasi di atas, beberapa masalah teknis umum meliputi:
- Status
UnknownErroratauNotSigned: Pastikan binary tidak dimodifikasi setelah proses signing (misalnya kompresi UPX setelah penandatanganan). Signing harus menjadi langkah kompilasi terakhir. - Validasi Timestamp Gagal di CI/CD: Server timestamp RFC 3161 dapat mengalami rate limiting atau timeout jaringan. Konfigurasikan retry logic di step CI untuk eksekusi
signtool.exe. - Trust Anchor Root: Pada mesin isolasi tanpa akses internet langsung, verifikasi Authenticode dapat gagal jika intermediate certificate tidak disertakan dalam rantai penandatanganan (bundled certificate). Gunakan opsi
/acpadasigntooljika diperlukan sertifikat cross-certificate.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!