Pub安全性
Dartastic Pub會為您發布的每個套件評分,並對它提供的每個套件(包括公開套件)套用您組織的安全性政策。本頁說明這些分數和政策、拒絕代表什麼,以及該如何處理。
「Scores」分頁
您的Dartastic Pub上,每個套件的Scores分頁都會顯示兩個分數。版本發布後,Dartastic Pub會在無法連上網際網路的隔離worker中,分析該套件的最新穩定版和最新預先發行版。
- pub points:pana的160分報告,也就是pub.dev顯示的那份。只有一行不同:任何正式的授權都能通過授權那一行,因為商業授權本來就適合私有程式碼。缺少授權、空白或只有預留位置的授權仍然無法通過,分頁也會註明這一行已調整。
- Security Score:0至100分並附等級,涵蓋pana不檢查的項目。每項檢查都會顯示檢查了什麼、發現了什麼,以及如何修正。
分析無法完成時(記憶體或時間用盡,或無法解析某個相依套件),分頁會說明情況和原因,而不是顯示一個低分。
Security Score的檢查項目
| 檢查項目 | 分數 | 檢查內容 |
|---|---|---|
| Known advisories | 30 | 此版本及其解析到的每個套件上的已知安全性公告。 |
| Secrets in the archive | 20 | 封存檔中遺留的權杖、金鑰和憑證檔案。能讀取該套件的人都看得到發現的類型,只有套件管理員看得到位置。 |
| Review verdict | 10 | 安全性審查對此版本的判定。 |
| Binaries and build hooks | 15 | 封存檔中的原生二進位檔和建置掛鉤,每一項都連同其sha256一併記錄。經審查並獲准後,才能取得這部分分數。單純使用FFI不會扣分。 |
| Publisher and provenance | 15 | 由誰發布該套件,以及發布者是否變更。 |
| Same uploader as the last release | 5 | 上傳此版本的人是否也上傳了上一個版本。 |
| Release age | 5 | 此版本是否已發布至少7天。 |
- 無從判斷的檢查會被排除:分數依實際執行的檢查換算,分頁會列出未執行的檢查。這類檢查絕不算作通過。
- 等級:90分以上為A,80分以上為B,70分以上為C,60分以上為D,低於60分為F。A和B顯示為藍色,C為黃色,D和F為紅色。
- 遭隔離或拒絕的版本得0分。管理員可以手動設定任一分數;此時分頁會註明,計算出的分數仍保留在記錄中。
- 分數只反映檢查過的項目,並不保證套件是安全的。
您組織的安全性政策
每個組織有一種政策,除非管理員變更,否則為Standard。它決定新的公開版本要等待多久,以及審查中被標記的版本如何處理。
| 政策 | 新的公開版本 | 審查中被標記的版本 |
|---|---|---|
| Monitor完整掌握,不打斷開發 | 立即提供 | 提供並計數 |
| Standard適合正式上線團隊的均衡防護 | 等待3天 | 提供,並在套件頁面上標記 |
| Strict適合受法規監管環境的最高控管 | 等待7天,審查未結束時還要等待人工處理 | 不提供 |
您組織自己的套件從不等待,也從不因審查而暫緩。任何政策都不會提供遭隔離或拒絕的版本。
新的公開版本需要等待
發布時間未達政策時限的公開版本,不會列在您的Dartastic Pub提供的版本中,因此dart pub get會解析到符合時間要求的最新版本。不會有任何失敗。管理員可以提前核准某個版本,也可以拒絕它。
如果鎖定檔已固定一個仍在等待中的版本,dart pub get會拒絕它,並指出它可供使用的日期。
審查與判定
某些訊號會讓版本送交審查:與熱門套件只差一個字的名稱、發布者變更的公開套件、長期沉寂後突然發布的套件,或您的某個套件出現新的上傳者。在Strict政策下,審查未結束時該版本需要等待。
審查以判定結束。allow:提供該版本。warn:提供該版本,並在其頁面上標記,Strict政策下除外。quarantine和deny:對所有組織停止提供該版本。
品質關卡
組織管理員可以設定品質關卡:最低pub points、最低Security Score,以及必須通過的檢查。未達關卡的版本不會列在提供給您組織的版本中,因此dart pub get無法選用它。
公開套件在這裡沒有pub points,因此pub points下限不會擋下公開套件。必要的檢查必須已經通過,因此未執行的檢查視為未通過。
您的CI可以使用讀取時的同一個Pub權杖,查詢某個版本是否通過。回應中的status為allow、warn、block或pending。為pending時表示分析尚未完成,請繼續輪詢:
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, … }
}若要讓某個版本通過關卡,由組織管理員為其設定豁免並註明理由。豁免只對該版本解除關卡。
當dart pub get拒絕某個版本時
拒絕訊息會說明原因和處理方式。各訊息的意義:
| 訊息 | 意義 |
|---|---|
Your organization's security policy holds <package> <version> until <date>. | 您的政策會暫緩這個公開版本,直到顯示的日期。您可以等待、相依於較舊的版本,或請組織管理員提前核准。 |
Your organization's security policy holds every version of <package>. | 這個公開套件的所有版本都比您的政策允許的還新。最早的版本在顯示的日期開放使用。 |
An organization admin rejected <package> <version>. | 組織管理員拒絕了這個版本。請相依於其他版本,或請管理員解除拒絕。 |
<package> <version> is quarantined while it is reviewed. | 此版本正在審查中,審查結束前不提供給任何人。請相依於其他版本。 |
<package> <version> was denied. | 審查認定此版本有問題。請相依於其他版本。 |
A security review flagged <package> <version>, … | 審查標記了此版本,而您的政策(Strict)不提供被標記的版本。請相依於其他版本,或請組織管理員設定豁免。 |
<package> <version> is waiting on a security review, … | 此版本有尚未結束的審查,您的政策(Strict)會等到審查結束。請相依於其他版本,或請組織管理員為其設定豁免。 |
<package> <version> does not meet your organization's quality gate. | 此版本未達您組織的品質關卡;訊息中列出了原因。請相依於其他版本,或請組織管理員為其設定豁免。 |
安全性頁面
組織管理員在安全性頁面https://pub.dartastic.io/security-admin上管理以上所有項目,須登入您的Dartastic Pub。頁面上的每項操作都會受到稽核,記錄執行者和時間。管理員可以在這裡:
- 提前核准或拒絕被政策暫緩的版本
- 隔離、解除隔離或拒絕組織自有套件的某個版本
- 手動設定組織自有套件的分數
- 新增或移除豁免,並註明理由
- 選擇組織的政策及其品質關卡
- 查看組織拉取過、受判定或已知安全性公告影響的每個版本,誰拉取了它、拉取次數和時間,以及組織的哪些套件相依於它