Authorization Matrix — OS-v1.0
Last verified: 2026-09-12. Target permissions; existing implementation belum memenuhi seluruh matrix. Acuan: baseline, API contract.
1. Roles dan scope
Role target: platform_operator, organizer_owner, competition_admin, exam_manager, author, proctor, grader, reviewer, auditor, participant. Nama baru adalah kontrak target, bukan klaim seed/migration sudah ada. Existing owner alias dimigrasikan secara eksplisit. Default deny.
| Capability | Allowed role/scope | Pembatasan |
|---|---|---|
| Provision/deactivate organizer | platform_operator | Tidak otomatis boleh isi jawaban, key, evidence atau hasil tenant |
| Manage staff membership | organizer_owner | Tenant sendiri; role escalation audited; tidak self-approve dual control |
| Competition/schedule/import/enrollment | competition_admin, exam_manager; owner dengan capability terkait | Event assigned; schedule frozen tidak diubah setelah admission |
| Question/rubric draft/version | author, exam_manager | Tenant dan assignment; keys tidak dikirim ke participant |
| Freeze exam/publish admission | exam_manager | Complete scoring/form/readiness policy; actor auditable |
| Issue/revoke enrollment credentials | competition_admin, exam_manager | Event scoped; revocation membatalkan runner/launch generation lama |
| Start/items/save/heartbeat/submit | participant | Own authorized enrollment/session/attempt + device + secure policy; staff tidak impersonate |
| Room monitoring/Zoom reference | proctor assigned room; exam_manager event command | Tidak melihat full answers/keys; participant hanya room sendiri |
| Observe/warn/request recovery | proctor assigned room | Facts/reason; tidak force-submit, extend, score atau disqualify |
| Recover device/force-submit | exam_manager event scope | Reason + audit + token invalidation; tidak mengubah deadline |
| Manual incident penalty/disposition | Customer-designated authority (DEC-12), represented by explicit capability | Tidak otomatis semua proctor/owner; evidence/reason/response/appeal preserved |
| Blind essay grading | grader assignment | Tidak PII/enrollment directory/camera/Zoom; submitted attempt saja |
| Grade moderation | reviewer assignment | Bukan grader revision yang sama; reason/revision audit |
| Finalize score/ranking/freeze | exam_manager; reviewer dengan explicit scope | All essays moderated; snapshot immutable |
| Approve publication | organizer_owner atau named customer approver | Berbeda actor dari penyiap final snapshot; approval record wajib |
| Publish/withdraw/supersede | exam_manager dengan valid approval | DEC-12 authority; immutable history; bukan edit score |
| Own published result | participant | Own result dan publication visibility; tidak membuka unpublished draft |
| Event reports/export | exam_manager; auditor dengan approved scope | Data minimization; export access/expiry audited |
| Evidence view/download | Assigned proctor, incident reviewer yang ditunjuk DEC-08 | Staff role saja tidak cukup; grader dan score reviewer denied |
| Audit read | scoped auditor; owner sesuai scope | Redacted; audit permission tidak otomatis image access |
| Retention/hold/delete policy | owner/privacy authority; scoped worker | DEC-08 approved, reason, audit, backup handling |
| Certificate APIs/UI | Tidak ada dalam v1 | Exclude melalui RM-011; public legacy route juga harus disabled |
Named role owner bukan bypass semua matrix. Platform break-glass hanya jika ADR/customer policy dan access review terpisah; tidak diimplementasikan sebagai silent superuser.
2. Authentication contract
Browser staff dan runner menggunakan sesi terpisah, Secure/HttpOnly cookie + CSRF/origin validation untuk unsafe methods; session generation/revocation persisted. Exact cookie policy/TTL serta handoff diputuskan dalam RM-002/OP-01 dan diuji di SEB. Native launcher menggunakan short-lived enrollment-bound authorization, bukan staff cookie/token.
MFA mandatory untuk privileged staff; enrollment, recovery dan revocation harus end-to-end, tidak sekadar mfa_enabled flag. Token kind/audience/expiry/issuer yang dipilih dan active membership divalidasi tiap request. Role/enrollment/device/revocation changes berlaku pada request berikut, bukan menunggu token expired.
3. Negative test matrix wajib
Untuk setiap protected operation: unauthenticated, expired/wrong token kind, revoked session, wrong organizer, wrong event/session, wrong enrollment/attempt, unassigned room/question, role-only tanpa capability, stale device generation, unpublished result, reused evidence authorization. Generic 404 untuk resource tidak visible; 403 untuk action yang tidak diizinkan pada resource visible.
Participant DTO/bundle tidak memuat keys/rubrics private; grading DTO tanpa identity. Uji grader mencoba enrollment/media/Zoom/evidence/export endpoints, bukan hanya queue response. Recovery/force-submit/publish membutuhkan CSRF, idempotency dan reason. Camera interruption tidak auto-penalty dan tidak menghapus ACK.