import { ProofOfActor } from "@proofofactor/sdk";
const actor = await ProofOfActor.verify({
require: [
"human_presence",
"human_control",
"session_continuity"
]
});
if (actor.humanControl > 0.90) {
allow();
}
// For agents
const authority = await ProofOfActor.verifyAuthority({
agent,
action
});Phạm vi API đề xuất
5 điểm cuối, 1 bản chứng thực
Yêu cầu những gì cần thiết cho bối cảnh của bạn, xem xét bằng chứng, áp dụng chính sách của bạn. Cùng một mô hình áp dụng cho con người, con người được AI hỗ trợ và tác nhân.
Tạo yêu cầu xác minh
POST/v1/verifications
Khai báo các yêu cầu đối với tương tác: sự hiện diện của con người, khả năng kiểm soát liên tục, việc công khai sử dụng AI, mức độ công khai danh tính.
POST /v1/verifications
{
"requirements": {
"human_presence": true,
"continuous_control": true,
"ai_disclosure": true
}
}Truy xuất trạng thái tác nhân
GET/v1/verifications/{verification_id}
Xem loại tác nhân và mức độ tin cậy của từng nhận định. Chính sách của bạn quyết định cách xử lý thông tin đó.
GET /v1/verifications/{verification_id}
{
"actor_type": "human",
"confidence": 0.97,
"human_presence": "verified",
"human_control": 0.94,
"ai_participation": "low",
"continuity": 0.99
}Yêu cầu xác nhận rõ ràng ý định của con người
POST/v1/intent
Dành cho các hành động có hệ quả đáng kể, đòi hỏi con người phê duyệt trực tiếp chính hành động này, vào thời điểm này, theo các điều kiện này.
Truy xuất bản chứng thực
GET/v1/attestations/{id}
Trả về Actor Trust Receipt ở định dạng máy có thể đọc để phục vụ kiểm toán và các hệ thống hạ nguồn.
Actor Policy
Khai báo các yêu cầu về độ tin cậy
Các ứng dụng cần có khả năng khai báo yêu cầu của mình dưới dạng chính sách. Nguyên tắc kiến trúc cốt lõi: Proof of Actor cung cấp bằng chứng về độ tin cậy. Khách hàng quyết định chính sách chấp nhận được.
policy.require({
actor: "human",
presence: "continuous",
control: 0.90,
aiAssistance: "low"
});
policy.allow({
actor: ["human", "authorized_agent"],
agentAuthority: {
required: true
}
});Nguyên tắc thiết kế dành cho nhà phát triển
- Việc tích hợp nên dễ hơn việc tự xây dựng hạ tầng xác minh nội bộ.
- Mọi kết quả đều có thể giải thích: các khẳng định đi kèm bằng chứng và mức độ tin cậy.
- Chỉ yêu cầu những thông tin xác nhận bạn cần; không thu thập thêm bất cứ điều gì.
- Con người và tác nhân đều là các chủ thể hành động được hỗ trợ đầy đủ trong cùng một API.
- Quyền hạn của tác nhân luôn có thể bị thu hồi và luôn được kiểm tra cho từng hành động.
Giá
Thông tin về giá chưa được công bố trong giai đoạn nghiên cứu. Chúng tôi sẽ không chốt giá trước khi hiểu những đơn vị xác minh nào tạo ra nhiều giá trị nhất. Một mô hình có thể áp dụng sau này:
- Nhà phát triển
- Môi trường thử nghiệm miễn phí
- Xây dựng
- Phí cơ bản hằng tháng + phí theo mức sử dụng
- Quy mô
- Giá theo mức sử dụng
- Doanh nghiệp
- Lưu lượng lớn + chính sách nâng cao + triển khai riêng
Câu hỏi thường gặp
Câu hỏi từ nhà phát triển
Tôi có thể tích hợp Proof of Actor ngay hôm nay không?
Chưa. Proof of Actor đang được phát triển và chưa có API hoặc SDK dùng trong môi trường thực tế. Các điểm cuối và lời gọi SDK trên trang này là bản xem trước dành cho nhà phát triển của thiết kế đề xuất, được công bố để các nhà phát triển có thể góp phần định hình thiết kế.
Sẽ có SDK không?
SDK là một phần của trải nghiệm dành cho nhà phát triển được đề xuất. Tên gói và phương thức hiển thị ở đây chỉ mang tính minh họa và có thể thay đổi trước khi phát hành.
Giá sẽ được tính như thế nào?
Thông tin về giá chưa được công bố trong giai đoạn nghiên cứu. Các đơn vị tính giá có thể gồm mỗi lần xác minh, mỗi phiên liên tục, mỗi chứng thực và mỗi lần xác minh thẩm quyền, cùng với môi trường thử nghiệm miễn phí cho nhà phát triển. Chưa có gì được chốt.
Làm thế nào để tôi được cấp quyền truy cập?
Tham gia chương trình Developer Preview. Hãy cho chúng tôi biết bạn muốn xác minh điều gì và số lượng tương tác ước tính; chúng tôi dùng những câu trả lời đó để ưu tiên thiết kế và cấp quyền truy cập sớm.
Góp phần định hình API trước khi phát hành.
Hãy cho chúng tôi biết bạn đang muốn xác minh điều gì và số lượng lượt tương tác liên quan. Thành viên chương trình Xem trước dành cho nhà phát triển sẽ được xem thiết kế trước.