API từng có một mô hình traffic rất đơn giản. Một developer đăng ký, nhận một key, viết một tích hợp, và tích hợp đó gọi các endpoint của bạn theo lịch hoặc khi người dùng bấm vào một thứ gì đó. Quản lý bot cho API phát triển quanh mô hình đó: xác thực key, giới hạn lưu lượng, lọc traffic lạm dụng rõ ràng, và giữ dịch vụ sẵn sàng cho mọi người còn lại.
Mô hình đó vẫn còn hiệu lực, và các công cụ được xây dựng cho nó vẫn rất quan trọng. Điều thay đổi là ai đang đứng sau các cuộc gọi. Cùng một API key giờ có thể mang request từ một người dùng app của khách hàng bạn, một người đã nhờ trợ lý AI làm việc, và một agent tự động chạy một tác vụ nhiều bước qua đêm. Các kiểm soát hiện có của bạn nhìn thấy một key và một tốc độ request. Sản phẩm, hỗ trợ và các quyết định chính sách của bạn thường cần biết nhiều hơn.
Proof of Actor lấp đầy khoảng trống đó. Nó cho API của bạn biết ai hoặc cái gì đang hành động trên mỗi request và nêu rõ bằng chứng, rồi để code của bạn tự quyết định. Trang này so sánh nó với các lớp chính của bảo vệ bot cho API để bạn thấy mỗi thứ thuộc về đâu.
Tóm tắt ngắn gọn
| Bảo vệ bot cho API | Proof of Actor | |
|---|---|---|
| Câu hỏi chính | Request này có được phép, đã xác thực và nằm trong giới hạn không? | Ai hoặc cái gì đang hành động, và bằng chứng là gì? |
| Các lớp điển hình | API gateway, quy tắc bot của WAF, API key, rate limit | Phân loại actor bên trong API của bạn hoặc MCP server |
| Xác định | Account hoặc tích hợp sở hữu key | Actor đứng sau mỗi request: Human, Human + AI, Agent hoặc Unknown |
| Đầu ra | Cho phép, từ chối, giảm tốc; đôi khi là bot score | Một class cộng với một basis: verified, declared, inferred hoặc unknown |
| Traffic không rõ ràng | Thường được cho qua nếu key hợp lệ, hoặc bị từ chối bởi một quy tắc | Unknown, với cơ chế dự phòng bạn chọn theo từng route |
| Ai quyết định phản hồi | Cấu hình của gateway và WAF | Code của ứng dụng bạn |
| Mặc định khi cài đặt | Enforcement | Quan sát; không có gì thay đổi cho đến khi bạn thêm policy |
| Phù hợp nhất cho | Tính sẵn sàng, lọc lạm dụng, hạn mức, khả năng quy trách nhiệm | Phục vụ đúng cách cho từng actor và hiểu cách sử dụng API |
Các phần dưới đây giải thích từng phần.
Bảo vệ bot cho API làm tốt điều gì
Nên mô tả rõ nhiệm vụ của từng lớp, vì Proof of Actor được thiết kế để đứng cạnh tất cả chúng, chứ không thay thế bất kỳ lớp nào.
API gateway
Gateway là cửa ngõ đầu tiên của API của bạn. Nó kết thúc kết nối, xác thực API key hoặc token, định tuyến request đến dịch vụ đúng, thực thi hạn mức và thường ghi lại việc sử dụng cho billing và phân tích. Nó trả lời nhanh chóng và nhất quán trên mọi endpoint câu hỏi "bên gọi này có được phép vào không, và đi qua cửa nào?".
Quy tắc bot của WAF
Một web application firewall với quy tắc bot kiểm tra traffic để tìm các mẫu tấn công đã biết và tự động hóa lạm dụng. Nó có thể lọc các nỗ lực injection, chặn traffic từ các nguồn có lịch sử lạm dụng, và thách thức hoặc loại bỏ các request trông giống scraping hoặc tấn công thông tin đăng nhập. Đây là tuyến phòng vệ tốt nhất của bạn trước traffic không bao giờ nên chạm vào code.
API key và token
Key và token mang lại khả năng quy trách nhiệm. Mỗi request ánh xạ tới một account, nên bạn biết tích hợp nào đã gọi, có thể thu hồi quyền truy cập, và có thể quy về mức sử dụng. Token có phạm vi còn đi xa hơn và giới hạn những gì bên gọi được phép làm.
Rate limit
Rate limit bảo vệ tính sẵn sàng. Chúng ngăn một tích hợp tiêu tốn dung lượng dành cho mọi người, và làm chậm các nỗ lực brute-force và enumeration. Giới hạn theo key và theo route là một kiểm soát tiêu chuẩn và hiệu quả.
Cùng nhau, các lớp này trả lời rất tốt các câu hỏi về bảo vệ và quy trách nhiệm. Hãy giữ chúng.
Câu hỏi mà chúng không được xây dựng để trả lời
Không lớp nào trong số đó được thiết kế để cho bạn biết loại actor nào đứng sau một request đã xác thực. Một key hợp lệ cho biết account nào sở hữu tích hợp. Nó không cho biết:
- request cụ thể này đến từ một người đang chạm vào nút trong app của khách hàng bạn hay không,
- một người đã nhờ trợ lý AI thực hiện hành động hay không,
- một agent tự động đã gọi nó như một bước trong một tác vụ dài hơn hay không,
- hoặc có phải là không ai có thể nói chắc hay không.
Sự phân biệt đó ngày càng quan trọng theo từng tháng. Một API phục vụ tích hợp CRM, công cụ lập lịch hoặc nền tảng cho developer ngày càng nhận traffic từ agent qua cùng các key phục vụ ứng dụng do con người điều khiển. Nếu bạn muốn đưa ra phản hồi có cấu trúc cho agent, yêu cầu xác nhận cho các thao tác ghi có tác động lớn do agent kích hoạt, gắn nhãn các gửi lên có hỗ trợ AI, hoặc đơn giản là đo xem bao nhiêu phần trong việc sử dụng API của bạn là do agent điều khiển, bạn cần ngữ cảnh actor.
Proof of Actor thêm gì vào một API
Proof of Actor trả về một trong bốn class cho mỗi tương tác:
- Human: các tín hiệu quan sát được cho thấy tương tác do con người điều khiển.
- Human + AI: một người đã điều hướng tương tác với sự hỗ trợ của AI được khai báo hoặc quan sát thông qua một tích hợp được hỗ trợ.
- Agent: tương tác có nguồn gốc tự động hoặc từ agent.
- Unknown: bằng chứng không đủ để đưa ra kết luận đáng tin cậy.
Mỗi kết quả cũng nêu rõ evidence basis của nó:
- Verified: ví dụ, một HTTP Message Signature (RFC 9421) được kiểm tra đối chiếu với một key đã công bố.
- Declared: client hoặc chính ứng dụng của bạn đã nêu ra điều đó.
- Inferred: các tín hiệu hành vi hoặc ngữ cảnh, được gắn nhãn rõ là suy luận.
- Unknown: không có basis đáng tin cậy.
Với API, basis Verified đặc biệt hữu ích. Các agent ký request của mình có thể được kiểm tra đối chiếu với key đã công bố của chúng, đây là cách tiếp cận đứng sau nỗ lực IETF Web Bot Auth. Đọc phần giải thích về Web Bot Auth cho các đội sản phẩm để có bối cảnh, và hướng dẫn về xác minh request agent đã ký để xem phần triển khai.
Có một giới hạn quan trọng ở đây. Một chữ ký hợp lệ chứng minh key nào đã ký request. Nó không chứng minh agent được ủy quyền để thực hiện hành động đó. Ủy quyền vẫn ở đúng chỗ của nó, trong kiểm soát truy cập riêng của API bạn. Mục ủy quyền agent giải thích sự khác biệt này.
Score và key so với bằng chứng actor
Một số sản phẩm bảo vệ bot gắn một score cho mỗi request. Score hiệu quả cho quyết định chặn. Nó ít hữu ích hơn cho các quyết định sản phẩm API, vì nó không cho bạn biết một request hợp lệ là do con người điều khiển hay do agent điều khiển, và nó không tách biệt факт đã xác minh khỏi suy luận.
API key có giới hạn ngược lại. Chúng chính xác về quyền sở hữu và im lặng về actor. Key của một khách hàng có thể mang cả bốn class trong cùng một giờ.
Proof of Actor giữ cả hai sự phân biệt này ở trạng thái hiển thị. API của bạn nhìn thấy account từ key, actor class từ Proof of Actor, và basis hỗ trợ nó. Mỗi lớp trả lời câu hỏi mà nó làm tốt nhất.
Mỗi thứ chạy ở đâu
Gateway và WAF chạy ở rìa mạng của bạn hoặc ở phía trước các dịch vụ của bạn. Vị trí đó phù hợp cho bảo vệ và hạn mức.
Proof of Actor chạy ở nơi logic API của bạn tồn tại. Các founding team có thể tích hợp qua middleware Node.js, Next.js, một lớp edge do bạn kiểm soát, HTTP API tổng quát, hoặc một tích hợp MCP server. Xem tích hợp để có danh sách đầy đủ. Vì nó chạy bên trong ứng dụng của bạn, nó có thể dùng những gì API của bạn biết: route, workflow, liệu client có tự khai báo hay không, và liệu chữ ký có được xác minh hay không.
Quyết định định tuyến vẫn nằm trong code của bạn
Proof of Actor mặc định không chặn gì cả. Nó bắt đầu ở chế độ quan sát, nên việc cài đặt nó không thay đổi cách API của bạn phản hồi. Bạn thấy cơ cấu actor của mình theo từng endpoint, xem xét bằng chứng cho các kết quả riêng lẻ, và theo dõi tỷ lệ Unknown của bạn.
Khi sẵn sàng, bạn viết policy do ứng dụng định nghĩa theo từng route, từng actor class và từng basis. Các kết quả điển hình là:
- Allow: phục vụ request bình thường.
- Adapt: trả về phản hồi có cấu trúc hoặc rút gọn cho một agent đã xác minh.
- Challenge: yêu cầu một bước xác nhận bổ sung, ví dụ phê duyệt của con người cho một thao tác ghi có tác động lớn.
- Review: đưa hành động vào hàng đợi để một người kiểm tra.
- Rate-limit: áp dụng giới hạn chặt hơn cho một class và basis cụ thể trên một route cụ thể.
Bạn có thể xem trước một policy trên traffic thực trước khi enforcement, rồi áp dụng enforcement theo từng route. Hướng dẫn về triển khai policy nhận biết actor một cách an toàn trình bày quy trình, và bảo vệ các hành động nhạy cảm mà không chặn agent cho thấy các mẫu phổ biến.
Xử lý các API caller Unknown
Mỗi API đều nhận traffic không thể được phân loại với độ tin cậy cao. Với các kiểm soát truyền thống, một key hợp lệ thường có nghĩa request được đi qua, còn một key không hợp lệ thì không. Không có khoảng giữa.
Proof of Actor cho bạn một kết quả Unknown rõ ràng và cho phép bạn chọn cơ chế dự phòng theo từng route. Các endpoint danh mục chỉ đọc có thể vẫn mở. Các thay đổi tài khoản có thể giữ các kiểm tra chặt hơn hiện có của bạn. Các lần xuất hàng loạt có thể chuyển sang review. Xem xử lý traffic Unknown và traffic tự động Unknown để biết chi tiết.
Chúng kết hợp như thế nào
Thiết lập API mạnh nhất sẽ dùng từng lớp cho đúng nhiệm vụ của nó:
- Ở rìa hệ thống, WAF lọc traffic lạm dụng và traffic sai định dạng.
- Ở gateway, key được xác thực, hạn mức được thực thi và việc sử dụng được ghi lại.
- Bên trong API, Proof of Actor phân loại từng request đi qua và nêu basis của nó.
- Trong handler của bạn, policy dùng class và basis để chọn phản hồi: xử lý bình thường cho một cuộc gọi do con người điều khiển, phản hồi có cấu trúc cho một agent đã xác minh, bước xác nhận cho một thao tác ghi có tác động lớn do agent điều khiển, cơ chế dự phòng cho Unknown.
- Trong phân tích, đội của bạn thấy từng actor class dùng endpoint và workflow nào, cùng với dữ liệu account từ gateway.
Không có gì trong ngăn xếp này bị lặp lại. Gateway biết account, WAF biết mẫu đe dọa, và Proof of Actor biết actor.
Khi nào nên tập trung vào cái nào
Hãy tập trung vào bảo vệ bot cho API trước nếu vấn đề chính của bạn là lạm dụng, tính sẵn sàng hoặc usage không được đo lường: tấn công thông tin đăng nhập vào endpoint xác thực, scraping mạnh, hoặc một tích hợp làm các tích hợp khác bị thiếu tài nguyên.
Hãy tập trung vào Proof of Actor khi các câu hỏi chính của bạn liên quan đến bên gọi: bao nhiêu traffic API của bạn là do agent điều khiển, agent nào gọi endpoint nào, đâu là khác biệt giữa usage do người và do agent điều khiển, và route nào cần một policy nhận biết actor. Mục use case cho API và nhận dạng AI agent cho API đi sâu hơn.
Phần lớn đội ngũ đang vận hành một API production đều cần câu trả lời cho cả hai.
Bắt đầu
Proof of Actor đang ở giai đoạn private beta. Các founding developer team được chọn có thể nhận tới 12 tháng truy cập miễn phí trong các giới hạn sử dụng đã thỏa thuận, không có thanh toán tự động. Đăng ký quyền truy cập sớm và cho chúng tôi biết về API cũng như các bên gọi mà bạn muốn hiểu rõ.