Addon Store (Peninjauan Pengajuan)

Menu Addon Store di License Admin (admin.alurkerja.com) dipakai tim AlurKerja untuk meninjau addon yang diajukan pelanggan dari Studio (tab Explore di halaman Addons) sebelum tampil di katalog Explore. Hanya akun dengan peran license_admin yang bisa membukanya; peran lain ditolak 403.

Peran license_admin

license_admin adalah peran akses License Admin yang memegang pengelolaan Store: menerima pengajuan addon dari Studio, meninjau dan memutuskannya, serta mengatur addon yang sudah terdaftar.

Siapa yang memegangnya. Peran ini untuk tim AlurKerja, bukan untuk pelanggan. Akun pelanggan tidak perlu dan tidak akan mendapatkannya.

Apa yang bisa dilakukan.

• Melihat antrean pengajuan dan membuka isi paket (manifest, daftar file, isi script).
• Menyetujui pengajuan, dan paket ditandatangani otomatis oleh server, atau menolaknya dengan catatan yang terbaca pengaju.
• Mengatur paket yang sudah masuk Store: plan yang boleh melihatnya dan tampil / disembunyikan di katalog.

Cara mendapatkannya. Peran diberikan di Keycloak (realm alurkerja) oleh administrator: tambahkan peran realm license_admin ke akun yang bersangkutan, lalu login ulang ke License Admin agar token baru memuat peran tersebut. Server membaca peran dari token, baik sebagai peran realm maupun peran client license-admin. Akun tanpa peran ini yang membuka menu Addon Store mendapat 403, dan token yang tidak valid mendapat 401.

Kenapa dibatasi. Paket yang disetujui ditandatangani dan dapat dipasang di instance pelanggan; paket berisi script bahkan dijalankan di instance tersebut. Karena itu hanya orang yang bertanggung jawab atas peninjauan yang boleh memutuskan.

Antrean Pengajuan

Buka Katalog → Addon Store. Antrean terbagi tiga tab: Menunggu, Disetujui, dan Ditolak. Kolomnya: Paket, Versi, Instance / Customer, Workspace, Diajukan oleh, Tanggal. Pengajuan yang berisi script diberi tanda Berisi script.

Pengajuan yang baru dikirim dari Studio muncul di tab Menunggu.

Meninjau Pengajuan

Klik pengajuan untuk membuka detailnya:

• Workspace, Customer, ukuran, dan SHA-256 paket. Email pengaju adalah klaim dari instance dan tidak diverifikasi server.
• Manifest (Actions dan Config yang dideklarasikan).
• Daftar file, dengan penanda script dan executable. Lihat isi menampilkan isi file; file biner atau terlalu besar tidak ditampilkan, dan isi yang panjang dipotong.
• Versi sebelumnya yang disetujui, untuk membandingkan.
• Unduh zip untuk memeriksa lengkap.

Checklist review pengajuan addon

Checklist ini untuk reviewer dengan peran license_admin. Semua butir bisa dikerjakan dari layar detail pengajuan dan dari zip yang diunduh lewat Unduh zip; salin sebagai dasar SOP review. Penanda di layar (tanda script, executable, peringatan Paket ini berisi script) hanya membantu menemukan file yang perlu dibaca. Penanda itu bukan hasil pemeriksaan keamanan.

A. Identitas dan asal pengajuan

1. Judul halaman (nama + versi) sesuai fungsi addon yang diajukan. Bila nama kosong, judul memakai key addon.
2. Buka index.json lewat Lihat isi di daftar file. Periksa addon_key, name, description, dan version: deskripsi masuk akal dan sesuai isi paket.
3. Kartu Detail pengajuan: Customer, Instance, dan Workspace dikenal, dan sesuai dengan pelanggan yang memang memakai addon ini. Nama dan email Pengaju adalah klaim dari instance dan tidak diverifikasi server; jangan dijadikan bukti identitas. Bila ragu, konfirmasi ke customer lewat jalur lain.
4. Bila ada kartu Perubahan dari versi …, baca perubahannya. Bandingkan juga dengan Versi sebelumnya yang disetujui. Pengajuan pertama untuk sebuah paket tidak punya pembanding, jadi tinjau seluruh isinya.

B. Paket berscript atau tidak

5. Periksa ada tidaknya peringatan Paket ini berisi script dan tanda Berisi script di antrean. Paket ditandai berscript bila ada file berekstensi .py, .sh, .bash, .zsh, .rb, .pl, atau .php, file diawali #!, file dengan bit executable, atau index.json mendeklarasikan script pada scripts. Paket berscript direview lebih ketat: script dijalankan di instance yang memasangnya.
6. Paket tanpa tanda script tetap tidak otomatis aman. File .js tidak dihitung script, padahal bundel di folder view (misalnya views/dist) dijalankan di browser pengguna. Buka isinya bila terbaca. Bundel hasil build sulit dibaca, jadi andalkan perbandingan dengan versi sebelumnya dan sumber addon dari pengaju.

C. Isi script

Buka tiap file bertanda script lewat Lihat isi, dari awal sampai akhir. Cari:

7. Akses jaringan keluar: alamat atau host yang dipanggil. Sesuai fungsi addon yang dideklarasikan? Tolak host tak dikenal atau alamat IP mentah.
8. Membaca kredensial, variabel lingkungan, atau berkas di luar folder addon (misalnya os.environ, ~/.ssh, /etc, berkas .env).
9. Menulis atau menghapus berkas di luar folder addon.
10. Menjalankan perintah shell atau proses lain (misalnya os.system, subprocess, eval, exec).
11. Kode yang disamarkan: string base64 panjang yang didekode lalu dijalankan, eval/exec pada teks dari luar, nama variabel sengaja tidak terbaca.
12. Secret tertanam: token, password, API key, atau kunci privat di dalam script maupun berkas konfigurasi.

D. Dependensi dan file lain

13. Buka requirements.txt (bila ada). Sumber dan versi paket wajar dan sudah dikenal. Tolak paket yang diambil dari URL atau repositori tak dikenal, atau yang diunduh saat script berjalan.
14. Perhatikan ukuran dan daftar file. Tolak file yang tidak relevan dengan fungsi addon: dump database, data pelanggan, berkas kunci, atau arsip bersarang.
15. File yang isinya tidak tampil. Lihat isi hanya menampilkan file teks berukuran sampai 256 KB. File biner, file lebih besar, dan file tanpa ekstensi teks yang dikenal (misalnya .sql atau tanpa ekstensi) menampilkan "Isi file tidak ditampilkan". Untuk file seperti itu, klik Unduh zip, ekstrak di komputer yang terpisah dari pekerjaan harian, lalu periksa manual. Biner tanpa sumber yang bisa dibaca sebaiknya ditolak.
16. Bila isi file dipotong ("Isi dipotong"), bagian setelah batas tidak terlihat. Periksa dari zip.

E. Keputusan

17. Putuskan hanya setelah semua butir di atas selesai. Bila ada yang belum bisa dipastikan, tolak dengan catatan yang meminta pengaju memperjelasnya, daripada menyetujui. Versi yang disetujui tidak dapat diubah.
18. Menolak: tulis Catatan penolakan yang bisa ditindaklanjuti. Sebutkan file dan alasannya, serta apa yang harus diubah. Contoh: "scripts/sync/sync.py baris sekitar 40 memanggil http://203.0.113.9/upload. Hapus panggilan itu atau jelaskan tujuannya, lalu ajukan versi baru." Catatan ini terbaca pengaju di Studio sebagai Catatan reviewer.

Menyetujui atau Menolak

Tombol Tolak membuka dialog dengan kolom Catatan penolakan; bila dikosongkan, dialog menampilkan "Catatan wajib diisi saat menolak."

Pengajuan yang sudah diputuskan tidak bisa diputuskan lagi (not_in_review).

Paket Store: Plan dan Tampilan

Tautan Daftar paket membuka Paket Store: paket yang sudah masuk Store beserta Pemilik, Plan, dan status Tampil / Disembunyikan.

Pada Pengaturan katalog sebuah paket Anda dapat mengatur:

Klik Simpan untuk menerapkan.