OpenAI
此頁面由機器翻譯。查看原文英文文章

API Platform 的管理與稽核日誌 API

在你的 API Platform 組織中取得稽核日誌,並執行管理員操作。

更新日期:11 days ago

管理員 API 功能

管理員 API 讓 API 平台組織擁有者及安全團隊以程式化方式管理其 API 平台組織、執行身分及存取管理政策,並支援安全與合規要求。

他們可透過管理員 API:

  • 列出、建立、擷取及刪除 API 平台組織中的邀請。

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

    • 更新 API 平台組織中的使用者角色。

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

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

  • 列出、建立、擷取及刪除專案中的服務帳戶。

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

  • 列出、建立、擷取及刪除 API 平台組織中的管理員金鑰。

請參閱管理員 API 文件以了解詳情。

如何為 API 平台組織建立管理員金鑰?

API 平台組織擁有者可在 API 平台組織設定中建立組織管理員金鑰。選取建立新的管理員金鑰,然後選擇整合所需的權限。

API 平台組織管理員金鑰與在管理員主控台建立的 ChatGPT 工作區管理員金鑰互相獨立。如需工作區金鑰的相關資訊,請參閱:在管理員主控台中管理管理員金鑰

請參閱管理員 API 文件以了解詳情。

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

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

只有 API 平台組織擁有者可以建立組織管理員金鑰。管理員 API 金鑰可用於驗證具備所需管理範圍的管理員 API 請求。部分群組及角色端點需要的範圍並未包括在組織管理內。如果請求傳回缺少範圍的錯誤,請檢查該端點所需的權限,並在授予更廣泛的存取權之前聯絡 OpenAI 支援團隊。

進一步了解 API 平台組織中的使用者角色。

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

已刪除的資料無法復原。此 API 不提供刪除 OpenAI 內為審計或安全而記錄之任何資料的功能。所有對此 API 的已驗證請求都會基於安全及合規目的而記錄。當項目使用此 API 刪除時,亦會從所有內部搜尋及擷取索引中移除。

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

刪除請求後,資料會在內部保留不超過 30 天。

我遺失了 Admin API 金鑰,如何復原?

如果 API 金鑰遺失,便無法復原。我們建議您從管理員金鑰中刪除先前的金鑰,然後建立新的金鑰。

稽核記錄功能

稽核記錄 API 為安全團隊提供 API 平台組織管理活動的不可竄改記錄。這些記錄有助識別安全問題、合規風險及作業程序的不足之處。您可以追蹤:

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

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

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

  • 登入及登出失敗。

  • API 平台組織設定的更新。

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

請參閱稽核記錄文件以了解詳情。

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

啟用稽核記錄功能後,便無法在組織設定中停用。API 平台組織擁有者必須聯絡 OpenAI 支援團隊以要求變更。

API 平台組織擁有者可前往 API 平台組織設定 > 資料控制 > 資料保留,啟用稽核記錄功能。在稽核記錄下,選取啟用並儲存變更。

請參閱稽核記錄文件以了解詳情。

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

誰可以使用稽核記錄 API 金鑰?

只有 API 平台組織擁有者可以建立組織管理員金鑰。如要存取稽核記錄,請建立一個將稽核記錄範圍設為讀取的金鑰,並將其用於稽核記錄 API。必須先啟用稽核記錄功能,才能取得稽核記錄資料。


進一步了解 API 平台組織中的使用者角色。

API 平台審計記錄會保留多久?

API 平台審計記錄目前沒有固定保留期限或已設定的 TTL。OpenAI 會在這些審計記錄仍可用期間盡力保留,但不保證永久可用。

由於審計記錄可用於長期安全、合規及管理審查,OpenAI 不會在短暫的固定時段後自動刪除它們。如客戶因自身保留、合規或電子探索政策而需要審計記錄,應匯出並在自己的系統中儲存副本。

API 平台審計記錄會記錄管理及組織設定事件,例如對使用者、專案、API 金鑰、服務帳戶及組織設定的變更。它們與 API 請求及回應中的客戶內容分開。

零資料保留會影響 API 平台審計記錄嗎?

不會。零資料保留不會改變 API 平台審計記錄的可用性、保留行為或事件內容。

零資料保留適用於 API 使用及濫用監控控制中的客戶內容保留。API 平台審計記錄是關於組織的管理/設定中繼資料,無論是否啟用零資料保留,均可獨立使用。

這篇文章對你有幫助嗎?