Panduan

Exam browser untuk CBT sekolah dan Moodle

CBT berbasis web sudah menyimpan soal dan nilai. Yang belum ada: HP siswa yang terkunci selama ujian, dan halaman ujian yang menolak dibuka di Chrome biasa. Panduan ini memasang keduanya.

Terbit

Teruji membuka alamat CBT sekolah di dalam layar yang terkunci. Soal, akun siswa, dan nilai tetap di CBT Anda. Bagian pertama panduan ini berlaku untuk CBT apa pun yang dibuka lewat browser, termasuk Moodle dan LMS lain. Bagian kedua, middleware verifikasi, khusus untuk CBT yang dibangun dengan Node.js dan Express.

Bagian 1: buka CBT di dalam Teruji

  1. Buka menu Ujian, lalu Buat ujian. Isi URL awal dengan alamat halaman ujian CBT, misalnya halaman login CBT atau halaman kuis Moodle. Buat PIN keluar untuk pengawas.
  2. Pilih cara identitas. Bila CBT sudah punya login sendiri, pilih Tanpa identitas: siswa langsung masuk ke CBT, dan monitor menampilkan setiap HP sebagai "Perangkat" dengan kode pendek. Bila ingin nama siswa tampil di monitor, pilih Isian bebas atau Data peserta.
  3. Isi Domain yang diizinkan dengan semua domain yang dibuka halaman ujian: domain CBT dan CDN yang dipakainya (font, gambar, skrip). Pola *.sekolah.sch.id mencakup semua subdomain sekolah Anda. Pola yang terlalu luas seperti *.com atau *.sch.id ditolak.
  4. Isi Pola URL selesai dengan alamat halaman "terima kasih" CBT, dalam bentuk ekspresi reguler. Uji dengan tombol Uji pola memakai alamat halaman selesai yang asli. Setelah halaman itu muncul, aplikasi keluar sendiri.
  5. Atur aturan pelanggaran dan jadwal, lalu simpan. Tampilkan QR dari Mode proyektor dan pantau dari Monitor langsung.

Pada tahap ini HP siswa sudah terkunci dan terpantau. Namun alamat CBT yang sama masih bisa dibuka di Chrome, di HP lain atau di laptop. Bagian berikut menutup celah itu.

Bagian 2: CBT menolak browser biasa

Middleware examBrowserGuard adalah satu berkas JavaScript tanpa dependensi untuk Express 4 dan 5. Setiap halaman yang dibuka aplikasi Teruji membawa tanda tangan yang terikat ke alamat halaman, sesi siswa, dan waktu (berlaku ±120 detik). Middleware menghitung ulang tanda tangan itu dari alamat yang benar-benar diterima. Cocok, halaman dibuka dan cookie verifikasi dipasang agar permintaan lanjutan (XHR, kirim jawaban, gambar) ikut lolos. Tidak cocok, browser mendapat 403 dengan pesan "Gunakan aplikasi Teruji".

  1. Salin examBrowserGuard.js ke proyek CBT, misalnya ke src/middleware/. Berkas ini kami berikan bersama akun trial. Butuh Node.js 20.19 ke atas.
  2. Ambil kunci ujian dari panel: buka ujian, lalu kartu Integrasi CBT, dan salin baris untuk berkas .env server CBT (EXAMBRO_BROWSER_EXAM_KEY=…). Jangan menyimpan kunci ini di repositori.
  3. Pasang middleware sebelum rute ujian. Untuk CBT yang halaman login-nya juga dipakai di luar ujian, pasang hanya di router ujian, misalnya app.use('/ujian', …).
    import { examBrowserGuard } from './middleware/examBrowserGuard.js'
    
    // Wajib bila CBT di belakang Nginx, Caddy, atau Cloudflare.
    app.set('trust proxy', 1)
    
    app.use(
      examBrowserGuard({
        browserExamKey: process.env.EXAMBRO_BROWSER_EXAM_KEY,
        mode: 'report',
        exemptPaths: ['/health', '/static'],
      }),
    )
  4. Uji dalam mode laporan. Buka ujian dari aplikasi: log server CBT tidak boleh berisi baris [examBrowserGuard]. Buka CBT di Chrome: harus muncul baris dengan alasan missing.
  5. Ubah ke mode: 'enforce'. Chrome kini mendapat halaman penolakan, sementara aplikasi tetap lancar.

Bagaimana dengan Moodle?

Moodle dan LMS berbasis PHP bisa dibuka di dalam Teruji seperti CBT lain (Bagian 1): HP terkunci, domain dibatasi, dan pelanggaran terpantau. Middleware verifikasi saat ini hanya tersedia untuk Node.js/Express, sehingga halaman kuis Moodle masih bisa dibuka di browser biasa oleh siswa yang mengetahui alamat dan akunnya. Batasi celah itu dengan pengaturan kuis Moodle sendiri, misalnya kata sandi kuis yang diumumkan saat ujian dimulai.

Masalah umum

Log berisi hash_mismatch untuk permintaan dari aplikasi
Biasanya CBT di belakang reverse proxy tanpa app.set('trust proxy', 1), sehingga middleware melihat http://localhost:3000/… sementara aplikasi menandatangani alamat publik. Pastikan proxy mengirim X-Forwarded-Proto dan X-Forwarded-Host. Bila proxy menulis ulang path, pakai opsi getUrl.
Muncul "Situs tidak diizinkan" di tengah ujian
Halaman CBT memuat domain lain (CDN, layanan gambar). Tambahkan domain itu ke daftar di form ujian.
Kunci ujian bocor atau perlu diganti
Rotasi kunci di panel, lalu perbarui .env CBT. Siswa yang sedang ujian memakai kunci lama sampai masuk ulang, jadi rotasi di luar jam ujian atau pasang kunci lama sebagai cadangan sementara: browserExamKey: [kunciBaru, kunciLama].
Satu CBT dipakai beberapa ujian Teruji sekaligus
Isi browserExamKey dengan daftar kunci semua ujian itu.

Rincian teknis mekanisme ini ada di halaman keamanan Teruji. Untuk mencobanya di CBT sekolah Anda, minta trial 14 hari.

Coba panduan ini di sekolah Anda.

Trial 14 hari, gratis, tanpa kartu kredit. Kami bantu menyiapkan ujian pertama Anda.