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.Identifier ke 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-File untuk menghindari dialog peringatan interaktif, yang secara efektif menghapus metadata ADS sepenuhnya.
  • Format Non-ZIP: Format seperti .tar.gz yang 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 UnknownError atau NotSigned: 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 /ac pada signtool jika diperlukan sertifikat cross-certificate.