Panduan super admin

1Siapa super admin

Panduan ini memakai dua istilah yang berbeda walaupun orangnya bisa sama:

• Super admin Google Workspace memegang hak super admin (atau peran admin setara) di Admin Console FIWA dan peran Owner di proyek Google Cloud fiwa-sesi-les. Membuat akun, mengatur OU, mewajibkan 2SV, hak Google untuk aplikasi, dan deploy adalah tugasnya.
• Superadmin Digispace adalah anggota grup admin aplikasi (ADMIN_GRUP). Ia melihat semua menu dasbor, memberi peran admin lain, menyetujui izin baca log, menyetujui permintaan empat mata, dan satu-satunya yang bisa menyalakan jejak semua URL.

Yang hanya bisa diubah superadmin di dasbor

Admin lain melihat halaman yang sama, tetapi isian dan tombolnya terkunci, biasanya dengan tulisan "Hanya superadmin yang bisa mengubah". Semua perubahan di bawah tercatat di Sistem › Log dan audit › Tindakan staf.

Tanggal akhir semester (Sistem › Setup umum › Kalender dan hari libur, tampil di Yang biasa diubah) boleh diubah admin akademik dan superadmin. Pastikan tanggalnya terisi sebelum permintaan akses dinyalakan, karena masa akses santri paling lama sampai tanggal itu.

Superadmin utama (v3.62)

Superadmin utama adalah satu superadmin Digispace yang perannya tidak bisa dicabut oleh superadmin lain. Gunanya supaya sekolah selalu punya satu pemegang kunci yang tidak bisa disingkirkan dari dalam aplikasi. Superadmin lain tetap bisa dicabut seperti biasa. Ini hanya berlaku di Digispace; super admin Google Workspace tetap diatur di Admin Console.

1. Buka Sistem › Akun › Pengguna dan cari superadmin yang akan ditetapkan. Ia harus anggota grup superadmin.
2. Buka menu baris akun itu, pilih Jadikan superadmin utama…, isi alasan (wajib, masuk audit), lalu tekan Jadikan superadmin utama.
3. Hasilnya tertulis tetap di halaman Akun, dan akun itu menerima pemberitahuan. Penetapan tercatat di Sistem › Log dan audit › Tindakan staf sebagai Tetapkan superadmin utama.

• Siapa yang bisa menetapkan: pertama kali, superadmin mana pun. Sesudah itu hanya superadmin utama sendiri yang bisa memindahkannya ke superadmin lain, dan superadmin utama lama diberi tahu.
• Tidak bisa dicabut atau dinonaktifkan: Cabut peran dan Cabut semua pada superadmin utama ditolak. Bila orang itu perlu diganti, ia sendiri lebih dulu menetapkan superadmin lain sebagai utama.
• Peringatan di Sistem › Akun: "Superadmin utama belum ditetapkan" selama belum ada yang ditetapkan, atau "Superadmin utama … tidak lagi ada di grup superadmin" bila akunnya dikeluarkan dari grup di luar Digispace (misalnya lewat Admin Console). Dalam keadaan kedua, superadmin lain boleh menetapkan superadmin utama baru.

2Hak Google untuk aplikasi

Server memakai service account sesi-les-run@fiwa-sesi-les.iam.gserviceaccount.com. Bila GOOGLE_SUBJEK di env.sh terisi, semua panggilan Google (Directory, Chrome Policy, OU, Reports) berjalan atas nama admin itu lewat domain-wide delegation (DWD). Bila kosong, service account sendiri diberi peran admin. Email pemberitahuan tidak bergantung pada pilihan ini (lihat kotak di bawah).

Scope domain-wide delegation

Admin Console › Security › Access and data control › API controls › Manage Domain Wide Delegation › baris client ID service account › Edit. Kotak scope diganti seluruhnya, jadi selalu tempel daftar lengkap (10 scope):

Peran admin akun layanan

FIWA memakai peran yang ditetapkan langsung ke service account (GOOGLE_SUBJEK kosong): Admin Console › Account › Admin roles › peran kustom aplikasi › Admins assigned › Assign service accounts. Bila memakai DWD, peran yang sama dipasang di akun GOOGLE_SUBJEK. Centang hak di bagian Admin console privileges dan Admin API privileges sekaligus.

Cakupan peran harus meliputi OU santri (OU kelas dan OU pribadi ada di bawahnya) dan OU asal Chromebook santri (OU_PERANGKAT), karena Chromebook dipindah dari OU asal ke OU pribadi. Peran Super Admin juga bekerja, tetapi lebih luas dari yang diperlukan.

Akses aplikasi OAuth dan pelaporan perangkat

• Security › API controls › App access control: aplikasi OAuth ekstensi FIWA Digispace sudah dikonfigurasi (Trusted atau Limited) untuk OU santri. Tanpa ini santri melihat "Belum terhubung" dengan kode token, dan aturan galat-token memicu.
• Devices › Chrome › Settings › Device › Report device user tracking = Enable. Dipakai pemeriksaan "perangkat dipakai santri" di Armada dan deteksi akun lain di CB santri (kontrol F6).

Setelah mengubah hak atau scope, tunggu beberapa menit, lalu minta admin teknis membuka Sistem › Rincian teknis › Kesiapan sistem dan menekan Uji hak Google. Butir Pemantauan kinerja menunjukkan apakah scope log audit sudah diterima.

3Pengaturan Chromebook

Pengaturan berikut dibuat sekali di OU induk santri, lalu diwariskan ke semua kelas dan OU pribadi di bawahnya. Bila satu kelas tidak bekerja, periksa apakah OU-nya menimpa (override) salah satu pengaturan ini. Sejak v3.11, menu Chromebook › Kepatuhan perangkat memeriksa kontrol perangkat dan pengguna tiap jam dan bisa menerapkan sebagian lewat Chrome Policy API (panduan admin, bagian 13).

4Kebijakan ekstensi

Ekstensi membaca pengaturan dari Admin Console. Buka Chrome › Apps & extensions › Users & browsers, pilih ekstensi FIWA Digispace, lalu isi kotak Policy for extensions dengan JSON. Setiap kunci ditulis sebagai objek dengan Value:

Nilai server di kotak ini mengalahkan alamat yang tertanam di paket ekstensi. Selama kotak ini masih berisi alamat lama (https://sesi-les-q4ug76vuda-et.a.run.app), Chromebook tetap memanggil alamat lama walaupun ekstensinya sudah 2.25.1. Ganti nilainya ke alamat baru sesudah server v3.62.3 tayang dan ekstensi 2.25.1 lolos di kanal uji.

Ekstensi 2.16.0

Versi yang terpasang di produksi adalah 2.16.0. Ekstensi menjalankan kendali kelas (kunci layar, buka situs dari guru, kode hadir), Cek kesiapan, halaman blokir Digispace, penyaring isi situs C (sejak 2.15.0), dan tombol Minta akses (2.16.0). Teks untuk santri berbahasa Indonesia.

• Minta akses di popup dan di halaman blokir tidak lagi berisi formulir. Ekstensi meminta tautan sekali pakai ke server, lalu membuka halaman permintaan di server sekolah. Popup menampilkan ringkasan permintaan santri (bagian 20).
• Selama Permintaan akses menyala, ekstensi yang lebih lama dari 2.16.0 mendapat pesan Perbarui Chromebook dulu saat santri mencoba meminta akses.
• Kontrak sinkron tetap 5 dan tidak ada izin ekstensi baru dibanding 2.15.0, jadi Admin Console tidak perlu diubah.
• Halaman blokir Digispace: selama sesi les, situs yang diblokir kebijakan sekolah dialihkan ke halaman ekstensi dengan pilihan meminta ke guru, mengusulkan situs ke sekolah, atau meminta akses. Di luar sesi, halaman blokir Chrome biasa tetap tampil.
• Paket baru selalu dikemas di Mac dengan infra/kemas-crx.sh memakai infra/ekstensi-kunci.pem yang sama, lalu dideploy (bagian 11). Custom URL update.xml sudah terdaftar, jadi tidak ada yang diunggah ke Admin Console; Chromebook menarik versi baru sendiri dalam beberapa jam, atau setelah koneksinya pulih.
• Batas versi yang dianggap patuh diatur di Chromebook › Settings (Mulai versi berapa ekstensi Digispace dianggap patuh?). Versi ekstensi tiap Chromebook tampil di Chromebook › Armada; daftar Chromebook yang masih berekstensi lama ada di Pantau › Kondisi Chromebook (tautan Lihat daftar di panel status tab Penyaring isi).

5Anti-bypass

Di mode Pribadi, akses situs les datang dari OU pribadi, bukan dari ekstensi. Tetapi ekstensi yang mengirim detak, menutup tab situs les tepat waktu, mencatat log URL, menjalankan kendali kelas, dan menilai isi situs C. Bila ekstensi dimatikan, santri ditandai tidak terpantau dan kegiatannya tidak tercatat; akses les ikut dicabut hanya bila cabut saat diam dinyalakan di Chromebook › Settings, dan itu tidak disarankan. Pastikan di OU santri (Users & browsers, ketik nama pengaturan di kotak cari):

Daftar lengkap kontrol (A1–A10, B1–B16, dan seterusnya) beserta cara memperbaikinya ada di Chromebook › Kepatuhan perangkat › Kontrol. Baris Kebijakan Chrome pendukung di Sistem › Rincian teknis › Kesiapan sistem mencoba membaca sebagian nilai ini lewat API. Bila tertulis Tidak diketahui, cek manual dengan daftar di atas.

6Peran admin dan guru

Sejak v3.11, peran dikelola dari Sistem › Akun › Pengguna di dasbor (panduan admin, bagian 4). Ringkasnya:

Setelah deploy v3.11, anggota ADMIN_GRUP yang sekarang otomatis menjadi superadmin dengan hak yang sama seperti sebelumnya. Persempit lewat Sistem › Akun: beri peran admin akademik atau admin teknis ke staf yang tepat, lalu keluarkan mereka dari grup superadmin bila tidak perlu semua akses.

7Google Cloud

Semua komponen ada di proyek fiwa-sesi-les, wilayah Jakarta (asia-southeast2).

Isian penting di env.sh

BATAS_DETAK_MENIT, CABUT_SAAT_DIAM, INTERVAL_SINKRON_DETIK, RETENSI_*, SELALU_IZINKAN, dan SELALU_BLOKIR hanya nilai awal. Sekali diubah di dasbor (halaman Setelan tiap menu atau Sistem › Setup umum), nilai dasbor yang berlaku tanpa deploy. Isian lain (domain, OU, kunci, proyek) tetap dari env.sh dan tampil baca-saja di Sistem › Rincian teknis › Konfigurasi server.

GCP_PROYEK diisi deploy.sh otomatis dari PROYEK. WEBRISK_KEY, YOUTUBE_KEY, dan PAGESPEED_KEY yang ditulis di env.sh diabaikan deploy.sh; simpan ketiganya dengan simpan-kunci.sh (bagian 8).

8Prasyarat fitur

Semua fitur bisa dideploy tanpa prasyarat ini; fitur yang prasyaratnya belum ada hanya diam. Kerjakan butir yang dibutuhkan sebelum fitur terkait dinyalakan di dasbor. Jangan pernah menempel kunci, token, atau isi env.sh di chat.

1. Dataset BigQuery jejak

1. Isi export JEJAK_BQ_DATASET="jejak" di infra/env.sh (huruf, angka, dan garis bawah saja).
2. Jalankan ./setup.sh. Langkah 7/8 membuat dataset itu di WILAYAH yang sama (asia-southeast2) dan memberi sesi-les-run peran BigQuery Data Editor pada dataset itu. Peran BigQuery Job User di proyek sudah diberi di langkah sebelumnya. Bila perintah bq tidak ada, pasang dulu dengan gcloud components install bq.
3. Jalankan ./deploy.sh. Di akhir keluarannya tidak boleh ada catatan "JEJAK_BQ_DATASET kosong".

2. Kunci Web Risk, YouTube Data API, dan PageSpeed Insights

1. Di Cloud Console › APIs & Services › Credentials › Create credentials › API key, buat satu kunci untuk Web Risk, satu untuk YouTube, dan satu untuk PageSpeed. Batasi masing-masing (API restrictions) hanya ke Web Risk API, YouTube Data API v3, atau PageSpeed Insights API. setup.sh sudah menyalakan ketiga API itu (PageSpeed: pagespeedonline.googleapis.com) dan Gmail API.
2. Jalankan ./simpan-kunci.sh webrisk, tempel kuncinya saat diminta (tidak tampil di layar), lalu Enter. Kunci disimpan sebagai rahasia sesi-les-webrisk.
3. Ulangi dengan ./simpan-kunci.sh youtube (rahasia sesi-les-youtube) dan ./simpan-kunci.sh pagespeed (rahasia sesi-les-pagespeed).
4. Jalankan ./deploy.sh. Baris "Rahasia terpasang" di akhir menyebut WEBRISK_KEY, YOUTUBE_KEY, dan PAGESPEED_KEY untuk kunci yang sudah disimpan.

Kunci PageSpeed dipakai server untuk mengambil tangkapan layar halaman yang diajukan guru, supaya penyetuju bisa melihat isinya. Gambar diunduh server dan ditampilkan dari Digispace, jadi peramban penyetuju tidak membuka situs yang diajukan. Tanpa kunci ini, atau bila pengambilan gagal, kartu memakai gambar pratinjau yang dipasang situs itu sendiri (og:image); untuk video, thumbnail YouTube.

Kunci tidak pernah ditulis ke env.sh, berkas, atau riwayat shell. Untuk mengganti kunci, jalankan lagi simpan-kunci.sh lalu deploy.sh.

3. TrustPositif

Isi TRUSTPOSITIF_URL dengan alamat lengkap (https://…) daftar domain terlarang Komdigi yang berisi satu domain per baris, lalu deploy. Pastikan alamat itu memang daftar resmi dan bisa diunduh dari Cloud Run.

4. Email pemberitahuan

1. Email tidak butuh GOOGLE_SUBJEK (bagian 2). Jalankan ./setup.sh sekali bila belum, supaya service account mendapat peran Service Account Token Creator atas dirinya sendiri.
2. Tambahkan https://www.googleapis.com/auth/gmail.send ke daftar scope DWD client ID service account (tempel daftar lengkap 10 scope).
3. Isi SUREL_PENGIRIM dengan akun Workspace yang aktif dan punya Gmail, misalnya akun notifikasi khusus. Isi URL_DASBOR bila dasbor punya alamat sendiri.
4. Deploy. Pemberitahuan mendesak dikirim langsung; sisanya digabung dalam satu email per orang pukul 06.00 WIB.

5. Appraisal (opsional)

Sejak v3.11.1 grup appraisal diatur dari dasbor: Sistem › Setup umum › Akun dan keamanan › Google Group appraisal (opsional), tombol Tautkan atau Ubah (superadmin; kosongkan dengan tanda -). Anggota grup itu (tim kurikulum dan kepala sekolah) otomatis berperan Appraisal, dan perubahannya dicatat di audit. APPRAISAL_GRUP di env.sh hanya nilai awal sebelum grup pernah diatur di dasbor. Tanpa grup, appraisal tetap bisa diberi satu per satu oleh admin akademik.

6. Pemberitahuan resmi sebelum jejak dinyalakan

Jejak semua URL mencatat penjelajahan anak di bawah umur, termasuk di luar jam les. Ini data pribadi yang dilindungi UU PDP. Sebelum superadmin menekan Nyalakan pencatatan, sampaikan pemberitahuan resmi tertulis ke santri dan wali: apa yang dicatat, di perangkat apa, berapa lama disimpan, siapa yang boleh membaca, dan untuk apa. Simpan bukti pemberitahuannya.

7. Seluruh YouTube untuk satu ruang

Guru bisa mengajukan lingkup Seluruh YouTube untuk satu ruang belajar. Pengajuan ini selalu menunggu kepala sekolah, juga saat persetujuan situs Mati, dan berlaku 30 hari (paling lama 120 hari). Izin ini tidak masuk pustaka sekolah.

• YouTube beserta youtu.be, ytimg.com, googlevideo.com, dan ggpht.com hanya dipasang untuk ruang itu selama kontrol B10y (YouTube Restricted Mode Strict) berstatus patuh di audit Kepatuhan. Nilainya di Admin Console: Users & browsers › SafeSearch and restricted mode › YouTube: Strict, di OU santri.
• Bila B10y tidak patuh atau tidak terbaca, izin tertahan: YouTube tidak dipasang walau sudah disetujui (gagal-tutup). Tab Situs ruang menunjukkannya, dan superadmin menerima pemberitahuan "Seluruh YouTube ditahan" sekali sehari di ringkasan.
• Status ini dihitung ulang tiap jam, jadi izin yang kedaluwarsa dicabut dan izin yang tertahan terpasang sendiri setelah B10y patuh.
• Entri youtube.com yang ditulis guru di daftar situs, atau yang tersisa dari data lama, tetap ditolak. Seluruh YouTube hanya bisa dibuka lewat pengajuan ini.

9Bawaan aman dan urutan menyalakan

Fitur penegakan baru selalu terpasang dengan bawaan yang aman. Bawaan berikut dijanjikan dan tidak berubah tanpa keputusan sadar. Keadaan di produksi bisa berbeda karena sudah diputuskan Mudir; lihat halaman setelannya.

Urutan yang disarankan

1. Deploy, lalu jalankan PERBARUI=1 ./pantau.sh. Pastikan minimal dua superadmin, lalu bagi peran admin akademik dan admin teknis.
2. Minggu pertama: biarkan semua bawaan. Admin teknis membereskan Chromebook › Kepatuhan perangkat › Santri tidak patuh dan Chromebook › Daftar kerja fisik. Admin akademik memantau penanda pengawasan.
3. Impor pustaka awal situs dan minta appraisal meninjaunya, sebelum persetujuan situs diaktifkan.
4. Setelah data bersih dan disetujui Mudir: gerbang ke Aktif (tingkat K), pengawasan ke Aktif, persetujuan situs ke Aktif, 2SV guru ke Aktif. Satu per satu, dengan jeda beberapa hari.
5. Jejak semua URL dinyalakan terakhir, setelah pemberitahuan resmi ke santri dan wali (bagian 10).

Untuk penyaring isi dan permintaan akses, urutannya sendiri: penyaring dari Tidak aktif ke Pantau saja, lalu ke Aktif sesudah kalibrasi (bagian 16); permintaan akses dinyalakan sesudah ekstensi 2.16.0 tersebar dan prasyaratnya siap (bagian 20).

10Menyalakan jejak semua URL

Jejak hanya berjalan bila tiga syarat terpenuhi bersamaan: gudang jejak ada (JEJAK_BQ_DATASET), superadmin menyalakannya di aplikasi, dan kebijakan ekstensi rekamSemuaUrl di perangkat itu tidak bernilai false. Bendera nyala/mati disimpan di ekstensi, jadi tetap berlaku saat CB offline; bila server menjawab jejak mati, antrean jejak di CB dikosongkan.

1. Pastikan prasyarat 1 dan 6 di bagian 8 selesai, dan ekstensi 2.1.0 sudah tersebar (Chromebook › Armada).
2. Bila ada perangkat yang tidak boleh mencatat (misalnya CB pinjaman di OU tertentu), pasang "rekamSemuaUrl": {"Value": false} di kebijakan ekstensi OU itu (bagian 4).
3. Superadmin membuka Sistem › Setup umum › Data dan privasi, kelompok Rekam akses santri, memilih Rekam akses santri: Sepanjang hari, mengisi Rekam sepanjang hari sampai (masa pengamatan), lalu Simpan dan konfirmasi.
4. Popup ekstensi santri tidak menampilkan tanda pencatatan (keputusan Mudir 10 Okt); pemberitahuan dilakukan secara resmi oleh sekolah.
5. Untuk menghentikan, pilih Hanya saat sesi les yang dimulai guru lalu Simpan, atau biarkan tanggal akhirnya lewat. Data yang sudah tersimpan tetap ada sampai masa simpannya habis.

Membaca dan menahan

• Hanya superadmin dan admin akademik dengan izin per santri yang masih berlaku yang bisa membaca jejak, di Pantau › Aktivitas santri, bagian Forensik pada halaman santri itu. Admin teknis tidak membacanya. Setiap pembacaan wajib beralasan dan tercatat sebagai BACA_JEJAK.
• Penahanan kasus: pembaca yang berhak membuka kasus dengan Tahan jejak (alasan minimal 10 huruf). Jejak santri itu tidak terhapus otomatis sampai kasus ditutup. Hanya superadmin yang bisa Tutup kasus; sesudahnya data kembali mengikuti masa simpan biasa (14 hari untuk rinci).
• Kunjungan ke situs terlarang langsung menjadi temuan kritis jejak-terlarang.

11Memperbarui dan rollback

Semua perintah dijalankan dari Mac (zsh) dengan folder proyek di ~/sesi-les, di luar jam KBM bila bisa. Baca dulu catatan rilisnya (docs/RILIS-V3.md, bagian paling atas): di sana tertulis apakah rilis itu butuh setup.sh, ekstensi baru, atau isian env.sh baru. Catat nama revisi yang sedang aktif sebelum deploy, karena itu tujuan rollback.

Langkah baku

1. Unduh dan buka paket. Hapus dulu zip lama supaya unduhan baru tidak berganti nama, lalu buka dan cocokkan versinya:
   Terminal

   rm -f ~/Downloads/sesi-les.zip # unduh sesi-les.zip yang baru, lalu: cd ~ && unzip -o -q ~/Downloads/sesi-les.zip && head -2 ~/sesi-les/VERSI.txt
   Baris pertama harus menyebut versi yang dimaksud, baris kedua commit-nya. unzip -o menimpa berkas tanpa menyentuh infra/env.sh, infra/ekstensi-kunci.pem, dan server/public/ekstensi/, karena ketiganya tidak ikut zip.
2. ./setup.sh bila catatan rilis menyebut indeks, TTL, peran, API, atau dataset baru. Aman diulang.
   Terminal

   cd ~/sesi-les/infra && source env.sh && ./setup.sh 2>&1 | tail -20
   Di akhir keluarannya ada baris Indeks komposit: … belum ada, … belum READY dan TTL hapusPada: … belum ACTIVE. Indeks baru butuh beberapa menit; jalankan ulang ./setup.sh untuk melihat status terbaru. Bila gcloud meminta masuk ulang, jalankan gcloud auth login dulu tanpa | tail.
3. ./deploy.sh. Skrip ini membangun image dan memasang dua layanan: sesi-les (dasbor dan Chromebook) dan sesi-les-tugas (hanya dipanggil Cloud Scheduler). Sesi yang sedang berjalan tidak terputus.
   Terminal

   ./deploy.sh 2>&1 | tail -20
   Baca akhir keluarannya: baris Revisi: sesi-les = … ; sesi-les-tugas = …, tidak ada PERINGATAN soal trafik atau variabel env, dan baris Rahasia terpasang.
4. Bandingkan nama variabel env revisi baru dengan revisi lama, untuk kedua layanan. Isinya harus sama, kecuali catatan rilis menyebut variabel baru.
   Terminal (ganti <LAMA> dan <BARU>)

   gcloud run revisions describe <LAMA> --region asia-southeast2 --format='value(spec.containers[0].env[].name)' | tr ';' '\n' | sort > /tmp/envA.txt gcloud run revisions describe <BARU> --region asia-southeast2 --format='value(spec.containers[0].env[].name)' | tr ';' '\n' | sort > /tmp/envB.txt diff /tmp/envA.txt /tmp/envB.txt && echo "NAMA ENV SAMA"
   Ulangi untuk revisi sesi-les-tugas-…. Perintah ini hanya membandingkan nama, bukan isi rahasia.
5. Bila ekstensi berubah: ./kemas-crx.sh (butuh infra/ekstensi-kunci.pem asli supaya ID ekstensi tetap), lalu ./deploy.sh sekali lagi. Periksa versinya:
   Terminal

   curl -s https://digispace.fiwa.sch.id/ekstensi/update.xml | grep -o "updatecheck[^>]*"
   Keluarannya harus menyebut versi baru, misalnya version='2.16.0'. Tidak ada yang perlu diunggah ke Admin Console.
6. Bila kebijakan peringatan berubah (catatan rilis menyebutnya): PERBARUI=1 ./pantau.sh sekali.
7. Periksa di dasbor: Sistem › Rincian teknis › Kesiapan sistem tanpa butir gagal, halaman yang disebut catatan rilis, lalu awasi Sistem › Rincian teknis › Kinerja dan SLO selama 2 jam pertama.

Naik ke v3.41.1

v3.41.1 membawa migrasi Chromebook empat langkah (bagian 18). Ekstensi tetap 2.16.0 dan tidak ada variabel env baru.

1. Unzip, lalu head -2 ~/sesi-les/VERSI.txt harus menyebut v3.41.1.
2. ./setup.sh: indeks baru pekerjaanMassal (jenis, lalu dibuatPada menurun). Sebelum indeksnya READY, kartu langkah tetap jalan dengan pengurutan di memori.
3. ./deploy.sh, lalu bandingkan nama env dengan revisi v3.41 (sesi-les-00152-d9s dan sesi-les-tugas-00019-h5z). ./kemas-crx.sh tidak perlu.
4. Buka Pantau › Kondisi Chromebook: panel Migrasi ke OU pribadi menampilkan empat kartu langkah. Jalankan langkah 1 lebih dulu.

Rollback: kembalikan trafik kedua layanan ke sesi-les-00152-d9s dan sesi-les-tugas-00019-h5z. Sebelum rollback, jeda atau batalkan pekerjaan langkah 1, 2, dan 4 (cek kesiapan, pindahkan, audit ulang), karena v3.41 tidak punya pelaksananya.

Naik ke v3.41

v3.41 membawa permintaan akses santri dua tingkat dan ekstensi 2.16.0. Urutannya: ./setup.sh (indeks permintaanAkses, TTL buktiPermintaan, tautanSantri, sesiSantri), ./deploy.sh, lalu ./kemas-crx.sh dan ./deploy.sh lagi untuk 2.16.0. Setelan Permintaan akses tetap Mati sampai superadmin menyalakannya (bagian 20).

Rilis sebelumnya: v3.40 sampai v3.40.2

v3.40 (mode akses bertumpuk, mode Ujian, Situs ruang satu panel, Paket situs), v3.40.1 (migrasi aman dan pekerjaan massal di server), dan v3.40.2 (mode penyaring isi) cukup dengan ./deploy.sh; tidak ada variabel env, indeks, atau versi ekstensi baru. Revisi rollback yang tercatat: v3.40.2 ke sesi-les-00149-9tl / sesi-les-tugas-00016-hp2, v3.40.1 ke sesi-les-00146-mdb / sesi-les-tugas-00013-qvn, v3.40 ke sesi-les-00145-cb7 / sesi-les-tugas-00012-fmj. Untuk tautan satu dokumen Google Docs, tambahkan resepnya (bagian 17).

Rilis v3.39

v3.39 menggabungkan Aturan situs, prasyarat situs, penyaring isi situs C, dan paket kinerja, dengan ekstensi 2.15.0. Rilis ini butuh ./setup.sh (TTL hapusPada untuk koleksi pekerjaan, ringkasanDasbor, penyaringKejadian, penyaringCuplikan, penyaringLaporan, serta enam indeks penyaring isi) dan ./kemas-crx.sh. Ekstensi yang sudah terpasang di Chromebook tidak turun saat server di-rollback.

Variabel kinerja (opsional)

Paket kinerja membatasi sendiri laju panggilan Google, menulis kebijakan OU lewat antrean, dan menampung tulisan sinkron sebelum disimpan. Perubahan kebijakan grup F+ (daftar situs ruang dan sesi) ditulis lewat antrean dan dikirim ke Google paling lama sekitar satu menit setelah disimpan; bila Google sedang membatasi, antrean mengulang sendiri dan perubahan sampai sedikit lebih lama. Pesan sibuk hanya muncul bila server menolak sebuah permintaan karena terlalu banyak yang diproses bersamaan. Semua variabel di bawah punya nilai bawaan, jadi env.sh tidak perlu diubah.

Rollback

Revisi lama tetap ada di Cloud Run. Bila revisi baru bermasalah, kembalikan trafik kedua layanan ke revisi sebelumnya: Cloud Run › layanan › Revisions › Manage traffic, atau:

• Sesudah rollback, trafik terpin ke revisi itu, dan deploy berikutnya tidak memindahkan trafik ke revisi baru dengan sendirinya. deploy.sh menulis PERINGATAN: … belum menerima 100% trafik beserta perintah update-traffic … --to-latest untuk tiap layanan; jalankan bila revisi baru memang mau dipakai.
• Rollback server tidak menurunkan ekstensi yang sudah terpasang di Chromebook, dan tidak mengembalikan setelan dasbor atau data Firestore.
• Jeda atau batalkan dulu pekerjaan massal berjenis baru yang tidak dikenal revisi lama (catatan rilis menyebutnya).
• Setiap deploy tercatat sebagai perubahan di linimasa aplikasi, jadi admin bisa melihat apakah gejala muncul setelah deploy. Tag fplus menandai revisi F+ terakhir sebelum v3.

12Peringatan dan biaya

Cloud Monitoring

pantau.sh membuat pemeriksaan /sehat dan kebijakan peringatan berawalan "FIWA Digispace:", semuanya berlabel app=sesi-les. Isinya antara lain server tidak menjawab, banyak galat, jadwal otomatis gagal, tugas tiap menit berhenti, analisis kinerja gagal, temuan kritis (maks. satu email per 5 menit), temuan serius, dan banyak Chromebook santri tidak melapor saat les (Serius; ambang bawaan lebih dari 15% dan minimal 5 santri, bisa diubah dengan ARMADA_PERSEN dan ARMADA_MIN_SANTRI).

Penerima email tidak diatur di skrip. Admin teknis mengisinya di Sistem › Setup umum › Data dan privasi (Penerima email peringatan), dan server memasangnya ke semua kebijakan berlabel tadi. Untuk itu service account butuh peran Monitoring Notification Channel Editor, Monitoring AlertPolicy Editor, dan peran kustom sesiLesAturanLog untuk kebijakan berbasis log (semuanya dipasang setup.sh). Kebijakan buatan versi lama baru ikut diatur setelah PERBARUI=1 ./pantau.sh.

Kritis, Serius, dan eskalasi (v3.11)

• Kritis: email langsung dari Cloud Monitoring ke penerima di Sistem › Setup umum › Data dan privasi, dan masuk lonceng admin teknis. Bila 30 menit tidak ada yang menekan Ditangani di Sistem › Temuan, alarm diteruskan ke semua superadmin Digispace lewat lonceng dan email langsung (butuh email pemberitahuan aktif).
• Serius: sejak v3.11 tidak dikirim langsung. Untuk admin teknis, Serius masuk email ringkasan harian pukul 06.00 WIB. Perilaku lama bisa dikembalikan dengan PERINGATAN_LANGSUNG=ya saat menjalankan PERBARUI=1 ./pantau.sh, atau dengan kotak "Kirim juga peringatan Serius langsung" di Sistem › Setup umum › Data dan privasi.

Biaya per santri (ubin B1)

1. Billing › Billing export › BigQuery export › Standard usage cost › pilih atau buat dataset di proyek fiwa-sesi-les.
2. Tunggu sampai tabel gcp_billing_export_v1_… muncul (bisa sampai sehari).
3. Isi BILLING_TABEL="fiwa-sesi-les.<dataset>.<tabel>" di env.sh, jalankan ./setup.sh (hak baca dataset), lalu ./deploy.sh.
4. Bila tagihan dalam dolar, minta admin teknis mengisi Kurs USD di Sistem › Setup umum › Data dan privasi.

Server menarik biaya sekali sehari. Target awal di bawah Rp2.000 per santri per bulan. Dataset jejak menambah biaya BigQuery; perkiraan awal di bawah $5 per bulan, perlu diukur setelah berjalan.

13Darurat tingkat Admin Console

Selama dasbor bisa dibuka, admin cukup memakai tombol Cabut semua akses les di Sistem › Zona darurat (panduan admin, Darurat). Langkah di bawah untuk saat server atau dasbor tidak bisa dipakai.

Bila dasbor tidak bisa dibuka: kebijakan ekstensi

Ubah Policy for extensions ekstensi (bagian 4). Pertahankan kunci server dan rekamSemuaUrl bila diisi.

Diagnosis santri menandai Chromebook yang masih dalam mode darurat. Bila OU pribadi masih berkeadaan les dan server mati, kosongkan URL blocking OU pribadi yang bersangkutan agar kembali mewarisi OU kelas; aplikasi menyelaraskannya lagi saat server pulih.

Menutup semua akses les seketika (grup F+)

Bila dasbor tidak bisa dibuka atau ada penyalahgunaan dan semua sesi F+ harus ditutup sekarang juga:

1. Admin Console › Devices › Chrome › Settings › Users & browsers › Groups, pilih grup [Aktif] yang bermasalah.
2. Kosongkan Blocked URL exceptions lalu simpan. Chromebook yang online menerima perubahan dalam hitungan detik.
3. Di Directory › Groups, keluarkan semua anggota grup aktif-les-… tersebut.
4. Minta santri restart Chromebook agar aturan sekolah biasa pasti berlaku.

Saat server normal kembali, aplikasi menulis ulang kebijakan grup [Aktif] sesuai sesi yang benar-benar berjalan.

Server mati atau revisi baru rusak

Kembalikan trafik ke revisi sebelumnya (bagian 11). Saat server hidup lagi, tugas tiap menit menyelaraskan semua OU pribadi dan sesi yang waktunya sudah habis.

Pekerjaan massal yang salah arah

Bila pemindahan atau penulisan pembatasan login berjalan ke arah yang salah, tekan Jeda atau Hentikan… di kartu langkahnya (Pantau › Kondisi Chromebook) atau di baki pekerjaan. Yang sudah dikerjakan tetap tersimpan; sisanya menunggu dilanjutkan, atau tidak dikerjakan sama sekali bila Anda menekan Batalkan…. Chromebook yang sudah dipindah bisa dikembalikan dari Chromebook › Kepemilikan.

14Kunci, rahasia, dan data

Retensi data otomatis

15Aturan tingkat pengawasan (v3.34)

Panel Aturan tingkat pengawasan situs di Akses internet › Setelan › Umum (dulu Setup sistem › Aturan tingkat pengawasan) memuat aturan yang dipakai mesin untuk mengusulkan tingkat pengawasan A/B/C di setiap jalur masuk katalog. Admin lain bisa membaca dan menguji alamat; hanya superadmin yang mengubah. Arti A/B/C ada di panduan admin, Tingkat pengawasan A/B/C.

Langkah mengubah aturan:

1. Ubah tingkat ciri atau isian lain.
2. Uji beberapa alamat di Uji aturan sebelum disimpan, misalnya padlet.com (diharapkan C) dan phet.colorado.edu (diharapkan A).
3. Klik Simpan aturan. Dialog Simpan aturan versi N? merangkum perbedaannya. Konfirmasi.
4. Hasil: versi aturan naik satu, audit Mengubah aturan tingkat pengawasan, dan penilaian ulang katalog langsung berjalan di latar dengan batas laju. Bila isinya sama dengan yang berlaku, versi tidak naik.
5. Menyimpan aturan tidak mengubah tingkat yang sudah diputuskan. Usulan yang berbeda masuk Akses internet › Antrean situs › Tinjau ulang tingkat; manusia yang memutuskan. Setelah penilaian selesai, superadmin dan petugas tinjau menerima satu pemberitahuan.

Bila Gemini gagal berulang, penilaian berhenti sementara dan kartu penilaian menautkan ke halaman ini. Yang dikirim ke Gemini hanya alamat (ID dokumen disamarkan), teks halaman publik, dan daftar ciri; tanpa data santri, email, atau nama ruang. Usulan tetap bisa dibuat dari pola host saja bila Gemini dimatikan, tetapi entri Perlu ditinjau akan lebih banyak.

Keputusan G1 dan G2

Masa peralihan bawaan mengikuti keadaan akses saat v3.34.0 tayang: host katalog C yang sudah terbuka saat migrasi dicatat sekali (penanda pemantauan:peralihanKatalog, audit target peralihan:katalog) dan tetap terbuka; host yang dijadikan C sesudahnya mulai tertutup. Beri tahu admin akademik dan penyetuju situs tentang G2.

Menetapkan C untuk WhatsApp Web, email pribadi, Gmail, Docs, Drive, Meet, dan Chat

Dikerjakan sekali sesudah v3.34.0 tayang; ulangi untuk layanan serupa yang muncul di Di luar katalog. Langkah ini tidak mengubah akses siapa pun.

Prasyarat: audit memuat satu Mengisi tingkat pengawasan dari sifat lama (MIGRASI_TINGKAT) dan satu Menilai ulang tingkat pengawasan katalog.

1. Buka Akses internet › Katalog situs, lalu tab Di luar katalog.
2. Cari baris berikut:

   Layanan	Baris di tabel	Asal
   WhatsApp Web	Pesan pribadi (web.whatsapp.com dan alamat pesan lain di baris itu)	Rak tidak bisa diawasi
   Email pribadi	Email pribadi (mail.yahoo.com dan alamat email lain di baris itu)	Rak tidak bisa diawasi
   Gmail	Gmail sekolah (mail.google.com)	Selalu diizinkan
   Docs	Docs (docs.google.com)	Selalu diizinkan
   Drive	Drive (drive.google.com)	Selalu diizinkan
   Meet	Meet (meet.google.com)	Selalu diizinkan
   Chat	Google Chat (chat.google.com)	Selalu diizinkan. Nilai bawaan aplikasi tidak memuat alamat ini, jadi baris ini hanya ada bila chat.google.com sudah ditambahkan ke Selalu diizinkan (Akses internet › Setelan, tab Umum atau Aturan situs).

3. Di kolom Tetapkan tiap baris, pilih C.
4. Klik Terapkan di setiap baris, atau Terapkan semua keputusan (N)… di bawah tabel untuk semua baris yang belum ditetapkan.
5. Baca dialog ringkasan ("Hanya mencatat tingkat untuk masa peralihan. Akses tidak berubah: Selalu diizinkan, rak, kebijakan, dan OU tidak disentuh."), lalu konfirmasi.
6. Hasil yang diharapkan: pesan "N tingkat di luar katalog ditetapkan.", kolom Tingkat menampilkan C dengan keterangan ditetapkan beserta nama Anda, dan audit Mengubah tingkat pengawasan situs dengan target Di luar katalog.
7. Verifikasi di Akses internet › Katalog situs, tab Situs C (sejak v3.37), pil Masa peralihan: Gmail sekolah, Docs, Drive, Meet (dan Chat bila ada) Terbuka; layanan pesan pribadi dan email pribadi Tertutup. Kolom Santri sekarang tidak berubah.

Sejak v3.37 situs C dibuka atau ditutup lewat keadaannya di tab Situs C dan mode penyaring isi (bagian 16). Formulir persetujuan santri dan wali per situs dari v3.34 tidak dipakai lagi; persetujuan walisantri kini bagian dari permintaan akses santri (bagian 20).

16Penyaring isi situs C

Setelannya ada di Akses internet › Setelan › Penyaring isi. Hanya superadmin yang mengubah; admin akademik dan admin teknis membaca dengan tulisan "Hanya superadmin yang mengubah setelan ini. Anda melihatnya saja." Kejadiannya dibaca di Pantau › Aktivitas santri, dan pembagian tugas PDC, BK, dan kepala sekolah ada di panduan admin.

Mode penyaring isi situs C (v3.40.2)

1. Di panel Status, pilih mode di Mode penyaring isi situs C. Keterangan di bawahnya menjelaskan akibat mode yang dipilih.
2. Klik Simpan setelan. Dialog Ubah mode penyaring menjadi …? meminta Alasan minimal 10 huruf.
3. Hasil: perubahan tercatat di audit (Ubah setelan penyaring isi, dengan keterangan "mode … → …"), semua superadmin diberi tahu, dan penegakan berjalan seketika. Chromebook menerima mode baru pada sinkron berikutnya.

• Kapan ke Aktif. Tingkat C hanya label sampai penyaring dikalibrasi (keputusan Mudir 15 Okt). Pindah ke Aktif sesudah hasil uji skenario di Pantau saja diterima Mudir, dan sedikitnya 95% Chromebook santri sudah siap. Angkanya di panel status ("N dari M Chromebook sudah siap memakai penyaring"); pil N masih ekstensi lama dengan tautan Lihat daftar membuka Pantau › Kondisi Chromebook yang tersaring ke Chromebook itu.
• Gagal tertutup. Bila setelan atau daftar situs penyaring belum terbaca sah (galat baca sebelum muat pertama, atau dokumen rusak), situs C diperlakukan seperti mode Aktif, bukan seperti Tidak aktif.
• Batas yang diketahui. Halaman yang sudah ditutup ekstensi saat Aktif tetap tertutup sampai aturan per halamannya habis (paling lama 30 menit) sesudah beralih ke Pantau saja atau Tidak aktif.

Isi tab Penyaring isi

• Kategori: 10 kategori dalam empat kelompok (isi, kontak, perilaku, transaksi), masing-masing dengan sakelar Menyala, Tindakan, dan Kepekaan. Saat Pantau saja, kolom Tindakan menulis perilaku Pantau; pilihan di menu baru berlaku saat Aktif.
• Situs C: di Akses internet › Katalog situs, tab Situs C, pilih Tutup atau Buka dengan penyaring isi per situs, satu per satu dan di luar jam KBM. Pilihan Tutup dari Anda menutup situs itu di semua mode, termasuk tautan satu halamannya di ruang. Masa peralihan Gmail, Docs, Drive, Meet, dan Chat diakhiri per situs dengan mengetik kata konfirmasi; lakukan sesudah hampir semua Chromebook siap (panduan admin, Jalur tiap tingkat).
• Lanjutan: batas panggilan penilai teks per menit dan per hari. Bila batas habis atau penilai gagal, halaman tetap terbuka dengan pemeriksaan daftar kata, tautan, dan gambar, dan superadmin diberi tahu.
• Pemberitahuan: periksa Sistem › Setup umum › Email dan pemberitahuan untuk baris konselor, PDC, dan kepala sekolah; dokumen pengalihan yang sudah tersimpan tidak ditimpa rilis.

17Aturan situs (v3.38)

Dulu dua puluh daftar alamat yang menentukan akses santri tertanam di kode, dan sebagian lagi di env.sh. Sejak v3.38 semuanya menjadi setelan di Akses internet › Setelan › Aturan situs (alamat #/admin/akses/setelan?tab=aturan-situs). Isi di kode hanya bawaan awal. Hanya superadmin yang bisa mengubah daftar. Admin akademik dan admin teknis membuka halaman yang sama dengan pil Hanya baca: mereka bisa melihat isi (Lihat isi) dan riwayat, tetapi tidak menyimpan. Penjelasan tiap daftar untuk admin ada di panduan admin, Aturan situs.

Setiap kartu menyebut jumlah isi, penjelasan, dan pil Bawaan (belum pernah diubah) atau Diubah oleh … · tanggal beserta alasannya. Kotak Cari daftar atau alamat juga mencari di dalam isi daftar, dan pilihan Diubah dari bawaan menyaring kartu yang sudah diubah.

Mengubah satu daftar

1. Klik Ubah di kartu daftar. Penyunting terbuka dengan petunjuk isiannya: satu alamat per baris tanpa https://, tabel baris untuk prasyarat dan halaman galat, nama rak dan isinya untuk rak, pilihan kategori untuk kategori, atau JSON untuk resep dan templat.
2. Ubah isinya, lalu klik Simpan…. Server memeriksa dulu (pratinjau) tanpa mengubah apa pun. Bila ada isian yang salah, galatnya ditulis di bawah penyunting per baris; klik label Baris n untuk melompat ke baris itu.
3. Bila lolos, dialog Simpan perubahan …? merangkum alamat yang Ditambah dan Dikurangi, bagian Dampak dalam kalimat biasa (mis. berapa ruang yang terdampak), catatan yang perlu diperiksa, dan peringatan Hati-hati bila daftarnya peka.
4. Isi Alasan perubahan (wajib, minimal 5 huruf, paling panjang 500), lalu klik Simpan perubahan. Contoh alasan: "Zoom kelas daring butuh zoom.us (uji CB 14 Okt)".
5. Hasil tertulis di bawah tombol kartu: "Tersimpan: n ditambah, n dikurangi. Perubahan dikirim ke Google secara bertahap dan sampai di Chromebook santri beberapa menit sesudahnya." Server menerapkan ulang daftar situs semua ruang dan kebijakan Chromebook di latar. Instance lain memuat isi baru paling lama 60 detik kemudian.

Riwayat, Kembalikan bawaan, dan audit

• Riwayat menampilkan 50 perubahan terakhir per daftar, terbaru di atas: waktu, oleh siapa, alasan, dan alamat yang ditambah dan dikurangi.
• Kembalikan bawaan memasang lagi isi bawaan dengan alasan wajib, lewat dialog Kembalikan … ke bawaan?. Tombol ini mati bila isinya sudah sama dengan bawaan. Perubahan sebelumnya tetap tercatat di Riwayat.
• Setiap simpan dan setiap Kembalikan bawaan tercatat di audit dengan aksi UBAH_ATURAN_SITUS. Untuk membacanya, buka Sistem › Log dan audit › Tindakan staf lalu pilih jenis tindakan Ubah aturan situs. Keterangannya memuat nama daftar, contoh alamat yang berubah, dan alasannya.

Lantai infrastruktur

Beberapa alamat wajib ada supaya Chromebook santri bisa masuk akun Google dan ekstensi Digispace bisa mengambil token, juga di jam terkunci. Alamat ini tidak bisa dihapus. Bila salah satunya dihapus dari penyunting, pratinjau menolak dengan pesan "… tidak bisa dihapus: … Kembalikan baris ini ke daftar, lalu simpan lagi."

Resep platform dan tautan satu halaman (v3.40)

Sejak v3.40 daftar Kedalaman minimum per platform juga menentukan tautan satu halaman yang dipakai guru langsung di ruang sebagai tingkat B: tanpa persetujuan, tanpa penyaring isi, dan hanya selama sesi les. Resep dihitung bila punya kedalaman minimum (minBagian lebih dari 0) dan tidak bertanda takBisaSempit. Tautannya harus sedalam resep, termasuk panjang bagian terakhir (panjangMin); alamat dengan bagian janggal seperti .., //, atau %2e ditolak. Bila Anda memilih Tutup untuk situs C induknya di Akses internet › Katalog situs › Situs C, tautan satu halamannya ikut tertutup (keputusan Mudir K1).

Menambah resep Google Docs. Resep bawaan belum memuat Docs, jadi tautan satu dokumen belum dikenali sebagai tingkat B. Untuk menambahkannya:

1. Buka kartu Kedalaman minimum per platform di Aturan situs, lalu klik Ubah.
2. Tambahkan satu resep, misalnya:
   Resep Google Docs (contoh)

   { "id": "google-docs", "nama": "Google Docs", "host": ["docs.google.com"],
  "minBagian": 3, "panjangMin": 25, "satuan": "dokumen",
  "contoh": "docs.google.com/document/d/<ID dokumen>/edit",
  "tingkat": ["Seluruh Google Docs", "Semua dokumen satu jenis", "Semua dokumen", "Satu dokumen"],
  "langkah": ["Buka dokumennya.", "Tekan Bagikan, lalu Salin link.", "Tempel tautan itu di sini."],
  "catatan": null }
   Kedalaman 3 berarti jalur sampai ID dokumen (document, d, lalu ID); ID Docs jauh lebih panjang dari 25 huruf.
3. Klik Simpan…, baca bagian Dampak, isi alasan, lalu Simpan perubahan.
4. Uji di ruang uji: tempel tautan satu dokumen di kotak Tambah situs. Keadaannya harus Siap (satu dokumen). Lalu buka dari Chromebook uji selama sesi.

Selalu diizinkan dan Selalu diblokir

Dua daftar ini kini bisa diubah langsung di Aturan situs, tanpa mengubah env.sh dan tanpa deploy. Sumbernya tetap satu dengan isian Selalu diizinkan dan Selalu diblokir di tab Umum halaman yang sama (kelompok "Situs yang selalu terbuka atau selalu tertutup"): mengubah di satu tempat ikut mengubah tempat lain, dan perubahannya juga tercatat sebagai UBAH_SETUP.

• SELALU_IZINKAN dan SELALU_BLOKIR di env.sh masih dibaca, tetapi hanya sebagai nilai awal selama daftar belum pernah disimpan dari dasbor. Untuk dua daftar ini, Kembalikan bawaan memasang lagi nilai dari env.sh itu, bukan daftar dari kode.
• Alamat server dan ekstensi Digispace selalu ikut di Selalu diizinkan dan tidak bisa dihapus.
• google.com, www.google.com, google.co.id, dan www.google.co.id utuh ditolak di Selalu diizinkan (keputusan Mudir 10 Okt), karena satu host itu membuka Search, Maps, dan permainan sekaligus. Jalur teknisnya sudah termasuk infrastruktur.

18Migrasi Chromebook ke OU pribadi

Chromebook santri dipindah dari OU asalnya ke OU pribadi pemiliknya, lalu login di Chromebook itu dibatasi ke pemilik ditambah akun staf. Pekerjaannya dijalankan admin teknis di Pantau › Kondisi Chromebook, panel Migrasi ke OU pribadi. Bagian ini menjelaskan yang menjadi urusan superadmin; langkah harian ada di panduan admin, Kepemilikan.

Empat langkah (v3.41.1)

Di atas kartu ada dua angka: Dipindah ke OU pribadi x dari n, dan Dibatasi ke pemilik y dari x. Tiap langkah adalah pekerjaan massal sendiri di server, tidak bergantung satu sama lain, dan boleh dijalankan kapan saja, termasuk saat jam KBM.

• Cakupan di dialog Mulai: semua, OU tertentu (OU asal, OU kelas, atau OU pribadi, termasuk yang di bawahnya), Satu Chromebook, atau Hanya yang gagal di pekerjaan terakhir. Rincian Chromebook di Kondisi Chromebook juga punya "Jalankan untuk Chromebook ini". Alasan wajib dan masuk audit.
• Lewati dan ulang, bukan berhenti total. Galat satu Chromebook atau satu OU hanya menggagalkan butir itu. Sebab yang bisa berubah (kuota, gangguan Google, hak di satu OU, kebijakan yang baru ditinjau, konfirmasi Google) diulang otomatis sesudah jeda. Pekerjaan berhenti sendiri hanya bila galat hak yang sama muncul di 3 OU berbeda, atau saat pemeriksaan awal gagal.
• Macet: pekerjaan tanpa kemajuan lebih dari 10 menit menampilkan Ulangi sekarang, yang melanjutkan dari posisi terakhir.
• Yang gagal dikelompokkan per sebab dengan kalimat biasa, keterangan diulang otomatis atau perlu tindakan, dan tombol per kelompok. Rincian teknis terlipat di bawahnya.
• Tombol Pindahkan di Chromebook › Kepemilikan tetap memakai jalur lama untuk satu atau beberapa Chromebook: tulis pembatasan login, baca ulang, baru pindah.

Syarat pengaman dan Samakan pembatasan login

Sampai langkah 3 selesai, OU pribadi mewarisi pembatasan login dari Active Students atau OU kelasnya. Karena itu langkah 2 hanya memindah Chromebook bila pembatasan warisan itu sama atau lebih ketat dari OU asal Chromebook. Syarat ini diperiksa di awal pekerjaan dan untuk tiap Chromebook. Bila belum lolos, hasil langkah 1 dan kelompok gagal Pembatasan login warisan lebih longgar dari OU asal menampilkan tombol Samakan pembatasan login di … untuk OU yang disebut.

1. Klik tombolnya. Bila sudah lebih dari 15 menit sejak masuk, dasbor meminta konfirmasi akun Google dulu.
2. Dialog Samakan pembatasan login? menjelaskan bahwa nilai di OU itu diganti nilai OU asal Chromebook yang paling ketat. Isi alasan minimal 10 huruf, lalu klik Samakan.
3. Hasil tertulis di tempat: "Disamakan: …. Mulai lagi langkahnya untuk melanjutkan." atau "Sudah sama atau lebih ketat; tidak ada yang ditulis." Audit mencatat Samakan pembatasan login OU tujuan beserta nilai sebelum dan sesudahnya.
4. Jalankan lagi langkah 1, lalu lanjutkan langkah 2.

Digispace tidak pernah menulis nilai yang lebih longgar dari OU asal mana pun, dan menolak bila nilai di OU asal berbeda-beda sehingga tidak bisa diurutkan, atau bila OU yang disebut adalah OU pribadi (OU pribadi dibatasi lewat langkah 3). Nilai lama dicadangkan dan bisa dibatalkan dari Chromebook › Kepemilikan › Siapkan OU tujuan; pembatalan itu melonggarkan, jadi butuh persetujuan superadmin lain (empat mata).

Akun staf yang boleh login di semua Chromebook santri

Tempatnya di Chromebook › Settings › Chromebook santri, kartu Akun staf yang boleh login di semua Chromebook santri. Pil Berlaku di n OU pribadi menyebut berapa OU pribadi yang terkena.

• Dari peran IT (otomatis): akun berperan Akun IT di CB dari Sistem › Akun › Pengguna. Ikut berubah bila peran itu diubah.
• Akun tambahan: diisi superadmin. Tiap akun diperiksa di Directory: harus akun sekolah yang ada dan aktif, bukan akun santri, dan ditulis satu per satu. Akun guru tidak dimasukkan; daftar ini untuk perawatan, bukan untuk mengajar.
• Rapikan entri lama. Entri berpola seperti *@fiwa.sch.id dan akun di luar domain sekolah yang tersimpan dari versi lama ditandai perlu dirapikan. Selama masih ada, penulisan ulang pembatasan login ditolak dan migrasi tertahan. Entri berpola tidak dimuat ke isian, jadi ikut terhapus saat Anda menyimpan; akun di luar domain hapus dari isian. Tambahkan akun pengganti satu per satu, lalu simpan.
• Simpan: isi Alasan perubahan (minimal 10 huruf), klik Simpan…, periksa pratinjau (Ditambah, Dikurangi, akun yang ditolak beserta alasannya), lalu Simpan dan jadwalkan. Pembatasan login semua OU pribadi yang berisi Chromebook ditulis ulang lewat pekerjaan massal (langkah 3) yang kemajuannya tampil di baki kartu.
• Lebih dari 5 akun memunculkan peringatan, karena setiap akun bisa login di semua Chromebook santri. Tanpa akun staf sama sekali, admin tidak bisa login ke Chromebook santri sesudah migrasi.

Sudah saya tinjau dan Bukan kebijakan keamanan

Kebijakan perangkat di OU tujuan dan OU pribadi harus sama atau lebih ketat dari OU asal. Perbedaan yang bukan soal keamanan tidak perlu menghalangi migrasi. Superadmin punya dua cara, keduanya dengan alasan minimal 10 huruf:

• Sudah saya tinjau pada satu perbedaan (di Kesiapan Kepemilikan atau kelompok gagal langkah migrasi): perbedaan itu lolos selama kedua nilainya sama dengan saat ditinjau. Audit: Tandai perbedaan kebijakan sudah ditinjau.
• Kartu Bukan kebijakan keamanan di Chromebook › Settings › Chromebook santri: nama kebijakan perangkat yang boleh berbeda antar-OU, misalnya bahasa layar masuk, wallpaper, zona waktu, dan pola nama host. Tulis nama pendek seperti DeviceWallpaperImage, boleh diakhiri * untuk satu awalan. Kesiapan OU tujuan dihitung ulang sesudah disimpan.

Setelan per langkah

Tombol Setelan… di kartu langkah membuka dialog Setelan langkah. Perubahan butuh alasan minimal 10 huruf dan berlaku untuk pekerjaan yang sedang berjalan mulai menit berikutnya.

Angka sekaligus yang lebih besar mempercepat pekerjaan, tetapi menghabiskan kuota tulis kebijakan Google (30 per menit untuk seluruh sekolah) lebih cepat, sehingga sesi les yang dibuka bersamaan bisa ikut melambat. Naikkan hanya di luar jam KBM, turunkan bila kartu sering menulis Menunggu kuota. Batas atas darurat untuk semua pekerjaan massal adalah SERENTAK_MASSAL (bagian 11).

19Device dan User Lifecycle (v3.60)

v3.60 menambah satu catatan per Chromebook (registri) dan satu status per santri dan staf. Cara kerjanya untuk admin ada di panduan admin, bab Chromebook dan Status santri dan staf. Bab ini hanya memuat yang menjadi tugas super admin.

Prasyarat di Admin Console (dikerjakan IT sebelum menyalakan)

• OU baru: /Device/Baru (penampungan CB baru: hanya aplikasi jenis 1, ekstensi dipasang paksa, login hanya akun staf), /Device/Karantina (login hanya akun staf), dan OU Alumni (hanya Drive, Gmail, Google Takeout). Path OU penampungan dan karantina bisa diubah di Chromebook › Settings.
• Hak peran admin untuk akun subjek utama: kelola perangkat ChromeOS (nonaktifkan, aktifkan ulang, deprovision), perintah jarak jauh (hapus profil, powerwash), dan ubah setelan perangkat (anotasi). Uji dulu pada satu CB stok FIWA. Deprovision dan powerwash hanya diuji pada CB yang memang akan dipensiunkan.
• Akun khusus suspend (variabel GOOGLE_SUBJEK_PENGGUNA): peran dengan hak pengguna Read, Update, Suspend, dan Move saja, tanpa membuat, menghapus, atau mengganti sandi. Akunnya harus berbeda dari akun subjek utama. Bila kosong, suspend ditolak dan fitur lain tetap berjalan.
• Pesan layar CB terkunci: nama FIWA dan nomor kantor, tanpa nama santri.

Urutan menyalakan

1. Registri sudah Nyala sejak deploy, karena hanya membaca. Pada hari pertama, cocokkan angka Overview (Fleet, Enrolled, Discovered) dengan Admin Console. Selisih yang tidak bisa dijelaskan: berhenti di sini dan laporkan.
2. Penulisan ke Google dari menu Chromebook (Chromebook › Settings): nyalakan sesudah angka cocok, hak peran sudah diuji pada CB stok, dan migrasi OU pribadi sudah selesai, di luar jam KBM, dengan alasan. Begitu sakelar ini dan Registri sama-sama Nyala, menu Armada dan Kepemilikan disembunyikan (dialihkan ke Inventory dan Enrollment), sehingga panel Migrasi ke OU pribadi tidak lagi bisa dibuka admin teknis.
3. Akses efektif dari registri: nyalakan hanya sesudah teks gerbangnya disahkan, dan sesudah pratinjau menunjukkan berapa santri yang aksesnya turun.
4. Offboarding staf otomatis, Service, laporan walisantri, dan Retirement mengikuti urutan di catatan rilis. Setiap sakelar bisa dimatikan lagi dengan alasan; registri tidak pernah menimpa isi Admin Console diam-diam.

Sapuan masa simpan catatan santri

Catatan Digispace santri yang sudah lulus atau keluar (OU pribadi, kebijakan santri, kepemilikan dan konfigurasi Chromebook, tugas Retirement) dihapus sesudah masa simpannya. Tiga isian Setup di kelompok Berapa lama data disimpan mengaturnya:

• Sapuan masa simpan berjalan (bawaan Tidak; hanya superadmin, alasan wajib). Bila Tidak, tidak ada catatan yang dihapus dan pratinjaunya tidak berjalan. Bila Ya, sapuan berjalan setiap hari. Penghapusan tidak bisa dibatalkan.
• Masa simpan catatan santri sesudah keluar (bawaan 365 hari, 90 sampai 1.825).
• Sapuan masa simpan butuh persetujuan bila lebih dari (bawaan 50 santri, hanya superadmin). Sapuan yang akan menghapus lebih dari angka ini berhenti di pratinjau sampai superadmin menekan Terapkan; sapuan pertama selalu berhenti di pratinjau.

Persetujuan superadmin kedua

Powerwash jarak jauh, deprovision, dan penghapusan akhir data alumni menunggu persetujuan superadmin lain di Beranda › Menunggu keputusan Anda. Karena itu FIWA perlu paling sedikit dua akun superadmin aktif dengan 2SV. Persetujuan yang tidak diputus sampai batas di Setup (bawaan 72 jam) kedaluwarsa tanpa mengubah apa pun. Beranda Anda memuat satu kartu Persetujuan orang kedua: … per jenis (misalnya Powerwash CB, Pensiun CB, Gelombang hapus akun santri keluar), dengan jumlah, pengajuan tertua, dan sisa jam sebelum yang paling cepat kedaluwarsa; kartu membuka halaman tempat pengajuan itu diputus. Pengajuan Anda sendiri tampil di Untuk diketahui sebagai Pengajuan Anda menunggu orang kedua, karena pengaju tidak bisa memutus pengajuannya sendiri.

Persetujuan Retire dan menarik pengajuan (v3.62.1)

Pengajuan Retire Chromebook, satu per satu atau per gelombang Retire bergelombang, diputus di panel Persetujuan Retire di Chromebook › Retirement, bukan hanya di Beranda. Anda tidak bisa menyetujui pengajuan Anda sendiri, dan hanya pengaju yang bisa menarik pengajuannya. Retire tidak bisa dibatalkan sesudah disetujui. Rinciannya di panduan admin, Persetujuan Retire.

20Permintaan akses santri (v3.43)

Santri menyusun sendiri situs belajarnya untuk waktu Luar KBM dan Hari libur di halaman Akses belajarku, dibuka dari ikon Digispace lewat tautan sekali pakai (berlaku 15 menit, sesi 2 jam). Ia memilih situs katalog, menulis untuk apa, memilih rencana pakai per pekan, menulis target dan mapel, dan mencentang ikrar. AI menantang permintaan per situs tanpa nama, email, dan kelas santri. Guru pilihan santri memberi rekomendasi per situs, walisantri menjawab per situs (tidak setuju mutlak untuk situs itu), lalu PDC menetapkan profil pengawasan Standar atau Ketat dan memutuskan per situs. Sistem menilai amanah dan manfaat secara berkala, merekomendasikan ke PDC, dan mengirim laporan pagi ke walisantri dan PDC. Kepala sekolah memantau persetujuan di kampusnya.

Tugas guru ada di panduan guru, tugas PDC dan kepala sekolah di panduan admin, dan yang dilihat santri di panduan santri.

Saat v3.43 tayang

• Saat server v3.43 pertama menyala, semua ruang dan permintaan cara lama diakhiri dengan sebab pergantian sistem, sekali jalan. Periksa audit Pergantian sistem permintaan akses v3.43 di Sistem › Log dan audit › Tindakan staf. Santri, walisantri, dan PDC menerima kabar singkat. Data lama tidak dihapus. Mundur ke v3.41.2 tidak membuka lagi ruang yang sudah diakhiri.
• Ekstensi 2.18 membawa check-in profil Ketat di popup dan teks janji yang dibetulkan. Kemas dengan kunci sekolah dan uji dulu di Chromebook akun uji santri sebelum disebar.
• Sakelar Permintaan akses santri tetap seperti sebelum deploy.

Sebelum menyalakan

1. Pastikan ekstensi 2.18 sudah tersebar (Chromebook › Compliance › Per kelas).
2. Buka Akses internet › Setelan, tab Umum, panel Persetujuan situs, kartu Permintaan akses: keadaan dan prasyarat. Periksa email pengirim sekolah, kontak walisantri dari FIMS, analisis AI, dan akhir semester.
3. Periksa mode penyaring isi di Akses internet › Setelan › Penyaring isi. Mode ini muncul di pernyataan yang wajib dicentang PDC setiap kali menyetujui atau memperpanjang situs C, misalnya "Saya tahu penyaring isi sedang Pantau saja".
4. Uji alurnya dengan akun uji santri di Chromebook uji, bersama akun guru dan PDC yang ikut menguji.

Setelan yang diubah superadmin

Di Akses internet › Setelan, tab Umum, kelompok Saat santri meminta akses di luar KBM: sakelar Permintaan akses santri (bawaan Mati, meminta konfirmasi), masa paling lama situs C (28 hari), situs aktif per santri (20), pilihan rencana pakai (60, 120, 180, 300 menit), tanda lemah bila pemakaian melewati rencana (2 kali), batas keputusan tinjauan PDC (72 jam), analisis AI tinjauan per hari (200), masa simpan laporan harian (90 hari), check-in (90 hari), dan penilaian (400 hari), serta angka label penilaian. Angka label memakai bawaan kontrak dan ditinjau ulang sesudah 4 pekan pilot. Masa simpan hanya bisa diperpendek.

Hak superadmin atas data perilaku santri

• Superadmin bisa membuka profil akses, laporan harian, penilaian, dan pemantauan santri semua kampus, setara kepala sekolah untuk semua kampus, tanpa menulis alasan. Setiap pembukaan tetap tercatat di audit: siapa, kapan, dan santri mana. Karena itu akun superadmin sebaiknya hanya dipegang orang yang memang berwenang melihat data perilaku santri.
• Log kunjungan rinci (alamat dan judul halaman, profil Ketat) bisa dibuka superadmin, PDC santri, dan penyetuju situs khusus akses yang dihentikan tanda kuat.
• Pada kartu permintaan, superadmin yang juga PDC santri itu, guru terpilih, atau kepala sekolah kampusnya bertindak dengan peran itu. Superadmin tanpa peran lain atas santri itu hanya membaca, dan tetap punya hentikan darurat.
• Admin teknis tidak melihat data perilaku santri.

Masa simpan

Laporan harian dan check-in 90 hari; penilaian, usul walisantri, dan permintaan 400 hari; profil akses selama masih ada situs yang berlaku, lalu 400 hari sesudah situs terakhirnya berakhir; log kunjungan rinci mengikuti masa simpan log situs di Setup. Isi akhirnya tertulis di Kebijakan privasi.

21Rutinitas super admin