Coding agent berbasis terminal seperti Claude Code, Cline, atau custom agent di Cursor sering kali menjalankan perintah diagnostik secara otomatis. Tanpa proteksi pada level hook eksekusi, agen berisiko membaca berkas konfigurasi lokal seperti .env, private key SSH, atau membuang dump log berukuran puluhan megabyte langsung ke context window LLM. Hal ini memicu dua masalah fatal: kebocoran kredensial ke inference engine pihak ketiga dan lonjakan biaya token akibat loop evaluasi teks raksasa.
Solusi paling efisien untuk masalah ini berada pada level interceptor eksekusi perintah (pre-execution hook) berbasis POSIX shell. Hook bertindak sebagai gateway yang memfilter teks sensitif dan memotong payload berlebih sebelum string output dikirimkan kembali ke model.
Arsitektur Interceptor Context Window
Saat coding agent menjalankan instruksi shell (misalnya cat, tail, atau script automasi), standar pipeline-nya langsung mengalirkan stdout dan stderr ke prompt inference engine. Kita mengintervensi alur ini dengan wrapper perantara:
- Ukuran Payload: Batasi ukuran byte input/output. Jika melebihi batas batas (misalnya 50 KB), potong teks secara deterministik dan sisipkan penanda peringatan.
- Filter Kredensial: Pindai teks terhadap pattern token umum (AWS keys, generic Bearer tokens, GitHub personal access tokens, dan format private key) menggunakan
sed. - Validasi File Berbahaya: Cegah pembacaan path sensitif seperti
id_rsa,id_ed25519, atau berkas rahasia lokal secara eksplisit.
Implementasi Hook Sanitasi dan Truncation
Gunakan script POSIX shell mandiri berikut tanpa ketergantungan library pihak ketiga. Simpan sebagai sanitize_context.sh dan gunakan sebagai filter wrapper untuk perintah terminal yang dijalankan agen.
#!/bin/sh
# sanitize_context.sh: Filter token abuse dan sanitasi secret via STDIN
set -eu
MAX_BYTES=${MAX_BYTES:-51200} # Default limit: 50KB
# Baca STDIN ke file sementara
TMP_RAW=$(mktemp)
TMP_CLEAN=$(mktemp)
trap 'rm -f "$TMP_RAW" "$TMP_CLEAN"' EXIT
cat > "$TMP_RAW"
# 1. Truncation jika melebihi kuota byte
RAW_SIZE=$(wc -c < "$TMP_RAW" | tr -d ' ')
if [ "$RAW_SIZE" -gt "$MAX_BYTES" ]; then
head -c "$MAX_BYTES" "$TMP_RAW" > "$TMP_CLEAN"
TRUNCATED=1
else
cp "$TMP_RAW" "$TMP_CLEAN"
TRUNCATED=0
fi
# 2. Masking secret & token sensitif menggunakan sed
# ponytail: Regex basic POSIX. Upgrade ke gitleaks jika butuh entropy scanning kompleks.
sed -i \
-e 's/AKIA[0-9A-Z]\{16\}/[REDACTED_AWS_KEY]/g' \
-e 's/ghp_[a-zA-Z0-9]\{36\}/[REDACTED_GITHUB_TOKEN]/g' \
-e 's/Bearer [a-zA-Z0-9_\.\-]\{20,\}/Bearer [REDACTED_BEARER]/g' \
-e 's/-----BEGIN [A-Z ]*PRIVATE KEY-----[a-zA-Z0-9/+=
]*-----END [A-Z ]*PRIVATE KEY-----/[REDACTED_PRIVATE_KEY]/g' \
"$TMP_CLEAN"
# Output hasil sanitasi ke terminal / konteks agent
cat "$TMP_CLEAN"
if [ "$TRUNCATED" -eq 1 ]; then
printf "\n\n[WARNING: Context terpotong! Output asli %d bytes, dibatasi ke %d bytes untuk efisiensi token.]\n" "$RAW_SIZE" "$MAX_BYTES"
fi
Pengujian Otomatis Tanpa Dependensi Luar
Pastikan validitas proteksi secret dan pemotongan byte menggunakan uji assert sederhana berbasis script sh berikut:
#!/bin/sh
# test_hook.sh: Self-check verifikasi regex dan byte boundary
set -eu
SCRIPT="./sanitize_context.sh"
assert_contains() {
echo "$1" | grep -q "$2" || {
echo "ASSERT FAILED: Expected substring '$2' not found."
exit 1
}
}
assert_not_contains() {
echo "$1" | grep -q "$2" && {
echo "ASSERT FAILED: Found restricted substring '$2'."
exit 1
}
}
# Test 1: Masking AWS Secret Access Key ID
AWS_OUTPUT=$(printf "AKIAIOSFODNN7EXAMPLE" | "$SCRIPT")
assert_contains "$AWS_OUTPUT" "[REDACTED_AWS_KEY]"
assert_not_contains "$AWS_OUTPUT" "AKIAIOSFODNN7EXAMPLE"
# Test 2: Masking GitHub PAT
GH_OUTPUT=$(printf "ghp_1234567890abcdefghijklmnopqrstuvwxyz" | "$SCRIPT")
assert_contains "$GH_OUTPUT" "[REDACTED_GITHUB_TOKEN]"
# Test 3: Truncation boundary
LARGE_PAYLOAD=$(head -c 60000 < /dev/zero | tr '\0' 'A')
TRUNC_OUTPUT=$(printf "%s" "$LARGE_PAYLOAD" | MAX_BYTES=1000 "$SCRIPT")
assert_contains "$TRUNC_OUTPUT" "[WARNING: Context terpotong!"
echo "All 3 assertions passed successfully."
Trade-off dan Limitasi
Penggunaan pattern matching berbasis regex POSIX pada shell hook memiliki karakteristik performa yang instan dan memory footprint nol, namun ada trade-off arsitektural yang perlu dipertimbangkan:
- High-entropy string false negative: Token custom tanpa awalan baku (misalnya custom internal API keys acak tanpa prefix) tidak tertangkap oleh filter regex statis. Jika arsitektur menuntut deteksi password generik dinamis, integrasikan tool khusus seperti
trufflehogataugitleakspada CI/hook agent. - Truncation Context Loss: Pemotongan byte deterministik (
head -c) memotong teks secara kaku pada index byte batas. Agen LLM dapat kehilangan konteks stack trace di baris terbawah log. Solusi lazim adalah memprioritaskan pemotongan pada log lama dan menyisakan 20% kapasitas untuk output tail.
Komentar
0 komentar
Masuk ke akun kamu untuk ikut berkomentar.
Belum ada komentar
Jadilah yang pertama ikut berdiskusi!