Chuyển đến nội dung chính
Onboard cho phép agent ghi danh với một dịch vụ bằng code. Một request có chữ ký thay thế biểu mẫu đăng ký. Chủ sở hữu phê duyệt một lần, rồi dịch vụ cấp một credential. Bên dưới Onboard là Agent Enrollment Protocol (AEP). AEP là một giao thức mở cho ghi danh agent, credential do dịch vụ cấp và quyền truy cập có xác thực của agent.

Ý nghĩa đối với dịch vụ của bạn

Agent ghi danh với dịch vụ của bạn và nhận credential riêng. Không ai đăng ký tài khoản cho agent hoặc sao chép API key. Agent trở thành một khách hàng được nhận biết, gắn với chủ sở hữu của agent.
  • Dịch vụ của bạn xuất bản AEP Service Document tại /.well-known/aep. Tài liệu này công bố các lệnh, phương thức và loại credential mà bạn triển khai.
  • Dịch vụ của bạn cấp các credential.
  • Các quyền hiện có của bạn giữ nguyên. AEP không thay thế các quy tắc truy cập của bạn.

Thuật ngữ

Cách một agent onboard

1

Agent kiểm tra dịch vụ

Agent đọc AEP Service Document của dịch vụ. Tài liệu này liệt kê các lệnh, phương thức và loại credential mà dịch vụ hỗ trợ, cùng các thông tin danh tính (claims) mà dịch vụ yêu cầu.
2

Agent ghi danh

Agent gửi một request ghi danh có chữ ký, kèm các claim mà dịch vụ yêu cầu.
3

Chủ sở hữu phê duyệt

InFlow có thể yêu cầu chủ sở hữu phê duyệt lần ghi danh.
4

Dịch vụ ghi nhận một khách hàng được nhận biết

Dịch vụ kiểm tra request có chữ ký. Sau đó dịch vụ ghi nhận agent là một khách hàng được nhận biết.
5

Agent nhận credential

Dịch vụ cấp một credential dưới dạng một grant. InFlow CLI lưu credential đó trong vault mã hóa.
6

Agent gọi dịch vụ

Agent dùng credential đó để gọi các resource được bảo vệ. Header xác thực cơ bản là Authorization: AEP <jwt>.
Agent cũng có thể kiểm tra trạng thái vòng đời của một lần ghi danh và thu hồi các credential của nó.

Cách InFlow lưu trữ danh tính agent

InFlow là một platform AEP. Server InFlow lưu trữ danh tính của mỗi agent InFlow, và InFlow CLI là agent.
  • InFlow xuất bản tài liệu platform tại https://api.inflowpay.ai/.well-known/aep-platform. DID của platform là did:web:app.inflowpay.ai.
  • InFlow cấp cho một agent một agent DID khác nhau cho mỗi dịch vụ. Mỗi agent DID bắt đầu bằng did:web:app.inflowpay.ai:agents:.
  • InFlow xuất bản tài liệu DID của mỗi agent trên app.inflowpay.ai. Dịch vụ lấy khóa công khai của agent từ tài liệu này.
  • InFlow giữ các khóa riêng và ký các request của agent. Thuật toán ký là ES256.
Để tìm ra khách hàng nào đến từ InFlow, xem Nhận biết khách hàng InFlow.

Cách AEP kết nối với ODP và thanh toán

Agent thường tìm dịch vụ trước bằng ODP. Một hành động ODP hoặc một endpoint có thu phí có thể cần ghi danh. Với một endpoint có thu phí, InFlow CLI gửi credential AEP cùng với credential thanh toán.

Bắt đầu tại đây

Đặc tả và SDK

Grant cấp credential phiên bằng API key là một bản nháp.
Lần sửa đổi cuối 30 tháng 10, 2026