Kompilasi binary rilis pada pipeline CI yang terhubung ke internet membuka celah serangan supply chain dan eksfiltrasi kredensial. Jika dependency resolver mengunduh paket berbahaya saat proses kompilasi berjalan, penyerang dapat mengeksekusi skrip instalasi untuk mencuri environment variable (seperti signing key) keluar jaringan. Mengadopsi prinsip hardware air-gap (tanpa wireless chip dan antarmuka jaringan fisik), air-gapped build runner mematikan akses jaringan sepenuhnya pada tahap kompilasi rilis.

Arsitektur Pemisahan Tahap Fetch dan Build

Pola implementasi membagi pipeline menjadi dua tahap terisolasi:

  1. Tahap Ingestion (Fetch): Kontainer memiliki akses internet terbatas hanya untuk mengunduh source code dan dependensi berdasarkan manifest lockfile. Seluruh dependensi divalidasi checksum SHA-256 miliknya, lalu dikompresi menjadi volume cache lokal. Tidak ada private signing key yang dipasang pada tahap ini.
  2. Tahap Kompilasi (Air-Gapped Build): Kontainer dieksekusi dengan isolasi jaringan penuh. Engine kompilator diarahkan hanya membaca direktori cache lokal (vendor/offline mode). Signing key dimasukkan melalui ephemeral mount hanya pada tahap ini.

Konfigurasi Docker Runner Menggunakan --network none

Docker menyediakan driver none yang meniadakan stack jaringan eksternal pada kontainer, hanya menyisakan loopback interface (127.0.0.1). Pendekatan ini memblokir seluruh socket TCP/UDP keluar.

# Eksekusi runner tanpa akses jaringan eksternal
docker run --rm \
  --network none \
  -v "$(pwd)/cache/vendor":/workspace/vendor:ro \
  -v "$(pwd)/src":/workspace/src:ro \
  -v "$(pwd)/dist":/workspace/dist:rw \
  -v "/etc/ci-secrets/release.key":/secrets/release.key:ro \
  golang:1.22-alpine \
  sh -c "cd /workspace/src && go build -mod=vendor -v -o /workspace/dist/app-release ."

Verifikasi Integritas Dependensi dan Vendor Cache

Pre-fetching wajib mengecek integritas file sebelum file tersebut diteruskan ke build runner. Hindari penggunaan tag versi mutable (seperti latest) atau dependensi tanpa hash yang terverifikasi.

#!/usr/bin/env bash
# prefetch.sh: Dijalankan pada tahap fetch terisolasi
set -euo pipefail

CACHE_DIR="./cache/vendor"
mkdir -p "${CACHE_DIR}"

# Unduh dependensi
go mod download

# Verifikasi hash checksum terhadap go.sum
go mod verify

# Salin dependensi ke cache lokal yang akan di-mount
go mod vendor -o "${CACHE_DIR}"

# Generate hash manifest untuk audit pipeline
find "${CACHE_DIR}" -type f -exec sha256sum {} + | sort -k 2 > "${CACHE_DIR}.manifest.sha256"

Mitigasi Eksfiltrasi Secret pada Tahap Kompilasi

Dengan menerapkan isolasi network, vektor serangan eksfiltrasi data secret langsung diputus:

  • Eksfiltrasi Out-of-Band (DNS tunneling): Flag --network none menonaktifkan resolusi nama domain host karena tidak ada interface yang terhubung ke gateway atau resolver DNS.
  • HTTP Exfiltration: Script berbahaya yang disisipkan ke paket dependensi gagal melakukan panggilan POST/PUT karena koneksi socket langsung mengembalikan error ENETUNREACH (Network is unreachable).
  • Prinsip Least Privilege Secret: Environment variable yang berisi token cloud provider (seperti AWS IAM, NPM publishing tokens) tidak boleh disuntikkan ke dalam build runner, melainkan didelegasikan ke post-build step terpisah yang hanya mengunggah artefak hasil kompilasi.

Runnable Bash Verification Script

Script berikut membuktikan bahwa kontainer yang berjalan dengan --network none tidak dapat menjangkau jaringan eksternal dan tetap dapat menyelesaikan proses kompilasi binary dari cache lokal.

#!/usr/bin/env bash
# test-airgap-runner.sh: Self-check isolasi jaringan runner
set -euo pipefail

WORK_DIR=$(mktemp -d)
trap 'rm -rf "${WORK_DIR}"' EXIT

# 1. Setup mock source file
cat << 'EOF' > "${WORK_DIR}/main.go"
package main
import "fmt"
func main() {
    fmt.Println("Air-gapped build success")
}
EOF

# 2. Verifikasi pemblokiran jaringan (Wajib gagal connect)
echo "[1/2] Verifikasi isolasi network runner..."
set +e
docker run --rm --network none alpine:latest ping -c 1 1.1.1.1 >/dev/null 2>&1
STATUS=$?
set -e

if [ "${STATUS}" -eq 0 ]; then
    echo "FAIL: Jaringan terdeteksi aktif pada network none!" >&2
    exit 1
fi
echo "PASS: Isolasi jaringan bekerja. Koneksi eksternal diblokir."

# 3. Eksekusi build Go lokal dalam kontainer tanpa jaringan
echo "[2/2] Menguji proses kompilasi offline..."
docker run --rm \
    --network none \
    -v "${WORK_DIR}":/workspace:rw \
    -w /workspace \
    golang:alpine \
    go build -o mock-binary main.go

# 4. Validasi artefak
"${WORK_DIR}/mock-binary" | grep -q "Air-gapped build success"
echo "PASS: Binary berhasil dikompilasi dan dijalankan tanpa koneksi internet."

Trade-off dan Batasan

Implementasi air-gapped build runner memerlukan alokasi disk cache yang lebih besar pada host runner untuk menyimpan seluruh pohon dependensi lokal. Kompilasi toolchain C/C++ yang mengandalkan dynamic link (shared libraries) juga memerlukan base image yang sudah membundel SDK secara lengkap, tanpa bergantung pada perintah apk add atau apt-get install saat runtime kompilasi berlangsung.