Giao thức Gateway

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Vận chuyển

• WebSocket, khung văn bản với tải trọng JSON.
• Khung đầu tiên phải là yêu cầu connect.
• Các khung trước kết nối được giới hạn ở 64 KiB. Sau khi bắt tay thành công, client nên tuân theo các giới hạn hello-ok.policy.maxPayload và hello-ok.policy.maxBufferedBytes. Khi bật chẩn đoán, các khung đến quá cỡ và bộ đệm gửi đi chậm sẽ phát ra sự kiện payload.large trước khi gateway đóng hoặc bỏ khung bị ảnh hưởng. Các sự kiện này giữ lại kích thước, giới hạn, bề mặt và mã lý do an toàn. Chúng không giữ nội dung thông điệp, nội dung tệp đính kèm, thân khung thô, token, cookie hoặc giá trị bí mật.

​

Bắt tay (connect)

{
  "type": "event",
  "event": "connect.challenge",
  "payload": { "nonce": "…", "ts": 1737264000000 }
}

{
  "type": "req",
  "id": "…",
  "method": "connect",
  "params": {
    "minProtocol": 3,
    "maxProtocol": 4,
    "client": {
      "id": "cli",
      "version": "1.2.3",
      "platform": "macos",
      "mode": "operator"
    },
    "role": "operator",
    "scopes": ["operator.read", "operator.write"],
    "caps": [],
    "commands": [],
    "permissions": {},
    "auth": { "token": "…" },
    "locale": "en-US",
    "userAgent": "openclaw-cli/1.2.3",
    "device": {
      "id": "device_fingerprint",
      "publicKey": "…",
      "signature": "…",
      "signedAt": 1737264000000,
      "nonce": "…"
    }
  }
}

{
  "type": "res",
  "id": "…",
  "ok": true,
  "payload": {
    "type": "hello-ok",
    "protocol": 4,
    "server": { "version": "…", "connId": "…" },
    "features": { "methods": ["…"], "events": ["…"] },
    "snapshot": { "…": "…" },
    "auth": {
      "role": "operator",
      "scopes": ["operator.read", "operator.write"]
    },
    "policy": {
      "maxPayload": 26214400,
      "maxBufferedBytes": 52428800,
      "tickIntervalMs": 15000
    }
  }
}

{
  "auth": {
    "role": "operator",
    "scopes": ["operator.read", "operator.write"]
  }
}

{
  "auth": {
    "deviceToken": "…",
    "role": "operator",
    "scopes": ["operator.read", "operator.write"]
  }
}

{
  "auth": {
    "deviceToken": "…",
    "role": "node",
    "scopes": [],
    "deviceTokens": [
      {
        "deviceToken": "…",
        "role": "operator",
        "scopes": ["operator.approvals", "operator.read", "operator.talk.secrets", "operator.write"]
      }
    ]
  }
}

​

Ví dụ Node

{
  "type": "req",
  "id": "…",
  "method": "connect",
  "params": {
    "minProtocol": 3,
    "maxProtocol": 4,
    "client": {
      "id": "ios-node",
      "version": "1.2.3",
      "platform": "ios",
      "mode": "node"
    },
    "role": "node",
    "scopes": [],
    "caps": ["camera", "canvas", "screen", "location", "voice"],
    "commands": ["camera.snap", "canvas.navigate", "screen.record", "location.get"],
    "permissions": { "camera.capture": true, "screen.record": false },
    "auth": { "token": "…" },
    "locale": "en-US",
    "userAgent": "openclaw-ios/1.2.3",
    "device": {
      "id": "device_fingerprint",
      "publicKey": "…",
      "signature": "…",
      "signedAt": 1737264000000,
      "nonce": "…"
    }
  }
}

​

Đóng khung

• Yêu cầu: {type:"req", id, method, params}
• Phản hồi: {type:"res", id, ok, payload|error}
• Sự kiện: {type:"event", event, payload, seq?, stateVersion?}

​

Role + phạm vi

​

Role

• operator = client mặt phẳng điều khiển (CLI/UI/tự động hóa).
• node = máy chủ capability (camera/screen/canvas/system.run).

​

Phạm vi (operator)

• operator.read
• operator.write
• operator.admin
• operator.approvals
• operator.pairing
• operator.talk.secrets

• yêu cầu không có lệnh: operator.pairing
• yêu cầu có lệnh Node không phải exec: operator.pairing + operator.write
• yêu cầu bao gồm system.run, system.run.prepare hoặc system.which: operator.pairing + operator.admin

​

Caps/commands/permissions (Node)

• caps: các danh mục capability cấp cao như camera, canvas, screen, location, voice và talk.
• commands: allowlist lệnh cho invoke.
• permissions: các công tắc chi tiết (ví dụ: screen.record, camera.capture).

​

Hiện diện

• system-presence trả về các mục được khóa theo danh tính thiết bị.
• Mục hiện diện bao gồm deviceId, roles và scopes để UI có thể hiển thị một hàng duy nhất cho mỗi thiết bị ngay cả khi thiết bị đó kết nối vừa là operator vừa là node.
• node.list bao gồm các trường tùy chọn lastSeenAtMs và lastSeenReason. Node đã kết nối báo cáo thời gian kết nối hiện tại của chúng dưới dạng lastSeenAtMs với lý do connect; Node đã ghép cặp cũng có thể báo cáo hiện diện nền bền vững khi một sự kiện Node đáng tin cậy cập nhật metadata ghép cặp của chúng.

​

Sự kiện Node sống trong nền

{
  "event": "node.presence.alive",
  "payloadJSON": "{\"trigger\":\"silent_push\",\"sentAtMs\":1737264000000,\"displayName\":\"Peter's iPhone\",\"version\":\"2026.4.28\",\"platform\":\"iOS 18.4.0\",\"deviceFamily\":\"iPhone\",\"modelIdentifier\":\"iPhone17,1\",\"pushTransport\":\"relay\"}"
}

{
  "ok": true,
  "event": "node.presence.alive",
  "handled": true,
  "reason": "persisted"
}

​

Phạm vi sự kiện broadcast

• Khung chat, agent và kết quả công cụ (bao gồm các sự kiện agent được stream và kết quả gọi công cụ) yêu cầu ít nhất operator.read. Các phiên không có operator.read bỏ qua hoàn toàn các khung này.
• Broadcast plugin.* do Plugin định nghĩa được kiểm soát theo operator.write hoặc operator.admin, tùy theo cách Plugin đăng ký chúng.
• Sự kiện trạng thái và vận chuyển (heartbeat, presence, tick, vòng đời kết nối/ngắt kết nối, v.v.) vẫn không bị hạn chế để mọi phiên đã xác thực đều quan sát được sức khỏe vận chuyển.
• Các họ sự kiện broadcast không xác định mặc định bị kiểm soát theo phạm vi (fail-closed) trừ khi một handler đã đăng ký nới lỏng chúng một cách tường minh.

​

Các họ method RPC phổ biến

​

Các nhóm sự kiện thường gặp

• chat: các cập nhật trò chuyện UI như chat.inject và các sự kiện trò chuyện chỉ thuộc bản ghi khác.
• session.message và session.tool: các cập nhật bản ghi/luồng sự kiện cho một phiên đã đăng ký.
• sessions.changed: chỉ mục phiên hoặc siêu dữ liệu đã thay đổi.
• presence: các cập nhật snapshot hiện diện hệ thống.
• tick: sự kiện keepalive / liveness định kỳ.
• health: cập nhật snapshot tình trạng gateway.
• heartbeat: cập nhật luồng sự kiện heartbeat.
• cron: sự kiện thay đổi lượt chạy/tác vụ cron.
• shutdown: thông báo tắt gateway.
• node.pair.requested / node.pair.resolved: vòng đời ghép cặp node.
• node.invoke.request: phát quảng bá yêu cầu gọi node.
• device.pair.requested / device.pair.resolved: vòng đời thiết bị đã ghép cặp.
• voicewake.changed: cấu hình kích hoạt bằng wake-word đã thay đổi.
• exec.approval.requested / exec.approval.resolved: vòng đời phê duyệt exec.
• plugin.approval.requested / plugin.approval.resolved: vòng đời phê duyệt plugin.

​

Phương thức trợ giúp Node

• Nodes có thể gọi skills.bins để lấy danh sách hiện tại của các tệp thực thi skill phục vụ kiểm tra tự động cho phép.

​

RPC sổ cái tác vụ

• tasks.list yêu cầu operator.read.
  • Tham số: status tùy chọn ("queued", "running", "completed", "failed", "cancelled" hoặc "timed_out") hoặc một mảng các trạng thái đó, agentId tùy chọn, sessionKey tùy chọn, limit tùy chọn từ 1 đến 500, và chuỗi cursor tùy chọn.
  • Kết quả: { "tasks": TaskSummary[], "nextCursor"?: string }.
• tasks.get yêu cầu operator.read.
  • Tham số: { "taskId": string }.
  • Kết quả: { "task": TaskSummary }.
  • Id tác vụ bị thiếu trả về dạng lỗi not-found của Gateway.
• tasks.cancel yêu cầu operator.write.
  • Tham số: { "taskId": string, "reason"?: string }.
  • Kết quả: { "found": boolean, "cancelled": boolean, "reason"?: string, "task"?: TaskSummary }.
  • found báo cáo liệu sổ cái có tác vụ khớp hay không. cancelled báo cáo liệu runtime đã chấp nhận hoặc ghi nhận việc hủy hay chưa.

​

Phương thức trợ giúp cho operator

• Operators có thể gọi commands.list (operator.read) để lấy danh mục lệnh runtime cho một agent.
  • agentId là tùy chọn; bỏ qua để đọc workspace agent mặc định.
  • scope điều khiển bề mặt mà name chính nhắm tới:
    • text trả về token lệnh văn bản chính không có / ở đầu
    • native và đường dẫn both mặc định trả về tên native nhận biết provider khi có
  • textAliases mang các alias slash chính xác như /model và /m.
  • nativeName mang tên lệnh native nhận biết provider khi tồn tại.
  • provider là tùy chọn và chỉ ảnh hưởng đến cách đặt tên native cùng khả năng sẵn có của lệnh plugin native.
  • includeArgs=false bỏ siêu dữ liệu đối số đã tuần tự hóa khỏi phản hồi.
• Operators có thể gọi tools.catalog (operator.read) để lấy danh mục công cụ runtime cho một agent. Phản hồi bao gồm các công cụ đã nhóm và siêu dữ liệu nguồn gốc:
  • source: core hoặc plugin
  • pluginId: chủ sở hữu plugin khi source="plugin"
  • optional: liệu công cụ plugin có tùy chọn hay không
• Operators có thể gọi tools.effective (operator.read) để lấy danh mục công cụ có hiệu lực runtime cho một phiên.
  • sessionKey là bắt buộc.
  • gateway suy ra ngữ cảnh runtime đáng tin cậy từ phiên ở phía máy chủ thay vì chấp nhận ngữ cảnh xác thực hoặc phân phối do bên gọi cung cấp.
  • Phản hồi được giới hạn theo phiên và phản ánh những gì cuộc hội thoại đang hoạt động có thể dùng ngay bây giờ, bao gồm công cụ core, plugin và kênh.
• Operators có thể gọi tools.invoke (operator.write) để gọi một công cụ có sẵn thông qua cùng đường dẫn chính sách gateway như /tools/invoke.
  • name là bắt buộc. args, sessionKey, agentId, confirm và idempotencyKey là tùy chọn.
  • Nếu cả sessionKey và agentId đều có mặt, agent của phiên đã phân giải phải khớp agentId.
  • Phản hồi là một envelope hướng tới SDK với ok, toolName, output tùy chọn, và các trường error có kiểu. Từ chối do phê duyệt hoặc chính sách trả về ok:false trong payload thay vì bỏ qua pipeline chính sách công cụ gateway.
• Operators có thể gọi skills.status (operator.read) để lấy danh mục skill hiển thị cho một agent.
  • agentId là tùy chọn; bỏ qua để đọc workspace agent mặc định.
  • Phản hồi bao gồm điều kiện đủ, yêu cầu còn thiếu, kiểm tra cấu hình, và tùy chọn cài đặt đã được làm sạch mà không để lộ giá trị bí mật thô.
• Operators có thể gọi skills.search và skills.detail (operator.read) để lấy siêu dữ liệu khám phá ClawHub.
• Operators có thể gọi skills.upload.begin, skills.upload.chunk và skills.upload.commit (operator.admin) để stage một kho lưu trữ skill riêng tư trước khi cài đặt. Đây là đường dẫn tải lên admin riêng cho các client đáng tin cậy, không phải luồng cài đặt skill ClawHub thông thường, và mặc định bị tắt trừ khi skills.install.allowUploadedArchives được bật.
  • skills.upload.begin({ kind: "skill-archive", slug, sizeBytes, sha256?, force?, idempotencyKey? }) tạo một lượt tải lên gắn với slug và giá trị force đó.
  • skills.upload.chunk({ uploadId, offset, dataBase64 }) nối byte tại offset đã giải mã chính xác.
  • skills.upload.commit({ uploadId, sha256? }) xác minh kích thước cuối cùng và SHA-256. Commit chỉ hoàn tất lượt tải lên; nó không cài đặt skill.
  • Kho lưu trữ skill đã tải lên là kho lưu trữ zip chứa một gốc SKILL.md. Tên thư mục nội bộ của kho lưu trữ không bao giờ chọn đích cài đặt.
• Operators có thể gọi skills.install (operator.admin) ở ba chế độ:
  • Chế độ ClawHub: { source: "clawhub", slug, version?, force? } cài đặt một thư mục skill vào thư mục skills/ của workspace agent mặc định.
  • Chế độ tải lên: { source: "upload", uploadId, slug, force?, sha256?, timeoutMs? } cài đặt một lượt tải lên đã commit vào thư mục skills/<slug> của workspace agent mặc định. slug và giá trị force phải khớp yêu cầu skills.upload.begin ban đầu. Chế độ này bị từ chối trừ khi skills.install.allowUploadedArchives được bật. Thiết lập này không ảnh hưởng đến các cài đặt ClawHub.
  • Chế độ trình cài đặt Gateway: { name, installId, dangerouslyForceUnsafeInstall?, timeoutMs? } chạy một hành động metadata.openclaw.install đã khai báo trên host gateway.
• Operators có thể gọi skills.update (operator.admin) ở hai chế độ:
  • Chế độ ClawHub cập nhật một slug được theo dõi hoặc tất cả cài đặt ClawHub được theo dõi trong workspace agent mặc định.
  • Chế độ cấu hình vá các giá trị skills.entries.<skillKey> như enabled, apiKey và env.

​

Chế độ xem models.list

• Bỏ qua hoặc "default": hành vi runtime hiện tại. Nếu agents.defaults.models được cấu hình, phản hồi là catalog được phép, bao gồm các model được phát hiện động cho các mục provider/*. Nếu không, phản hồi là toàn bộ catalog Gateway.
• "configured": hành vi có kích thước phù hợp cho bộ chọn. Nếu agents.defaults.models được cấu hình, nó vẫn được ưu tiên, bao gồm khám phá theo phạm vi provider cho các mục provider/*. Khi không có danh sách cho phép, phản hồi dùng các mục models.providers.*.models rõ ràng, chỉ fallback về toàn bộ catalog khi không tồn tại hàng model đã cấu hình nào.
• "all": toàn bộ catalog Gateway, bỏ qua agents.defaults.models. Dùng chế độ này cho chẩn đoán và UI khám phá, không phải các bộ chọn model thông thường.

​

Phê duyệt exec

• Khi một yêu cầu exec cần phê duyệt, gateway phát quảng bá exec.approval.requested.
• Client vận hành phân giải bằng cách gọi exec.approval.resolve (yêu cầu phạm vi operator.approvals).
• Với host=node, exec.approval.request phải bao gồm systemRunPlan (argv/cwd/rawCommand/siêu dữ liệu phiên chuẩn). Các yêu cầu thiếu systemRunPlan bị từ chối.
• Sau khi phê duyệt, các lệnh gọi node.invoke system.run được chuyển tiếp sẽ tái sử dụng systemRunPlan chuẩn đó làm ngữ cảnh lệnh/cwd/phiên có thẩm quyền.
• Nếu bên gọi chỉnh sửa command, rawCommand, cwd, agentId hoặc sessionKey giữa bước chuẩn bị và lần chuyển tiếp system.run đã phê duyệt cuối cùng, gateway từ chối lượt chạy thay vì tin vào payload đã bị chỉnh sửa.

​

Fallback phân phối agent

• Các yêu cầu agent có thể bao gồm deliver=true để yêu cầu phân phối đi.
• bestEffortDeliver=false giữ hành vi nghiêm ngặt: các đích phân phối không phân giải được hoặc chỉ nội bộ trả về INVALID_REQUEST.
• bestEffortDeliver=true cho phép fallback về thực thi chỉ trong phiên khi không thể phân giải tuyến có thể phân phối ra bên ngoài (ví dụ phiên nội bộ/webchat hoặc cấu hình đa kênh mơ hồ).
• Kết quả agent cuối cùng có thể bao gồm result.deliveryStatus khi đã yêu cầu phân phối, dùng cùng các trạng thái sent, suppressed, partial_failed và failed được ghi tài liệu cho openclaw agent --json --deliver.

​

Phiên bản hóa

• PROTOCOL_VERSION nằm trong src/gateway/protocol/version.ts.
• Clients gửi minProtocol + maxProtocol; máy chủ từ chối các khoảng không bao gồm giao thức hiện tại của nó. Client native dùng giới hạn dưới v3 để các client v4 bổ sung vẫn có thể truy cập gateway v3.
• Schemas + models được tạo từ các định nghĩa TypeBox:
  • pnpm protocol:gen
  • pnpm protocol:gen:swift
  • pnpm protocol:check

​

Hằng số client

​

Xác thực

• Xác thực Gateway bằng bí mật dùng chung sử dụng connect.params.auth.token hoặc connect.params.auth.password, tùy theo chế độ xác thực đã cấu hình.
• Các chế độ mang định danh như Tailscale Serve (gateway.auth.allowTailscale: true) hoặc gateway.auth.mode: "trusted-proxy" không phải loopback đáp ứng kiểm tra xác thực kết nối từ header yêu cầu thay vì connect.params.auth.*.
• gateway.auth.mode: "none" cho ingress riêng tư bỏ qua hoàn toàn xác thực kết nối bằng bí mật dùng chung; không để lộ chế độ đó trên ingress công khai/không tin cậy.
• Sau khi ghép cặp, Gateway cấp một mã thông báo thiết bị giới hạn theo vai trò + phạm vi kết nối. Nó được trả về trong hello-ok.auth.deviceToken và nên được client lưu giữ cho các lần kết nối sau.
• Client nên lưu giữ hello-ok.auth.deviceToken chính sau bất kỳ lần kết nối thành công nào.
• Kết nối lại bằng mã thông báo thiết bị đã lưu đó cũng nên tái sử dụng tập phạm vi đã phê duyệt được lưu cho mã thông báo đó. Điều này bảo toàn quyền truy cập đọc/thăm dò/trạng thái đã được cấp và tránh âm thầm thu hẹp các lần kết nối lại thành một phạm vi ngầm định chỉ dành cho quản trị hẹp hơn.
• Tập hợp xác thực kết nối phía client (selectConnectAuth trong src/gateway/client.ts):
  • auth.password độc lập và luôn được chuyển tiếp khi được đặt.
  • auth.token được điền theo thứ tự ưu tiên: mã thông báo dùng chung tường minh trước, sau đó là deviceToken tường minh, rồi đến mã thông báo theo từng thiết bị đã lưu (khóa theo deviceId + role).
  • auth.bootstrapToken chỉ được gửi khi không có mục nào ở trên phân giải được auth.token. Một mã thông báo dùng chung hoặc bất kỳ mã thông báo thiết bị nào đã phân giải sẽ chặn nó.
  • Tự động nâng cấp một mã thông báo thiết bị đã lưu trong lần thử lại một lần AUTH_TOKEN_MISMATCH chỉ được cho phép với endpoint tin cậy — loopback, hoặc wss:// có tlsFingerprint được ghim. wss:// công khai không có ghim không đủ điều kiện.
• Các mục hello-ok.auth.deviceTokens bổ sung là mã thông báo bàn giao bootstrap. Chỉ lưu giữ chúng khi kết nối đã dùng xác thực bootstrap trên một transport tin cậy như wss:// hoặc ghép cặp loopback/cục bộ.
• Nếu client cung cấp deviceToken tường minh hoặc scopes tường minh, tập phạm vi do bên gọi yêu cầu đó vẫn có thẩm quyền; phạm vi đã lưu trong cache chỉ được tái sử dụng khi client đang tái sử dụng mã thông báo theo từng thiết bị đã lưu.
• Có thể xoay vòng/thu hồi mã thông báo thiết bị qua device.token.rotate và device.token.revoke (yêu cầu phạm vi operator.pairing).
• device.token.rotate trả về siêu dữ liệu xoay vòng. Nó chỉ phản hồi lại mã thông báo bearer thay thế cho các lệnh gọi cùng thiết bị đã được xác thực bằng mã thông báo thiết bị đó, để các client chỉ dùng mã thông báo có thể lưu giữ mã thay thế trước khi kết nối lại. Các lần xoay vòng dùng shared/admin không phản hồi lại mã thông báo bearer.
• Việc cấp, xoay vòng và thu hồi mã thông báo luôn bị giới hạn trong tập vai trò đã phê duyệt được ghi trong mục ghép cặp của thiết bị đó; việc thay đổi mã thông báo không thể mở rộng hoặc nhắm tới một vai trò thiết bị mà phê duyệt ghép cặp chưa từng cấp.
• Với phiên mã thông báo thiết bị đã ghép cặp, quản lý thiết bị được tự giới hạn phạm vi trừ khi bên gọi cũng có operator.admin: bên gọi không phải quản trị chỉ có thể xóa/thu hồi/xoay vòng mục thiết bị của chính họ.
• device.token.rotate và device.token.revoke cũng kiểm tra tập phạm vi mã thông báo operator mục tiêu so với phạm vi phiên hiện tại của bên gọi. Bên gọi không phải quản trị không thể xoay vòng hoặc thu hồi một mã thông báo operator rộng hơn phạm vi họ đang có.
• Lỗi xác thực bao gồm error.details.code cùng gợi ý khôi phục:
  • error.details.canRetryWithDeviceToken (boolean)
  • error.details.recommendedNextStep (retry_with_device_token, update_auth_configuration, update_auth_credentials, wait_then_retry, review_auth_configuration)
• Hành vi client đối với AUTH_TOKEN_MISMATCH:
  • Client tin cậy có thể thử lại một lần có giới hạn bằng mã thông báo theo từng thiết bị đã lưu trong cache.
  • Nếu lần thử lại đó thất bại, client nên dừng vòng lặp tự động kết nối lại và hiển thị hướng dẫn hành động cho operator.
• AUTH_SCOPE_MISMATCH nghĩa là mã thông báo thiết bị đã được nhận diện nhưng không bao phủ vai trò/phạm vi được yêu cầu. Client không nên trình bày lỗi này như một mã thông báo sai; hãy nhắc operator ghép cặp lại hoặc phê duyệt hợp đồng phạm vi hẹp/rộng hơn.

​

Định danh thiết bị + ghép cặp

• Node nên bao gồm một định danh thiết bị ổn định (device.id) được dẫn xuất từ fingerprint của keypair.
• Gateway cấp mã thông báo theo thiết bị + vai trò.
• Cần phê duyệt ghép cặp cho ID thiết bị mới trừ khi bật tự động phê duyệt cục bộ.
• Tự động phê duyệt ghép cặp xoay quanh các kết nối local loopback trực tiếp.
• OpenClaw cũng có một đường tự kết nối hẹp, cục bộ với backend/container cho các luồng helper dùng bí mật dùng chung tin cậy.
• Các kết nối tailnet hoặc LAN cùng máy chủ vẫn được xem là từ xa cho mục đích ghép cặp và yêu cầu phê duyệt.
• Client WS thường bao gồm định danh device trong connect (operator + node). Các ngoại lệ operator không có thiết bị duy nhất là các đường tin cậy tường minh:
  • gateway.controlUi.allowInsecureAuth=true cho khả năng tương thích HTTP không an toàn chỉ trên localhost.
  • xác thực Control UI của operator bằng gateway.auth.mode: "trusted-proxy" thành công.
  • gateway.controlUi.dangerouslyDisableDeviceAuth=true (break-glass, hạ cấp bảo mật nghiêm trọng).
  • RPC backend gateway-client direct-loopback được xác thực bằng mã thông báo/mật khẩu Gateway dùng chung.
• Tất cả kết nối phải ký nonce connect.challenge do server cung cấp.

​

Chẩn đoán di chuyển xác thực thiết bị

• Luôn chờ connect.challenge.
• Ký payload v2 có bao gồm nonce của server.
• Gửi cùng nonce đó trong connect.params.device.nonce.
• Payload chữ ký ưu tiên là v3, ràng buộc platform và deviceFamily ngoài các trường device/client/role/scopes/token/nonce.
• Chữ ký v2 cũ vẫn được chấp nhận để tương thích, nhưng việc ghim siêu dữ liệu thiết bị đã ghép cặp vẫn kiểm soát chính sách lệnh khi kết nối lại.

​

TLS + ghim

• TLS được hỗ trợ cho kết nối WS.
• Client có thể tùy chọn ghim fingerprint chứng chỉ Gateway (xem cấu hình gateway.tls cùng gateway.remote.tlsFingerprint hoặc CLI --tls-fingerprint).

​

Phạm vi

​

Liên quan

• Giao thức bridge
• Runbook Gateway