Tự lưu trữ cấu hình Codex cho nhóm của bạn

Cung cấp các giá trị cấu hình mặc định và chế độ cài đặt bắt buộc cho Codex từ một điểm cuối HTTPS do bạn vận hành.

Nếu người dùng của bạn không đăng nhập vào Codex bằng ChatGPT, bạn có thể phân phối cấu hình đến Codex CLI và ứng dụng máy tính từ một máy chủ HTTPS do bạn vận hành. Codex tải các chế độ cài đặt của bạn khi khởi động, bất kể người dùng kết nối trực tiếp với nhà cung cấp mô hình hay thông qua cổng kết nối.

Giới hạn của ứng dụng khách

Ứng dụng máy tính không thể nhắc bạn đăng nhập vào máy chủ cấu hình. Nếu máy chủ yêu cầu đăng nhập lại, hãy chạy codex login trong terminal trên cùng máy tính, rồi mở lại ứng dụng. Nếu ứng dụng không thể tải các chế độ cài đặt bắt buộc, quá trình khởi động sẽ tạm dừng.

Cấu hình Codex để sử dụng máy chủ

Trên một máy tính thử nghiệm, hãy tạo hoặc cập nhật tệp requirements.toml của hệ thống. Thêm bảng [config_server] với URL cơ sở của máy chủ cấu hình. Dùng /etc/codex/requirements.toml trên Linux và macOS, hoặc %ProgramData%\OpenAI\Codex\requirements.toml trên Windows. Trên macOS, bạn cũng có thể phân phối bảng này thông qua tùy chọn được quản lý.

[config_server]
base_url = "https://codex-config.example.com/team"

Chỉ các yêu cầu cục bộ do quản trị viên kiểm soát mới có thể chọn máy chủ. Giữ bảng này trên máy tính khi bạn chuyển phần chính sách còn lại sang điểm cuối.

Xác thực với máy chủ cấu hình (tùy chọn)

Theo mặc định, Codex cố gắng lấy cấu hình mà không dùng thông tin xác thực. Nếu máy chủ yêu cầu đăng nhập, hãy thêm [config_server.oauth] vào cùng tệp requirements.toml. Codex sử dụng luồng mã ủy quyền OAuth với Proof Key for Code Exchange (PKCE).

[config_server.oauth]
authorization_url = "https://login.example.com/oauth/authorize"
token_url = "https://login.example.com/oauth/token"
client_id = "codex-policy"
redirect_port = 43127

URI chuyển hướng cho ví dụ này là http://127.0.0.1:43127/callback. Bạn có thể bỏ qua redirect_port nếu nhà cung cấp chấp nhận lệnh gọi lại loopback trên bất kỳ cổng khả dụng nào. Codex gửi mã thông báo truy cập trong tiêu đề Authorization. Máy chủ của bạn phải xác minh mã này trước khi trả về gói cấu hình.

Cung cấp cấu hình Codex

Lưu trữ cấu hình được quản lý của bạn tại một điểm cuối HTTPS. Khi Codex CLI lấy gói cấu hình, nó gửi yêu cầu GET bằng URL cơ sở từ requirements.toml cục bộ:

GET {config_server.base_url}/codex/config/bundle

Với base_url trong ví dụ thiết lập ban đầu ở trên, Codex gửi yêu cầu sau:

GET https://codex-config.example.com/team/codex/config/bundle

Phản hồi bằng 200 OK và một gói cấu hình JSON trong nội dung phản hồi.

Định dạng gói cấu hình

Gói cấu hình nhóm các mục TOML thành hai mảng:

  • config_toml.enterprise_managed chứa các giá trị mặc định cần áp dụng. contents của mỗi mục là văn bản config.toml.
  • requirements_toml.enterprise_managed chứa các yêu cầu cần thực thi. contents của mỗi mục là văn bản requirements.toml.

Mỗi mục trong mảng có ba trường chuỗi: id, name (tên hiển thị) và contents. Dùng một mảng rỗng cho loại bạn không cần.

Ví dụ này đặt giá trị mặc định cho tìm kiếm trên web thành disabled và thực thi giá trị đó bằng allowed_web_search_modes.

{
  "config_toml": {
    "enterprise_managed": [
      {
        "id": "search-default",
        "name": "Default web search",
        "contents": "web_search = 'disabled'"
      }
    ]
  },
  "requirements_toml": {
    "enterprise_managed": [
      {
        "id": "search-policy",
        "name": "Allowed web search modes",
        "contents": "allowed_web_search_modes = ['disabled']"
      }
    ]
  }
}

Xác minh cấu hình trong Codex

  1. Trên một máy tính thử nghiệm, mở terminal trong thư mục dự án và chạy codex. Hoàn tất đăng nhập bằng tài khoản công ty nếu được nhắc.
  2. Tại dấu nhắc tương tác của Codex CLI, nhập /debug-config rồi nhấn Enter.
  3. Nếu bạn cung cấp các giá trị mặc định, hãy tìm tên và ID của chúng trong Ngăn xếp lớp cấu hình. Với ví dụ ở trên, hãy tìm enterprise-managed (Default web search, search-default) (enabled).
  4. Nếu bạn cung cấp các yêu cầu, hãy tìm một chế độ cài đặt mà bạn thực thi trong Yêu cầu rồi kiểm tra nguồn chính sách được liệt kê bên cạnh.

Codex có thể khởi động với các chế độ cài đặt đã lưu trong bộ nhớ đệm và làm mới chúng ở chế độ nền. Sau khi thay đổi một chính sách trên máy chủ, hãy chờ Codex làm mới chính sách đó, rồi bắt đầu phiên mới và lặp lại bước kiểm tra trước khi triển khai sang các máy khác.