驗證憑證語意
本文件定義了以下元件共用的憑證資格判定與解析語意:
resolveAuthProfileOrderresolveApiKeyForProfilemodels status --probedoctor-auth
目標是讓選擇階段與執行階段的行為保持一致。
穩定的原因代碼
okmissing_credentialinvalid_expiresexpiredunresolved_ref
Token 憑證
Token 憑證(type: "token")支援內嵌 token 和/或 tokenRef。
資格規則
- 當
token和tokenRef都不存在時,該 token 設定檔不合格。 expires為選填。- 若提供了
expires,其值必須是大於0的有限數字。 - 若
expires無效(NaN、0、負數、非有限值或型別錯誤),該設定檔會以invalid_expires標記為不合格。 - 若
expires已過期,該設定檔會以expired標記為不合格。 tokenRef不會跳過expires的驗證。
解析規則
- 解析器對
expires的語意與資格判定一致。 - 對於合格的設定檔,token 內容可從內嵌值或
tokenRef取得。 - 無法解析的參照會在
models status --probe輸出中產生unresolved_ref。
向下相容的訊息格式
為了與既有腳本相容,探測錯誤的第一行維持不變:
Auth profile credentials are missing or expired.
後續行可附加人類可讀的詳細資訊與穩定的原因代碼。