Keamanan Pub
Dartastic Pub memberi skor setiap package yang Anda publikasikan, dan menerapkan kebijakan keamanan organisasi Anda pada setiap package yang disajikannya, termasuk package publik. Halaman ini menjelaskan skor, kebijakan, arti sebuah penolakan, dan apa yang perlu dilakukan.
Tab Scores
Tab Scores setiap package di Dartastic Pub Anda menampilkan dua angka. Setelah sebuah versi dipublikasikan, Dartastic Pub menganalisis versi stabil terbaru dan versi prerelease terbaru package tersebut di worker terisolasi tanpa akses internet.
- Pub points: laporan 160 poin dari pana, sama dengan yang ditampilkan pub.dev. Satu baris berbeda: baris lisensi lulus untuk lisensi sah jenis apa pun, karena lisensi komersial memang tepat untuk kode pribadi. Lisensi yang tidak ada, kosong, atau masih placeholder tetap gagal, dan tab menyebutkan bahwa baris itu diubah.
- Security Score: 0 sampai 100 dengan nilai huruf, untuk hal yang tidak diperiksa pana. Setiap pemeriksaan menunjukkan apa yang diperiksanya, apa yang ditemukannya, dan cara memperbaikinya.
Saat analisis tidak dapat selesai (kehabisan memori atau waktu, atau sebuah dependensi tidak dapat diselesaikan), tab menyebutkannya beserta alasannya, alih-alih menampilkan skor rendah.
Pemeriksaan Security Score
| Pemeriksaan | Poin | Yang diperiksa |
|---|---|---|
| Known advisories | 30 | Advisory keamanan yang diketahui pada versi ini dan pada setiap package yang menjadi dependensinya. |
| Secrets in the archive | 20 | Token, kunci, dan file kredensial yang tertinggal di arsip. Siapa pun yang dapat membaca package melihat jenis yang ditemukan; hanya admin package yang melihat lokasinya. |
| Review verdict | 10 | Keputusan review keamanan untuk versi ini. |
| Binaries and build hooks | 15 | Binary native dan build hook di dalam arsip, masing-masing dicatat beserta sha256-nya. Poin ini didapat setelah semuanya ditinjau dan diizinkan. FFI saja tidak mengurangi poin. |
| Publisher and provenance | 15 | Siapa yang memublikasikan package, dan apakah itu berubah. |
| Same uploader as the last release | 5 | Apakah orang yang mengunggah versi ini juga mengunggah versi sebelumnya. |
| Release age | 5 | Apakah release berumur setidaknya 7 hari. |
- Pemeriksaan tanpa data untuk dinilai tidak dihitung: skor diskalakan atas pemeriksaan yang berjalan, dan tab mencantumkan yang tidak berjalan. Pemeriksaan itu tidak pernah dianggap lulus.
- Nilai: A mulai 90, B mulai 80, C mulai 70, D mulai 60, F di bawah 60. A dan B tampil biru, C kuning, D dan F merah.
- Versi yang dikarantina atau diblokir mendapat skor 0. Admin dapat menetapkan kedua skor secara manual; tab lalu menyebutkannya, dan skor hasil perhitungan tetap tercatat.
- Skor melaporkan apa yang diperiksa. Skor tidak menjamin bahwa sebuah package aman.
Kebijakan keamanan organisasi Anda
Setiap organisasi memiliki satu kebijakan, yaitu Standard kecuali admin mengubahnya. Kebijakan menentukan berapa lama versi publik baru menunggu dan apa yang terjadi pada versi yang ditandai dalam review.
| Kebijakan | Versi publik baru | Versi yang ditandai dalam review |
|---|---|---|
| MonitorVisibilitas penuh, tanpa gangguan | Langsung disajikan | Disajikan dan dihitung |
| StandardPerlindungan seimbang untuk tim produksi | Menunggu 3 hari | Disajikan, dan ditandai di halaman package |
| StrictKontrol maksimal untuk lingkungan teregulasi | Menunggu 7 hari, dan menunggu keputusan orang selama review masih terbuka | Tidak disajikan |
Package milik organisasi Anda sendiri tidak pernah menunggu dan tidak pernah ditahan untuk review. Tidak ada kebijakan yang menyajikan versi yang dikarantina atau diblokir.
Versi publik baru menunggu
Versi publik yang lebih muda dari batas kebijakan Anda tidak dimasukkan ke daftar versi yang disajikan Dartastic Pub Anda, sehingga dart pub get memilih versi terbaru yang sudah cukup lama. Tidak ada yang gagal. Admin dapat menyetujui versi lebih awal, atau menolaknya.
Jika lockfile sudah mengunci versi yang masih menunggu, dart pub get menolaknya dan menyebutkan tanggal versi itu tersedia.
Review dan keputusan
Beberapa sinyal mengirim versi ke review: nama yang hanya beda satu salah ketik dari package populer, package publik yang publisher-nya berganti, package yang lama tidak aktif lalu tiba-tiba merilis, atau pengunggah baru di package milik Anda. Dengan kebijakan Strict, versi menunggu selama review-nya masih terbuka.
Review berakhir dengan keputusan. allow menyajikan versi. warn menyajikannya, dengan tanda di halamannya, kecuali di kebijakan Strict. quarantine dan deny menghentikannya untuk setiap organisasi.
Gerbang kualitas
Admin organisasi dapat menetapkan gerbang kualitas: pub points minimum, Security Score minimum, dan pemeriksaan yang harus lulus. Versi di bawah gerbang tidak dimasukkan ke daftar versi yang disajikan untuk organisasi Anda, sehingga dart pub get tidak dapat memilihnya.
Package publik tidak memiliki pub points di sini, sehingga minimum pub points tidak menahannya. Pemeriksaan wajib harus sudah lulus, sehingga pemeriksaan yang tidak berjalan membuatnya gagal.
CI Anda dapat menanyakan apakah suatu versi lulus, dengan token Pub yang sama yang digunakannya untuk membaca. Nilai status dalam jawabannya adalah allow, warn, block, atau pending. Terus lakukan polling selama nilainya pending, yang berarti analisis belum selesai:
curl -sS -H "Authorization: Bearer $PUB_TOKEN" \
https://pub.dartastic.io/api/dartastic/security/quality-gate/acme_models/1.3.0{
"package": "acme_models",
"version": "1.3.0",
"status": "block",
"securityScore": 73,
"pubPoints": 140,
"reasons": ["Security Score 73 is below 80."],
"gate": { "action": "block", "minSecurityScore": 80, "minPubPoints": 120, … }
}Untuk meloloskan satu versi melewati gerbang, admin organisasi mengecualikannya, dengan alasan. Pengecualian itu hanya mencabut gerbang untuk versi tersebut.
Saat dart pub get menolak versi
Penolakan menyebutkan alasan dan apa yang harus dilakukan. Arti masing-masing:
| Pesan | Artinya |
|---|---|
Your organization's security policy holds <package> <version> until <date>. | Kebijakan Anda menahan versi publik ini hingga tanggal yang ditampilkan. Tunggu, gunakan versi yang lebih lama, atau minta admin organisasi menyetujuinya lebih awal. |
Your organization's security policy holds every version of <package>. | Setiap versi package publik ini lebih muda dari yang diizinkan kebijakan Anda. Versi pertama tersedia pada tanggal yang ditampilkan. |
An organization admin rejected <package> <version>. | Admin organisasi menolak versi ini. Gunakan versi lain, atau minta admin mencabut penolakannya. |
<package> <version> is quarantined while it is reviewed. | Versi ini sedang dalam review dan tidak disajikan kepada siapa pun sampai review selesai. Gunakan versi lain. |
<package> <version> was denied. | Review menyatakan versi ini buruk. Gunakan versi lain. |
A security review flagged <package> <version>, … | Review menandai versi ini, dan kebijakan Anda (Strict) tidak menyajikan versi yang ditandai. Gunakan versi lain, atau minta pengecualian kepada admin organisasi. |
<package> <version> is waiting on a security review, … | Versi ini memiliki review yang masih terbuka, dan kebijakan Anda (Strict) menunggu review itu ditutup. Gunakan versi lain, atau minta admin organisasi mengecualikannya. |
<package> <version> does not meet your organization's quality gate. | Versi ini berada di bawah gerbang kualitas organisasi Anda; pesannya mencantumkan alasannya. Gunakan versi lain, atau minta admin organisasi mengecualikannya. |
Halaman keamanan
Admin organisasi mengelola semua ini di halaman keamanan, https://pub.dartastic.io/security-admin, setelah masuk ke Dartastic Pub Anda. Setiap tindakan di sana diaudit beserta siapa yang melakukannya dan kapan. Di sana admin dapat:
- Menyetujui lebih awal, atau menolak, versi yang ditahan kebijakan
- Mengarantina, membatalkan karantina, atau memblokir versi package milik organisasi sendiri
- Menetapkan skor secara manual pada package milik organisasi sendiri
- Menambahkan atau menghapus pengecualian, dengan alasan
- Memilih kebijakan organisasi dan gerbang kualitasnya
- Melihat setiap versi dengan keputusan atau advisory yang diketahui yang diunduh organisasi, siapa yang mengunduhnya, seberapa sering dan kapan, serta package organisasi mana yang bergantung padanya