LIÊN HỆ HOTLINE/ZALO: 0981.243.678
Quản lý khóa Quản trị viên (Admin keys) trong Admin Console
Tạo và quản lý các khóa Admin theo phạm vi không gian làm việc (workspace) cho các API quản trị ChatGPT và Codex được hỗ trợ.
Khóa Quản trị viên (Admin keys) cho phép chủ sở hữu và quản trị viên không gian làm việc được ủy quyền kết nối các công cụ và dịch vụ với các API quản trị ChatGPT và Codex được hỗ trợ. Tùy thuộc vào không gian làm việc và các quyền bạn chọn, một khóa có thể hỗ trợ phân tích dữ liệu, quản lý người dùng và nhóm, lời mời, giới hạn sử dụng, nhật ký tuân thủ và hoạt động, hoặc quản trị tài khoản dịch vụ (service account).
Mỗi khóa Admin chỉ áp dụng cho một không gian làm việc ChatGPT duy nhất. Khóa không cấp quyền truy cập vào các không gian làm việc khác, quyền quản trị trên toàn bộ tenant, các tổ chức thuộc Nền tảng API (API Platform), tài khoản Quảng cáo (Ads), các mô hình hoặc việc suy luận mô hình (model inference).
Để được trợ giúp chọn tenant hoặc không gian làm việc của bạn, hãy xem: Quản lý tenant của bạn trong Admin Console.
Kiểm tra tính khả dụng và quyền truy cập của không gian làm việc
Khóa Admin khả dụng cho các không gian làm việc ChatGPT được quản trị đủ điều kiện, bao gồm các không gian làm việc ChatGPT Enterprise, ChatGPT Edu và ChatGPT for Healthcare. Bạn phải có vai trò Chủ sở hữu (Owner) hoặc Quản trị viên (Admin) trong không gian làm việc cụ thể mà bạn muốn quản lý.
Quyền truy cập phụ thuộc vào vai trò Owner hoặc Admin được chỉ định trong không gian làm việc ChatGPT đã chọn. Việc là quản trị viên toàn cục (global admin), chủ sở hữu tổ chức API Platform hoặc người dùng có vai trò tùy chỉnh trong không gian làm việc sẽ không tự động cấp quyền truy cập khóa Admin.
Để biết chi tiết về các vai trò tích hợp sẵn trong không gian làm việc, hãy xem: Quản lý thành viên, vai trò không gian làm việc và số ghế.
Hiểu quyền truy cập theo vai trò
-
Chủ sở hữu không gian làm việc (Workspace owners) có thể tạo các khóa với quyền Tất cả (All), Chỉ đọc (Read only) hoặc Tùy chỉnh (Custom). Họ có thể chỉnh sửa hoặc thu hồi bất kỳ khóa Admin nào trong không gian làm việc của mình.
-
Quản trị viên không gian làm việc (Workspace admins) tạo các khóa có phạm vi tùy chỉnh bằng cách chọn cấp độ truy cập khả dụng cho từng danh mục quyền. Khóa thu được sẽ được gắn nhãn Tùy chỉnh (Custom). Họ chỉ có thể chỉnh sửa hoặc thu hồi các khóa do chính mình tạo và chỉ khi quyền của khóa đó vẫn nằm trong phạm vi vai trò hiện tại của họ.
-
Quản trị viên toàn cục (Global admins) không có vai trò Owner hoặc Admin trong không gian làm việc đã chọn thì không thể tạo hoặc quản lý các khóa Admin của không gian làm việc đó.
Chọn quyền cho khóa Admin
Thiết lập quyền sẵn có cho Chủ sở hữu (Owner)
Chủ sở hữu không gian làm việc có thể chọn một trong các thiết lập quyền sẵn có sau:
-
Tất cả (All): cấp tất cả các quyền quản trị khả dụng cho không gian làm việc đã chọn, bao gồm cả các quyền chỉ dành riêng cho chủ sở hữu khi có sẵn.
-
Chỉ đọc (Read only): cấp các quyền chỉ đọc khả dụng cho không gian làm việc đã chọn.
-
Tùy chỉnh (Custom): cho phép bạn chọn cấp độ truy cập khả dụng cho từng danh mục quyền.
Quyền của quản trị viên theo danh mục
Quản trị viên không gian làm việc sẽ không thấy bộ chọn mẫu sẵn All, Read only hoặc Custom. Trong mục Quyền (Permissions), họ chọn Không (None), Đọc (Read) hoặc Ghi (Write) cho từng danh mục khả dụng. Khóa tạo ra sẽ được gắn nhãn Custom.
Tùy thuộc vào không gian làm việc của bạn, các danh mục khả dụng có thể bao gồm Ứng dụng (Apps), Giới hạn sử dụng (Usage limits), Quản lý nhóm (Group Management), Người dùng (Users), Lời mời (Invitations), API phân tích Codex (Codex analytics API), API phân tích doanh nghiệp (Enterprise analytics API), Phân tích không gian làm việc (Workspace analytics), Chi phí (Costs) và Tài khoản dịch vụ (Service accounts). Một số danh mục chỉ hỗ trợ Read hoặc Write, và một số chỉ hiển thị khi tính năng liên quan khả dụng.
Các ánh xạ quyền phổ biến bao gồm:
-
Codex analytics API > Read:
codex.enterprise.analytics.read. -
Usage limits > Read:
chatgpt.enterprise.usage_limit.read. -
Usage limits > Write:
chatgpt.enterprise.usage_limit.writevàchatgpt.enterprise.usage_limit.read. -
Users > Read:
chatgpt.enterprise.user.read, tại những nơi khả dụng.
Các quyền tuân thủ diện rộng, Tin nhắn trò chuyện (Conversation messages) và Vai trò và quyền hạn (Roles and permissions) chỉ khả dụng cho chủ sở hữu không gian làm việc khi được hỗ trợ. Quản trị viên không gian làm việc vẫn có thể chọn các danh mục nhật ký hoạt động riêng lẻ, chẳng hạn như nhật ký kiểm toán (audit logs) hoặc xác thực (authentication logs).
Quyền dành cho quản lý nhóm
Để tạo, cập nhật hoặc xóa các nhóm bằng Groups Admin API trong một không gian làm việc ChatGPT đủ điều kiện, hãy sử dụng khóa Admin của không gian làm việc đó.
Hãy xem lại mục Quản lý nhóm (Group Management) khi chọn quyền cho khóa và cấp các quyền theo yêu cầu của endpoint (điểm cuối). Một khóa chỉ đọc (read-only) sẽ không có quyền thực hiện các thay đổi đối với nhóm.
Chỉ riêng việc được chỉ định là người quản lý nhóm (group manager) sẽ không cấp quyền tạo khóa Admin hoặc sử dụng Groups Admin API. Chỉ chủ sở hữu và quản trị viên không gian làm việc mới có thể tạo khóa Admin; các yêu cầu API đòi hỏi phải có một khóa sở hữu các quyền cần thiết.
Để biết về việc ủy quyền quản trị nhóm, hãy xem: Quản lý nhóm và người quản lý nhóm.
Để biết đường dẫn endpoint, các thao tác được hỗ trợ, các trường yêu cầu và phạm vi (scopes) bắt buộc, hãy xem Tài liệu tham khảo Admin API. Quản lý các nhóm được đồng bộ hóa thông qua quy trình SCIM của nhà cung cấp danh tính (IdP) của bạn. Để biết hướng dẫn đồng bộ hóa, hãy xem: Cấp phép và quản lý SCIM.
Tạo khóa Admin
-
Đăng nhập vào Admin Console.
-
Chọn tenant của bạn nếu cần, sau đó chọn không gian làm việc ChatGPT nơi bạn có vai trò Owner hoặc Admin.
-
Mở mục Thông tin xác thực (Credentials), sau đó chọn Khóa Admin (Admin keys).
-
Chọn Tạo khóa admin mới (Create new admin key) và nhập tên mang tính gợi nhớ.
-
Chọn thời hạn hết hạn: Không bao giờ (Never), 30 ngày, 60 ngày, 90 ngày hoặc Tùy chỉnh (Custom). Thời hạn tùy chỉnh có thể từ 1 đến 365 ngày.
-
Chọn các quyền mà tích hợp của bạn cần. Chủ sở hữu không gian làm việc có thể chọn All, Read only hoặc Custom; quản trị viên không gian làm việc chọn quyền khả dụng cho từng danh mục.
-
Chọn Gửi (Submit), sau đó sao chép và lưu trữ chuỗi khóa bí mật (secret) một cách an toàn. Bạn sẽ không thể xem lại khóa bí mật này sau đó.
Khóa của chủ sở hữu không gian làm việc có thể mặc định là quyền All và thời hạn hết hạn có thể mặc định là Never. Hãy kiểm tra lại cả hai cài đặt trước khi bạn tạo khóa.
Xem lại, chỉnh sửa hoặc thu hồi khóa Admin
Mở không gian làm việc ChatGPT trong Admin Console, sau đó đi tới Credentials > Admin keys. Xem lại tên, trạng thái, ID theo dõi, chuỗi bí mật đã ẩn một phần, người tạo, quyền hạn, ngày sử dụng gần nhất và thời hạn hết hạn của từng khóa.
-
Để thay đổi tên hoặc quyền của khóa, hãy mở menu tùy chọn khác (•••) của khóa đó, chọn Chỉnh sửa (Edit), thực hiện các thay đổi và chọn Lưu thay đổi (Save changes).
-
Để ngừng sử dụng một khóa, hãy mở menu tùy chọn khác (•••) của khóa, chọn Thu hồi (Revoke) và xác nhận bằng Thu hồi khóa admin (Revoke admin key).
Chủ sở hữu không gian làm việc có thể chỉnh sửa hoặc thu hồi bất kỳ khóa nào của không gian làm việc đã chọn. Quản trị viên không gian làm việc chỉ có thể chỉnh sửa hoặc thu hồi các khóa do chính họ tạo, và chỉ khi các quyền của khóa đó vẫn thuộc phạm vi vai trò hiện tại của họ. Hãy yêu cầu chủ sở hữu không gian làm việc quản lý các khóa có quyền chỉ dành riêng cho chủ sở hữu. Ngày hết hạn đã thiết lập không thể thay đổi.
Các khóa bị thu hồi sẽ ngừng hoạt động ngay sau khi thay đổi có hiệu lực. Hãy tạo một khóa thay thế và cập nhật bất kỳ tích hợp bị ảnh hưởng nào trước khi thu hồi một khóa vẫn đang được sử dụng.
Tìm hiểu về tính tuân thủ và dữ liệu nhạy cảm
Một số quyền của khóa Admin có thể để lộ hoạt động hoặc nội dung nhạy cảm của không gian làm việc. Chỉ chủ sở hữu không gian làm việc mới có thể cấp quyền truy cập tuân thủ diện rộng hoặc quyền truy cập vào Tin nhắn trò chuyện (Conversation messages).
Quản trị viên không gian làm việc có thể cấp quyền truy cập vào các danh mục nhật ký riêng lẻ được hỗ trợ, bao gồm nhật ký kiểm toán, xác thực hoặc ứng dụng. Hãy xem xét kỹ từng danh mục; các nhật ký riêng lẻ vẫn có thể chứa thông tin nhạy cảm.
Để biết thông tin về các API tuân thủ và quyền truy cập dữ liệu, hãy xem: Nền tảng Tuân thủ của OpenAI dành cho Khách hàng Doanh nghiệp và Giáo dục (Enterprise & Edu).
Các yêu cầu Admin API của không gian làm việc ChatGPT sử dụng https://api.chatgpt.com/v1. Ví dụ: sử dụng /manage/workspaces/{workspace_id}/users để liệt kê các thành viên hiện tại của không gian làm việc. Các endpoint dưới /v1/organization/ quản lý các tổ chức API Platform và yêu cầu khóa Admin của tổ chức API Platform.
Để biết đường dẫn endpoint, cấu trúc request/response và các phạm vi (scopes) bắt buộc, hãy xem Tài liệu tham khảo Admin API.
Phân biệt khóa Admin với các loại thông tin xác thực khác
-
Khóa Admin của không gian làm việc xác thực các API quản trị ChatGPT và Codex được hỗ trợ cho một không gian làm việc ChatGPT duy nhất. Chúng không cấp quyền truy cập vào việc suy luận mô hình (model inference).
-
Mã token truy cập tài khoản dịch vụ Codex (Codex service-account access tokens) xác thực một danh tính phi con người trong không gian làm việc phục vụ cho mục đích tự động hóa Codex. Chúng không xác thực các yêu cầu Admin API. Để biết hướng dẫn thiết lập, hãy xem: Tạo và quản lý tài khoản dịch vụ Codex.
-
Khóa Admin của tổ chức API Platform được quản lý riêng trong Nền tảng API và không dùng để quản trị các không gian làm việc ChatGPT.
Nếu bạn cần khóa cho tổ chức thuộc Nền tảng API, hãy mở Khóa Admin của tổ chức API Platform. Sử dụng các endpoint ChatGPT Admin API dành riêng cho không gian làm việc cùng với khóa Admin của không gian làm việc đó; các endpoint của tổ chức API Platform yêu cầu thông tin xác thực riêng biệt.
Khắc phục sự cố truy cập và thiếu quyền
-
Xác nhận rằng bạn đã đăng nhập bằng đúng tài khoản OpenAI và đã chọn đúng tenant cũng như không gian làm việc ChatGPT dự kiến.
-
Kiểm tra xem tư cách thành viên không gian làm việc của bạn có đang hoạt động hay không và vai trò của bạn trong không gian làm việc có phải là Owner hoặc Admin không.
-
Đảm bảo không gian làm việc ChatGPT của bạn đủ điều kiện sử dụng khóa Admin. Tính khả dụng có thể khác nhau tùy thuộc vào gói dịch vụ và tiến trình triển khai.
-
Nếu thiếu một danh mục quyền, hãy xác nhận rằng tính năng đó có khả dụng trong không gian làm việc đã chọn và vai trò của bạn có cho phép truy cập hay không. Nếu danh mục bắt buộc vẫn không hiển thị, hãy liên hệ với bộ phận Hỗ trợ của OpenAI thay vì chọn một quyền không liên quan khác.
-
Nếu bạn không thể chỉnh sửa hoặc thu hồi một khóa, hãy xác nhận rằng bạn chính là người đã tạo khóa đó và các quyền của khóa vẫn khả dụng đối với vai trò hiện tại của bạn. Hãy nhờ chủ sở hữu không gian làm việc quản lý các khóa có quyền chỉ dành riêng cho chủ sở hữu.
-
Nếu một khóa trước đây hoạt động bình thường nhưng nay bị lỗi, hãy kiểm tra Trạng thái (Status) và Ngày hết hạn (Expiration) của khóa, xác nhận rằng khóa chưa hết hạn hoặc chưa bị thu hồi, đồng thời xác minh rằng người tạo khóa vẫn có vai trò không gian làm việc đang hoạt động với các quyền bắt buộc.
Nếu sự cố vẫn tiếp diễn, hãy liên hệ với bộ phận Hỗ trợ của OpenAI. Cung cấp ID tenant, tên hoặc ID không gian làm việc và ảnh chụp màn hình nếu được yêu cầu, nhưng tuyệt đối không bao giờ chia sẻ chuỗi bí mật của khóa Admin.
Bảo vệ khóa Admin của bạn
-
Chọn các quyền Tùy chỉnh (Custom) và chỉ cấp đúng quyền truy cập mà tích hợp của bạn cần.
-
Thiết lập thời hạn hết hạn bất cứ khi nào có thể. Không bao giờ (Never) có nghĩa là khóa không có thời gian hết hạn theo lịch trình. Tuy nhiên, khóa vẫn có thể ngừng hoạt động nếu bị thu hồi, người tạo khóa mất quyền truy cập cần thiết vào không gian làm việc, hoặc tài khoản của người tạo bị vô hiệu hóa.
-
Sử dụng các khóa riêng biệt cho các tích hợp hoặc quy trình làm việc khác nhau.
-
Lưu trữ các chuỗi bí mật trong một trình quản lý khóa bí mật an toàn (secret manager). Tuyệt đối không gửi chúng qua email, tin nhắn trò chuyện hoặc yêu cầu hỗ trợ.
-
Thường xuyên kiểm tra mức độ sử dụng và thời hạn hết hạn, đồng thời thu hồi các khóa bạn không còn cần nữa.

Liên hệ qua Zalo