Panduan Pengguna
API Publik, Model AI Kustom & SSO
Integrasi SIAKAD/SIM lewat API publik, mengarahkan AI ke model fine-tuned sendiri, dan login SSO — ketiganya khusus plan Enterprise.
Versi dokumen: v1.0
Tiga fitur berikut hanya tersedia untuk plan Enterprise, masing-masing bisa diatur dari menu Pengaturan > Enterprise.
API Publik untuk Integrasi SIAKAD/SIM
Institusi yang sudah punya sistem akademik sendiri (SIAKAD/SIM) bisa mengambil data dari Lesan lewat API publik — read-only di versi pertama ini: daftar siswa dan enrollment cohort, nilai/skor submission per siswa, dan presensi kelas umum.
Buat API key dari Pengaturan > Enterprise > API Publik, pilih izin akses (abilities) yang dibutuhkan, lalu salin key yang ditampilkan — hanya ditampilkan sekali, tidak bisa diambil ulang setelah ditutup. Setiap key bisa dicabut kapan saja tanpa memengaruhi key lain.
Authorization: Bearer lsn_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxBelum ada: endpoint tulis (push data dari SIM ke Lesan) dan webhook otomatis dari Lesan ke SIM — SIM pelanggan perlu polling endpoint API ini secara berkala.
Model AI Kustom
Institusi yang sudah melatih model AI sendiri (fine-tuned lewat API resmi OpenAI atau Anthropic, di luar Lesan) bisa mengarahkan proses AI Lesan (analisis kelemahan, rencana belajar, feedback) memakai model itu, bukan model default.
Ini bukan fitur fine-tuning — Lesan tidak melatih model apa pun untuk Anda. Fitur ini hanya titik integrasi: masukkan nama model yang sudah Anda latih sendiri di Pengaturan > Enterprise > Model AI Kustom, pilih provider (OpenAI atau Anthropic), lalu aktifkan.
SSO (Single Sign-On)
Staf dan siswa bisa login memakai akun identitas institusi yang sudah ada (Azure AD/Entra ID, Okta, Google Workspace, atau provider OIDC lain), tanpa perlu akun Lesan terpisah.
Admin memasukkan Client ID, Client Secret, dan tiga endpoint (authorization, token, userinfo) dari aplikasi OIDC yang didaftarkan di provider identitas institusi, plus domain email yang diizinkan. Kebijakan: email dari SSO harus cocok dengan akun yang sudah ada di Lesan — tidak ada pembuatan akun otomatis lewat SSO.
Yang didukung: provider OIDC (Azure AD, Okta, Google Workspace, dll.). Tidak didukung: SAML2 dan LDAP langsung ke direktori on-prem.
Kapan Dipakai
Ketiga fitur ini ditujukan untuk institusi besar (kampus, jaringan sekolah, lembaga pelatihan korporat) dengan kebutuhan integrasi sistem yang sudah ada — bukan fitur yang relevan untuk bimbel kecil-menengah yang belum punya sistem akademik atau identitas terpisah.