這些頁面顯示的是Cloud的URL。在Dedicated上登入後,就會顯示您伺服器的URL。

Pub安全性

Dartastic Pub會為您發布的每個套件評分,並對它提供的每個套件(包括公開套件)套用您組織的安全性政策。本頁說明這些分數和政策、拒絕代表什麼,以及該如何處理。

建置DARTASTIC架構使用者權杖issuePub權杖pushCI交換應用程式交付給使用者:應用程式商店、Web、伺服器符號當機堆疊追蹤原始碼遙測開發者電腦flutter run · dart pub getCIGitHub Actions、GitLab…Control Room建立權杖 · 角色型存取控制控制平面組織 · 角色 · 權杖Dartastic Pub套件 · 原始碼Observatory工作階段 · 追蹤 · 記錄Symbolizer當機 → 原始碼行Dartastic AI綜合兩者作答Issue追蹤系統GitHub · Jira · Linear行動與桌面應用程式手機 · 平板 · 桌機以OTLP權杖傳送Web應用程式在瀏覽器中以Browser OTLP權杖傳送Dart伺服器後端 · 服務以OTLP權杖傳送

「Scores」分頁

您的Dartastic Pub上,每個套件的Scores分頁都會顯示兩個分數。版本發布後,Dartastic Pub會在無法連上網際網路的隔離worker中,分析該套件的最新穩定版和最新預先發行版。

  • pub points:pana的160分報告,也就是pub.dev顯示的那份。只有一行不同:任何正式的授權都能通過授權那一行,因為商業授權本來就適合私有程式碼。缺少授權、空白或只有預留位置的授權仍然無法通過,分頁也會註明這一行已調整。
  • Security Score:0至100分並附等級,涵蓋pana不檢查的項目。每項檢查都會顯示檢查了什麼、發現了什麼,以及如何修正。

分析無法完成時(記憶體或時間用盡,或無法解析某個相依套件),分頁會說明情況和原因,而不是顯示一個低分。

Security Score的檢查項目

檢查項目分數檢查內容
Known advisories30此版本及其解析到的每個套件上的已知安全性公告。
Secrets in the archive20封存檔中遺留的權杖、金鑰和憑證檔案。能讀取該套件的人都看得到發現的類型,只有套件管理員看得到位置。
Review verdict10安全性審查對此版本的判定。
Binaries and build hooks15封存檔中的原生二進位檔和建置掛鉤,每一項都連同其sha256一併記錄。經審查並獲准後,才能取得這部分分數。單純使用FFI不會扣分。
Publisher and provenance15由誰發布該套件,以及發布者是否變更。
Same uploader as the last release5上傳此版本的人是否也上傳了上一個版本。
Release age5此版本是否已發布至少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時表示分析尚未完成,請繼續輪詢:

shell
curl -sS -H "Authorization: Bearer $PUB_TOKEN" \
  https://pub.dartastic.io/api/dartastic/security/quality-gate/acme_models/1.3.0
json
{
  "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。頁面上的每項操作都會受到稽核,記錄執行者和時間。管理員可以在這裡:

  • 提前核准或拒絕被政策暫緩的版本
  • 隔離、解除隔離或拒絕組織自有套件的某個版本
  • 手動設定組織自有套件的分數
  • 新增或移除豁免,並註明理由
  • 選擇組織的政策及其品質關卡
  • 查看組織拉取過、受判定或已知安全性公告影響的每個版本,誰拉取了它、拉取次數和時間,以及組織的哪些套件相依於它