Chữ ký số và thu hồi
Trang này dành cho người cấu hình và vận hành. Bạn sẽ đặt khóa tin cậy trên máy hoặc dịch vụ, biết hệ thống đang chống những gì, và biết xử lý khi một version phải thu hồi. Phần khái niệm nằm ở Khóa version và chữ ký số.
Hệ thống chống những gì?
| Mối đe dọa | Biện pháp |
|---|---|
| Kho gói hoặc cơ sở dữ liệu của Tara bị sửa | Chữ ký kiểm bằng khóa công khai cấu hình sẵn ở bên dùng, không lấy từ Tara |
| Gói bị thay trên đường truyền | sha256 trong phillip.lock và trong bản khai đã ký |
| Gói chưa ký hoặc bị sửa lọt vào | Bên kiểm từ chối gói chưa ký hoặc ký bằng khóa lạ |
| Bản đã duyệt sau đó phát hiện lỗi | Danh sách thu hồi có ký, bản bị thu hồi bị từ chối kể cả khi nằm trong bộ đệm |
| Quay về danh sách thu hồi cũ hơn | Bên kiểm giữ serial cao nhất đã thấy |
Vuốt ngang để xem hết sơ đồ.
Bản khai đã ký nói gì
Với mỗi version phát hành, Tara ký một bản khai loại tara.package/v2. Bản khai ghi tên (không kèm namespace), version, org sở hữu gói (slug tổ chức hoặc tên người dùng), channel (kênh: official, org, user cho gói cá nhân private, hoặc community cho gói public) và sha256 của gói. Bên kiểm buộc org trong bản khai phải khớp với tổ chức của gói đang nạp, nên gói không giả làm gói của chủ khác được. Gói user phải thuộc về chính người dùng đang cài nó. Bản khai kiểu cũ tara.package/v1 vẫn được kiểm. Loại này mang center thay cho org (trung tâm đã được thay bằng tổ chức): trung tâm điều phối cũ tương ứng aiforge (chính thức), trung tâm khác tương ứng tổ chức đó (kênh org), còn kênh community giữ nguyên là cộng đồng. Hãy cập nhật các bên kiểm trước khi Tara bắt đầu ký v2, vì bên kiểm cũ không nhận v2: Phillip trước, rồi Bandum, rồi Ryoma.
Cấu hình khóa tin cậy
Khóa công khai có dạng ed25519:<base64>. Quản trị phát khóa qua một kênh tin cậy, cùng lúc với cấu hình môi trường. Bạn đừng lấy khóa từ chính Tara rồi tin ngay.
Trên máy người dùng
Script cài Phillip của tổ chức thường ghi sẵn khóa. Nếu cần tự làm, bạn dùng ba lệnh sau để xem, thêm và bỏ khóa.
ph tara keys
ph tara keys trust ed25519:<khóa>
ph tara keys remove <keyId>Khi thêm khóa, Phillip in vân tay (keyId) và hỏi xác nhận, nên bạn đối chiếu vân tay với trưởng nhóm hoặc quản trị trước khi đồng ý. Biến PHILLIP_TARA_KEYS ghi đè cấu hình, tiện cho CI.
Trên máy chủ
Bandum và Ryoma nhận khóa qua biến cấu hình của dịch vụ là BANDUM_TARA_KEYS và RYOMA_TARA_KEYS. Bandum chỉ nạp gói chính thức, cùng gói kênh org có org trùng với BANDUM_ORG của nó (để trống nghĩa là chỉ gói chính thức), và từ chối gói user lẫn community. Trong cấu hình Bandum, plugin được viết là tên@version:sha256 (của aiforge) hoặc acme/tên@version:sha256. Guardrails trên máy người dùng bắt buộc phải có khóa tin cậy trong cấu hình dịch vụ của nó.
Khi đã có khóa, bên kiểm từ chối gói chưa ký, gói ký bằng khóa lạ và gói có bản khai không khớp tên, version hay sha256. Nếu chưa có khóa thì chỉ kiểm sha256 và hiện cảnh báo, và bạn nên coi đó là trạng thái chưa an toàn.
Xoay khóa
Muốn xoay khóa mà không gián đoạn, bạn làm đúng thứ tự sau.
- Thêm khóa mới vào mọi bên kiểm và giữ khóa cũ.
- Người vận hành Tara đổi khóa ký sang khóa mới rồi khởi động lại Tara.
- Ký lại các bản đã phát hành bằng khóa mới.
- Bỏ khóa cũ khỏi các bên kiểm.
Khóa ký riêng được giữ ngoài cơ sở dữ liệu và ngoài kho gói, kể cả bản sao lưu. Bạn có thể đặt khóa trong KMS (Vault hoặc OpenBao, mô-đun Transit) để khóa riêng không bao giờ rời KMS, khi đó Tara chỉ gửi bản khai đi ký và nhận chữ ký về. Xoay khóa trong KMS cũng theo các bước trên.
Thu hồi một version
Khi version có lỗ hổng hoặc lỗi nghiêm trọng, bạn thu hồi nó bằng lệnh sau, hoặc bằng Portal trên trang version. Chủ của tài nguyên cá nhân thu hồi version của nó, Owner hoặc Admin của tổ chức thu hồi version của tổ chức đó, còn platform staff của PhillipCLI thu hồi version chính thức.
ph tara yank ten-tai-nguyen@1.0.1 --reason "Mô tả ngắn lỗi"Lúc này Tara ký lại toàn bộ danh sách thu hồi với serial tăng dần, trong cùng giao dịch với việc đổi trạng thái. Bên kiểm làm mới danh sách và từ chối nạp version đó, còn ph tara list cảnh báo các dự án đang khóa nó. Bandum và Ryoma chỉ kiểm danh sách khi khởi động, nên nếu plugin đang chạy bị thu hồi thì bạn khởi động lại dịch vụ.
Danh sách thu hồi xem được ở GET /v1/revocations. Mỗi mục có trường org, và mục không có org áp dụng cho mọi tổ chức. Danh sách chung chỉ gồm gói chính thức và gói public. Các bản bị thu hồi ở kho riêng của một tổ chức (kênh org) không công khai: chúng nằm ở GET /v1/orgs/{org}/revocations, được ký theo yêu cầu và chỉ thành viên của tổ chức đó đọc được. Với gói kênh org, Phillip, Bandum và Ryoma kiểm cả hai danh sách. Nếu Tara chưa phát danh sách, bên kiểm có khóa tin cậy sẽ từ chối, vì vậy khi nâng cấp hệ thống bạn nâng Tara trước các bên kiểm. Riêng bản chứa mã độc thì Tara còn gỡ gói, nên sau đó không ai tải được nữa.
Sau khi thu hồi thì làm gì?
Bạn phát hành bản vá hoặc bản mới, xem Quy tắc version, rồi nhắc các dự án chạy ph tara outdated và ph tara upgrade. Nếu nghi dữ liệu đã lộ, bạn báo Security và xoay credential liên quan, vì thu hồi chỉ ngăn nạp tiếp chứ không thu lại những gì đã chạy.
Giới hạn
Nếu cài trực tiếp bằng lệnh claude plugin mà không qua Phillip thì không có bước kiểm chữ ký, và lớp bảo vệ còn lại là bộ quét tự động và, ở kho chính thức, bước duyệt. Kit cài trên máy người dùng chạy cùng quyền với người dùng, nên chữ ký và các phép kiểm là hàng rào chính. Trên máy chủ thì kit chạy trong sandbox node --permission.