管理員金鑰可讓獲授權的工作區擁有者與管理員,將工具和服務連接至支援的 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.write和chatgpt.enterprise.usage_limit.read。使用者 > 讀取:可用時為
chatgpt.enterprise.user.read。
在支援的情況下,廣泛的合規權限、對話訊息及角色與權限僅供工作區擁有者使用。工作區管理員仍可能可以選取個別活動記錄類別,例如稽核或驗證記錄。
建立管理員金鑰
登入管理控制台。
如有需要,請選取您的租用戶,然後選取您具備擁有者或管理員角色的 ChatGPT 工作區。
開啟認證,然後選取管理員金鑰。
選取建立新的管理員金鑰,並輸入易於辨識的名稱。
選擇到期時間:永不、30 天、60 天、90 天或自訂。自訂到期時間可設為 1 至 365 天。
選擇整合所需的權限。工作區擁有者可選取全部、唯讀或自訂;工作區管理員則須為每個類別選取可用權限。
選取提交,然後複製密鑰並妥善保存。之後將無法再次查看此密鑰。
工作區擁有者建立的金鑰可能預設為全部權限,到期時間也可能預設為永不。建立金鑰前,請檢查這兩項設定。
檢查、編輯或撤銷管理員金鑰
在管理控制台中開啟 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 及螢幕擷取畫面,但切勿分享管理員金鑰的密鑰。
保護您的管理員金鑰
選擇自訂權限,並僅授予整合所需的存取權。
請盡可能設定到期時間。永不表示金鑰沒有預定的到期時間。如果金鑰遭撤銷、建立者失去必要的工作區存取權,或建立者的帳戶停用,金鑰仍可能停止運作。
請為不同的整合或工作流程使用不同金鑰。
將密鑰存放在安全的密鑰管理工具中。切勿透過電子郵件、聊天或支援要求傳送密鑰。
定期檢查使用情況與到期時間,並撤銷不再需要的金鑰。
