Cấu hình được quản lý | Triển khai và cấu hình

Cấu hình được quản lý cho phép quản trị viên doanh nghiệp đặt các yêu cầu và giá trị mặc định được hỗ trợ cho ChatGPT Work và Codex. Các yêu cầu giới hạn những gì người dùng và tác vụ có thể thực hiện. Các giá trị mặc định cung cấp giá trị ban đầu. Mức độ hỗ trợ tùy thuộc vào sản phẩm, phiên bản ứng dụng khách và môi trường thực thi.

Bắt đầu tại Bảo mật tác nhân trong Bảng điều khiển quản trị để thiết lập các cài đặt được hỗ trợ và quản lý qua đám mây. Sử dụng các tùy chọn điều khiển cho tác vụ thông thường, hoặc chọn Chỉnh sửa dưới dạng TOML để kiểm tra, sao chép hoặc chỉnh sửa văn bản cấu hình. Cả hai chế độ xem đều chỉnh sửa cùng một chính sách; TOML còn hiển thị các trường được hỗ trợ nhưng không có tùy chọn điều khiển riêng. Bạn không cần phân phối tệp cục bộ để sử dụng các cài đặt được quản lý qua đám mây. Các hạn chế xác thực và triển khai được quản lý trên thiết bị có quy trình thiết lập cục bộ riêng.

Quản trị viên Enterprise có thể kiểm soát hành vi của các máy khách cục bộ được hỗ trợ bằng:

Yêu cầu: các ràng buộc do quản trị viên áp đặt mà người dùng không thể ghi đè.
Giá trị cấu hình mặc định: các thiết lập config.toml do hệ thống hoặc đám mây quản lý mà người dùng có thể ghi đè.
Giá trị mặc định được quản lý theo cơ chế cũ: các giá trị ban đầu trong managed_config.toml được áp dụng khi ứng dụng khách được hỗ trợ khởi động. Người dùng vẫn có thể thay đổi thiết lập trong một phiên chạy. Ứng dụng khách áp dụng lại các giá trị mặc định này vào lần khởi động tiếp theo.

Xem Agent Security để biết cấu hình cơ sở Global, các thiết lập ghi đè theo môi trường và danh sách trường của bộ điều phối và bộ thực thi.

Cấu hình chính sách trong Bảo mật tác nhân

Khi Bảo mật tác nhân được bật, chủ sở hữu không gian làm việc, quản trị viên không gian làm việc và thành viên có quyền quản trị Codex có thể quản lý chính sách. Quyền truy cập trình chỉnh sửa chính sách không cấp cho thành viên quyền truy cập các tính năng mà chính sách kiểm soát.

Sử dụng Mặc định của không gian làm việc làm cấu hình cơ sở cho không gian làm việc. Sử dụng Ghi đè khi người dùng, nhóm hoặc vai trò cụ thể cần các cài đặt khác. Cấu hình ghi đè theo đối tượng xác định ai nhận chính sách; cài đặt môi trường xác định nơi áp dụng các biện pháp kiểm soát thực thi được hỗ trợ.

Mở Bảng điều khiển quản trị > Bảo mật tác nhân rồi chọn Mặc định của không gian làm việc hoặc chính sách bạn muốn chỉnh sửa trong Ghi đè.
Mở Yêu cầu để đặt các giới hạn bắt buộc, hoặc Mặc định để đặt các giá trị ban đầu mà thành viên có thể thay đổi trong phạm vi những giới hạn đó.
Giữ các cài đặt phê duyệt, tìm kiếm trên web và các cài đặt áp dụng cho toàn bộ tác nhân trong Toàn cục. Khi có sẵn, sử dụng Thêm cài đặt môi trường trong thẻ tương ứng để thêm Môi trường cục bộ hoặc Môi trường Codex Cloud cho các cài đặt thực thi được hỗ trợ. Tài liệu môi trường trống kế thừa cài đặt từ Toàn cục; tài liệu này không sao chép hoặc cố định cấu hình cơ sở hiện tại.
Sử dụng các tùy chọn điều khiển được mô tả trong hướng dẫn này. Đối với các trường nâng cao, chọn Chỉnh sửa dưới dạng TOML rồi chỉnh sửa requirements.toml hoặc config.toml của phạm vi phù hợp. Chọn Sử dụng các tùy chọn điều khiển cài đặt để quay lại trình chỉnh sửa trực quan.
Xem xét các thông báo xác thực, rồi chọn Lưu thay đổi. Việc áp dụng quy tắc trong trình chỉnh sửa quy tắc sẽ cập nhật bản nháp; thao tác đó không tự lưu chính sách.
Kiểm tra việc lựa chọn chính sách và hành vi của ứng dụng khách được hỗ trợ như mô tả trong Xác nhận trải nghiệm của quản trị viên và nhân viên.

Các trình chỉnh sửa môi trường và trường được hỗ trợ phụ thuộc vào không gian làm việc và chính sách. Xem Phạm vi áp dụng cài đặt trước khi chuyển một cài đặt Toàn cục vào môi trường. Cài đặt trong Toàn cục không nhất thiết áp dụng cho mọi sản phẩm hoặc luồng thực thi.

Sao chép hoặc tái sử dụng cấu hình

Trình chỉnh sửa trực quan không thay thế TOML. Chọn Chỉnh sửa dưới dạng TOML để sao chép cấu hình, giữ một bản tham chiếu hoặc tái sử dụng cài đặt trong chính sách khác. Chọn Sử dụng các tùy chọn điều khiển cài đặt để quay lại trình chỉnh sửa trực quan.

Mở chính sách nguồn rồi chọn Chỉnh sửa dưới dạng TOML.
Chọn phạm vi bạn muốn sao chép: Toàn cục hoặc một thẻ môi trường có sẵn. Sao chép văn bản từ Yêu cầu (requirements.toml), Mặc định (config.toml) hoặc cả hai, tùy theo nội dung bạn muốn tái sử dụng.
Mở chính sách đích, chọn Chỉnh sửa dưới dạng TOML rồi chọn phạm vi tương ứng. Dán các yêu cầu vào requirements.toml và các giá trị mặc định vào config.toml. Xem xét các cài đặt hiện có ở đích trước khi thay thế văn bản; giữ lại các cài đặt không liên quan vẫn cần áp dụng.
Xem xét các thông báo xác thực, đối tượng áp dụng và mức ưu tiên của chính sách đích, rồi chọn Lưu thay đổi. Xác nhận hành vi thực tế của ứng dụng khách trước khi dựa vào chính sách đã sao chép.

Văn bản được sao chép chứa các cài đặt đã được thiết lập cho chính sách và phạm vi đó. Văn bản này không bao gồm việc gán chính sách, thứ tự chính sách, các tài liệu môi trường khác hoặc cấu hình có hiệu lực được kết hợp từ các chính sách khác và cài đặt thiết bị. Sao chép riêng các cài đặt môi trường khi cần. Việc chuyển chế độ xem hoặc sao chép văn bản không lưu thay đổi chính sách.

Thử ví dụ bên dưới: thay đổi một cài đặt, rồi chọn Chỉnh sửa dưới dạng TOML để xem cấu hình của cài đặt đó. Chuyển lại bằng Sử dụng các tùy chọn điều khiển cài đặt để tiếp tục thử nghiệm.

Chính sách mẫu

Thay đổi một cài đặt mẫu, rồi chuyển chế độ xem để xem cùng cấu hình đó dưới dạng TOML.

Yêu cầu · Toàn cục

Chính sách phê duyệt

Chế độ môi trường cô lập

Chế độ tìm kiếm trên web

allowed_approval_policies = ["on-request"]
allowed_sandbox_modes = ["read-only"]
allowed_web_search_modes = ["disabled"]

Chỉ là ví dụ. Các thay đổi chỉ được giữ trên trang này và không cập nhật không gian làm việc. Trường được thay đổi gần nhất được tô sáng trong chế độ xem TOML.

Chọn tùy chọn điều khiển phù hợp

Tác vụ	Nơi cấu hình	Nội dung thay đổi
Hạn chế quyền truy cập trình duyệt và ứng dụng gốc	Yêu cầu > Tính khả dụng của tính năng trên máy tính, Quy tắc trang web và Quy tắc ứng dụng	Kiểm soát những khả năng được hỗ trợ trên máy tính có thể sử dụng và những trang web hoặc ứng dụng mà chúng có thể truy cập.
Giới hạn các lựa chọn phê duyệt, môi trường cô lập hoặc tìm kiếm trên web	Yêu cầu > Giới hạn chính sách	Hạn chế các lựa chọn có sẵn cho ứng dụng khách được hỗ trợ.
Đặt hành vi ban đầu cho phê duyệt, quyền, tìm kiếm hoặc công cụ	Mặc định	Đặt các giá trị mà thành viên có thể thay đổi trong phạm vi yêu cầu bắt buộc.
Hạn chế đích kết nối mạng của lệnh	Yêu cầu > Kiểm soát sử dụng mạng	Áp dụng các quy tắc mạng được quản lý cho lưu lượng lệnh được hỗ trợ. Đây không phải công tắc internet cho toàn bộ không gian làm việc.
Cấu hình plugin và hook được quản lý	Chỉnh sửa dưới dạng TOML	Cho phép cấu hình các trường chính sách được hỗ trợ nhưng không có tùy chọn điều khiển trực quan riêng.
Hạn chế phương thức đăng nhập hoặc không gian làm việc trước khi đăng nhập	Yêu cầu hệ thống cục bộ hoặc macOS MDM	Áp dụng các hạn chế xác thực trước khi chính sách đám mây được tải.

Kiểm soát trình duyệt và Computer Use

Sử dụng Bảo mật tác nhân trong Bảng điều khiển quản trị để quản lý quyền truy cập trình duyệt và ứng dụng gốc cho các ứng dụng khách trên máy tính được hỗ trợ. Bắt đầu với các tùy chọn điều khiển trên giao diện. Các ví dụ TOML bên dưới cung cấp cấu hình tham chiếu cho việc phân phối chính sách qua tệp và các cài đặt cần trình chỉnh sửa TOML.

Browser Use kiểm soát hoạt động do tác nhân thực hiện trong trình duyệt. Computer Use kiểm soát hoạt động do tác nhân thực hiện trong các ứng dụng gốc trên máy tính. Cài đặt cho khung trình duyệt tích hợp tách biệt với Browser Use. Xem phiên trình duyệt và các phiên đăng nhập hiện có để biết sự khác biệt giữa các cách sử dụng trình duyệt.

Trước khi bắt đầu

Sử dụng tài khoản có quyền quản lý chính sách Bảo mật tác nhân. Xác nhận những người nhận chính sách cũng như các phiên bản ứng dụng khách và hệ điều hành bạn cần hỗ trợ. Xem Bảo mật tác nhân để tìm hiểu về việc gán chính sách, cài đặt Toàn cục và các cấu hình ghi đè theo môi trường được hỗ trợ.

Sử dụng Yêu cầu cho các giới hạn mà người dùng không thể ghi đè. Mặc định đặt các giá trị ban đầu trong phạm vi những giới hạn đó. Việc cho phép một trang web hoặc ứng dụng không cài đặt plugin, cấp quyền hệ điều hành, đăng nhập cho người dùng hay phê duyệt hành động vẫn cần được xem xét.

Trong Tính khả dụng của tính năng trên máy tính, hãy xem xét Sử dụng trình duyệt, Sử dụng trình duyệt bên ngoài và Sử dụng máy tính. Buộc tắt vô hiệu hóa tính năng tương ứng; quy tắc cho phép đối với trang web hoặc ứng dụng không ghi đè được thiết lập này. Hãy xem xét Toàn quyền truy cập CDP riêng; Chặn người dùng tự bật ngăn người dùng bật tính năng này.

Các tùy chọn kiểm soát trên máy tính này không cấu hình trình duyệt Work Cloud được lưu trữ trên đám mây. Hãy quản lý Sử dụng trình duyệt đám mây và Truy cập mạng đám mây riêng trong Bảng điều khiển quản trị > Quyền và vai trò > Khả năng của không gian làm việc > Khả năng của máy tính đám mây. Xem cách Agent Security áp dụng cho Work Cloud.

Cấu hình quyền truy cập trình duyệt

Mở Bảng điều khiển quản trị > Bảo mật tác nhân. Dùng Mặc định của không gian làm việc làm cấu hình cơ sở cho không gian làm việc, hoặc mở chính sách tương ứng trong Ghi đè. Trong Yêu cầu, chuyển đến Kiểm soát trình duyệt trên máy tính.
Trong Quy tắc trang web, mở menu thao tác của hàng Mặc định rồi chọn Chỉnh sửa mặc định. Để giới hạn quyền truy cập ở các trang web đã được phê duyệt, đặt Quyền truy cập trang web thành Chặn, rồi chọn Áp dụng quy tắc. Hàng Mặc định cung cấp giá trị cho các thiết lập mà quy tắc trang web khớp vẫn để ở Dùng quy tắc mặc định.
Chọn Thêm quy tắc trang web. Trong Trang web hoặc mẫu, nhập một nguồn gốc: giao thức, tên máy chủ và cổng tùy chọn. Ví dụ: https://example.com là hợp lệ; https://example.com/files thì không. Không thêm đường dẫn, truy vấn hoặc đoạn định danh. HTTP và HTTPS là các nguồn gốc khác nhau. Chỉ định cổng khi cổng đó khác với cổng mặc định của giao thức.
Đặt Quyền truy cập trang web và xem xét Tải xuống, Tải lên và Gỡ lỗi/CDP. Chọn Cho phép hoặc Chặn cho phù hợp, hoặc giữ thiết lập ở Dùng quy tắc mặc định. Gỡ lỗi/CDP kiểm soát toàn quyền truy cập Chrome DevTools Protocol để gỡ lỗi trình duyệt. Cho phép để các bước kiểm tra chính sách và phê duyệt thông thường tiếp tục.
Xem xét Tự động xem xét, Luôn cho phép và Thời hạn phê duyệt cho trang web. Thời hạn phê duyệt có các lựa chọn Lượt này và Luồng này. Đồng thời xem xét Lịch sử trình duyệt, Lưu phê duyệt trang web và Tự động phê duyệt yêu cầu trong Kiểm soát trình duyệt trên máy tính.
Chọn Thêm quy tắc, xem xét các thông báo xác thực rồi chọn Lưu thay đổi. Kiểm thử một trang web được cho phép và một trang web bị chặn trên máy khách được hỗ trợ có nhận chính sách này. Kiểm thử riêng việc tải lên, tải xuống và các thao tác bị hạn chế khác.

Thêm quy tắc trang web

Hàng Mặc định được áp dụng khi quy tắc trang web giữ một quyền ở Mặc định. Nếu các quy tắc chồng lấn, Chặn được ưu tiên cho từng quyền.

Trang web hoặc mẫu

Quyền truy cập trang webDùng quy tắc mặc định

Tải xuốngDùng quy tắc mặc định

Tải lênDùng quy tắc mặc định

Gỡ lỗi/CDPDùng quy tắc mặc định

Tự động xem xétDùng quy tắc mặc định

Luôn cho phépDùng quy tắc mặc định

Thời hạn phê duyệtDùng quy tắc mặc định

Việc tắt xem xét tự động đối với các thao tác trên trình duyệt sẽ chuyển các thao tác đó đến người dùng để phê duyệt. Việc này không tắt tính năng giám sát an toàn của mô hình.

Khi nhiều mẫu nguồn gốc cùng khớp, giá trị hạn chế nhất được ưu tiên cho từng thiết lập. Cấu hình cục bộ không thể nới lỏng lệnh từ chối do chính sách quản lý áp đặt. Các lệnh từ chối truy cập mạng được quản lý và danh sách chỉ cho phép các mục được liệt kê cũng áp dụng cho công cụ trình duyệt. Xem các trường chính sách trình duyệt để biết các mẫu nguồn gốc và cách hoạt động của cơ chế phê duyệt.

Computer Use cũng có thể điều khiển trình duyệt như một ứng dụng gốc. Các quy tắc về trang web và khả năng của Browser Use không áp dụng cho cách sử dụng đó. Hãy xem xét riêng quyền truy cập ứng dụng gốc; xem ranh giới bảo mật của trình duyệt.

Cấu hình quyền truy cập ứng dụng gốc

Trong Yêu cầu, chuyển đến Kiểm soát ứng dụng trên máy tính > Quy tắc ứng dụng.
Dùng menu thao tác của hàng Mặc định để cấu hình quyền truy cập cho các ứng dụng không có quy tắc khớp. Để giới hạn Computer Use ở các ứng dụng đã được phê duyệt, hãy chặn truy cập theo mặc định và thêm quy tắc cho phép cho những ứng dụng đó.
Chọn Thêm quy tắc ứng dụng. Trong hộp thoại Chỉnh sửa quy tắc, chọn ID gói macOS, AUMID Windows hoặc Tệp thực thi Windows từ Ứng dụng. Nhập chính xác Mã định danh ứng dụng tương ứng với ID gói hoặc Application User Model ID (AUMID). Với Tệp thực thi Windows, nhập Tên nhà phát hành và Tên sản phẩm; Tên tệp nhị phân là tùy chọn. Dùng thông tin nhận dạng ứng dụng đã được xác minh, không dùng tên hiển thị hoặc đường dẫn tệp.
Đặt Quyền truy cập ứng dụng cho quy tắc rồi chọn Thêm quy tắc. Xem xét Lưu phê duyệt ứng dụng trong Kiểm soát ứng dụng trên máy tính, xem xét các thông báo xác thực rồi chọn Lưu thay đổi. Tắt lưu phê duyệt vẫn cho phép phê duyệt trong phiên hiện tại; cho phép lưu phê duyệt không đồng nghĩa với việc phê duyệt ứng dụng.
Kiểm thử một ứng dụng được cho phép và một ứng dụng bị chặn trên từng hệ điều hành được hỗ trợ trong môi trường triển khai của bạn. Xác nhận rằng các quyền của hệ điều hành vẫn áp dụng và người dùng vẫn phải cung cấp những phê duyệt cần thiết.

Xem các trường chính sách Computer Use để biết các yêu cầu về nhận dạng trên Windows và các hạn chế sử dụng khi máy bị khóa đối với máy Mac được quản lý.

Kiểm tra chính sách có hiệu lực

Nếu một trang web hoặc ứng dụng được cho phép vẫn bị chặn, hãy kiểm tra các quy tắc khớp khác, việc gán và mức ưu tiên của chính sách, các yêu cầu đối với thiết bị và cấu hình người dùng. Quy tắc cho phép ở một nguồn không bỏ qua được lệnh từ chối khác đang áp dụng. Xem vị trí đặt yêu cầu và thứ tự ưu tiên.

Nếu một thiết lập không có tác dụng, hãy xác minh rằng máy khách, hệ điều hành và phương thức phân phối chính sách có hỗ trợ thiết lập đó. Đặc biệt chú ý đến Work Cloud có quyền truy cập máy tính cục bộ: một số trường chỉ được hỗ trợ một phần hoặc cần được xác thực. Xem Khả năng tương thích với Work trong Tài liệu tham chiếu cấu hình.

Kiểm tra riêng quyền của không gian làm việc và các tùy chọn kiểm soát plugin khi người dùng không thể truy cập tính năng hoặc plugin cần thiết.

Tham chiếu cấu hình TOML

Các ví dụ sau mô tả cùng một ý đồ chính sách cho requirements.toml. Sử dụng chúng khi quản lý chính sách qua tệp hoặc trình chỉnh sửa TOML. Bạn không cần chỉnh sửa tệp cục bộ để sử dụng các tùy chọn kiểm soát có trong Agent Security.

Ví dụ về trình duyệt này mặc định từ chối truy cập, cho phép https://example.com, chặn việc tải lên và quyền truy cập CDP đầy đủ tại đó, đồng thời giới hạn hiệu lực phê duyệt truy cập trang web trong lượt hiện tại:

[browser_use]
allow_history_access = false
allow_global_persistent_approval = false

[browser_use.default_origin_policy]
access = "deny"

[browser_use.origins."https://example.com"]
access = "allow"
uploads = "deny"
downloads = "allow"
full_cdp_access = "deny"
persistent_approval = false
access_approval_lifetime = "turn"

Để tắt tính năng xét duyệt tự động cho các thao tác trên trình duyệt, hãy đặt browser_use.disable_auto_review = true, hoặc đặt auto_review = "deny" trong một chính sách nguồn gốc để hạn chế tính năng này đối với nguồn gốc đó.

Để bật Công cụ trang web cho một không gian làm việc Enterprise đủ điều kiện, hãy đặt browser_use.allow_webmcp = true. Việc chủ động bật qua chính sách quản lý này áp dụng cho trình duyệt tích hợp trong ứng dụng máy tính. Đặt thành false hoặc bỏ qua thiết lập này sẽ giữ nguyên các bước kiểm tra thông thường về tính khả dụng của tính năng; false không áp đặt lệnh chặn. Tùy chọn của người dùng và quyền trang web vẫn được áp dụng.

Ví dụ về ứng dụng gốc này cho phép Calculator trên macOS, mặc định từ chối các ứng dụng khác, và ngăn việc duy trì phê duyệt ứng dụng qua các phiên:

[computer_use]
default_app_access = "deny"
allow_persistent_approval = false

[computer_use.macos.bundle_ids]
"com.apple.calculator" = "allow"

Chính sách Windows có thể xác định các ứng dụng đóng gói bằng computer_use.windows.aumids hoặc các tệp thực thi bằng computer_use.windows.exes. Quy tắc cho tệp thực thi yêu cầu publisher_name, product_name và access; binary_name là tùy chọn.

Để xem tất cả các trường và giá trị được hỗ trợ, hãy dùng tài liệu tham chiếu requirements.toml. Để tắt một khả năng thay vì hạn chế từng trang web hoặc ứng dụng, hãy xem Cố định cờ tính năng.

Các tùy chọn kiểm soát khác trên máy tính

Các tùy chọn kiểm soát trên máy tính sau đây bao gồm tính khả dụng của tính năng, Locked Use, Appshots và điều khiển thiết bị từ xa. Sử dụng các thiết lập chuyên biệt cho tính khả dụng của tính năng và Locked Use; cấu hình Appshots và điều khiển thiết bị từ xa bằng Chỉnh sửa dưới dạng TOML. Để biết các hạn chế về đích đến của lưu lượng ứng dụng máy tính, hãy xem Kiểm soát đích mạng của ứng dụng máy tính.

Cố định cờ tính năng

Đối với các tính năng trên máy tính có trong Agent security, hãy mở Toàn cục > Yêu cầu > Tính khả dụng của tính năng trên máy tính. Đặt Trình duyệt trong ứng dụng, Sử dụng trình duyệt, Sử dụng trình duyệt bên ngoài hoặc Sử dụng máy tính thành Buộc tắt để tắt khả năng đó, rồi chọn Lưu thay đổi. Đối với Quyền truy cập CDP đầy đủ, hãy chọn Chặn người dùng tự bật để ngăn người dùng bật tính năng này. Việc cho phép một tính năng không ghi đè các điều kiện về tính khả dụng theo sản phẩm, nền tảng hoặc đợt triển khai.

Đối với các cờ tính năng được hỗ trợ khác, hãy sử dụng Chỉnh sửa dưới dạng TOML và tài liệu requirements.toml Toàn cục, hoặc một nguồn cung cấp yêu cầu cục bộ được hỗ trợ. Các ví dụ sau bao gồm cả thiết lập cố định tính năng trong môi trường thực thi và thiết lập dành riêng cho máy tính:

[features]
hooks = true
unified_exec = false

# Disable surface-specific features when needed.
browser_use = false
browser_use_full_cdp_access = false
browser_use_external = false
in_app_browser = false
in_app_updates = false
computer_use = false

Sử dụng các khóa tính năng chuẩn từ bảng [features] của config.toml cho các tính năng trong môi trường thực thi. Môi trường thực thi cục bộ chuẩn hóa các tính năng được nhận diện để tuân thủ các thiết lập cố định này và từ chối các thao tác ghi xung đột vào config.toml hoặc thiết lập tính năng trong tệp hồ sơ.

Thiết lập unified_exec = false do quản trị viên quản lý vẫn cho phép thực thi lệnh, nhưng tắt các tiến trình có thể tiếp tục và công cụ write_stdin. Cấu hình người dùng không thể tắt tính năng này.

in_app_browser = false tắt ngăn trình duyệt tích hợp.
in_app_updates = false tắt trình cập nhật riêng của ứng dụng ChatGPT trên máy tính khi khởi động lại, ở những nơi được hỗ trợ. Thiết lập này không ảnh hưởng đến việc triển khai gói bên ngoài hoặc kéo dài thời gian hỗ trợ cho các phiên bản ứng dụng cũ hơn. Để biết hướng dẫn thiết lập và triển khai, hãy xem Quản lý bản cập nhật ứng dụng.
browser_use = false tắt các khả năng Browser Use được hỗ trợ. Browser Use bên ngoài và Computer Use cho ứng dụng gốc có các tùy chọn kiểm soát riêng.
browser_use_full_cdp_access = false tắt quyền truy cập CDP đầy đủ trong môi trường thực thi cục bộ, bao gồm chế độ Nhà phát triển trình duyệt, đồng thời ngăn ứng dụng ChatGPT trên máy tính bật thiết lập tương ứng.
browser_use_external = false tắt Browser Use do tác nhân điều khiển thông qua các tiện ích mở rộng trình duyệt được hỗ trợ.
computer_use = false tắt Computer Use cho ứng dụng gốc, bao gồm việc vận hành trình duyệt như một ứng dụng gốc, cùng với Record & Replay và các quy trình cài đặt hoặc thiết lập liên quan.

Chỉ tắt Browser Use không chặn mọi cách truy cập trình duyệt. Computer Use cho ứng dụng gốc vẫn có thể vận hành trình duyệt khi khả năng đó và quyền truy cập ứng dụng được cho phép; các quy tắc về trang web và khả năng của Browser Use không áp dụng cho cách truy cập này. Để chặn cách truy cập này, hãy đặt Sử dụng máy tính thành Buộc tắt (computer_use = false), hoặc từ chối ứng dụng trình duyệt trong Quy tắc ứng dụng nếu các ứng dụng gốc khác cần tiếp tục khả dụng. Xem xét riêng Sử dụng trình duyệt bên ngoài và Trình duyệt trong ứng dụng. Xem phiên trình duyệt và các lần đăng nhập hiện có để biết các tùy chọn kiểm soát áp dụng cho từng cách truy cập.

Nếu bạn bỏ qua các khóa này, chính sách cho phép các tính năng đó, tùy theo tính khả dụng thông thường của ứng dụng khách, nền tảng và đợt triển khai.

Hạn chế sử dụng máy tính khi khóa

Để ngăn người dùng bật Locked Use trên máy Mac được quản lý, hãy mở Toàn cục > Yêu cầu > Các tùy chọn kiểm soát ứng dụng máy tính, đặt Cho phép sử dụng khi khóa thành Đã tắt, rồi chọn Lưu thay đổi. Thiết lập này không tắt Locked Use trên máy Mac đã bật tính năng đó.

Yêu cầu tương đương khi dùng trình chỉnh sửa TOML hoặc phân phối qua cơ chế quản lý thiết bị là:

[computer_use]
allow_locked_computer_use = false

Yêu cầu này loại bỏ các tùy chọn điều khiển để bật Locked Use. Yêu cầu này không tắt Locked Use nếu tính năng đó đã được bật. Nếu bạn bỏ qua yêu cầu này, tính khả dụng thông thường của sản phẩm và thiết lập cục bộ của người dùng vẫn được áp dụng.

Tắt Appshots

Appshots cho phép các ứng dụng khách được hỗ trợ đính kèm ảnh chụp nhanh ứng dụng. Để tắt tính năng này cho người dùng được quản lý qua đám mây, hãy mở Chỉnh sửa dưới dạng TOML trong Agent security và đặt trường allow_appshots ở cấp cao nhất trong requirements.toml Toàn cục. Đối với các đợt triển khai được quản lý qua thiết bị, hãy sử dụng nguồn cung cấp yêu cầu cục bộ phù hợp:

allow_appshots = false

Ở những nơi Appshots khả dụng, allow_appshots = false sẽ tắt tính năng này. Nếu bạn bỏ qua khóa này, các yêu cầu không hạn chế Appshots và các bước kiểm tra thông thường về tính khả dụng của sản phẩm sẽ được áp dụng. Các ứng dụng khách app-server đọc các yêu cầu có hiệu lực qua configRequirements/read nhận cùng hạn chế đó qua allowAppshots; giá trị bị bỏ qua hoặc null của allowAppshots không tắt Appshots.

Tắt điều khiển thiết bị từ xa

Để tắt điều khiển thiết bị từ xa cho người dùng được quản lý qua đám mây, hãy dùng Chỉnh sửa dưới dạng TOML trong Agent security và đặt trường allow_remote_control ở cấp cao nhất trong requirements.toml Toàn cục. Bạn cũng có thể đặt allow_remote_control trong một nguồn cung cấp yêu cầu cục bộ được hỗ trợ:

allow_remote_control = false

Ở những nơi điều khiển thiết bị từ xa được hỗ trợ, allow_remote_control = false sẽ tắt tính năng này. Nếu bạn bỏ qua khóa này, các yêu cầu không hạn chế điều khiển thiết bị từ xa và các bước kiểm tra thông thường về tính khả dụng của sản phẩm sẽ được áp dụng. Yêu cầu này không tắt các kết nối từ xa qua SSH.

Thiết lập phê duyệt và quyền thực thi

Sử dụng phần này để thiết lập hành vi phê duyệt, ranh giới quyền và các giá trị mặc định ban đầu. Bắt đầu với Giới hạn chính sách và Giá trị mặc định. Các tác vụ tiếp theo giải thích các yêu cầu TOML về việc bắt buộc sử dụng bên xét duyệt, hồ sơ quyền tùy chỉnh, hạn chế hệ thống tệp, thiết lập ghi đè cho máy chủ và quy tắc lệnh.

Yêu cầu do quản trị viên thực thi (requirements.toml)

Các yêu cầu ràng buộc những thiết lập nhạy cảm về bảo mật (chính sách phê duyệt, người xét duyệt yêu cầu phê duyệt, chính sách xét duyệt tự động, chế độ môi trường cô lập, hồ sơ quyền, chế độ tìm kiếm web, hook được quản lý, các MCP servers mà người dùng có thể bật và các nguồn kho plugin mà họ có thể dùng). Khi xác định cấu hình có hiệu lực (ví dụ từ config.toml, các tệp hồ sơ hoặc tùy chọn ghi đè cấu hình của CLI), nếu một giá trị xung đột với quy tắc bắt buộc, máy khách cục bộ sẽ dùng giá trị tương thích thay thế và thông báo cho người dùng. Nếu bạn cấu hình danh sách cho phép mcp_servers, máy khách chỉ bật MCP server khi cả tên và danh tính của máy chủ đều khớp với một mục đã được phê duyệt; nếu không, máy khách sẽ tắt máy chủ đó.

Các yêu cầu cũng có thể ràng buộc cờ tính năng thông qua bảng [features] trong requirements.toml. Lưu ý rằng tính năng không phải lúc nào cũng nhạy cảm về bảo mật, nhưng doanh nghiệp có thể cố định giá trị nếu muốn. Các khóa bị lược bỏ sẽ không bị ràng buộc.

Đối với Codex 0.138.0 trở lên, nên ưu tiên hồ sơ quyền với allowed_permission_profiles và default_permissions được quản lý. Chỉ dùng allowed_sandbox_modes cho các bản triển khai cũ vẫn còn cấu hình sandbox_mode.

Để xem danh sách khóa chính xác, hãy tham khảo phần requirements.toml trong Tài liệu tham khảo cấu hình.

Đặt giới hạn cho phê duyệt, môi trường cô lập và tìm kiếm trên web

Sử dụng Yêu cầu > Giới hạn chính sách để giới hạn các lựa chọn được hỗ trợ của ứng dụng khách. Các tùy chọn kiểm soát này ràng buộc cấu hình; chúng không chọn giá trị ban đầu. Đặt riêng giá trị ban đầu trong Giá trị mặc định.

Trong Toàn cục, mở Chính sách phê duyệt và chọn các kiểu phê duyệt được phép. Ví dụ: Hỏi khi cần cho phép tác nhân yêu cầu phê duyệt cho các hành động như nâng quyền để vượt giới hạn môi trường cô lập. Không bao giờ hỏi ngăn yêu cầu phê duyệt; tùy chọn này không cấp quyền thực thi không giới hạn.
Mở Chế độ môi trường cô lập để giới hạn các lựa chọn môi trường cô lập cũ. Chỉ đọc hạn chế thao tác ghi, Ghi trong không gian làm việc cho phép ghi trong không gian làm việc và các thư mục gốc được cấu hình cho phép ghi, còn Toàn quyền truy cập loại bỏ môi trường cô lập hệ thống tệp. Sử dụng yêu cầu về hồ sơ quyền cho các triển khai dùng hồ sơ quyền thay cho sandbox_mode.
Trong Toàn cục, mở Chế độ tìm kiếm web để giới hạn tìm kiếm web. Chọn Bộ nhớ đệm để cho phép tìm kiếm trong bộ nhớ đệm mà không tìm kiếm trực tiếp, hoặc Tắt để tắt tìm kiếm web. Các hạn chế tìm kiếm web độc lập với quy tắc mạng cho lệnh.
Xem lại các lựa chọn được phép và giá trị mặc định tương ứng, rồi chọn Lưu thay đổi.

Để trống một yêu cầu nghĩa là chính sách đó không áp đặt giới hạn nào. Các chính sách khác có liên quan vẫn áp dụng. Tùy chọn Hỏi đối với lệnh không đáng tin cậy tương ứng với untrusted trong danh sách cho phép của các yêu cầu; tùy chọn này không khôi phục thiết lập tường minh approval_policy = "untrusted" đã ngừng hỗ trợ. Làm theo hướng dẫn chuyển đổi bên dưới cho trường hợp đó.

Để giới hạn tìm kiếm web, dùng Toàn cục > Yêu cầu > Giới hạn chính sách > Chế độ tìm kiếm web. TOML tương đương là:

allowed_web_search_modes = ["cached"] # "disabled" remains implicitly allowed

allowed_web_search_modes = [] chỉ cho phép "disabled". Ví dụ: allowed_web_search_modes = ["cached"] ngăn tìm kiếm web trực tiếp ngay cả trong các phiên danger-full-access.

Đặt giá trị cấu hình mặc định

Các giá trị mặc định cung cấp cấu hình ban đầu cho thành viên. Chúng không áp đặt hạn chế hay cấp quyền truy cập vào tính năng của không gian làm việc.

Mở thẻ Giá trị mặc định của chính sách. Giữ các giá trị mặc định cho toàn bộ tác nhân trong Toàn cục; dùng thẻ môi trường có sẵn cho các giá trị thực thi mặc định được hỗ trợ.
Trong Thực thi lệnh, chọn Chính sách phê duyệt và Người xét duyệt phê duyệt ban đầu, cùng Chế độ môi trường cô lập hoặc Quyền mặc định phù hợp. Người xét duyệt xác định ai xét duyệt các yêu cầu phê duyệt theo mặc định; chính sách phê duyệt xác định khi nào có thể gửi yêu cầu.
Trong Tìm kiếm web, chọn chế độ Tìm kiếm web và Ngữ cảnh tìm kiếm web ban đầu. Trong Ứng dụng và công cụ, xem lại Ứng dụng/trình kết nối, Công cụ tương tác với môi trường bên ngoài và Công cụ có tính phá hủy cho các công cụ ứng dụng được hỗ trợ.
Xác nhận các giá trị mặc định đáp ứng Yêu cầu, rồi chọn Lưu thay đổi.

Dùng Chỉnh sửa dưới dạng TOML cho các giá trị mặc định được hỗ trợ nhưng không có điều khiển trực quan, chẳng hạn như cấu hình chợ plugin. Các giá trị mặc định trên đám mây này dùng thứ tự ưu tiên cấu hình thông thường. Chúng khác với thứ tự ưu tiên managed_config.toml cũ, vốn đặt các giá trị mặc định được quản lý cao hơn cấu hình cục bộ khi khởi động.

Ví dụ về requirements.toml

Ví dụ này chặn --ask-for-approval never và --sandbox danger-full-access (bao gồm --yolo):

allowed_approval_policies = ["untrusted", "on-request"]
allowed_sandbox_modes = ["read-only", "workspace-write"]

Ở đây, untrusted giữ nguyên cơ chế phê duyệt nghiêm ngặt hơn được suy ra từ trust_level = "untrusted"; điều này không có nghĩa là approval_policy = "untrusted" trở thành một thiết lập tường minh được hỗ trợ.

Chuyển đổi khỏi chính sách phê duyệt `untrusted` đã ngừng hỗ trợ

Codex và ChatGPT Work không còn hỗ trợ approval_policy = "untrusted". Xóa thiết lập này khỏi các giá trị mặc định được quản lý, managed_config.toml cũ và mọi cấu hình người dùng, dự án, hồ sơ hoặc khởi động có đặt thiết lập này.

Để sử dụng tương tác ở chế độ chỉ đọc, chọn approval_policy = "on-request" cùng với môi trường cô lập chỉ đọc hoặc hồ sơ quyền được các yêu cầu được quản lý của bạn cho phép. Các lệnh được môi trường cô lập đó cho phép có thể chạy mà không cần phê duyệt.

Để duy trì phê duyệt lệnh nghiêm ngặt hơn, không đặt tường minh approval_policy, đặt trust_level = "untrusted" trong mục của dự án trong ~/.codex/config.toml ở cấp người dùng và giữ untrusted trong allowed_approval_policies. Thao tác này cũng vô hiệu hóa cấu hình cục bộ của dự án. Việc đặt tường minh on-request sẽ ghi đè chính sách đó. Xem Chuyển đổi khỏi chính sách phê duyệt untrusted đã ngừng hỗ trợ để biết ví dụ và các đánh đổi về bảo mật.

Cấu hình chính sách xét duyệt tự động

Để đặt xét duyệt tự động làm mặc định, dùng Toàn cục > Giá trị mặc định > Thực thi lệnh > Người xét duyệt phê duyệt. Giá trị mặc định cho phép người dùng chọn người xét duyệt khác được phép. Để bắt buộc xét duyệt tự động hoặc cung cấp hướng dẫn xét duyệt của tổ chức, hãy dùng Chỉnh sửa dưới dạng TOML và chỉnh sửa requirements.toml trong Toàn cục. Các yêu cầu này độc lập với các điều khiển xét duyệt tự động của trình duyệt.

Dùng allowed_approvals_reviewers để bắt buộc hoặc cho phép xét duyệt tự động. Đặt giá trị này thành ["auto_review"] để bắt buộc xét duyệt tự động, hoặc thêm "user" khi người dùng có thể chọn phê duyệt thủ công.

Đặt guardian_policy_config để thay thế phần dành riêng cho đối tượng thuê trong chính sách xét duyệt tự động. Môi trường chạy cục bộ vẫn dùng mẫu người xét duyệt và quy ước đầu ra tích hợp sẵn. guardian_policy_config được quản lý có mức ưu tiên cao hơn [auto_review].policy cục bộ.

allowed_approval_policies = ["on-request"]
allowed_approvals_reviewers = ["auto_review"]

guardian_policy_config = """
## Environment Profile
- Trusted internal destinations include github.com/my-org, artifacts.example.com,
  and internal CI systems.

## Tenant Risk Taxonomy and Allow/Deny Rules
- Treat uploads to unapproved third-party file-sharing services as high risk.
- Deny actions that expose credentials or private source code to untrusted
  destinations.
"""

Kiểm soát các hồ sơ quyền khả dụng

Dùng Giá trị mặc định > Thực thi lệnh > Quyền mặc định để chọn hồ sơ tích hợp sẵn mà người dùng bắt đầu sử dụng. Để quy định những hồ sơ người dùng được chọn hoặc định nghĩa hồ sơ tùy chỉnh, dùng Chỉnh sửa dưới dạng TOML và cấu hình requirements.toml cho phạm vi Toàn cục hoặc môi trường thực thi được hỗ trợ phù hợp. Chỉ chọn một giá trị mặc định không hạn chế các hồ sơ có sẵn.

Dùng allowed_permission_profiles để kiểm soát những hồ sơ quyền tích hợp sẵn và tùy chỉnh mà người dùng có thể chọn. Đây là thành phần tương ứng với allowed_sandbox_modes dành cho hồ sơ quyền; hãy dùng danh sách cho phép phù hợp với cách người dùng của bạn chọn quyền.

Danh sách cho phép hồ sơ quyền yêu cầu Codex 0.138.0 trở lên. Codex 0.137.0 và các phiên bản cũ hơn bỏ qua allowed_permission_profiles và default_permissions được quản lý.

Chỉ dùng các ví dụ về hồ sơ quyền bên dưới sau khi mọi máy khách được quản lý đều chạy một bản phát hành hỗ trợ. Không triển khai hồ sơ tùy chỉnh được quản lý cho đến khi quá trình nâng cấp toàn bộ đội máy hoàn tất.

Khi có mặt, bảng này là danh sách đầy đủ các hồ sơ được phép. Bảng cho phép những hồ sơ được đặt thành true và từ chối các hồ sơ bị lược bỏ hoặc được đặt thành false, bao gồm cả những hồ sơ tích hợp sẵn được bổ sung trong các phiên bản Codex tương lai.

Cho phép các hồ sơ tiêu chuẩn

Chính sách này cho phép quyền chỉ đọc và quyền truy cập không gian làm việc, nhưng không cho phép quyền truy cập đầy đủ:

default_permissions = ":workspace"

[allowed_permission_profiles]
":read-only" = true
":workspace" = true
# ":danger-full-access" is omitted, so it is denied.

Thêm giá trị mặc định đặc quyền tối thiểu được quản lý

Quản trị viên có thể định nghĩa một hồ sơ tùy chỉnh trong cùng nguồn yêu cầu. Hãy dùng tên hồ sơ riêng của tổ chức để không xung đột với tên trong cấu hình đã tải của người dùng. Tên tùy chỉnh không được bắt đầu bằng : hoặc dùng tên dành riêng filesystem.

Không triển khai hồ sơ tùy chỉnh được quản lý cho các máy khách chạy Codex 0.137.0 hoặc cũ hơn. Những máy khách đó nhận diện được bảng hồ sơ nhưng không nhận diện được giá trị mặc định được quản lý chọn hồ sơ đó.

Ví dụ:

default_permissions = "acme_review_only"

[allowed_permission_profiles]
":read-only" = true
":workspace" = true
acme_review_only = true
# ":danger-full-access" is intentionally omitted, so it is denied.

[permissions.acme_review_only]
description = "Review code without modifying the workspace."
extends = ":read-only"

Chỉ cho phép hồ sơ do doanh nghiệp định nghĩa

Bỏ qua tất cả hồ sơ tích hợp sẵn khi người dùng chỉ được chọn các hồ sơ do quản trị viên định nghĩa:

default_permissions = "acme_workspace"

[allowed_permission_profiles]
acme_workspace = true

[permissions.acme_workspace]
description = "Workspace access with sensitive files denied."
extends = ":workspace"

[permissions.acme_workspace.filesystem]
glob_scan_max_depth = 3

[permissions.acme_workspace.filesystem.":workspace_roots"]
"**/*.env" = "deny"

Hồ sơ tùy chỉnh có thể mở rộng :workspace mặc dù người dùng không thể trực tiếp chọn hồ sơ tích hợp sẵn :workspace.

Tắt một hồ sơ được nguồn khác cho phép

Các danh sách cho phép quyền được kết hợp theo tên hồ sơ. Vì yêu cầu trên đám mây có mức ưu tiên cao hơn yêu cầu hệ thống, yêu cầu trên đám mây có thể dùng false để tắt một hồ sơ được tệp hệ thống cho phép.

Yêu cầu trên đám mây:

default_permissions = ":read-only"

[allowed_permission_profiles]
":read-only" = true
":workspace" = false

Yêu cầu hệ thống:

[allowed_permission_profiles]
":read-only" = true
":workspace" = true  # Not honored because cloud requirements set this to false.

Đặt tường minh default_permissions thành một hồ sơ được phép. Nếu bị lược bỏ, môi trường chạy cục bộ chỉ mặc định dùng :workspace khi cả :workspace và :read-only đều được cho phép tường minh. Khi không có allowed_permission_profiles, các yêu cầu được quản lý không hạn chế tên hồ sơ mà người dùng có thể chọn. Mỗi mục phải nêu tên một hồ sơ tích hợp sẵn hoặc một hồ sơ tùy chỉnh được định nghĩa trong nguồn cấu hình hoặc yêu cầu đã tải. Hãy định nghĩa hồ sơ tùy chỉnh trong các yêu cầu được quản lý để kiểm soát tập trung hành vi của chúng.

Thực thi các yêu cầu cấm đọc

Dùng Chỉnh sửa dưới dạng TOML để thêm hạn chế hệ thống tệp vào requirements.toml thuộc phạm vi Toàn cục hoặc môi trường thực thi được hỗ trợ phù hợp. Các hạn chế này chặn việc đọc các đường dẫn nhạy cảm; chỉ đặt mặc định là chỉ đọc không ẩn các tệp.

Quản trị viên có thể cấm đọc các đường dẫn chính xác hoặc mẫu glob bằng [permissions.filesystem]. Người dùng không thể nới lỏng các yêu cầu này bằng cấu hình cục bộ.

[permissions.filesystem]
deny_read = [
  # values can be absolute paths...
  "/**/*.env",
  # ...or relative to $HOME/%USERPROFILE% using `~`.
  "~/.ssh",
  # But relative paths starting with `./` are not allowed.
]

Khi có yêu cầu cấm đọc, môi trường chạy cục bộ từ chối quyền truy cập toàn phần và duy trì việc thực thi cục bộ trong môi trường cô lập chỉ đọc hoặc môi trường cô lập không gian làm việc để có thể thực thi các yêu cầu đó. Trên Windows gốc, deny_read được quản lý áp dụng cho các công cụ thao tác tệp trực tiếp; thao tác đọc của tiến trình con shell không sử dụng quy tắc môi trường cô lập này.

Ghi đè yêu cầu môi trường cô lập theo máy chủ

Dùng Chỉnh sửa dưới dạng TOML trong Bảo mật tác nhân để soạn yêu cầu dành riêng cho từng máy chủ. Các điều khiển môi trường chọn môi trường thực thi; các mẫu máy chủ chọn những máy khớp mẫu trong môi trường chạy được hỗ trợ.

Dùng [[remote_sandbox_config]] khi một chính sách được quản lý cần áp dụng các yêu cầu môi trường cô lập khác nhau trên những máy chủ khác nhau. Ví dụ, bạn có thể giữ giá trị mặc định nghiêm ngặt hơn cho máy tính xách tay, đồng thời cho phép ghi vào không gian làm việc trên các máy phát triển hoặc trình chạy CI khớp điều kiện. Hiện tại, các mục riêng theo máy chủ chỉ ghi đè allowed_sandbox_modes:

allowed_sandbox_modes = ["read-only"]

[[remote_sandbox_config]]
hostname_patterns = ["*.devbox.example.com", "runner-??.ci.example.com"]
allowed_sandbox_modes = ["read-only", "workspace-write"]

Môi trường chạy cục bộ so sánh từng mục hostname_patterns với tên máy chủ được phân giải theo cơ chế nỗ lực tối đa. Môi trường này ưu tiên tên miền đầy đủ khi có và quay về tên máy chủ cục bộ nếu không có. Việc đối sánh không phân biệt chữ hoa chữ thường; * khớp với chuỗi ký tự bất kỳ và ? khớp với một ký tự.

Mục [[remote_sandbox_config]] khớp đầu tiên sẽ thắng trong cùng một nguồn yêu cầu. Nếu không có mục nào khớp, môi trường chạy cục bộ giữ nguyên allowed_sandbox_modes cấp cao nhất. Việc đối sánh tên máy chủ chỉ dùng để lựa chọn chính sách; đừng coi đây là bằng chứng thiết bị đã được xác thực.

Thực thi quy tắc lệnh từ các yêu cầu

Dùng Chỉnh sửa dưới dạng TOML trong Bảo mật tác nhân để thêm quy tắc lệnh và hạn chế MCP server vào requirements.toml trong Toàn cục. Quy tắc lệnh chỉ định quyết định phê duyệt hoặc từ chối cho các lệnh khớp quy tắc; hạn chế MCP giới hạn những danh tính máy chủ mà máy khách có thể bật. Điều khiển Chính sách phê duyệt không dùng để soạn bất kỳ bộ quy tắc nào trong hai bộ này.

Quản trị viên cũng có thể thực thi các quy tắc hạn chế lệnh từ requirements.toml bằng bảng [rules]. Các quy tắc này được hợp nhất với các tệp .rules thông thường và quyết định nghiêm ngặt nhất vẫn được ưu tiên.

Khác với .rules, các quy tắc trong yêu cầu phải chỉ định decision và quyết định đó phải là "prompt" hoặc "forbidden" (không phải "allow").

[rules]
prefix_rules = [
  { pattern = [{ token = "rm" }], decision = "forbidden", justification = "Use git clean -fd instead." },
  { pattern = [{ token = "git" }, { any_of = ["push", "commit"] }], decision = "prompt", justification = "Require review before mutating history." },
]

Để hạn chế những MCP server mà máy khách cục bộ có thể bật, hãy thêm danh sách mcp_servers được phê duyệt. Với máy chủ stdio, đối chiếu theo command; với máy chủ HTTP hỗ trợ truyền dữ liệu dạng luồng, đối chiếu theo url:

[mcp_servers.docs]
identity = { command = "codex-mcp" }

[mcp_servers.remote]
identity = { url = "https://example.com/mcp" }

Dạng chuỗi của identity.command chỉ đối chiếu với command đã cấu hình. Dạng này không kiểm tra args, cwd, env hoặc env_vars.

Để ràng buộc toàn bộ lời gọi stdio, hãy đối chiếu tệp thực thi và từng đối số vị trí:

[mcp_servers.internal.identity]
command = { executable = "/usr/local/bin/codex-mcp", args = [
  { match = "exact", value = "serve" },
  { match = "prefix", value = "--workspace=" },
] }

Tệp thực thi, số lượng đối số và thứ tự đối số phải khớp. Các quy tắc đối số và URL hỗ trợ đối chiếu exact, prefix và regex trên toàn bộ giá trị. Các quy tắc lệnh có cấu trúc vẫn không kiểm tra cwd, env hoặc env_vars. Các MCP server đi kèm plugin sử dụng cùng các dạng danh tính trong plugins.<plugin>.mcp_servers.<server>.

Nếu mcp_servers có mặt nhưng để trống, máy khách cục bộ sẽ vô hiệu hóa tất cả MCP server.

Cấu hình quyền truy cập mạng

Kết nối mạng của lệnh và kết nối mạng của ứng dụng máy tính dùng các điều khiển khác nhau. Bắt đầu với Điều khiển sử dụng mạng cho lưu lượng lệnh được hỗ trợ, xem lại các giới hạn của môi trường và môi trường chạy, rồi dùng các yêu cầu riêng cho ứng dụng máy tính nếu cần. Các quy tắc trang web của trình duyệt vẫn nằm trong Kiểm soát trình duyệt và Computer Use.

Cấu hình yêu cầu truy cập mạng

Dùng Yêu cầu > Điều khiển sử dụng mạng để quản lý kết nối mạng của lệnh được hỗ trợ trong Bảo mật tác nhân. Cấu hình nền tảng chung trong Toàn cục, hoặc dùng thẻ Môi trường cục bộ hay Môi trường Codex Cloud có sẵn cho các thiết lập thực thi riêng theo môi trường.

Đặt Kết nối mạng được quản lý thành Bật để áp dụng quy tắc miền cho lưu lượng lệnh được quản lý. Chỉ thêm quy tắc miền sẽ không kích hoạt proxy được quản lý.
Trong Quy tắc mạng, chọn Thêm quy tắc mạng. Nhập Miền, chẳng hạn như api.openai.com hoặc **.example.com, không kèm giao thức URL hay đường dẫn. Chọn Cho phép hoặc Từ chối trong Quyền truy cập, rồi chọn Lưu quy tắc để cập nhật bản nháp. Lặp lại cho các đích khác.
Đặt Chỉ cho phép các miền do quản trị viên thêm thành Bật nếu cài đặt người dùng và phê duyệt theo từng miền không được phép mở rộng danh sách cho phép được quản lý. Thêm các mục Cho phép cần thiết; danh sách chỉ có mục từ chối sẽ không cho phép truy cập các đích khác.
Xem lại Cho phép truy cập mạng cục bộ cho các quy trình cần trình lắng nghe cục bộ hoặc đích riêng tư. Kết nối cục bộ trực tiếp có thể bỏ qua các quy tắc miền của proxy. Xem lại các giới hạn kết nối Codex Cloud bên dưới trước khi thay đổi cài đặt này.
Xem lại các quy tắc được kế thừa và thông báo xác thực, rồi chọn Lưu thay đổi. Kiểm thử một yêu cầu dự kiến thành công và một yêu cầu dự kiến bị chặn trong mọi môi trường thực thi bị ảnh hưởng.

Đặt Kết nối mạng được quản lý thành Tắt sẽ xóa các quy tắc mạng được tạo trong phạm vi đó và lưu giá trị tắt tường minh; thao tác này không vô hiệu hóa truy cập internet. Chưa đặt xóa các cài đặt mạng được tạo trong phạm vi đó để chính sách áp dụng hoặc giá trị mặc định của môi trường thực thi có thể có hiệu lực. Xóa cài đặt môi trường có thể làm các quy tắc Toàn cục được kế thừa có hiệu lực trở lại. Dùng Chỉnh sửa dưới dạng TOML cho các trường mạng nâng cao hoặc danh sách miền kiểu cũ hiện có mà trình chỉnh sửa trực quan không thể biểu diễn.

Dùng [experimental_network] trong requirements.toml khi quản trị viên cần định nghĩa tập trung các yêu cầu truy cập mạng. Những yêu cầu này tách biệt với nút chuyển features.network_proxy của người dùng: chúng có thể cấu hình kết nối mạng môi trường cô lập mà không cần cờ tính năng đó, nhưng không cấp quyền truy cập mạng cho lệnh khi môi trường cô lập đang hoạt động vẫn tắt kết nối mạng. Đặt experimental_network.enabled = true để kích hoạt proxy được quản lý; chỉ riêng các quy tắc miền sẽ không làm proxy hoạt động.

[experimental_network]
enabled = true
managed_allowed_domains_only = true

[experimental_network.domains]
"api.openai.com" = "allow"
"**.example.com" = "allow"
"blocked.example.com" = "deny"
"**.exfil.example.com" = "deny"

Chỉ dùng experimental_network.managed_allowed_domains_only = true khi bạn cũng định nghĩa các mục "allow" do quản trị viên sở hữu trong [experimental_network.domains] và muốn những quy tắc đó mang tính độc quyền. Nếu giá trị là true nhưng không có quy tắc cho phép được quản lý, các quy tắc cho phép miền do người dùng thêm sẽ không còn hiệu lực. Không kết hợp ánh xạ domains chuẩn với các danh sách cũ allowed_domains hoặc denied_domains.

*.example.com chỉ khớp với miền con. **.example.com khớp với miền gốc và các miền con của miền đó. Một quy tắc từ chối khớp điều kiện sẽ thắng quy tắc cho phép.

Cú pháp miền, quy tắc đích cục bộ/riêng tư, hành vi ưu tiên từ chối hơn cho phép và các hạn chế về DNS rebinding giống với hành vi mạng môi trường cô lập được mô tả trong Phê duyệt và bảo mật tác nhân.

Proxy định tuyến các lệnh cục bộ chạy bên trong môi trường cô lập. Các công cụ trình duyệt cũng kiểm tra các quy tắc từ chối mạng được quản lý và danh sách chỉ cho phép trước khi truy cập một nguồn. Đây là bước kiểm tra chính sách riêng biệt, không phải định tuyến lưu lượng trình duyệt qua proxy dành cho lệnh. Proxy này không lọc tìm kiếm trên web, ứng dụng và trình kết nối, MCP server, lưu lượng ứng dụng gốc, yêu cầu dịch vụ Codex hoặc lưu lượng riêng của các chức năng khác. Sử dụng các thiết lập kiểm soát cho từng thành phần:

Sử dụng allowed_web_search_modes để hạn chế tìm kiếm trên web.
Sử dụng features.apps = false để tắt các tích hợp ứng dụng và trình kết nối, và features.plugins = false để tắt plugin ở những nơi được hỗ trợ.
Sử dụng danh sách phê duyệt mcp_servers được quản lý để hạn chế MCP server.
Sử dụng các yêu cầu về tính năng như browser_use, in_app_browser và computer_use để hạn chế khả năng sử dụng trình duyệt và máy tính.
Đối với các lệnh Codex Cloud được quản lý có hỗ trợ, hãy cấu hình riêng các yêu cầu Agent Security và thiết lập internet của môi trường Cloud.

Danh sách cho phép miền lệnh không thay thế những biện pháp kiểm soát riêng theo khả năng này.

Trên các luồng thực thi Codex Cloud được quản lý có hỗ trợ, các yêu cầu Agent Security giới hạn hoạt động mạng của lệnh. Thiết lập internet của môi trường Codex Cloud được áp dụng riêng. Một miền được cho phép trong Agent Security không ghi đè hạn chế trong thiết lập internet của môi trường Cloud. Bản thân các biện pháp kiểm soát mạng dành cho lệnh này không vô hiệu hóa tìm kiếm trên web được lưu trữ trên dịch vụ, ứng dụng hoặc MCP. ChatGPT Work Cloud có các quyền chức năng riêng và không kế thừa những yêu cầu Agent Security này.

Danh sách cho phép dành cho lệnh được quản lý áp dụng cho các lệnh sử dụng proxy được quản lý. Khi chính sách cho phép nâng quyền để vượt toàn bộ giới hạn môi trường cô lập và việc này được phê duyệt, quá trình thực thi đó có thể bỏ qua proxy dành cho lệnh. Việc cấp quyền mạng trong phạm vi hẹp khác với nâng quyền để vượt toàn bộ giới hạn môi trường cô lập. Cấu hình các yêu cầu phê duyệt và môi trường cô lập bắt buộc để thiết lập ranh giới mong muốn, đồng thời kiểm thử cả lệnh thông thường lẫn lệnh được nâng quyền.

Không có đích được phép nào có hiệu lực: Khi Kết nối mạng được quản lý và Chỉ cho phép các miền do quản trị viên thêm đều Bật, các lệnh được quản lý thông thường cần có đích được phép có hiệu lực. Nếu không có mục Cho phép nào được cấu hình hoặc kế thừa, các lệnh đó sẽ không có đích nào được phép truy cập. Chính sách chỉ có mục từ chối không ngầm cho phép truy cập phần còn lại của internet. Thêm các mục Cho phép cần thiết và kiểm tra các quy tắc được kế thừa trước khi lưu. Hạn chế này áp dụng cho proxy lệnh được quản lý, không áp dụng cho mọi công cụ hoặc việc nâng quyền để vượt toàn bộ giới hạn môi trường cô lập đã được phê duyệt.

Kết nối cục bộ/riêng tư của Codex Cloud: Giá trị Tắt được đặt rõ ràng cho kết nối cục bộ/riêng tư có thể ngăn Codex Cloud truy cập proxy thượng nguồn, ngay cả khi miền đích được cho phép. Kiểm tra giá trị allow_local_binding cuối cùng và xác định chính sách hoặc cài đặt nào cung cấp giá trị đó. Trên luồng proxy Cloud được hỗ trợ, giá trị này chỉ mặc định là true khi không có yêu cầu áp dụng, cấu hình mạng được chọn hoặc cài đặt tính năng proxy nào cung cấp giá trị. Giá trị false được kế thừa vẫn được tính là một cài đặt rõ ràng. Khi được hỗ trợ, hãy đặt giá trị ghi đè Cloud có mức ưu tiên cao hơn để thay đổi giá trị này cho Codex Cloud mà không thay đổi giá trị Global được Local sử dụng. Thao tác này không thêm mục Allow cho miền. Xác minh khả năng hỗ trợ của trình thực thi trước khi dựa vào giá trị ghi đè. Không áp dụng giá trị mặc định Cloud này cho Local.

Khi các yêu cầu của môi trường để trống, các yêu cầu Toàn cục sẽ áp dụng. Đặt Kết nối mạng được quản lý thành Tắt là cài đặt riêng biệt với cài đặt truy cập Internet của môi trường Cloud. Xem Các biện pháp kiểm soát thực thi trong Bảo mật tác nhân để biết chi tiết về phạm vi thực thi.

Thứ tự ưu tiên của chính sách mạng và các giới hạn của môi trường thực thi

Trong một chính sách nhất định, thứ tự từ cao xuống thấp là ghi đè môi trường cho từng hệ điều hành → ghi đè môi trường cho mọi hệ điều hành → Toàn cục. Chính sách có mức ưu tiên cao hơn vẫn được ưu tiên so với chính sách có mức ưu tiên thấp hơn, ngay cả khi chính sách có mức ưu tiên thấp hơn cụ thể hơn. Một số yêu cầu có quy tắc hợp nhất riêng cho từng trường. Sau đó, môi trường thực thi sẽ thực thi các yêu cầu đã được xác định. Hãy xem xét các trường hợp mạng theo từng trường bên dưới tách biệt với mức ưu tiên của chính sách.

Các ví dụ này so sánh cài đặt môi trường và Toàn cục trong cùng một chính sách, khi kết nối mạng được quản lý đã được cấu hình và không có chính sách ưu tiên cao hơn thay đổi các giá trị. Chúng mô tả cách hợp nhất theo từng trường và hành vi của môi trường thực thi.

Đặt quyền truy cập miền khác nhau theo môi trường

Đối với cùng một quy tắc miền trong một chính sách, ghi đè môi trường của quản trị viên có thể cho phép một miền bị từ chối trong Toàn cục hoặc từ chối một miền được cho phép trong Toàn cục. Nếu không có ghi đè môi trường, quy tắc Toàn cục sẽ được kế thừa. Các quy tắc Từ chối hoặc biện pháp kiểm soát truy cập khác đang có hiệu lực vẫn có thể chặn yêu cầu.

Cách kết hợp các quy tắc miền

Quy tắc Toàn cục	Quy tắc môi trường	Kết quả chính sách miền
Từ chối	Cho phép	Được cho phép nhờ ghi đè môi trường, tùy thuộc vào các điều kiện bên dưới.
Cho phép	Từ chối	Bị chặn trong môi trường đó.
Cho phép	Cho phép	Được cho phép theo các quy tắc miền này.
Từ chối	Từ chối	Bị chặn theo các quy tắc miền này.
Cho phép hoặc Từ chối	Không ghi đè	Kế thừa quy tắc Toàn cục.

Các kết quả này so sánh cùng một khóa miền trong một chính sách, khi không có chính sách ưu tiên cao hơn thay đổi kết quả. Giá trị có mức ưu tiên cao hơn thay thế giá trị của cùng khóa đó. Các khóa được kế thừa khác vẫn được giữ lại. Một mục Cho phép không bỏ qua một mục Từ chối khác cũng khớp, chẳng hạn như ký tự đại diện được kế thừa. Ánh xạ môi trường trống không xóa các quy tắc được kế thừa.

Ví dụ: Từ chối packages.example.com trong Toàn cục và cho phép miền đó trong môi trường Phát triển. Môi trường Phát triển có thể cho phép miền đó theo các điều kiện ở trên. Môi trường Sản xuất kế thừa quy tắc Từ chối của Toàn cục trừ khi có ghi đè.

Xác nhận rằng trình thực thi đã triển khai hỗ trợ các quy tắc hợp nhất này. Vẫn cần xác thực mức độ hỗ trợ của các trình thực thi được quản lý thông thường.

Giới hạn của Orchestrator. Môi trường thực thi đám mây không hỗ trợ các cổng lắng nghe HTTP/SOCKS được quản lý và trình lắng nghe proxy trên địa chỉ không phải loopback; khả năng hỗ trợ quy tắc socket phụ thuộc vào luồng thực thi. Cài đặt thực thi cục bộ trong bảng bên dưới không phải là cấu hình Orchestrator được hỗ trợ.

Các giới hạn mạng khác của môi trường thực thi

Tất cả tên trường bên dưới đều nằm trong experimental_network của requirements.toml. Các mũi tên biểu thị giá trị Toàn cục, tiếp theo là giá trị môi trường trong cùng một chính sách. Các trường hợp thực thi cục bộ này không xác nhận rằng Orchestrator hỗ trợ những cài đặt tương tự.

Cài đặt và thao tác ghi đè được thử	Hành vi của môi trường thực thi	Thao tác của quản trị viên
domains: deny → allow	Mục Cho phép của môi trường thay thế cùng khóa miền Toàn cục trên các luồng được hỗ trợ. Các quy tắc Từ chối khác khớp với miền vẫn áp dụng.	Kiểm thử cả yêu cầu được phép và bị chặn trên trình thực thi đã triển khai.
`managed_allowed_domains_only`: true → false	Không suy ra hành vi chỉ cho phép từ cách kết hợp các khóa miền. Khi `enabled = true` và `managed_allowed_domains_only = true` có hiệu lực, các lệnh thông thường cần có mục Cho phép có hiệu lực.	Xem lại các cài đặt có hiệu lực và mục Cho phép được kế thừa. Chính sách chỉ có mục từ chối không cho phép truy cập phần còn lại của internet.
`allow_local_binding`: false → true	Trên luồng proxy Codex Cloud được hỗ trợ, giá trị false tường minh có thể ngăn truy cập proxy thượng nguồn. Ghi đè Cloud có mức ưu tiên cao hơn và được hỗ trợ có thể thay đổi giá trị này.	Kiểm tra nguồn của giá trị có hiệu lực và khả năng hỗ trợ của trình thực thi. Không áp dụng giá trị mặc định của Cloud cho Cục bộ.

Việc kích hoạt proxy, chế độ chỉ cho phép, hành vi của proxy thượng nguồn và các quy tắc Unix-socket có hành vi riêng tùy theo trình thực thi. Không khái quát hóa cách kết hợp các khóa miền sang những cài đặt này. Xác minh các giá trị có hiệu lực và kiểm thử môi trường thực thi đã triển khai. Để biết về kết nối cục bộ/riêng tư của Codex Cloud, xem Cấu hình yêu cầu truy cập mạng.

Xác minh hành vi trước khi triển khai rộng rãi

Kiểm thử các đích thực tế, trình lắng nghe cục bộ, hành vi proxy và đường dẫn socket mà quy trình của bạn sử dụng. Kiểm tra một thao tác dự kiến thành công và một thao tác dự kiến bị chặn trong từng môi trường bị ảnh hưởng. Kiểm tra xem phiên bản môi trường thực thi đã triển khai có hỗ trợ từng cài đặt bạn sử dụng hay không.

Kiểm soát các đích kết nối mạng của ứng dụng máy tính

Dùng Chỉnh sửa dưới dạng TOML trong Bảo mật tác nhân để cấu hình các yêu cầu dành riêng cho ứng dụng máy tính này trong Toàn cục. Giao diện Kiểm soát sử dụng mạng quản lý kết nối mạng của lệnh, vốn là một chính sách riêng biệt.

Sử dụng [application.network] trong requirements.toml để giới hạn các đích kết nối mạng của ứng dụng máy tính. Với enabled = true, các yêu cầu ra bên ngoài phải sử dụng HTTPS hoặc WSS và khớp chính xác với một miền có giá trị "allow" trong [application.network.domains]. Các miền con không được tự động cho phép. Nếu bảng ánh xạ miền trống, không đích bên ngoài nào được phép. Xem Tài liệu tham khảo cấu hình để biết các khóa được hỗ trợ.

Chính sách này tách biệt với quy tắc mạng cho lệnh và quy tắc nguồn gốc của trình duyệt. Chính sách này không áp đặt giới hạn đích kết nối đối với các mô-đun gốc hoặc tiến trình được khởi tạo, và không chi phối việc thực thi trong Work Cloud.

Cấu hình plugin và hook được quản lý

Đối với các tác vụ này, dùng Chỉnh sửa dưới dạng TOML trong Bảo mật tác nhân hoặc một nguồn cấu hình cục bộ được hỗ trợ. Giá trị mặc định của kho plugin, hạn chế plugin bắt buộc và hook được quản lý có mục đích khác nhau; hãy chọn tác vụ phù hợp với chính sách bạn cần.

Cấu hình kho plugin và giá trị mặc định

Dùng Bảo mật tác nhân > Chỉnh sửa dưới dạng TOML để xác định kho plugin cục bộ hoặc Git và các giá trị mặc định của plugin trong tài liệu config.toml Toàn cục. Bạn cũng có thể phân phối các cài đặt này trong config.toml của hệ thống. Chúng cung cấp cấu hình ban đầu cho kho plugin và plugin, không phải chính sách bắt buộc. Để giới hạn các nguồn mà thành viên có thể sử dụng, hãy cấu hình yêu cầu về nguồn kho plugin.

Xem Tài liệu tham chiếu cấu hình để biết các khóa cấu hình, Thứ tự ưu tiên cấu hình để biết về ghi đè và cài đặt plugin cho kho mã để biết về cấu hình cấp dự án. Nhập và đồng bộ hóa GitHub trong không gian làm việc là chức năng riêng biệt.

Kiểm soát khả năng sử dụng plugin

Dùng Chỉnh sửa dưới dạng TOML trong Bảo mật tác nhân để thiết lập các cài đặt tính năng plugin bắt buộc trong requirements.toml Toàn cục, hoặc phân phối chúng thông qua các yêu cầu cục bộ cho ứng dụng khách được quản lý trên thiết bị. Giá trị mặc định > Ứng dụng và công cụ > Ứng dụng/trình kết nối đặt giá trị mặc định cho công cụ ứng dụng; đây không phải công tắc features.plugins bắt buộc. Để biết về quyền plugin trong không gian làm việc, xem Ứng dụng và trình kết nối.

Để tắt plugin trong các máy khách cục bộ được hỗ trợ, hãy đặt features.plugins thành false trong requirements.toml:

features.plugins = false

Cài đặt này cũng áp dụng khi người dùng đăng nhập vào Codex bằng API key. Hãy xem tài liệu tham khảo features.plugins để biết cấu hình được hỗ trợ.

Hạn chế nguồn marketplace plugin

Sử dụng Chỉnh sửa dưới dạng TOML để cấu hình các yêu cầu về nguồn marketplace trong requirements.toml ở phạm vi Global, hoặc phân phối chúng qua các yêu cầu cục bộ. Các quy tắc này giới hạn những nguồn cục bộ hoặc Git mà người dùng có thể thêm và sử dụng. Chúng độc lập với các giá trị mặc định của marketplace.

Để hạn chế các nguồn kho plugin, hãy đặt restrict_to_allowed_sources = true và xác định một hoặc nhiều quy tắc nguồn:

[marketplaces]
restrict_to_allowed_sources = true

[marketplaces.allowed_sources.company_plugins]
source = "git"
url = "https://github.com/example/company-plugins.git"
ref = "main"

[marketplaces.allowed_sources.internal_git]
source = "host_pattern"
host_pattern = '^git\.example\.com$'

[marketplaces.allowed_sources.local_plugins]
source = "local"
path = "/opt/company/codex-plugins"

Quy tắc Git đối sánh URL kho lưu trữ đã chuẩn hóa và, khi có, một ref chính xác. Mẫu máy chủ là biểu thức chính quy được đối sánh với máy chủ Git viết thường; hãy dùng ^ và $ để đối sánh toàn bộ máy chủ. Quy tắc cục bộ yêu cầu một đường dẫn tuyệt đối, đã chuẩn hóa. Hãy xem tài liệu tham khảo requirements.toml để biết đầy đủ lược đồ và hành vi hợp nhất.

Các yêu cầu này từ chối thao tác thêm kho plugin, cài đặt plugin và làm mới kho plugin Git đã cấu hình nếu không khớp quy tắc nguồn. Chúng cũng lọc các kho plugin đã cấu hình và các plugin của những kho đó trong thời gian chạy.

Các kho plugin Git do OpenAI tuyển chọn, bao gồm danh mục API key, cũng phải khớp với danh sách nguồn được phép. Để cho phép các kho này, hãy thêm nguồn Git sau mà không đặt ràng buộc ref:

[marketplaces.allowed_sources.openai_curated]
source = "git"
url = "https://github.com/openai/plugins.git"

Để loại trừ các danh mục được tuyển chọn, hãy bỏ nguồn đó và bảo đảm không có quy tắc máy chủ nào rộng hơn cho phép nguồn đó. Các plugin đi kèm và plugin của không gian làm việc được cài đặt từ xa không thuộc phạm vi của chính sách nguồn Git được tuyển chọn này.

Những hạn chế nguồn này chỉ áp dụng ở nơi máy khách cục bộ hỗ trợ thao tác với marketplace plugin: ChatGPT và Codex trong ứng dụng dành cho máy tính, cùng Codex CLI. Chúng không kiểm soát việc sử dụng plugin trong ChatGPT trên web hoặc thiết bị di động và không thêm plugin vào tiện ích mở rộng IDE.

Thực thi hook được quản lý thông qua các yêu cầu

Hook được quản lý chạy các hành động do quản trị viên xác định khi xảy ra các sự kiện tác vụ hoặc công cụ được hỗ trợ. Sử dụng Chỉnh sửa dưới dạng TOML trong Agent Security để cấu hình chúng trong requirements.toml ở phạm vi Global; các tùy chọn cài đặt không có trình chỉnh sửa hook riêng. Các luồng thực thi bên dưới quyết định những loại hook có thể chạy.

Trước khi dựa vào các hook này, hãy kiểm tra khả năng kết nối của hàm gọi lại, các sự kiện cần thiết và hành vi khi xảy ra lỗi. Một phản hồi từ chối rõ ràng được hỗ trợ có thể chặn hành động, nhưng lỗi hàm gọi lại PreToolUse, hết thời gian chờ hoặc phản hồi sai định dạng có thể khiến hook thất bại mà không chặn công cụ. Hook MCP không cung cấp nhật ký kiểm toán Compliance API đầy đủ. Các ví dụ về tập lệnh và thư mục sau đây vẫn chỉ áp dụng cho Codex.

Quản trị viên cũng có thể định nghĩa các hook vòng đời được quản lý trực tiếp trong requirements.toml. Sử dụng [hooks] cho cấu hình hook và trỏ managed_dir đến thư mục mà MDM hoặc công cụ quản lý thiết bị đầu cuối của bạn dùng để cài đặt các tập lệnh được tham chiếu.

Để thực thi hook được quản lý ngay cả với người dùng đã tắt hook cục bộ, hãy cố định [features].hooks = true cùng với [hooks]. Để bỏ qua hook của người dùng, dự án, phiên và plugin trong khi vẫn cho phép hook được quản lý, hãy đặt allow_managed_hooks_only = true.

allow_managed_hooks_only = true

[features]
hooks = true

[hooks]
managed_dir = "/enterprise/hooks"
windows_managed_dir = 'C:\enterprise\hooks'

[[hooks.PreToolUse]]
matcher = "^Bash$"

[[hooks.PreToolUse.hooks]]
type = "command"
command = "python3 /enterprise/hooks/pre_tool_use_policy.py"
command_windows = 'py -3 C:\enterprise\hooks\pre_tool_use_policy.py'
timeout = 30
statusMessage = "Checking managed Bash command"

Lưu ý:

Môi trường thực thi cục bộ thực thi cấu hình hook từ requirements.toml, nhưng không phân phối các tập lệnh trong managed_dir.
Phân phối các tập lệnh đó bằng MDM hoặc giải pháp quản lý thiết bị của bạn.
Các lệnh hook được quản lý nên tham chiếu đến đường dẫn tuyệt đối của tập lệnh trong thư mục được quản lý đã cấu hình.
allow_managed_hooks_only = true bỏ qua hook từ các nguồn người dùng, dự án, phiên và plugin, nhưng vẫn tải hook từ requirements.toml và các lớp cấu hình được quản lý khác.

Tìm hiểu phạm vi và thứ tự ưu tiên của chính sách

Sử dụng phần này để kiểm tra nơi chính sách áp dụng, cách các yêu cầu kết hợp, cách ứng dụng khách nhận các cài đặt được quản lý trên đám mây và cách xác minh kết quả.

Đối với Work có quyền truy cập cục bộ và dots, chính sách Global được hỗ trợ chi phối bộ điều phối đám mây dùng chung khi chính sách được quản lý được bật; các yêu cầu thực thi cục bộ có liên quan chi phối máy tính được kết nối. Các vùng chứa đám mây của Work giữ nguyên các chính sách Work Cloud hiện có, và các biện pháp kiểm soát thiết bị được hỗ trợ vẫn áp dụng cho việc thực thi cục bộ. Codex giữ nguyên cách hoạt động của cấu hình hiện có. Cấu hình được quản lý không cấp suất sử dụng không gian làm việc hoặc quyền truy cập tính năng. Sử dụng Vai trò và quyền trong không gian làm việc để quản lý các quyền này.

Agent Security và quyền truy cập máy tính cục bộ với Work Cloud

Sử dụng Agent Security trong Bảng điều khiển quản trị để quản lý chính sách và cấu hình. Tính năng này thay thế Chính sách & Cấu hình. Agent Security có sẵn trong Bảng điều khiển quản trị, độc lập với quyền truy cập máy tính cục bộ với Work Cloud. Các chính sách, phân công áp dụng và thứ tự hiện có được giữ nguyên. Hãy xem lại các chính sách hiện có trong Agent Security. Quyền truy cập máy tính cục bộ với Work Cloud là tùy chọn cần bật riêng. Xem Agent Security để biết hướng dẫn chuyển đổi.

Trước khi chuyển quy trình tự động hóa chính sách sang Agent Security:

Xác định các tích hợp bị ảnh hưởng. Lập danh sách các cấu hình Terraform và tập lệnh cập nhật chính sách, đồng thời ghi lại những chính sách mà chúng quản lý.
Sử dụng API chính sách để quản lý các cài đặt Global. Để quản lý các cài đặt Local hoặc Codex Cloud, hãy sử dụng giao diện Agent Security. Các quy trình API Global hiện có vẫn khả dụng sau khi chuyển đổi. Kiểm thử các tập lệnh và tích hợp Terraform của bạn, đồng thời xác nhận rằng các phân công áp dụng chính sách và thứ tự không thay đổi.
Thực hiện các thay đổi cần thiết và kiểm thử quy trình tự động hóa. Xác minh rằng bản cập nhật dự kiến được áp dụng cho đúng chính sách Agent Security và các biện pháp kiểm soát tương ứng được thực thi.

Việc chuyển đổi chính sách không cấp quyền truy cập máy tính cục bộ cho Work hoặc dots. Bạn nên xem lại hoặc tạo chính sách trước khi triển khai, nhưng quy trình xác nhận không yêu cầu tạo chính sách để bật quyền truy cập. Trước khi bật Cho phép truy cập máy tính cục bộ, hãy xem lại cấu hình cơ sở đã chuyển đổi hoặc tạo cấu hình cơ sở trên đám mây nếu các chính sách của bạn hiện chỉ được phân phối qua MDM. Nếu enforce_residency được bật trong bất kỳ chính sách đám mây nào, Cho phép truy cập máy tính cục bộ sẽ bị vô hiệu hóa cho cả Work và dots. Biện pháp bảo vệ này không cấu hình nơi lưu trú dữ liệu của không gian làm việc và bản thân nó cũng không vô hiệu hóa Work Cloud hay dots.

Các cấu hình ghi đè theo môi trường điều chỉnh những cài đặt được hỗ trợ trong một chính sách. Trong một chính sách nhất định, thứ tự từ cao xuống thấp là cấu hình ghi đè theo môi trường dành riêng cho hệ điều hành → cấu hình ghi đè theo môi trường cho mọi hệ điều hành → Global. Chính sách có mức ưu tiên cao hơn vẫn được ưu tiên so với chính sách có mức ưu tiên thấp hơn, ngay cả khi chính sách có mức ưu tiên thấp hơn cụ thể hơn. Một số yêu cầu có quy tắc hợp nhất riêng cho từng trường. Hãy xác nhận những trình chỉnh sửa cấu hình ghi đè và trường nào khả dụng cho không gian làm việc của bạn.

Khi chính sách được quản lý và hook từ xa được bật, Work Cloud có quyền truy cập cục bộ và dots sử dụng các hook MCP từ xa do quản trị viên quản lý trên bộ điều phối đám mây. Cấu hình các trình xử lý mcp_tool trong requirements.toml ở phạm vi Global. Work Cloud không có quyền truy cập cục bộ và các tài khoản cá nhân không sử dụng những hook doanh nghiệp này. Các trình xử lý lệnh/shell, prompt và tác nhân; hook từ cấu hình cục bộ, plugin hoặc thư mục cục bộ; hook có phạm vi môi trường; và hook MCP SessionEnd không được hỗ trợ khi điều phối trên đám mây, ngay cả khi công cụ thực thi cục bộ. Khi cả điều phối và thực thi đều diễn ra cục bộ, các hook hiện được hỗ trợ vẫn hoạt động trong các luồng Work và Codex chỉ chạy cục bộ. Quản trị viên vẫn có thể cấu hình các hook được quản lý được hỗ trợ trong Agent Security cho những quy trình này. Trước khi dựa vào các hook này, hãy kiểm tra khả năng kết nối của hàm gọi lại, các sự kiện cần thiết và hành vi khi xảy ra lỗi. Một phản hồi từ chối rõ ràng được hỗ trợ có thể chặn hành động, nhưng lỗi hàm gọi lại PreToolUse, hết thời gian chờ hoặc phản hồi sai định dạng có thể khiến hook thất bại mà không chặn công cụ. Hook MCP không cung cấp nhật ký kiểm toán Compliance API đầy đủ. Xem Tài liệu tham chiếu cấu hình.

Vị trí và thứ tự ưu tiên

Đối với việc thực thi cục bộ, các yêu cầu được áp dụng theo thứ tự ưu tiên từ thấp đến cao như sau. Thứ tự này cũng áp dụng cho các bước cục bộ khi sử dụng quyền truy cập máy tính cục bộ với Work Cloud:

requirements.toml của hệ thống (/etc/codex/requirements.toml trên các hệ thống Unix, bao gồm Linux và macOS, hoặc %ProgramData%\OpenAI\Codex\requirements.toml trên Windows).
Các yêu cầu Agent Security được phân phối trong gói cấu hình đám mây.
Các trường managed_config.toml cũ mà ứng dụng khách cục bộ diễn giải lại thành yêu cầu.
Các tùy chọn được quản lý của macOS (MDM) được phân phối qua com.openai.codex:requirements_toml_base64.

Các lớp có mức ưu tiên cao hơn ghi đè các giá trị vô hướng và danh sách thông thường từ các lớp thấp hơn. Các bảng hợp nhất theo khóa, còn các yêu cầu như quy tắc, hook và hạn chế hệ thống tệp có cách kết hợp riêng cho từng trường. Sử dụng tài liệu tham chiếu requirements.toml để xem lược đồ hiện tại thay vì giả định rằng mọi trường đều hợp nhất theo cùng một cách.

Để tương thích ngược, các ứng dụng khách cục bộ được hỗ trợ diễn giải lại các trường cũ approval_policy, approvals_reviewer và sandbox_mode thành các yêu cầu. Việc chuyển đổi này bổ sung các lựa chọn tương thích khi cần; sử dụng requirements.toml để xác định rõ các danh sách cho phép.

Thứ tự ưu tiên cho quyền truy cập máy tính cục bộ với Work Cloud

Đối với Work có quyền truy cập cục bộ và dots, hãy phân biệt chính sách Global của bộ điều phối với chính sách thực thi. Các yêu cầu cục bộ có liên quan chi phối máy tính được kết nối. Các vùng chứa đám mây của Work và máy tính đám mây của dots sử dụng cấu hình và yêu cầu thực thi riêng, thay vì gói môi trường được quản lý mà các bộ thực thi khác sử dụng.

Đối với việc thực thi cục bộ, MDM và các yêu cầu quản lý thiết bị kiểu cũ có mức ưu tiên cao hơn Agent Security. Tệp yêu cầu hệ thống của thiết bị có mức ưu tiên thấp hơn Agent Security. Trong mỗi chính sách, áp dụng các thiết lập ghi đè môi trường dành riêng cho từng hệ điều hành trước các thiết lập ghi đè môi trường cho mọi hệ điều hành, rồi đến Global. Khi so sánh giữa các chính sách, mức ưu tiên của chính sách được ưu tiên hơn mức độ cụ thể.

Biện pháp kiểm soát	Work cục bộ không đồng bộ và Codex cục bộ	Truy cập máy tính cục bộ với Work Cloud
Yêu cầu của doanh nghiệp	Tuân theo thứ tự yêu cầu cục bộ ở trên.	Áp dụng cho các trình thực thi cục bộ. Các container đám mây của Work vẫn giữ các chính sách Work Cloud hiện có.
Hạn chế thực thi trên thiết bị	Được thực thi bằng các biện pháp kiểm soát cục bộ được hỗ trợ.	Tuân theo thứ tự yêu cầu cục bộ ở trên, trong đó MDM và các yêu cầu kiểu cũ có mức ưu tiên cao hơn Agent Security.
Thiết lập ghi đè môi trường	Sử dụng mô hình cấu hình của sản phẩm tương ứng.	Trong một chính sách: thiết lập ghi đè môi trường dành riêng cho từng hệ điều hành, rồi đến thiết lập ghi đè môi trường cho mọi hệ điều hành, sau đó là Global. Chính sách có mức ưu tiên thấp hơn không thể được ưu tiên chỉ nhờ mức độ cụ thể.

Các yêu cầu đặt ra ràng buộc, còn giá trị mặc định của cấu hình cung cấp các giá trị ban đầu. Đối với Work có quyền truy cập cục bộ và dots, chính sách Global được hỗ trợ sẽ áp dụng thông qua bộ điều phối đám mây dùng chung khi chính sách được quản lý được bật. Các yêu cầu requirements.toml cục bộ có liên quan chi phối việc thực thi trên máy tính được kết nối. Các container đám mây của Work và máy tính đám mây của dots sử dụng cấu hình thực thi và yêu cầu riêng, thay vì gói môi trường được quản lý mà các loại trình thực thi khác sử dụng. Các hạn chế thực thi cục bộ không tự động áp dụng cho những máy tính đám mây này. Hãy rà soát quyền sử dụng các tính năng đám mây và kiểm thử riêng việc thực thi cục bộ và trên đám mây.

Giữ các biện pháp kiểm soát bộ điều phối, bao gồm phê duyệt và tìm kiếm trên web, trong Global. Sử dụng các biện pháp kiểm soát chuyên biệt Chính sách phê duyệt được phép và Chế độ tìm kiếm trên web được phép nếu có, và dùng TOML cho các trường được hỗ trợ khác. Xem Tài liệu tham chiếu cấu hình để biết danh sách trường và phạm vi thực thi.

Yêu cầu được quản lý trên đám mây

Khi người dùng đăng nhập bằng ChatGPT với gói được hỗ trợ, các ứng dụng khách cục bộ được hỗ trợ có thể nhận các yêu cầu do quản trị viên áp đặt gắn với không gian làm việc. Đây là kênh phân phối chính sách tương thích với requirements.toml. Kênh này không cấp quyền truy cập không gian làm việc hoặc thay thế RBAC của không gian làm việc. Các yêu cầu xác thực phải được quản lý cục bộ.

Cấu hình các yêu cầu phổ biến bằng các biện pháp kiểm soát bảo mật tác nhân. Với chính sách chỉ cho phép phê duyệt on-request và môi trường cô lập read-only hoặc workspace-write, hãy dùng Chính sách phê duyệt và Chế độ môi trường cô lập trong Giới hạn chính sách. Để cũng yêu cầu xác nhận trước khi một điểm vào shell được hỗ trợ chạy, hãy dùng Chỉnh sửa dưới dạng TOML để thêm bảng [rules] vào requirements.toml trong Global.

Cấu hình TOML tương đương đầy đủ như sau:

allowed_approval_policies = ["on-request"]
allowed_sandbox_modes = ["read-only", "workspace-write"]

[rules]
prefix_rules = [
  { pattern = [{ any_of = ["bash", "sh", "zsh"] }], decision = "prompt", justification = "Require explicit approval for shell entry points" },
]

Kiểm tra để bảo đảm mọi phiên bản ứng dụng khách được quản lý đều hỗ trợ các khóa bạn chọn. Gán chính sách cho người dùng hoặc nhóm dự kiến và xác minh chính sách có hiệu lực trên các ứng dụng khách được hỗ trợ của họ. Sử dụng tài liệu tham chiếu cấu hình để biết lược đồ hiện tại và giao diện quản trị để biết cách hoạt động hiện tại của việc gán chính sách.

Dịch vụ chọn các lớp yêu cầu do doanh nghiệp quản lý áp dụng cho danh tính đã đăng nhập. Ứng dụng khách cục bộ đánh giá các lớp đó cùng với các nguồn yêu cầu khác được mô tả trong Vị trí và thứ tự ưu tiên. Sử dụng giao diện quản trị hiện tại để tạo và gán chính sách ở phía không gian làm việc. Đừng dựa vào thuật toán đối sánh nhóm được sao chép; dịch vụ quản trị kiểm soát cách hoạt động đó và có thể thay đổi độc lập với định dạng yêu cầu cục bộ.

Để biết các khóa được hỗ trợ và ví dụ, hãy xem Ví dụ về requirements.toml và tài liệu tham chiếu requirements.toml.

Cách ứng dụng khách cục bộ áp dụng các yêu cầu được quản lý trên đám mây

Cơ chế tải và lưu vào bộ nhớ đệm cục bộ dưới đây mô tả các ứng dụng khách cục bộ được hỗ trợ. Cơ chế này không xác định thời điểm chính sách đám mây đã thay đổi có hiệu lực trong một tác vụ đang chạy sử dụng quyền truy cập máy tính cục bộ với Work Cloud. Hãy xác minh chính sách đang có hiệu lực trước khi dựa vào một hạn chế đã thay đổi.

Khi người dùng khởi động một ứng dụng khách cục bộ được hỗ trợ và đăng nhập bằng ChatGPT với gói được hỗ trợ, trước tiên ứng dụng khách kiểm tra xem có mục bộ nhớ đệm hợp lệ, khớp với danh tính hay không. Nếu không có mục hợp lệ, ứng dụng khách tải gói áp dụng với cơ chế thử lại và ghi một mục bộ nhớ đệm có chữ ký khi thành công. Nếu yêu cầu thất bại hoặc hết thời gian chờ và không có bộ nhớ đệm hợp lệ, quá trình tải gói cấu hình đám mây sẽ trả về lỗi thay vì âm thầm khởi động mà không có lớp yêu cầu được quản lý trên đám mây.

Sau khi xử lý bộ nhớ đệm, ứng dụng khách kết hợp các yêu cầu đám mây với các lớp yêu cầu khác được mô tả ở trên. Quá trình làm mới trong nền cập nhật gói được lưu trong bộ nhớ đệm và cung cấp gói đó cho các lần tải cấu hình tiếp theo. Điều này không bảo đảm rằng tác vụ đang chạy sẽ sử dụng ngay chính sách đã thay đổi. Một số thiết lập trên máy tính yêu cầu khởi động lại ứng dụng; hãy làm theo mọi lời nhắc khởi động lại và xác minh các thiết lập đang có hiệu lực trước khi dựa vào thay đổi đó.

Xác nhận trải nghiệm của quản trị viên và nhân viên

Chỉ định một người chịu trách nhiệm cho mỗi chính sách được quản lý, ghi lại những người dùng hoặc nhóm cần nhận chính sách, đồng thời ghi rõ lý do nghiệp vụ cho mọi hạn chế về hệ thống tệp, mạng, phê duyệt hoặc hồ sơ quyền.

Kiểm thử một quy trình được phép và một quy trình bị chặn bằng tài khoản người dùng có các quyền dự kiến. Kiểm tra các thiết lập đang có hiệu lực trong ứng dụng khách được hỗ trợ. Chỉ riêng vai trò hoặc nhóm trong không gian làm việc không áp đặt hạn chế đối với môi trường thực thi cục bộ.

Sử dụng Kiểm thử chính sách trong Agent security để kiểm tra những chính sách khớp với lựa chọn thành viên, nhóm hoặc vai trò. Trong phiên có thể chỉnh sửa, thao tác này kiểm tra bản nháp hiện tại mà không lưu lại. Kết quả cho biết chính sách được chọn, không phải cấu hình đã hợp nhất cuối cùng hay việc ứng dụng khách có thực thi một hạn chế hay không. Sau khi lưu, hãy kiểm thử các quy trình được phép và bị chặn trên từng ứng dụng khách và đường thực thi có liên quan.

Triển khai cấu hình được quản lý trên thiết bị

Sử dụng các yêu cầu hệ thống cục bộ hoặc MDM cho các hạn chế xác thực và chính sách được quản lý trên thiết bị. Cơ chế managed_config.toml kiểu cũ có thứ tự ưu tiên khi khởi động khác với Giá trị mặc định trong Agent security. Quy trình MDM bao gồm cả yêu cầu lẫn giá trị mặc định kiểu cũ.

Quản lý xác thực cục bộ

Đặt allowed_login_methods, allowed_chatgpt_workspaces, cli_auth_credentials_store và chatgpt_base_url trong tệp hệ thống cục bộ requirements.toml hoặc các yêu cầu MDM của macOS. Codex bỏ qua bốn trường này trong các yêu cầu được quản lý trên đám mây. Các yêu cầu xác thực cục bộ được áp dụng trước khi thông tin xác thực được tải và trước khi Codex truy xuất chính sách đám mây.

Để yêu cầu đăng nhập bằng ChatGPT vào một không gian làm việc được phê duyệt và lưu thông tin xác thực trong kho thông tin xác thực của hệ điều hành, hãy dùng:

allowed_login_methods = ["chatgpt"]
allowed_chatgpt_workspaces = ["00000000-0000-0000-0000-000000000000"]
cli_auth_credentials_store = "keyring"

allowed_login_methods chấp nhận chatgpt, api hoặc cả hai. Nếu bỏ qua, thiết lập này không hạn chế các phương thức đăng nhập. Nếu được đặt, danh sách phải chứa ít nhất một phương thức. api cho phép xác thực qua API, bao gồm Amazon Bedrock. Hạn chế về không gian làm việc cũng áp dụng cho token truy cập Codex.

forced_login_method và forced_chatgpt_workspace_id do người dùng cấu hình phải tuân thủ các yêu cầu. Khi người dùng chọn một không gian làm việc, không gian đó cũng phải có trong danh sách không gian làm việc được phép do quản trị viên quản lý. Nếu không có không gian làm việc nào khớp, tính năng đăng nhập bằng ChatGPT sẽ không khả dụng. Xác thực qua API vẫn khả dụng khi được cho phép. Nếu không có phương thức đăng nhập nào khả dụng, Codex sẽ từ chối khởi động.

Xem tài liệu tham chiếu yêu cầu để biết các chế độ lưu trữ thông tin xác thực và cấu hình URL dịch vụ.

Giá trị mặc định được quản lý (`managed_config.toml`)

Sử dụng Giá trị mặc định trong Agent security cho các giá trị ban đầu được hỗ trợ và được quản lý trên đám mây. Phần này trình bày cơ chế quản lý trên thiết bị kiểu cũ managed_config.toml và thứ tự ưu tiên khi khởi động khác biệt của cơ chế đó. Việc chỉnh sửa Giá trị mặc định trong Agent security không triển khai tệp managed_config.toml đến thiết bị của các thành viên.

Giá trị mặc định được quản lý thiết lập cấu hình mà một máy khách cục bộ được hỗ trợ dùng khi khởi động. Khi khởi động, chúng ghi đè config.toml cục bộ của người dùng và mọi giá trị ghi đè CLI --config. Người dùng vẫn có thể thay đổi những cài đặt đó trong lượt chạy hiện tại và các giá trị mặc định sẽ được áp dụng lại vào lần khởi động tiếp theo của máy khách.

GPT-5.5 ngừng hoạt động trong Codex khi đăng nhập bằng ChatGPT vào buổi trưa ngày 14 tháng 10 năm 2026 theo giờ PDT (19:00 UTC). Nếu một giá trị mặc định được quản lý, hồ sơ macOS MDM hoặc cấu hình đã lưu cố định gpt-5.5 cho những người dùng đó, hãy thay thế bằng một mô hình khả dụng. Chọn gpt-6.1-sol sau khi quản trị viên đã bật mô hình này cho những người dùng bị ảnh hưởng. OpenAI API và các phiên Codex được xác thực bằng API key không bị ảnh hưởng. Xem khả năng cung cấp mô hình trong không gian làm việc.

Đối với các cấu hình vẫn cố định gpt-5.4 hoặc gpt-5.4-mini, hãy làm theo hướng dẫn di chuyển GPT-5.4.

Hãy bảo đảm các giá trị mặc định được quản lý đáp ứng yêu cầu của bạn; môi trường chạy cục bộ sẽ từ chối các giá trị không được phép.

Thứ tự ưu tiên và phân lớp

Môi trường chạy cục bộ tập hợp cấu hình có hiệu lực theo thứ tự sau (phía trên ghi đè phía dưới):

Tùy chọn được quản lý (MDM macOS; mức ưu tiên cao nhất)
managed_config.toml (tệp hệ thống/được quản lý)
config.toml (cấu hình cơ sở của người dùng)

Các giá trị ghi đè CLI --config key=value áp dụng cho cấu hình cơ sở, nhưng các lớp được quản lý sẽ ghi đè chúng. Điều này có nghĩa là mỗi lượt chạy đều bắt đầu từ các giá trị mặc định được quản lý, ngay cả khi bạn cung cấp cờ cục bộ.

config.toml trên đám mây sử dụng thứ tự ưu tiên cấu hình thông thường, không phải thứ tự cũ ở trên. requirements.toml trên đám mây sử dụng thứ tự ưu tiên yêu cầu.

Vị trí

Linux/macOS (Unix): /etc/codex/managed_config.toml
Windows/không phải Unix: ~/.codex/managed_config.toml

Nếu thiếu tệp, môi trường chạy cục bộ sẽ bỏ qua lớp được quản lý.

Ví dụ về managed_config.toml

# Set conservative defaults
approval_policy = "on-request"
sandbox_mode    = "workspace-write"

[sandbox_workspace_write]
network_access = false             # keep network disabled unless explicitly allowed

[otel]
environment = "prod"
exporter = "otlp-http"            # point at your collector
log_user_prompt = false            # keep prompts redacted
# exporter details live under exporter tables; see Monitoring and telemetry above

Các biện pháp bảo vệ được khuyến nghị

Ưu tiên workspace-write kèm phê duyệt cho hầu hết người dùng; chỉ dành quyền truy cập đầy đủ cho các vùng chứa được kiểm soát.
Giữ network_access = false trừ khi quy trình đánh giá bảo mật cho phép bộ thu thập hoặc các miền mà quy trình làm việc của bạn cần đến.
Sử dụng cấu hình được quản lý để cố định các thiết lập OTel (bộ xuất, môi trường), nhưng giữ log_user_prompt = false trừ khi chính sách của bạn cho phép rõ ràng việc lưu nội dung câu lệnh.
Định kỳ kiểm tra các khác biệt giữa config.toml cục bộ và chính sách được quản lý để phát hiện sai lệch; các lớp được quản lý phải được ưu tiên hơn các cờ và tệp cục bộ.

Tùy chọn được quản lý trên macOS (MDM)

Trên macOS, quản trị viên có thể đẩy một hồ sơ thiết bị cung cấp các payload TOML được mã hóa base64 tại:

Miền tùy chọn: com.openai.codex
Khóa:
- config_toml_base64 (giá trị mặc định được quản lý)
- requirements_toml_base64 (yêu cầu)

Môi trường thực thi cục bộ phân tích các gói dữ liệu "tùy chọn được quản lý" này dưới dạng TOML. Đối với các giá trị mặc định được quản lý (config_toml_base64), tùy chọn được quản lý có mức ưu tiên cao nhất. Đối với các yêu cầu (requirements_toml_base64), mức ưu tiên tuân theo thứ tự yêu cầu. Cùng một bảng [features] phía yêu cầu cũng hoạt động trong requirements_toml_base64; hãy dùng các khóa tính năng chuẩn ở đó.

Quy trình thiết lập MDM

Môi trường chạy cục bộ tuân thủ các payload MDM tiêu chuẩn của macOS, vì vậy bạn có thể phân phối cài đặt bằng những công cụ như Jamf Pro, Fleet hoặc Kandji. Một bản triển khai gọn nhẹ sẽ có dạng:

Tạo payload TOML được quản lý và mã hóa bằng base64 (không ngắt dòng).
Đưa chuỗi vào hồ sơ MDM của bạn trong miền com.openai.codex tại config_toml_base64 (giá trị mặc định được quản lý) hoặc requirements_toml_base64 (yêu cầu).
Đẩy hồ sơ, sau đó yêu cầu người dùng khởi động lại máy khách cục bộ được hỗ trợ và xác nhận bản tóm tắt cấu hình lúc khởi động phản ánh các giá trị được quản lý.
Khi thu hồi hoặc thay đổi chính sách, hãy cập nhật payload được quản lý; máy khách đọc tùy chọn đã làm mới vào lần khởi chạy tiếp theo.

Tránh nhúng bí mật hoặc giá trị động thay đổi thường xuyên vào payload. Hãy quản lý TOML được quản lý như mọi cài đặt MDM khác theo quy trình kiểm soát thay đổi.