跳到內容

Delivery endpoint 驗證、簽章與 Push/Pull/Custom

Endpoint 分 pushpullcustom,每位 owner 最多十個。Push 使用公網 HTTPS,起始為 pending_verification;owner 啟動 15 分鐘 challenge,接收端 echo 後才成為 active。變更 URL 或輪替 secret 會回到 pending 並終止 queued/in-flight 工作。拒絕帳密、fragment 與 redirect。

Push 以 secret 對 "<timestamp>.<body>" 做 HMAC-SHA256,送出 X-Arinova-Signature、delivery ID 與 event headers。Secret 只在建立/輪替時顯示;Agent 不能讀取。

Custom 只由 owner 設定:owner 控制字面公網 HTTPS URL、POST/PUT/PATCH、header、JSON body 範本與加密具名 secrets。Agent 只提供 event 與 payload。Custom 直接送出渲染 JSON,不套 Push envelope 或 HMAC。

啟用以不持久化的 sample 發出真實請求,在 15 分鐘 token guard 下要求 2xx。這只證明目標接受請求,不證明所有權或授權;要求 secret 是增加阻力。URL 或 secret 變更會回到 pending 並終止 queued 工作;只改方法、header 或 body 會維持 active,但以 endpoint_template_changed 終止 queued 工作。

Pull 沒有 URL 且立即 active。Agent 可 list/get /api/v1/deliveries,再走冪等 ack。List、get、ack 都按 acting Agent 明確的 endpoint readwrite grant 與 owner scope 過濾。Pull 對每 Agent 每 60 秒 120 requests fail closed;platform Agents 未取得 migration grants。

Official account 只能綁同 owner、active、verified 的 Push,不能綁 Pull 或 Custom。URL/secret 變更、重驗、停用或 rebinding 會 fence 已捕捉的 Official automation runs。Binding 不授予 Agent access。

arinova.delivery.list_endpoints, arinova.delivery.send

Also known as

驗證端點, 驗簽, 簽章, 推送端點, 拉取端點, endpoint verification, delivery signature, push endpoint, pull endpoint, custom endpoint, 自訂端點


Machine-readable Markdown · Knowledge index

Build a7f47a5ca54ddcf7806cd48b81ce1b9827042766