Kết nối dự án.
Điều phối tác vụ.
Giữ quyền kiểm soát.

Gọi API đầu tiên

Đặt token được cấp trong cấu hình bí mật của backend. FTC và các dự án khác gọi FTA từ server; giao diện người dùng giữ phiên đăng nhập của dự án.

# FTA_TOKEN được nạp từ secret của backend
curl --fail --silent --show-error \
  'https://api.flytrust-agent.io.vn/v1/projects' \
  -H "Authorization: Bearer $FTA_TOKEN"

import { RuntimeClient } from '@flytrust/agent-runtime/client';

const fta = new RuntimeClient(
  'https://api.flytrust-agent.io.vn', // origin, không thêm /v1
  process.env.FTA_RUNTIME_OPERATOR_TOKEN
);
const projects = await fta.projects();

Token server, quyền rõ ràng

Gửi Authorization: Bearer <token>. Chỉ health và OpenAPI của runtime là public. Token được cấp qua cấu hình quản trị FTA; chưa có đăng ký hoặc phát hành token tự phục vụ trên portal.

• Cấp token riêng từng tích hợp với projectIds phù hợp; token FTC hiện dùng project ftc-runtime.
• Token và signing secret nằm trong env/secret phía server. Không ghi vào URL, browser, bundle, Git hay log.
• Project scope thuộc một trusted operator realm. FTC tiếp tục cưỡng chế workspace, revision và quyền nghiệp vụ của mình.

Từ model đến kết quả

POST /v1/runs
Authorization: Bearer <operator-token>
Idempotency-Key: ftc-intent-unique-business-id
Content-Type: application/json

{ "planId": "plan-created-and-validated-earlier" }

DRY_RUN trả SIMULATED. LIVE kiểm tra CONTRACT_VERIFIED theo output contract; hiệu quả nghiệp vụ được theo dõi bằng dữ liệu kết quả của dự án.

Đấu nối capability của dự án

ADMIN đăng ký project với adapter HTTP_JSON, origin HTTPS, path capability và tên env chứa signing secret. Receiver kiểm tra HMAC, input, workspace/revision và intent nghiệp vụ đã được dự án cấp quyền.

x-fta-run-id          x-fta-step-id
x-idempotency-key     x-fta-timestamp
x-fta-signature

# HMAC-SHA256 của 7 dòng nối bằng LF, không LF cuối:
METHOD
pathname + query
ISO timestamp
idempotency key
run id
step id
SHA256(raw body)

• Verify raw body và timestamp trong ±5 phút; dùng timing-safe comparison.
• Signing secret cho FTA → receiver khác Bearer token cho client → FTA.
• Deduplicate bền vững cùng key/payload; khác payload trả 409. Commit nghiệp vụ và receipt nguyên tử.
• Chỉ trả output accepted khi đã commit. Callback có chữ ký vẫn cần qua gate nghiệp vụ của dự án.

Hiểu lỗi, giữ đúng trạng thái

Runtime hiện dùng một tiến trình với state bền vững, tối đa 4 run READY/RUNNING cùng lúc. Cần thiết kế transaction database/queue trước khi mở rộng thành nhiều replica.