Tính năng beta. Tính năng kiểm toán được phát hành dưới dạng beta trong khi chúng tôi thu thập phản hồi ban đầu.
Danh mục detector và định dạng báo cáo có thể thay đổi trước phiên bản ổn định tiếp theo.
Vui lòng mở một issue nếu có gì không ổn.
http://localhost:8020/audit khi chạy failproofai trên máy cục bộ.
cd <cwd> dư thừa, sleep-polling loop, đọc lại tệp vừa được chỉnh sửa, và hơn thế nữa.
Đối với mỗi bản ghi, mọi sự kiện tool-use được phát lại thông qua 39 chính sách builtin và thông qua 8 detector chỉ dành cho kiểm toán để bắt các mẫu chưa được bao gồm bởi các chính sách thời gian chạy. Các đếm được tổng hợp mỗi chính sách / detector trên tất cả các phiên.
Bạn nhận được gì
Trang/audit bao gồm sáu phần:
- Identity — agent của bạn được phân loại thành một trong 8 nguyên mẫu (
optimist,cowboy,explorer,goldfish,paranoid architect,precision builder,hammer,ghost) dựa trên tín hiệu có trọng số trên mọi bản ghi được kiểm toán. - Strengths — các con số thực tế được lấy từ quét (clean-call %, “0 credential leaks”, v.v.) được bảo vệ bởi các chính sách sanitize có liên quan thực sự kích hoạt.
- Score — 0-100 với các dải S/A/B/C/D/F và khả năng cải thiện dự báo nếu mọi chính sách được đề xuất đều được bật.
- Findings — các thẻ theo chính sách với những gì đã xảy ra, chi phí, bằng chứng được ghi lại, và
failproofai policy add <slug>chính xác để bật builtin thời gian chạy mà sẽ bắt được nó. - Prescribed policies — danh sách cài đặt được tổng hợp với lệnh
failproofai policies --installmột lần. - Re-audit reminder — “quay lại tốt hơn.” Đặt nhắc nhở email 7 ngày qua api-server (yêu cầu đăng nhập; xem
failproofai auth).
Detector chỉ dành cho kiểm toán
Những detector này phát hiện các mẫu “hành động ngu ngốc” chưa được (hoặc chưa) thực thi trong thời gian thực. Chúng chỉ chạy trong quá trình kiểm toán và không bao giờ chặn một lệnh gọi công cụ trực tiếp.| Detector | Những gì nó đếm |
|---|---|
redundant-cd-cwd | Lệnh Bash bắt đầu với cd <cwd> && … mặc dù các lệnh đã chạy trong cwd. |
prefer-edit-over-read-cat | cat/head/tail/less/more trên một tệp nguồn duy nhất — sử dụng công cụ Read. |
prefer-edit-over-sed-awk | sed -i / awk … > file chỉnh sửa tại chỗ — sử dụng công cụ Edit. |
prefer-write-over-heredoc | Heredoc / echo > file nhiều dòng ghi tệp — sử dụng công cụ Write. |
sleep-polling-loop | sleep N dài (≥ 30s) hoặc while …; sleep …; done polling loop. |
find-from-root | find /, find /home, find /usr, v.v. — phạm vi cho cwd. |
git-commit-no-verify | git commit … --no-verify / -n, bỏ qua hook. |
reread-after-edit | Read của một tệp vừa được Edit/Write trong cùng một phiên. |
Bộ nhớ cache
- Bộ nhớ cache mỗi bản ghi tại
~/.failproofai/cache/audit/<sha1>.jsonđược khóa bằng(mtime, size, engineVersion, detectorVersion)— tự động vô hiệu hóa khi bản ghi hoặc mã chính sách/detector thay đổi. Mỗi mục cũng lưu trữ một dấu thời giancachedAtdưới dạng siêu dữ liệu TTL (không phải một phần của khóa bộ nhớ cache); các mục cũ hơn 7 ngày bị từ chối khi đọc để kết quả dài hạn không vượt quá ý định detector phát triển. - Bộ nhớ cache kết quả toàn bộ tại
~/.failproofai/audit-dashboard.json(chế độ 0600). Cho phép bảng điều khiển hiển thị ngay lập tức khi điều hướng mà không cần chạy lại. Cũng bị từ chối khi đọc quá 7 ngày TTL —/auditsau đó rơi vào trạng thái trống của nó và nhắc nhở chạy lại tươi. Nhấp vào[ re-audit now ]gần dưới cùng của báo cáo để làm mới — kiểm toán lại gửinoCache: true, vì vậy nó bỏ qua bộ nhớ cache mỗi bản ghi và quét lại mỗi bản ghi thay vì trả về kết quả được lưu trong bộ nhớ cache; lần chạy phát trực tuyến tiến độ qua một dải dính ở trên cùng và hoán đổi kết quả tại chỗ khi thành công (không tải lại trang; kiểm toán lại không thành công giữ báo cáo trước đó).
Ghi chú
- Không có đột biến. Kiểm toán phát lại ở chế độ chỉ đọc.
warn-repeated-tool-callsbị bỏ qua vì sidecar của nó mỗi phiên sẽ bị sửa đổi. - Các chính sách quy trình được bỏ qua.
require-*-before-stopchính sách chỉ kích hoạt trên các sự kiệnStopvàexecSyncchống lại trạng thái git trực tiếp — chúng không có giải thích “điều gì sẽ xảy ra vào năm 2025” có ý nghĩa, vì vậy chúng không xuất hiện trong số lượng kiểm toán. - Các chính sách tùy chỉnh bị bỏ qua. Các hook tùy chỉnh do người dùng cung cấp không được phát lại (chúng có thể đã thay đổi kể từ phiên gốc).

