Pubのセキュリティ
Dartastic Pubは、公開されるすべてのパッケージにスコアを付け、配信するすべてのパッケージ(パブリックパッケージを含む)に組織のセキュリティポリシーを適用します。このページでは、スコア、ポリシー、拒否の意味と対処方法を説明します。
「Scores」タブ
Dartastic Pubの各パッケージのScoresタブには、2つの数値が表示されます。バージョンが公開されると、Dartastic Pubは、インターネットに接続しない隔離されたワーカーで、そのパッケージの最新の安定版と最新のプレリリース版を解析します。
- Pub points:panaによる160ポイントのレポートで、pub.devに表示されるものと同じです。違いは1項目だけです:ライセンスの項目は、種類を問わず本物のライセンスがあれば合格します。プライベートなコードには商用ライセンスが適切だからです。ライセンスがない、空、またはプレースホルダーのままの場合は不合格のままで、タブにはこの項目を変更したことが示されます。
- Security Score:panaがチェックしない部分を、0〜100の数値と評価で示します。各チェックは、何を調べ、何が見つかり、どう直せばよいかを示します。
解析を完了できなかった場合(メモリや時間が足りなくなった、依存関係を解決できなかったなど)、タブには低いスコアの代わりに、その旨と理由が表示されます。
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です。管理者はどちらのスコアも手動で設定できます。その場合はタブにその旨が表示され、計算されたスコアも記録に残ります。
- スコアは、チェックした内容を報告するものです。パッケージが安全であることを保証するものではありません。
組織のセキュリティポリシー
各組織にはポリシーが1つあり、管理者が変更しない限りStandardです。ポリシーは、新しいパブリックバージョンが待機する期間と、レビューでフラグが付いたバージョンの扱いを決めます。
| ポリシー | 新しいパブリックバージョン | レビューでフラグが付いたバージョン |
|---|---|---|
| Monitorすべてを可視化、作業は止めない | すぐに配信 | 配信して集計 |
| Standard本番運用チームのための、バランスの取れた保護 | 3日間待機 | 配信し、パッケージページにフラグを表示 |
| Strict規制の厳しい環境のための、最大限の管理 | 7日間待機、レビュー中は担当者の判断も待機 | 配信しない |
組織自身のパッケージは、待機することも、レビューのために保留されることもありません。隔離または拒否されたバージョンは、どのポリシーでも配信されません。
新しいパブリックバージョンは待機する
ポリシーの期間に達していないパブリックバージョンは、Dartastic Pubが配信するバージョンから除外されるため、dart pub getは十分に日数の経った最新のバージョンに解決します。何も失敗しません。管理者はバージョンを早期に承認することも、却下することもできます。
待機中のバージョンをロックファイルがすでに固定している場合、dart pub getはそれを拒否し、利用できるようになる日付を表示します。
レビューと判定
次のようなシグナルがあると、バージョンはレビューに回ります:人気パッケージと1文字違いの名前、パブリッシャーが変わったパブリックパッケージ、長く更新のなかったパッケージの突然のリリース、自社パッケージへの新しいアップローダー。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, … }
}1つのバージョンにゲートを通過させるには、組織の管理者が理由を添えてそのバージョンを適用除外にします。ゲートが解除されるのは、そのバージョンだけです。
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. | このバージョンは組織の品質ゲートを下回っています。理由はメッセージに一覧で示されます。別のバージョンに依存するか、組織の管理者に適用除外を依頼してください。 |
セキュリティページ
組織の管理者は、Dartastic Pubにログインした状態で、セキュリティページ(https://pub.dartastic.io/security-admin)からこれらすべてを管理します。そこでの操作はすべて、誰がいつ行ったかとともに監査ログに記録されます。管理者ができること:
- ポリシーで保留されているバージョンの早期承認、または却下
- 組織自身のパッケージのバージョンの隔離、隔離の解除、拒否
- 組織自身のパッケージのスコアを手動で設定
- 理由を添えた適用除外の追加と削除
- 組織のポリシーと品質ゲートの選択
- 判定または既知のアドバイザリの対象で、組織が取得したすべてのバージョンの確認:誰が、何回、いつ取得したか、組織のどのパッケージがそれに依存しているか