OpenAI

API 平台的管理與稽核日誌 API

在 API 平台組織中取得稽核日誌,並執行管理操作。

更新日期:21 days ago

管理員 API 功能

Admin API 可讓組織擁有者與資安團隊以程式化方式管理其 OpenAI 組織,強制執行既有的身分識別與存取管理政策,提升安全性並滿足合規要求。

透過 Admin API,他們可以:

  • 列出、建立、擷取、刪除組織中的Invite。

  • 列出、建立、更新、擷取及刪除組織中的使用者。

    • 更新組織中現有使用者的角色。

  • 列出、新增、更新、擷取及封存組織中的專案。

  • 列出、新增、擷取及移除專案中的使用者。

  • 列出、建立、擷取及刪除專案中的 Service Account。

  • 列出、擷取及刪除專案中的 API 金鑰。

  • 列出、建立、擷取及刪除組織中的 Admin API 金鑰。

若想了解更多資訊,請參閱我們的 Admin API 說明文件。

如何為我的組織建立管理員 API 金鑰?

組織擁有者可以在 API 平台儀表板中,依序選取左側面板的 管理員金鑰,再選取頁面左上方的「建立新的管理員金鑰」,即可建立管理員 API 金鑰。若想了解更多資訊,請參閱我們的 Admin API 說明文件。

Admin keys page listing organization admin API keys with a Create new admin key button

誰可以使用管理員 API 金鑰?

只有組織擁有者可以建立管理員 API 金鑰。管理員 API 金鑰可用於使用所需的管理範圍來驗證管理員 API 請求。

深入了解 API 組織中的使用者角色。

可以復原我透過 Admin API 刪除的資料嗎?

刪除的資料無法復原。此 API 不提供刪除 OpenAI 中稽核或安全性記錄的任何資料的功能。所有經過身分驗證的 API 要求都會記錄下來,確保安全性和合規性。當使用此 API 刪除項目時,它也會從所有內部搜尋和檢索索引中移除。

當我使用 Admin API 刪除資料後,OpenAI 會保存我的資料多久?

在收到刪除要求後,資料最多會在內部保留 30 天。

我不小心遺失了 Admin API 金鑰,該怎麼重新取得?

如果 API 金鑰遺失,將無法找回。我們建議你從「管理員金鑰」中刪除先前的金鑰,並建立新的金鑰。

稽核記錄功能

稽核記錄 API 可讓安全團隊完整掌握其 OpenAI 組織的狀態,透過提供不可變且可供稽核的事件記錄,協助識別安全性問題、合規風險,以及營運程序中的缺口。透過稽核記錄 API,他們可以追蹤:

  • API 金鑰的生命週期:建立、更新與刪除。

  • 帳戶邀請 — 邀請送出、接受或刪除的時間。

  • 使用者和服務帳戶的生命週期:建立、更新、刪除、角色指派與變更。

  • 登入與登出失敗。

  • 組織設定的更新。

  • 專案的生命週期:建立、更新與封存。

請參閱我們的稽核日誌文件,了解更多資訊。

如何為我的組織啟用稽核記錄功能?

請注意:一旦為你的 API 平台組織啟用稽核日誌,就無法停用。只有組織擁有者可以聯絡支援團隊以停用稽核日誌。

組織擁有者可以前往其 「組織設定 -> 資料控管 -> 資料保留」,並在底部「稽核日誌」下開啟「啟用」,以啟用稽核日誌。儲存你的選擇後,你的 API 平台組織將啟用稽核日誌功能。


請參閱我們的稽核日誌文件以瞭解詳情。

Data controls Data retention tab with API call logging set to Enabled per call

誰可以使用稽核日誌 API 金鑰?

只有組織擁有者才能建立並使用管理員 API 金鑰,以存取稽核紀錄。請注意,必須啟用稽核記錄功能,才能接收稽核記錄資料。深入了解 API 組織中的使用者角色。

API Platform 稽核日誌會保留多久?

API Platform 稽核記錄目前沒有固定的保留期間或已設定的 TTL。OpenAI 會盡力而為,在這些稽核記錄仍可用期間予以保留,但不保證其永久可用性。由於稽核記錄可用於長期的安全性、合規性與管理審查,OpenAI 不會在短暫的固定時間範圍後自動刪除這些記錄。需要基於自身保留、法規遵循或電子蒐證政策取得稽核記錄的客戶,應匯出副本並儲存在自己的系統中。API Platform 稽核記錄會記錄管理與組織設定事件,例如使用者、專案、API 金鑰、服務帳戶和組織設定的變更。它們與 API 請求與回應中的客戶內容是分開的。

零資料保留是否會影響 API 平台稽核記錄?

不會。零資料保留不會變更 API Platform 稽核日誌的可用性、保留行為或事件內容。零資料保留適用於 API 使用及濫用監控管控措施所涉及的客戶內容保留。API Platform 稽核記錄是與組織相關的管理/設定中繼資料,無論是否啟用零資料保留,皆可取得。

這篇文章有幫助嗎?