Những trang này hiển thị URL của Cloud. Đăng nhập trên Dedicated để các trang hiển thị URL máy chủ của bạn.

Bảo mật Pub

Dartastic Pub chấm điểm mọi package bạn xuất bản, và áp dụng chính sách bảo mật của tổ chức bạn cho mọi package nó phục vụ, kể cả package công khai. Trang này giải thích các điểm số, các chính sách, ý nghĩa của một lời từ chối và cách xử lý.

XÂY DỰNGKIẾN TRÚC DARTASTICNGƯỜI DÙNGtokentickettoken Pubpushtrao đổi từ CIứng dụng đến tay người dùng: kho ứng dụng, web, máy chủsymbolcrashstack tracemã nguồntelemetryMáy tính nhà phát triểnflutter run · dart pub getCIGitHub Actions, GitLab, …Control Roomtạo token · phân quyền theo vai tròControl Planetổ chức · vai trò · tokenDartastic Pubpackage · mã nguồnObservatoryphiên · trace · logSymbolizercrash → dòng mã nguồnDartastic AItrả lời từ cả haiHệ thống quản lý ticketGitHub · Jira · LinearỨng dụng di động + desktopđiện thoại · máy tính bảng · máy tínhgửi bằng token OTLPỨng dụng webtrong trình duyệtgửi bằng token Browser OTLPMáy chủ Dartbackend · dịch vụgửi bằng token OTLP

Tab Scores

Tab Scores của mỗi package trên Dartastic Pub của bạn hiển thị hai con số. Sau khi một phiên bản được xuất bản, Dartastic Pub phân tích phiên bản ổn định mới nhất và phiên bản prerelease mới nhất của package trong một worker cô lập không có kết nối Internet.

  • Pub points: báo cáo 160 điểm của pana, đúng bản mà pub.dev hiển thị. Chỉ một dòng khác: dòng giấy phép đạt với một giấy phép thực sự thuộc bất kỳ loại nào, vì giấy phép thương mại là phù hợp cho mã riêng tư. Giấy phép bị thiếu, rỗng hoặc chỉ là phần giữ chỗ vẫn không đạt, và tab ghi rõ dòng đó đã được thay đổi.
  • Security Score: từ 0 đến 100 kèm xếp hạng, cho những gì pana không kiểm tra. Mỗi mục kiểm tra cho thấy nó đã xem gì, tìm thấy gì và cách khắc phục.

Khi một lần phân tích không thể hoàn tất (hết bộ nhớ hoặc hết thời gian, hoặc không phân giải được một dependency), tab ghi rõ điều đó và lý do, thay vì hiển thị một điểm thấp.

Các mục kiểm tra của Security Score

Mục kiểm traĐiểmNhững gì nó xem xét
Known advisories30Các cảnh báo bảo mật đã biết trên phiên bản này và trên mọi package mà nó đã phân giải tới.
Secrets in the archive20Token, khóa và tệp thông tin xác thực còn sót trong archive. Ai đọc được package đều thấy loại đã được tìm thấy; chỉ quản trị viên của package thấy nó nằm ở đâu.
Review verdict10Kết luận của một lần đánh giá bảo mật cho phiên bản này.
Binaries and build hooks15Binary native và build hook trong archive, mỗi cái được ghi nhận cùng sha256 của nó. Chúng được nhận số điểm này khi đã được đánh giá và cho phép. Riêng việc dùng FFI không làm mất điểm.
Publisher and provenance15Ai xuất bản package, và điều đó có thay đổi không.
Same uploader as the last release5Người tải phiên bản này lên có phải cũng là người đã tải phiên bản trước lên không.
Release age5Bản phát hành đã được ít nhất 7 ngày chưa.
  • Một mục kiểm tra không có gì để dựa vào thì được bỏ qua: điểm được quy đổi theo các mục kiểm tra đã chạy, và tab liệt kê những mục không chạy. Mục đó không bao giờ được tính là đạt.
  • Xếp hạng: A từ 90, B từ 80, C từ 70, D từ 60, F dưới 60. A và B hiển thị màu xanh dương, C màu vàng, D và F màu đỏ.
  • Một phiên bản bị cách ly hoặc bị từ chối nhận 0 điểm. Quản trị viên có thể đặt điểm bằng tay cho cả hai loại điểm; khi đó tab ghi rõ điều này, và điểm đã tính vẫn được lưu lại.
  • Điểm số cho biết những gì đã được kiểm tra. Nó không cam kết rằng một package là an toàn.

Chính sách bảo mật của tổ chức bạn

Mỗi tổ chức có một chính sách, là Standard trừ khi quản trị viên đổi nó. Chính sách quyết định các phiên bản công khai mới phải chờ bao lâu và điều gì xảy ra với một phiên bản bị gắn cờ khi đánh giá.

Chính sáchPhiên bản công khai mớiPhiên bản bị gắn cờ khi đánh giá
MonitorThấy toàn bộ, không gián đoạnĐược phục vụ ngayĐược phục vụ và được đếm
StandardBảo vệ cân bằng cho các nhóm productionChờ 3 ngàyĐược phục vụ, và được gắn cờ trên trang package
StrictKiểm soát tối đa cho môi trường chịu quản lý chặt chẽChờ 7 ngày, và chờ một người duyệt khi còn một đánh giá đang mởKhông được phục vụ

Các package của chính tổ chức bạn không bao giờ phải chờ và không bao giờ bị giữ lại để đánh giá. Không chính sách nào phục vụ một phiên bản bị cách ly hoặc bị từ chối.

Phiên bản công khai mới phải chờ

Một phiên bản công khai chưa đạt giới hạn tuổi trong chính sách của bạn bị loại khỏi các phiên bản mà Dartastic Pub của bạn phục vụ, nên dart pub get phân giải tới phiên bản mới nhất đủ tuổi. Không có gì thất bại. Quản trị viên có thể duyệt sớm một phiên bản, hoặc từ chối nó.

Nếu lockfile đã ghim một phiên bản vẫn đang chờ, dart pub get từ chối nó và nêu ngày phiên bản đó có thể dùng được.

Đánh giá và kết luận

Một số tín hiệu đưa một phiên bản vào đánh giá: một cái tên chỉ cách một package phổ biến một lỗi gõ, một package công khai đổi nhà xuất bản, một package im lặng lâu ngày bỗng phát hành, hoặc một người tải lên mới trên package của bạn. Với Strict, phiên bản phải chờ trong khi đánh giá còn mở.

Một lần đánh giá kết thúc bằng một kết luận. allow phục vụ phiên bản. warn phục vụ nó, kèm cờ trên trang của nó, trừ khi dùng Strict. quarantine và deny chặn nó cho mọi tổ chức.

Cổng chất lượng

Quản trị viên tổ chức có thể đặt một cổng chất lượng: pub points tối thiểu, Security Score tối thiểu và các mục kiểm tra bắt buộc phải đạt. Một phiên bản dưới cổng bị loại khỏi các phiên bản mà tổ chức của bạn được phục vụ, nên dart pub get không thể chọn nó.

Package công khai không có pub points ở đây, nên mức pub points tối thiểu không giữ nó lại. Một mục kiểm tra bắt buộc phải đã đạt, nên mục nào không chạy thì khiến phiên bản không qua cổng.

CI của bạn có thể hỏi xem một phiên bản đã đạt chưa, bằng chính token Pub mà nó dùng để đọc. status trong câu trả lời là allow, warn, block hoặc pending. Tiếp tục hỏi lại khi còn là pending, nghĩa là phân tích chưa xong:

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

Để cho một phiên bản qua cổng, quản trị viên tổ chức miễn trừ nó, kèm lý do. Việc đó chỉ gỡ cổng cho đúng phiên bản đó.

Khi dart pub get từ chối một phiên bản

Một lời từ chối cho biết lý do và cần làm gì. Ý nghĩa của từng loại:

Thông báoÝ nghĩa
Your organization's security policy holds <package> <version> until <date>.Chính sách của bạn giữ phiên bản công khai này đến ngày được hiển thị. Hãy chờ, phụ thuộc vào một phiên bản cũ hơn, hoặc nhờ quản trị viên tổ chức duyệt sớm.
Your organization's security policy holds every version of <package>.Mọi phiên bản của package công khai này đều mới hơn mức chính sách của bạn cho phép. Phiên bản đầu tiên có thể dùng được vào ngày được hiển thị.
An organization admin rejected <package> <version>.Quản trị viên tổ chức đã từ chối phiên bản này. Hãy phụ thuộc vào một phiên bản khác, hoặc nhờ họ gỡ bỏ việc từ chối.
<package> <version> is quarantined while it is reviewed.Phiên bản đang được đánh giá và không được phục vụ cho ai cho đến khi đánh giá kết thúc. Hãy phụ thuộc vào một phiên bản khác.
<package> <version> was denied.Một lần đánh giá đã kết luận phiên bản này là xấu. Hãy phụ thuộc vào một phiên bản khác.
A security review flagged <package> <version>, …Một lần đánh giá đã gắn cờ phiên bản này, và chính sách của bạn (Strict) không phục vụ phiên bản bị gắn cờ. Hãy phụ thuộc vào một phiên bản khác, hoặc nhờ quản trị viên tổ chức miễn trừ.
<package> <version> is waiting on a security review, …Phiên bản có một đánh giá đang mở, và chính sách của bạn (Strict) chờ đánh giá đóng lại. Hãy phụ thuộc vào một phiên bản khác, hoặc nhờ quản trị viên tổ chức miễn trừ nó.
<package> <version> does not meet your organization's quality gate.Phiên bản nằm dưới cổng chất lượng của tổ chức bạn; thông báo liệt kê lý do. Hãy phụ thuộc vào một phiên bản khác, hoặc nhờ quản trị viên tổ chức miễn trừ nó.

Trang bảo mật

Quản trị viên tổ chức quản lý tất cả những điều này trên trang bảo mật, https://pub.dartastic.io/security-admin, khi đăng nhập vào Dartastic Pub của bạn. Mọi thao tác ở đó đều được ghi nhật ký kiểm tra, kèm người thực hiện và thời điểm. Tại đó, quản trị viên có thể:

  • Duyệt sớm, hoặc từ chối, một phiên bản mà chính sách đang giữ
  • Cách ly, gỡ cách ly hoặc từ chối một phiên bản thuộc các package của chính tổ chức
  • Đặt điểm bằng tay cho các package của chính tổ chức
  • Thêm hoặc gỡ một miễn trừ, kèm lý do
  • Chọn chính sách của tổ chức và cổng chất lượng của nó
  • Xem mọi phiên bản chịu một kết luận hoặc một cảnh báo bảo mật đã biết mà tổ chức đã kéo về, ai đã kéo, bao nhiêu lần và khi nào, cùng những package nào của tổ chức phụ thuộc vào nó