如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
總覽 智慧體存取權 ChatGPT 與 Codex 使用者文件 使用案例

安全性與隱私

開發外掛程式時應考量的安全性與隱私事項。

基本原則

外掛程式的工具可以存取使用者資料、呼叫第三方 API,以及執行寫入操作。請以正式環境軟體的標準來開發及維護每個 MCP 伺服器和使用者介面元件。

  • 最小權限: 只要求必要的授權範圍、儲存空間存取權和網路權限。
  • 使用者明確同意: 連結帳號或授予寫入權限時,請確保使用者清楚知道自己正在做什麼。執行破壞性操作前,請使用主機提供的確認提示。
  • 縱深防禦: 假設伺服器一定會收到提示注入攻擊和惡意輸入。檢查每一筆輸入,並保留稽核記錄。

資料處理

  • 結構化內容: 只納入處理目前提示詞所需的資料。避免在元件屬性中嵌入機密值或權杖。
  • 儲存: 決定使用者資料的保留期限,並公布保留政策。依使用者的刪除要求移除資料。
  • 日誌: 寫入日誌前,先遮蔽個人識別資訊(PII)。保留關聯 ID 以便偵錯。除非確有必要,否則請避免儲存提示詞原文。

提示注入與寫入操作

自訂 MCP 伺服器可提供完整的 MCP 存取權,包括使用寫入工具的權限。請採取以下措施降低風險。

  • 定期檢視工具說明,清楚標示使用限制以避免誤用,例如「請勿使用此工具刪除記錄」。
  • 即使輸入由模型提供,也要在伺服器端驗證每一筆輸入。
  • 執行無法復原的操作前,要求人工確認。

將測試提示注入時最有效的提示詞分享給 QA 團隊,讓團隊能及早找出防護弱點。

網路存取

小工具在隔離的 iframe 中執行,並受嚴格的內容安全政策(CSP)約束。小工具無法存取需要特殊權限的瀏覽器 API,例如 window.alert、window.prompt、window.confirm 或 navigator.clipboard。標準的 fetch 請求受 CSP 管控。預設無法使用巢狀框架。如需使用,請在資源的 CSP 中繼資料(例如 _meta.ui.csp.frameDomains)中明確指定允許的來源。外掛程式可以嵌入其 MCP 伺服器所屬可註冊網域下的網頁,包括既有的編輯器和管理介面。關於網域所有權、必須提供的理由及審查要求,請參閱 iframe 政策。

小工具的 CSP 會限制 iframe 可以載入哪些目的地。嵌入的網頁使用自己的 CSP。小工具的 connectDomains 和 resourceDomains 允許清單不會限制該網頁內發出的網路請求。請明確指定允許的 iframe 來源,並將嵌入的網頁及其功能納入安全審查。

伺服器端程式碼的網路存取僅受代管環境限制。對外發送請求時,請遵循一般最佳實務,包括驗證 TLS、設定重試機制和逾時期限。

身分驗證與授權

  • 整合外部帳號時,請使用 OAuth 2.1 授權碼流程。若授權伺服器支援用戶端 ID 中繼資料文件(CIMD),且外掛程式開發者選用此方式,請優先採用 CIMD。公開用戶端交換權杖時,請使用 none。若授權伺服器要求驗證用戶端身分,請使用 private_key_jwt。若外掛程式開發者選用動態用戶端註冊(DCR),或無法使用 CIMD,則須支援 DCR。
  • 每次呼叫工具時,都要驗證授權範圍,並確保操作未超出該範圍。若權杖已過期或格式錯誤,請回傳 401 回應。
  • 使用內建身分機制時,請避免儲存長期有效的機密值,改用系統提供的驗證上下文。

上線與維運準備

  • 上線前進行安全審查,尤其是處理受法規管制的資料時。
  • 監控流量是否出現異常模式,並設定警示,以便在錯誤反覆發生或驗證嘗試失敗時收到通知。
  • 及時為第三方相依套件、程式庫和建置工具套用修補程式,以降低供應鏈風險。

安全性與隱私是使用者信任的基礎。從規劃、實作到部署,每個階段都應將兩者納入工作流程,避免事後才補做。