1. Những gì đi kèm một báo cáo
Ba giá trị khiến một báo cáo tự xác minh được. Chúng xuất hiện trên artifact báo cáo và trên metadata share-portal công khai cho liên kết.content_hash — SHA-256 của bằng chứng
content_hash — SHA-256 của bằng chứng
Một digest SHA-256 hex chữ thường của JSON bằng chứng chuẩn tắc của báo
cáo. Các byte là tất định cho một báo cáo cho trước, nên bất kỳ ai có cùng
bằng chứng đều tính lại được hash giống hệt. Bất kỳ chỉnh sửa nào với bằng
chứng đều thay đổi giá trị này.
signature — Ed25519 trên hash
signature — Ed25519 trên hash
Một chữ ký Ed25519 base64 được tính trên
content_hash hex. Nó chứng minh
hash được ký bởi khóa ký của OrcaRouter và không bị giả mạo.sig_key_id — key nào đã ký nó
sig_key_id — key nào đã ký nó
Một định danh ngắn, ổn định cho khóa công khai đang hoạt động (ví dụ
orca- theo sau bởi một mảnh hex). Người xác minh dùng nó để xác nhận báo
cáo được ký bởi key hiện đang công bố — một báo cáo được ký bởi một key id
không xác định sẽ fail closed.Chữ ký bao phủ hash nội dung, không phải các byte PDF, CSV, hay JSON đã
render trực tiếp. Cùng bằng chứng render thành cả ba định dạng từ một hash, nên
bảo đảm toàn vẹn nằm trên bằng chứng nền tảng — mọi bản xuất của một báo cáo
cho trước đều chia sẻ một
content_hash, signature, và sig_key_id.2. Lấy khóa công khai
Khóa công khai ký được công bố tại một endpoint mở — không xác thực, không ngữ cảnh workspace. Một auditor gọi nó trực tiếp.public_key là khóa công khai Ed25519 32-byte mã hóa base64. key_id ở đây
phải khớp với sig_key_id trên báo cáo — nếu không, báo cáo được ký bởi một
key khác (có thể đã xoay vòng hoặc cũ hơn) và sẽ không xác minh được đối với
khóa đã công bố này.
3. Xác minh chữ ký
Bạn có thể xác minh chữ ký theo hai cách. Hoặc nhờ OrcaRouter kiểm tra bộ ba cho bạn, hoặc xác minh hoàn toàn ngoại tuyến với khóa công khai đã công bố.Endpoint verify được host
POST ba giá trị từ báo cáo tới endpoint verify mở. Nó công khai — một auditor gọi nó không cần thông tin xác thực.valid: true nghĩa là chữ ký kiểm tra đúng đối với key đang hoạt động cho key
id đó. valid: false nghĩa là hoặc chữ ký không khớp hash, hash rỗng, hoặc
sig_key_id không khớp khóa hiện đang công bố.
Xác minh ngoại tuyến với khóa công khai
Một auditor hoài nghi không cần tin endpoint verify chút nào. Vì thuật toán là Ed25519 tiêu chuẩn trên hash nội dung hex, chữ ký kiểm tra được bằng bất kỳ thư viện crypto nào:4. Chữ ký bao phủ những gì
Một chữ ký chứng minhcontent_hash của báo cáo được ký bởi OrcaRouter, và
hash chứng minh bằng chứng không bị chỉnh sửa. Một điểm tinh tế: hash được tính
trên một dạng chuẩn tắc của bằng chứng mà gateway xây dựng — không phải các
byte thô của file JSON hoặc PDF. Nên việc tự re-hash artifact đã tải xuống sẽ
không tái tạo content_hash. Hãy dùng endpoint verify (§2/§3), nó tính lại
hash chuẩn tắc và kiểm tra chữ ký Ed25519 cho bạn:
| Kiểm tra | Ý nghĩa |
|---|---|
signature_valid: true | content_hash được ký bởi khóa của OrcaRouter — bằng chứng xác thực và không bị chỉnh sửa. |
| Key id khớp | sig_key_id của báo cáo == key id đã công bố → được ký bởi key đang hoạt động. |
5. Xác minh một báo cáo được chia sẻ
Khi bạn gửi cho một auditor một liên kết share-portal thay vì file, metadata portal đã mang sẵncontent_hash, signature, và sig_key_id, cộng
một cờ signature_valid do server tính. Auditor có thể tin cờ và chạy lại
các kiểm tra ở trên đối với khóa công khai một cách độc lập — share portal
không cần đăng nhập, và đường xác minh là giống hệt.
Một artifact được chia sẻ chỉ được phục vụ khi khu vực đóng dấu của nó vẫn còn
khớp với khu vực data-residency đã
khai báo của workspace bạn. Nếu khu vực bị thay đổi, các lần tải xuống bị giữ
lại ngay cả khi metadata chữ ký vẫn xác minh được. Đây là chủ đích — xem
Đọc xuyên khu vực.
6. Đi đâu tiếp theo
Báo cáo có chữ ký
Cách một báo cáo có chữ ký được sinh, nó nắm bắt bằng chứng gì, và cách
phát hành một liên kết chia sẻ auditor.
Xuất bằng chứng
Lấy bằng chứng báo cáo dưới dạng PDF, CSV, hoặc JSON cho hồ sơ làm việc của
auditor.
Data residency
Cách dấu khu vực trên một báo cáo chi phối nơi nó được lưu trữ và phục vụ.
Trách nhiệm chia sẻ
Những gì OrcaRouter bảo đảm trên đường gateway so với những gì vẫn thuộc về
bạn.
