Leo
cdca296044
leo 07-29 指正：「現在沒有 partner key，改用 namespace，現在沒有發 API key 的機制」。
這些契約寫著 'KBDB partner key（ak_xxx）'／'租戶識別（ak_ 前綴）'＝假資訊源——
總管就是被它騙的（先把範例改成不存在的 {{credential.kbdb_partner_key}}），
不修的話下一個 AI 會再挖同一個坑。
改：kbdb_upsert_block／auth_oauth2／auth_service_account／auth_static_key 的
api_key description，改述為「租戶識別＝Arcrun namespace」＋註明 examples 裡的
ak_test/ak_nonexistent 是測試假值不代表真實格式。
只動 description，不動 schema／欄位名／gherkin_tests
（api_key 欄位名保留——改名會破壞現有 workflow）。
驗：四檔 YAML 可解析、required 不變、欄位清單不變、gherkin_tests 全保留、
ak_test 等測試值原封不動。
人閘：leo 07-29 跑 scripts/component-arm.sh 解保險授權。
72 lines
2.4 KiB
YAML
72 lines
2.4 KiB
YAML
canonical_id: "auth_static_key"
|
||
display_name: "Auth Primitive — Static Key"
|
||
category: "auth"
|
||
version: "v1"
|
||
wasi_target: "preview1"
|
||
stability: "floating"
|
||
runtime_compat:
|
||
- "cf-workers"
|
||
- "workerd"
|
||
- "wazero"
|
||
constraints:
|
||
max_size_kb: 2048
|
||
max_cold_start_ms: 50
|
||
no_network_syscall: true
|
||
no_filesystem_syscall: true
|
||
io_model: "stdin_stdout_json"
|
||
input_schema:
|
||
type: object
|
||
required: [action, api_key, service]
|
||
properties:
|
||
action:
|
||
type: string
|
||
enum: [authenticate]
|
||
description: 目前僅支援 authenticate;static_key 無 refresh 概念
|
||
api_key:
|
||
type: string
|
||
description: >-
|
||
租戶識別＝Arcrun namespace，用來組 {api_key}:cred:{name} KV key。
|
||
⚠️ 2026-07-29 更正：舊敘述寫「ak_ 前綴」，但現行沒有發 API key 的機制
|
||
（leo 07-29 指正）——namespace 即身分即憑證。下方 examples 的 ak_test/ak_nonexistent
|
||
是測試用假值，不代表真實格式。
|
||
service:
|
||
type: string
|
||
description: auth recipe 名稱,對應 auth_recipe:{service} 的 KV 記錄
|
||
request:
|
||
type: object
|
||
description: (保留)下游零件的 HTTP request 上下文;static_key 當前不使用
|
||
output_schema:
|
||
type: object
|
||
properties:
|
||
success:
|
||
type: boolean
|
||
auth_headers:
|
||
type: object
|
||
additionalProperties:
|
||
type: string
|
||
auth_query:
|
||
type: object
|
||
additionalProperties:
|
||
type: string
|
||
auth_body:
|
||
type: object
|
||
additionalProperties:
|
||
type: string
|
||
runtime:
|
||
type: object
|
||
description: Static key 不使用;欄位保留以對齊其他 auth primitive
|
||
gherkin_tests:
|
||
- scenario: "缺少 api_key"
|
||
given: '{"action":"authenticate","service":"openai"}'
|
||
then_contains: '{"success":false'
|
||
- scenario: "找不到 auth recipe"
|
||
given: '{"action":"authenticate","api_key":"ak_nonexistent","service":"nonexistent"}'
|
||
then_contains: '{"success":false'
|
||
tags: [auth, credential, primitive, static_key]
|
||
description: "Static key auth primitive。讀取 auth_recipe + 解密 required_secrets + 展開 {{secret.X}} 模板,回傳 auth_headers / auth_query / auth_body。涵蓋 Bearer token / API key / Basic auth / 自訂 header 等 80% 服務。透過 host function kv_get + crypto_decrypt,plaintext 永不離開 WASM。"
|
||
config_example: |
|
||
auth_step:
|
||
component: "auth_static_key"
|
||
action: "authenticate"
|
||
service: "openai" # 對應 auth_recipe:openai 的 KV 記錄
|