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

在管理控制台中管理管理員金鑰

建立及管理適用於支援的 ChatGPT 與 Codex 管理 API,且範圍限定於工作區的管理員金鑰。

更新日期:14 days ago

管理員金鑰可讓獲授權的工作區擁有者與管理員,將工具和服務連接至支援的 ChatGPT 與 Codex 管理 API。依您選擇的工作區與權限,金鑰可支援分析、使用者與群組管理、邀請、用量限制、合規與活動記錄,或服務帳戶管理。

每個管理員金鑰僅適用於一個 ChatGPT 工作區。它不會授予其他工作區、租用戶層級管理、API 平台組織、廣告帳戶、模型或模型推論的存取權。

如需選擇租用戶或工作區的協助,請參閱:在管理控制台中管理租用戶

檢查工作區的可用性與存取權

符合資格的受管理 ChatGPT 工作區可使用管理員金鑰,包括 ChatGPT Enterprise、ChatGPT Edu 和 ChatGPT 醫療照護版工作區。您必須在要管理的特定工作區中具備擁有者管理員角色。

存取權取決於您在所選 ChatGPT 工作區中獲指派的擁有者管理員角色。僅具備全域管理員、API 平台組織擁有者或自訂工作區角色,並不會自動取得管理員金鑰的存取權。

如需內建工作區角色的詳細資訊,請參閱:在 ChatGPT Enterprise 中管理成員、席位類型、角色與存取權

瞭解各角色的存取權

  • 工作區擁有者可建立具備全部唯讀自訂權限的金鑰。他們可以編輯或撤銷工作區中的任何管理員金鑰。

  • 工作區管理員可為每個權限類別選擇可用的存取層級,以建立自訂範圍的金鑰。產生的金鑰會標示為自訂。他們只能編輯或撤銷自己建立的金鑰,且金鑰權限必須是其目前角色可用的權限。

  • 若全域管理員在所選工作區中不具備擁有者管理員角色,就無法建立或管理該工作區的管理員金鑰。

選擇管理員金鑰權限

擁有者權限預設組合

工作區擁有者可選擇下列任一權限預設組合:

  • 全部會授予所選工作區可用的管理員權限,包括可用時僅限擁有者的權限。

  • 唯讀會授予所選工作區可用的唯讀權限。

  • 自訂可讓您為每個權限類別選擇可用的存取層級。

各類別的管理員權限

工作區管理員不會看到全部唯讀自訂預設組合選擇器。在權限下,他們須為每個可用類別選擇讀取寫入。產生的金鑰會標示為自訂

依工作區而定,可用類別可能包括應用程式用量限制群組管理使用者邀請Codex 分析 API企業分析 API工作區分析成本服務帳戶。部分類別僅支援讀取寫入,有些則只會在相關功能可用時顯示。

常見的權限對應包括:

  • Codex 分析 API > 讀取codex.enterprise.analytics.read

  • 用量限制 > 讀取chatgpt.enterprise.usage_limit.read

  • 用量限制 > 寫入chatgpt.enterprise.usage_limit.writechatgpt.enterprise.usage_limit.read

  • 使用者 > 讀取:可用時為 chatgpt.enterprise.user.read

在支援的情況下,廣泛的合規權限、對話訊息角色與權限僅供工作區擁有者使用。工作區管理員仍可能可以選取個別活動記錄類別,例如稽核或驗證記錄。

建立管理員金鑰

  1. 登入管理控制台

  2. 如有需要,請選取您的租用戶,然後選取您具備擁有者管理員角色的 ChatGPT 工作區。

  3. 開啟認證,然後選取管理員金鑰

  4. 選取建立新的管理員金鑰,並輸入易於辨識的名稱。

  5. 選擇到期時間:永不30 天60 天90 天自訂。自訂到期時間可設為 1 至 365 天。

  6. 選擇整合所需的權限。工作區擁有者可選取全部唯讀自訂;工作區管理員則須為每個類別選取可用權限。

  7. 選取提交,然後複製密鑰並妥善保存。之後將無法再次查看此密鑰。

工作區擁有者建立的金鑰可能預設為全部權限,到期時間也可能預設為永不。建立金鑰前,請檢查這兩項設定。

檢查、編輯或撤銷管理員金鑰

在管理控制台中開啟 ChatGPT 工作區,然後前往認證 > 管理員金鑰。檢查每個金鑰的名稱、狀態、追蹤 ID、遮蔽的密鑰、建立者、權限、上次使用日期及到期時間。

  • 若要變更金鑰名稱或權限,請開啟其更多選項選單 (•••),選取編輯並進行變更,然後選取儲存變更

  • 若要停止使用金鑰,請開啟其更多選項選單 (•••),選取撤銷,再以撤銷管理員金鑰確認。

工作區擁有者可以編輯或撤銷所選工作區的任何金鑰。工作區管理員只能編輯或撤銷自己建立的金鑰,且金鑰權限必須是其目前角色可用的權限。請由工作區擁有者管理具備擁有者專屬權限的金鑰。現有的到期日期無法變更。

變更生效後,遭撤銷的金鑰便會停止運作。撤銷仍在使用的金鑰前,請先建立替代金鑰並更新所有受影響的整合。

瞭解合規與敏感資料

部分管理員金鑰權限可能會揭露敏感的工作區活動或內容。只有工作區擁有者能授予廣泛的合規存取權,或授予對話訊息的存取權。

工作區管理員可能可以授予所支援個別記錄類別的存取權,包括稽核、驗證或應用程式記錄。請仔細檢查每個類別;個別記錄仍可能包含敏感資訊。

如需合規 API 與資料存取的相關資訊,請參閱:企業與教育客戶適用的 OpenAI 合規平台

ChatGPT 工作區管理員 API 要求使用 https://api.chatgpt.com/v1。例如,使用 /manage/workspaces/{workspace_id}/users 列出目前的工作區成員。/v1/organization/ 下的端點用於管理 API 平台組織,並需要 API 平台組織管理員金鑰。

如需端點路徑、要求與回應結構描述及必要範圍,請參閱管理員 API 參考資料

區分管理員金鑰與其他認證

  • 工作區管理員金鑰可驗證單一 ChatGPT 工作區所支援的 ChatGPT 與 Codex 管理 API。這些金鑰不會授予模型推論的存取權。

  • Codex 服務帳戶存取權杖會驗證用於 Codex 自動化的非真人工作區身分。這些權杖無法驗證管理員 API 要求。如需設定指引,請參閱:建立及管理 Codex 服務帳戶

  • API 平台組織的管理員金鑰須在 API 平台中另行管理,且不能用來管理 ChatGPT 工作區。

如需 API 平台組織的金鑰,請開啟 API 平台組織管理員金鑰。請使用工作區管理員金鑰存取 ChatGPT 工作區專用的管理員 API 端點;API 平台組織端點需要另外的認證。

排解存取與權限缺少問題

  • 確認您已使用正確的 OpenAI 帳戶登入,並選取預期的租用戶與 ChatGPT 工作區。

  • 檢查您的工作區成員資格是否有效,且工作區角色為擁有者管理員

  • 確認您的 ChatGPT 工作區符合使用管理員金鑰的資格。可用性可能因方案與推出進度而異。

  • 如果缺少某個權限類別,請確認所選工作區可使用相關功能,且您的角色允許存取。如果所需類別仍無法使用,請聯絡 OpenAI 支援,而不要選擇不相關的權限。

  • 如果無法編輯或撤銷金鑰,請確認該金鑰是由您建立,且其權限適用於您目前的角色。請由工作區擁有者管理具備擁有者專屬權限的金鑰。

  • 如果先前可用的金鑰停止運作,請檢查其狀態到期時間、確認金鑰並未過期或遭撤銷,並確認建立者仍具備有效且擁有必要權限的工作區角色。

如果問題持續發生,請聯絡 OpenAI 支援。如有要求,請附上租用戶 ID、工作區名稱或 ID 及螢幕擷取畫面,但切勿分享管理員金鑰的密鑰。

保護您的管理員金鑰

  • 選擇自訂權限,並僅授予整合所需的存取權。

  • 請盡可能設定到期時間。永不表示金鑰沒有預定的到期時間。如果金鑰遭撤銷、建立者失去必要的工作區存取權,或建立者的帳戶停用,金鑰仍可能停止運作。

  • 請為不同的整合或工作流程使用不同金鑰。

  • 將密鑰存放在安全的密鑰管理工具中。切勿透過電子郵件、聊天或支援要求傳送密鑰。

  • 定期檢查使用情況與到期時間,並撤銷不再需要的金鑰。

這篇文章有幫助嗎?