dsh-break-glass-settlement-proof：離線驗證緊急訪問會話結算證據

前言¶

在 DSH 插件開發或智能體運維中，緊急訪問（Break-glass）場景的審計是一個關鍵環節。我們需要確認一個會話是否在聲明的生命週期內被正確關閉，且僅執行了允許的操作。本插件提供了驗證這些結算證據的工具。

這是什麼¶

dsh-break-glass-settlement-proof 是一個 DSH 插件，由用戶 dongsheng123132 維護。它的核心功能是提供離線的、確定性的證據，用於驗證用戶提供的 break-glass 會話關閉證據。它不負責認證收據的真實性，也不提供訪問控制，只做驗證工作。

核心功能¶

插件主要提供以下能力：

1. 離線證據驗證：提供離線、確定性的證據，用於會話結算。
2. 生命週期檢查：驗證會話的激活、終止和過期狀態。
3. 操作審計：檢查活躍區間內的操作是否在允許列表中。
4. 權限吊銷驗證：驗證所有聲明的權限是否在關閉前被吊銷，且吊銷收據非零。
5. 工具支持：提供 DSH 原生工具和 MCP 工具，包括 dsh_break_glass_inspect、dsh_break_glass_verify、break_glass_inspect 和 break_glass_verify。
6. 安全報告：生成內容尋址且經過脫敏的報告。

安裝與啓用¶

安裝需要使用 DSH 插件命令，並指定絕對路徑。命令如下：

dsh plugin --profile <profile> add /absolute/path/to/dsh-break-glass-settlement-proof

典型用法¶

安裝後，可以通過 CLI 或代碼調用插件提供的功能。根據文檔，典型用法如下：

node bin/dsh-break-glass-settlement-proof.mjs inspect examples/settled.json
node bin/dsh-break-glass-settlement-proof.mjs verify examples/settled.json

適用場景與注意¶

• 適用場景：適用於需要審計 break-glass 會話是否合規關閉的場景，特別是安全運營和合規審計。
• 注意事項：
  • 本插件不是身份提供者或特權訪問管理器，不會授予、激活、批准或吊銷訪問權限。
  • 它僅驗證提供的結算數據，不驗證收據本身的真實性（即不進行身份認證）。
  • 不查詢實時身份基礎設施。
  • residualGrantCount: 0 僅是所提供關閉證據中的聲明，不代表事實。
  • 使用前請檢查源碼和許可證（MIT）。

結尾¶

該插件通過提供離線的確定性驗證手段，幫助開發者和管理員在不依賴實時基礎設施的情況下，快速覈查 break-glass 會話的結算狀態。如需瞭解更多細節，請參考 GitHub 倉庫。