Lewati ke isi

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.