このヘルプにはCloudのURLが表示されています。Dedicatedでログインすると、お客様のサーバーのURLが表示されます。

Pubのセキュリティ

Dartastic Pubは、公開されるすべてのパッケージにスコアを付け、配信するすべてのパッケージ(パブリックパッケージを含む)に組織のセキュリティポリシーを適用します。このページでは、スコア、ポリシー、拒否の意味と対処方法を説明します。

ビルドDartasticアーキテクチャユーザートークンIssuePubトークンプッシュCIトークン交換アプリをユーザーへ配布:アプリストア、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タブには、2つの数値が表示されます。バージョンが公開されると、Dartastic Pubは、インターネットに接続しない隔離されたワーカーで、そのパッケージの最新の安定版と最新のプレリリース版を解析します。

  • Pub points:panaによる160ポイントのレポートで、pub.devに表示されるものと同じです。違いは1項目だけです:ライセンスの項目は、種類を問わず本物のライセンスがあれば合格します。プライベートなコードには商用ライセンスが適切だからです。ライセンスがない、空、またはプレースホルダーのままの場合は不合格のままで、タブにはこの項目を変更したことが示されます。
  • Security Score:panaがチェックしない部分を、0〜100の数値と評価で示します。各チェックは、何を調べ、何が見つかり、どう直せばよいかを示します。

解析を完了できなかった場合(メモリや時間が足りなくなった、依存関係を解決できなかったなど)、タブには低いスコアの代わりに、その旨と理由が表示されます。

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です。管理者はどちらのスコアも手動で設定できます。その場合はタブにその旨が表示され、計算されたスコアも記録に残ります。
  • スコアは、チェックした内容を報告するものです。パッケージが安全であることを保証するものではありません。

組織のセキュリティポリシー

各組織にはポリシーが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は解析が終わっていないことを意味するので、その間はポーリングを続けてください:

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, … }
}

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)からこれらすべてを管理します。そこでの操作はすべて、誰がいつ行ったかとともに監査ログに記録されます。管理者ができること:

  • ポリシーで保留されているバージョンの早期承認、または却下
  • 組織自身のパッケージのバージョンの隔離、隔離の解除、拒否
  • 組織自身のパッケージのスコアを手動で設定
  • 理由を添えた適用除外の追加と削除
  • 組織のポリシーと品質ゲートの選択
  • 判定または既知のアドバイザリの対象で、組織が取得したすべてのバージョンの確認:誰が、何回、いつ取得したか、組織のどのパッケージがそれに依存しているか