Link Ajaib
Penjelasan lengkap tentang Link Ajaib, cara kerja, cara menyalin, dan troubleshooting URL localhost.
Apa itu Link Ajaib?
Link Ajaib adalah URL unik yang dibuat khusus untuk setiap peserta. Link ini mengandung token JWT yang mengidentifikasi peserta, sesi ujian, dan paket soal yang harus dikerjakan. Peserta hanya perlu mengklik link ini untuk langsung masuk ke ujian tanpa perlu login.
Cara Menyalin Link Ajaib
Admin dapat menyalin Link Ajaib dari halaman manajemen peserta di dashboard. Klik ikon salin di samping nama peserta untuk menyalin link.
Link Menampilkan localhost: Cara Memperbaiki
Penyebab
TESTRA menggunakan variabel NEXT_PUBLIC_SITE_URL untuk menentukan origin URL saat membuat Link Ajaib. Jika variabel ini kosong atau tidak disetel, sistem akan fallback ke window.location.origin. Pada lingkungan development, nilainya adalah http://localhost:3000.
Solusi
- 01
Buka Vercel Dashboard
Masuk ke vercel.com, pilih project TESTRA.
- 02
Navigasi ke Settings → Environment Variables
Cari halaman pengaturan environment variables untuk project.
- 03
Tambahkan atau perbarui variabel
Setel NEXT_PUBLIC_SITE_URL dengan nilai https://testra.web.id (tanpa trailing slash).
- 04
Redeploy project
Perubahan environment variable memerlukan redeploy agar berlaku. Klik "Redeploy" di tab Deployments.
# Nilai yang benar di Vercel Environment Variables
NEXT_PUBLIC_SITE_URL=https://testra.web.idMemahami Struktur Link Ajaib
https://testra.web.id/exam/{attemptId}?token={jwt_token}
↑ domain ↑ attempt UUID ↑ JWT berisi:
- attemptId
- participantId
- examAccessId
- packageVersionId
- participantCode
- fullName
- durationMinutes
- deadlineAt
- examType (PRETEST/POSTTEST)