Menyediakan fitur hosting atau rendering berkas HTML/JS dinamis yang diunggah oleh pengguna (User-Generated Content / UGC) membawa risiko fatal seperti Cross-Site Scripting (XSS), pencurian sesi otentikasi, dan perusakan reputasi domain utama. Solusi yang aman membutuhkan pemisahan eksekusi pada level backend, penyimpanan aset secara terisolasi, dan penerapan sandboxing berbasis origin di peramban.

Arsitektur Pipeline Pemrosesan dan Queue Worker

Unggahan berkas HTML mentah tidak boleh disajikan langsung ke web. Alur kerja yang benar memisahkan proses penerimaan berkas dan rendering via antrean background worker:

  1. Klien mengunggah berkas mentah ke bucket staging sementara via pre-signed URL.
  2. Layanan web memicu event pemrosesan ke dalam antrean (Redis/RabbitMQ).
  3. Worker mengambil tugas, mengunci proses secara terdistribusi, memvalidasi dan membersihkan markup via parser DOM (seperti DOMPurify berbasis JSDOM).
  4. Hasil sanitasi diunggah ke object storage publik terisolasi dengan metadata header keamanan ketat.
  5. Worker memperbarui status di database utama dan melepaskan lock.

Implementasi Worker Sanitasi dan Distributed Locking

Jika pengguna memperbarui berkas secara agresif, race condition dapat menyebabkan data versi lama menimpa versi baru. Kita gunakan distributed lock dengan Redis (Redlock pattern sederhana via SET NX PX) sebelum memproses berkas.

import { createClient } from 'redis';
import createDOMPurify from 'dompurify';
import { JSDOM } from 'jsdom';
import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3';

const redis = createClient({ url: process.env.REDIS_URL });
const s3 = new S3Client({ region: 'us-east-1' });
const window = new JSDOM('').window;
const DOMPurify = createDOMPurify(window);

async function processUserHtml(job) {
  const { userId, siteId, rawHtml, version } = job;
  const lockKey = `lock:site:${siteId}`;
  const lockTtlMs = 15000;

  // distributed lock: akuisisi lock eksklusif
  const acquired = await redis.set(lockKey, 'locked', { NX: true, PX: lockTtlMs });
  if (!acquired) {
    throw new Error(`Eksekusi bentrok untuk site ${siteId}, ulangi antrean.`);
  }

  try {
    // Sanitasi markup: izinkan struktur dasar, lucuti skrip yang mengeksploitasi origin
    const sanitizedHtml = DOMPurify.sanitize(rawHtml, {
      WHOLE_DOCUMENT: true,
      ADD_TAGS: ['style'],
      FORBID_TAGS: ['base'], // Cegah pembajakan base URI
      FORBID_ATTR: ['srcdoc']
    });

    // Kirim ke bucket CDN terisolasi
    await s3.send(new PutObjectCommand({
      Bucket: process.env.ISOLATED_STATIC_BUCKET,
      Key: `sites/${siteId}/index.html`,
      Body: sanitizedHtml,
      ContentType: 'text/html; charset=utf-8',
      CacheControl: 'public, max-age=300, must-revalidate',
      Metadata: { 'app-version': String(version) }
    }));
  } finally {
    // ponytail: rilis lock langsung tanpa verifikasi token kepemilikan; migrasi ke Redlock jika worker multi-instans tinggi
    await redis.del(lockKey);
  }
}

Isolasi Origin: Dedicated Sandboxed Subdomain

Meskipun HTML telah disanitasi, peramban tetap harus menganggap halaman tersebut berada di domain terpisah dari kredensial autentikasi sistem utama Anda. Jangan pernah melayani konten HTML pengguna pada root domain (example.com) atau domain API (api.example.com).

  • Separate Domain / Dedicated Subdomain: Sajikan aset statis pengguna di <user-id>.ugc-example.com atau <site-id>.preview-example.com.
  • Subdomain Wildcard Cookie Prevention: Pastikan cookie sesi utama diatur pada app.example.com tanpa Domain=.example.com, sehingga dokumen pada subdomain UGC tidak dapat membaca cookie sesi.
  • Iframe Sandboxing: Jika dokumen harus ditampilkan di dalam portal utama, gunakan atribut sandbox:
<iframe 
  src="https://site123.ugc-example.com"
  sandbox="allow-scripts allow-forms"
  referrerpolicy="no-referrer">
</iframe>

Atribut sandbox tanpa allow-same-origin memaksa dokumen diperlakukan sebagai unique origin, mencegah akses ke localStorage, sessionStorage, dan cookie domain pembungkus.

Konfigurasi Header Keamanan & Content Security Policy (CSP)

Object storage atau CDN reverse proxy (seperti Cloudflare atau NGINX) yang menyajikan berkas pengguna harus menyematkan respons header ketat secara native.

Content-Security-Policy: default-src 'self' https://*.ugc-example.com; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; object-src 'none'; base-uri 'none'; frame-ancestors 'self' https://app.example.com;
X-Content-Type-Options: nosniff
X-Frame-Options: SAMEORIGIN
Referrer-Policy: strict-origin-when-cross-origin
Cross-Origin-Opener-Policy: same-origin
Cross-Origin-Resource-Policy: cross-origin
  • X-Content-Type-Options: nosniff: Menghentikan peramban mengeksekusi berkas .txt atau .jpg sebagai berkas skrip via MIME sniffing.
  • frame-ancestors: Membatasi domain mana saja yang diizinkan memuat dokumen HTML pengguna ke dalam iframe (mencegah Clickjacking di situs ketiga).
  • object-src 'none': Memblokir Flash, Java, atau plugin eksternal lawas.

Aturan Pengamanan Object Storage Bucket

Hindari konfigurasi public read-all tanpa batas pada storage bucket. Buat storage terisolasi dengan batasan akses ketat:

  1. Nonaktifkan eksekusi endpoint S3 Website: Jangan gunakan fitur S3 Static Website Hosting langsung karena minim kendali custom response header keamanan. Lewatkan traffic melalui CloudFront atau NGINX proxy.
  2. Blokir Upload Script Dinamis Server-Side: Tolak berkas yang mencoba dieksekusi di edge runtime seperti berkas .php, .cgi, atau ekstensi server-side lainnya.
  3. Prinsip Least Privilege Worker: IAM role untuk worker sanitasi hanya memiliki hak akses s3:PutObject dan s3:DeleteObject khusus ke prefix sites/* pada bucket terisolasi, tanpa hak membaca data konfigurasi sistem.