OpenAI

18 tháng 11, 2026

Kỹ thuật

Bên trong sandbox của Codex

Cách Codex chạy lệnh trên máy của bạn với các giới hạn do bạn kiểm soát.

Tác giả: Michael Bolin, Thành viên đội ngũ kỹ thuật

Tại OpenAI, chúng tôi áp dụng phương pháp phòng thủ theo chiều sâu⁠(mở trong cửa sổ mới) để bảo vệ các tác nhân. Bên cạnh việc đầu tư vào huấn luyện và căn chỉnh làm nền tảng cho nỗ lực này, chúng tôi còn triển khai các tính năng trong hệ thống điều khiển tác nhân Codex⁠(mở trong cửa sổ mới) để tăng cường bảo vệ. Chạy lệnh trên máy tính của bạn là một trong những việc Codex làm thường xuyên nhất, đồng thời tiềm ẩn rủi ro. Vì vậy, chúng tôi xây dựng sandbox của Codex để Codex có thể hoạt động trong môi trường hiện có của bạn, với các giới hạn về hệ thống tệp và mạng do bạn kiểm soát.

Một ⁠(mở trong cửa sổ mới)sandbox⁠(mở trong cửa sổ mới) giới hạn những gì chương trình có thể truy cập khi chạy. Với tác vụ sắp xếp ảnh, bạn có thể cấu hình sandbox của Codex để cho phép lệnh đọc và sửa tệp trong ~/Pictures, đồng thời chặn truy cập mạng để ngăn tải ảnh lên. Khi rà soát mã, bạn có thể cho phép truy cập tài liệu trực tuyến nhưng vẫn giữ các tệp nguồn ở chế độ chỉ đọc. Người dùng cấu hình sandbox của Codex thông qua ⁠(mở trong cửa sổ mới)hồ sơ quyền⁠(mở trong cửa sổ mới), trong đó xác định các giới hạn về hệ thống tệp và mạng cho một phiên Codex.

Trong bài viết này, chúng tôi sẽ bắt đầu với những đánh đổi đằng sau thiết lập sandbox mặc định của Codex, rồi giải thích thiết kế sandbox và cách hệ thống điều khiển dùng sandbox để chạy lệnh. Chúng tôi sẽ trình bày cách người dùng cuối và doanh nghiệp tùy chỉnh quyền theo nhu cầu, cũng như cách nhà phát triển tái sử dụng sandbox trong công cụ của mình. Cuối cùng, chúng tôi sẽ xem xét cách các giới hạn này được thực thi trên macOS, Linux và Windows.

Lựa chọn ranh giới cho sandbox

Với Codex, chúng tôi chủ trương đặt các thiết lập sandbox mặc định thận trọng nhưng vẫn cho phép thực hiện công việc hữu ích. Ví dụ, khi dùng một kho lưu trữ Git làm thư mục gốc của không gian làm việc, hồ sơ quyền :workspace tích hợp sẵn sẽ:

  • Cho phép ghi trong không gian làm việc, nhưng giữ các thư mục như .git và .codex ở chế độ chỉ đọc. Nhờ đó, Codex có thể chỉnh sửa mã nguồn mà không cần xin phép cho từng thay đổi, đồng thời không thể sửa trực tiếp .codex/config.toml hoặc các hook Git trong .git/hooks.

  • Cho phép đọc trên phạm vi rộng của hệ thống tệp, trong giới hạn quyền hệ điều hành hiện có của người dùng. Trình biên dịch, môi trường thực thi và công cụ dựng phần mềm phụ thuộc vào SDK, thư viện và cấu hình nằm ngoài kho lưu trữ. Nếu chỉ cho phép đọc trong không gian làm việc, nhiều quy trình thông thường sẽ không hoạt động. Đổi lại, các tệp nhạy cảm ở nơi khác trên máy cũng có thể vẫn đọc được, chẳng hạn tệp cấu hình chứa khóa API.

  • Vô hiệu hóa truy cập mạng. Điều này chặn việc tải trực tiếp lên các dịch vụ bên ngoài, kể cả những nỗ lực đánh cắp dữ liệu mà lệnh có thể đọc. Thiết lập này cũng ngăn các thao tác hợp lệ như tải xuống thư viện phụ thuộc; các thao tác này cần thêm quyền truy cập.

Các giới hạn này ngăn chặn nhiều loại hành vi xấu, nhưng vẫn có thể xảy ra hành động gây hại. Ví dụ, tác nhân có thể chèn mã độc vào một gói được cài đặt cục bộ như node_modules/prettier. Thay đổi đó có thể không xuất hiện trong git status vì Git thường bỏ qua node_modules. Nếu trình soạn thảo của người dùng chạy bản Prettier đó khi lưu, chỉ cần lưu một tệp cũng có thể thực thi mã độc bên ngoài sandbox của Codex. Đó là lý do chúng tôi áp dụng phòng thủ theo chiều sâu: sandbox giới hạn những gì lệnh có thể truy cập, còn huấn luyện và căn chỉnh giúp mô hình sử dụng quyền truy cập đó đúng với ý định của người dùng.

Để được hướng dẫn tùy chỉnh quyền sandbox và kết hợp với các biện pháp bảo vệ khác trong môi trường doanh nghiệp, hãy xem Cẩm nang bảo mật Codex⁠(mở trong cửa sổ mới).

Thiết kế sandbox

Máy ảo và container⁠(mở trong cửa sổ mới) là hai cơ chế phổ biến để tạo sandbox, nhưng chúng tôi chọn cách tiếp cận khác với sandbox của Codex. Thay vì chuyển hoạt động tính toán sang một môi trường riêng để cô lập, Codex dùng cơ chế sandbox của từng nền tảng để giới hạn các lệnh chạy trong môi trường hiện có của người dùng.

Với nhiều nhà phát triển, máy tính xách tay là môi trường phát triển được tùy biến riêng, có thể thay đổi bất cứ lúc nào họ muốn. Việc tái tạo môi trường đó trong container Docker có thể tốn công, và một số quy trình vẫn phụ thuộc vào công cụ chạy trên máy chủ.

Ví dụ, hãy xét việc dùng Codex để phát triển ứng dụng iOS trên máy Mac. Nếu bạn cô lập Codex bằng cách chạy trong Docker, Codex sẽ không thể chạy chuỗi công cụ dựng iOS gồm các tệp thực thi gốc của Mac, cũng không thể khởi chạy trình mô phỏng iPhone để chạy mã. Quy trình dựa trên Docker có thể giao việc dựng ứng dụng và thao tác với trình mô phỏng cho máy Mac chủ, nhưng các thao tác đó sẽ chạy ngoài sandbox của container và cần có giới hạn riêng. Với Codex, chúng tôi muốn giữ mọi thứ đơn giản bằng cách đầu tư mạnh vào cơ chế sandbox riêng cho từng hệ điều hành, để Codex chạy trong môi trường phù hợp nhất với tác vụ đang thực hiện.

Hệ thống điều khiển cung cấp các cơ chế sandbox riêng của từng hệ điều hành qua một API chung trên macOS, Windows và Linux. API này nhận một lệnh và một hồ sơ quyền. Nếu hồ sơ quyền cho phép truy cập mạng có giới hạn, bên gọi phải cung cấp proxy mạng để thực thi các giới hạn đó:

Python

1
# This is a simplified version of the actual API.
2
def spawn_command_under_sandbox(
3
program_and_args: list[str],
4
cwd: Path,
5
env: dict[str, str],
6
permission_profile: PermissionProfile,
7
network_proxy: NetworkProxy | None,
8
) -> Child:

Hàm này khởi động tiến trình trong sandbox và trả về một handle Child mà hệ thống điều khiển có thể dùng để chờ tiến trình hoàn tất. Mỗi tiến trình con kế thừa các ràng buộc sandbox của tiến trình cha, nên các giới hạn đó áp dụng trên toàn bộ cây tiến trình do lệnh khởi tạo, kể cả những tiến trình hậu duệ còn chạy sau khi tiến trình ban đầu đã kết thúc.

Sơ đồ sau cho thấy cách các thành phần phối hợp, từ cấu hình đến chạy lệnh trong sandbox. Các phần tiếp theo giải thích từng giai đoạn.

Sơ đồ luồng: cấu hình và các yêu cầu được quản lý xác định hồ sơ quyền của phiên; hệ thống điều khiển Codex khởi chạy lệnh theo các giới hạn sandbox riêng cho macOS, Linux hoặc Windows. Các tiến trình con kế thừa những giới hạn đó, và một proxy mạng tùy chọn thực thi các quy tắc tên miền.

Cách hệ thống điều khiển tận dụng sandbox

Như giải thích trong bài Phân tích vòng lặp tác nhân Codex, hệ thống điều khiển Codex chịu trách nhiệm thực thi các lệnh gọi công cụ do mô hình tạo ra. Với tác vụ lập trình, công cụ được dùng nhiều nhất là công cụ shell, chạy lệnh tương tự như người dùng thao tác trong shell tương tác như Bash. Ở đây, chúng tôi sẽ xem xét công cụ shell ⁠(mở trong cửa sổ mới)exec_command⁠(mở trong cửa sổ mới) chạy một lần⁠(mở trong cửa sổ mới) để minh họa cách hệ thống điều khiển dùng sandbox nhằm đạt được các biện pháp bảo vệ mong muốn.

Đây là phiên bản giản lược về cách hệ thống điều khiển Codex xử lý lệnh gọi công cụ
exec_command khi không dùng sandbox:

Python

1
# Illustrative implementation of the exec_command tool call.
2

3
class ExecCommandToolCall:
4
cmd: str
5
workdir: str | None = None
6
shell: str | None = None
7
login: bool = True
8
timeout_ms: int = 10_000
9

10

11
def perform_exec_command(tool_call: ExecCommandToolCall):
12
program_and_args = [
13
tool_call.shell or os.environ.get("SHELL") or "/bin/sh",
14
"-lc" if tool_call.login else "-c",
15
tool_call.cmd,
16
]
17
child = subprocess.Popen(
18
program_and_args,
19
# workdir defaults to the turn's cwd, assumed here to be the process cwd.
20
cwd=Path(tool_call.workdir or ".").absolute(),
21
stdout=subprocess.PIPE,
22
stderr=subprocess.STDOUT,
23
)
24
output, exit_code = collect_output(child, timeout_ms=tool_call.timeout_ms)
25
return {"output": output, "exit_code": exit_code}

Để chạy lệnh trong sandbox, hệ thống điều khiển thay lời gọi subprocess.Popen() bằng spawn_command_under_sandbox(). Hệ thống điều khiển cung cấp hồ sơ quyền và proxy mạng khi cần:

Python

1
# Honoring the exec_command tool call while enforcing sandbox constraints.
2

3
def perform_exec_command_with_sandboxing(
4
tool_call: ExecCommandToolCall,
5
permission_profile: PermissionProfile,
6
network_proxy: NetworkProxy | None,
7
):
8
# ...build program_and_args as in the previous example...
9
child = spawn_command_under_sandbox(
10
program_and_args=program_and_args,
11
cwd=Path(tool_call.workdir or ".").absolute(),
12
env=os.environ.copy(),
13
permission_profile=permission_profile,
14
network_proxy=network_proxy,
15
)
16
output, exit_code = collect_output(child, timeout_ms=tool_call.timeout_ms)
17
return {"output": output, "exit_code": exit_code}

Công cụ exec_command cũng cho phép mô hình yêu cầu quyền khác cho từng lệnh, nhưng hệ thống điều khiển quyết định có chấp thuận hay không:

Python

1
class ExecCommandToolCall:
2
# ...command-related fields...
3

4
# Per-command sandbox override. Defaults to "use_default".
5
sandbox_permissions: Literal[
6
"use_default",
7
"with_additional_permissions",
8
"require_escalated",
9
] = "use_default"
10

11
# User-facing approval question; only for "require_escalated".
12
justification: str | None = None
13

14
# Expand network or filesystem access; only for "with_additional_permissions".
15
# AdditionalPermissions supports fine-grained options.
16
additional_permissions: AdditionalPermissions | None = None

Khi use_default được chỉ định, hệ thống điều khiển dùng cấu hình sandbox mặc định cho lượt đó. with_additional_permissions yêu cầu mở rộng quyền truy cập trong sandbox, còn require_escalated yêu cầu thực thi bên ngoài sandbox. Hệ thống điều khiển đánh giá yêu cầu dựa trên tùy chọn của người dùng trước khi thực thi lệnh. (Ví dụ, Codex có thể hỏi trực tiếp người dùng hoặc chuyển yêu cầu đến tính năng Tự động rà soát⁠(mở trong cửa sổ mới).) Nếu việc thực thi được cho phép, Codex sẽ truyền permission_profile và network_proxy thích hợp cho perform_exec_command_with_sandboxing(), cùng các đối số lệnh từ ExecCommandToolCall ban đầu.

Công cụ shell là thành phần chính sử dụng spawn_command_under_sandbox(); hệ thống điều khiển cũng tái sử dụng hạ tầng sandbox cho các thao tác như đọc và sửa tệp cục bộ. Khả năng tái sử dụng này còn vượt ra ngoài hệ thống điều khiển: lệnh codex sandbox cho phép bạn tích hợp việc thực thi lệnh trong sandbox vào công cụ riêng, như chúng ta sẽ thấy ở phần sau. Tiếp theo, chúng ta sẽ tìm hiểu cách định nghĩa hồ sơ quyền.

Cấu hình sandbox

Hồ sơ quyền có tên cho phép bạn tái sử dụng cùng các giới hạn hệ thống tệp và mạng trên nhiều dự án. Bạn có thể định nghĩa hồ sơ riêng trong mục [permissions] của config.toml. Ví dụ, cấu hình sau định nghĩa hồ sơ tên dev mở rộng⁠(mở trong cửa sổ mới) hồ sơ :workspace tích hợp sẵn:

TOML

1
# Use the dev profile by default.
2
default_permissions = "dev"
3

4
[permissions.dev]
5
# This is displayed when /permissions is run in the Codex CLI.
6
description = "Development with extra read-only protections."
7

8
# A profile can be derived from an existing profile.
9
# Profiles starting with ":" are provided by Codex.
10
extends = ":workspace"
11

12
[permissions.dev.filesystem]
13
"~/build-cache" = "write"
14

15
[permissions.dev.filesystem.":workspace_roots"]
16
".devcontainer" = "read"
17
".vscode" = "read"
18
"**/*.env" = "deny"
19
"secrets" = "deny"

Hồ sơ dev bổ sung quyền ghi vào ~/build-cache và áp đặt thêm giới hạn cho các tệp trong không gian làm việc. Các mục hệ thống tệp có thể cấp quyền chỉ đọc (read), cấp quyền đọc và ghi (write) hoặc chặn hoàn toàn truy cập (deny).

Bảng :workspace_roots cho phép bạn định nghĩa quy tắc cho các đường dẫn tương đối so với thư mục gốc không gian làm việc của dự án. Mặc định, Codex CLI dùng thư mục làm việc làm thư mục gốc duy nhất của không gian làm việc, còn ứng dụng ChatGPT trên máy tính dùng các thư mục mã nguồn của dự án. Codex áp dụng từng quy tắc cho mọi thư mục gốc, nên mục .vscode trong dev đặt thư mục .vscode dưới mỗi thư mục gốc thành chỉ đọc.

Ngoài các quy tắc riêng, dev kế thừa các biện pháp bảo vệ sau từ :workspace:

TOML

1
[permissions.":workspace".filesystem.":workspace_roots"]
2
".agents" = "read"
3
".aws" = "read"
4
".codex" = "read"
5
".git" = "read"

Quyền truy cập mạng

Về cơ bản, có ba lựa chọn khi cấu hình mạng cho sandbox trong Codex:

  • Vô hiệu hóa toàn bộ truy cập mạng (mặc định của hồ sơ :workspace)

  • Cho phép truy cập mạng trực tiếp, đầy đủ (mặc định của hồ sơ :danger-full-access)

  • Chỉ cho phép truy cập mạng qua proxy; proxy quyết định cho phép lưu lượng nào đi qua dựa trên hồ sơ quyền


Để cấp cho
dev quyền truy cập mạng trực tiếp, hãy đặt permissions.dev.network.enabled = true ở cấp cao nhất của config.toml. Thiết lập này cấp toàn quyền truy cập mạng khi proxy mạng bị tắt.

Để giới hạn dev vào một tập hợp tên miền, hãy bật proxy mạng và cấu hình các quy tắc tên miền:

TOML

1
[permissions.dev.network]
2
enabled = true
3

4
[permissions.dev.network.domains]
5
"*.openai.com" = "allow"
6
# Allow requests to local services by hostname or by IPv4/IPv6 loopback address.
7
"localhost" = "allow"
8
"127.0.0.1" = "allow"
9
"::1" = "allow"
10
"evil.example" = "deny"
11

12
[features]
13
# If neither local config nor managed requirements enable the proxy,
14
# this profile allows direct network access; domain rules are not enforced.
15
network_proxy = true

Quy tắc tên miền hỗ trợ tên chính xác và mẫu ký tự đại diện; các quy tắc từ chối được chỉ định rõ có ưu tiên cao hơn quy tắc cho phép. Yêu cầu đến các tên miền khác cần được phê duyệt hoặc sẽ bị chặn, như mô tả trong phần Proxy mạng bên dưới.

Phân lớp cấu hình và thực thi giới hạn

Người dùng cá nhân có thể cấu hình thiết lập mặc định áp dụng cho mọi dự án và ghi đè các thiết lập đó cho một dự án đáng tin cậy cụ thể. Quản trị viên doanh nghiệp cũng có thể muốn cấu hình thiết lập mặc định cho người dùng và giới hạn những thiết lập họ được thay đổi. Codex hỗ trợ cả hai nhu cầu thông qua cấu hình phân lớp và các yêu cầu được quản lý.

Như mô tả trong phần Thứ tự ưu tiên cấu hình,⁠(mở trong cửa sổ mới) Codex hợp nhất thiết lập từ nhiều tệp config.toml. Các bảng được hợp nhất đệ quy; khi giá trị xung đột, nguồn có mức ưu tiên cao hơn sẽ được chọn. Các mảng được thay thế toàn bộ.

Đó là lý do hồ sơ quyền dùng bảng cho đường dẫn hệ thống tệp và tên miền mạng. Một nhóm có thể thêm hoặc ghi đè từng mục trong cấu hình riêng, đồng thời tự động kế thừa thay đổi ở tất cả các mục khác trong cấu hình cơ sở của tổ chức:

TOML

1
[permissions.dev.filesystem.":workspace_roots"]
2
".idea" = "read"
3

4
[permissions.dev.network.domains]
5
"example.com" = "allow"

Quản trị viên cũng có thể cung cấp các yêu cầu được quản lý⁠(mở trong cửa sổ mới) qua requirements.toml để giới hạn lựa chọn cấu hình của người dùng. Các yêu cầu này có thể đến từ nhiều nguồn, bao gồm tệp hệ thống và chính sách được cung cấp từ đám mây. Một cách dùng phổ biến là chỉ định allowed_permission_profiles để giới hạn tập hợp hồ sơ quyền mà người dùng doanh nghiệp có thể chọn. Ví dụ, quản trị viên có thể chỉ định các yêu cầu từ đám mây sau:

TOML

1
default_permissions = ":read-only"
2

3
[allowed_permission_profiles]
4
":read-only" = true
5
":danger-full-access" = false

Các yêu cầu từ đám mây sẽ được ưu tiên hơn tệp yêu cầu hệ thống tại /etc/codex/requirements.toml, nên một mục trong tệp đó không thể ghi đè thiết lập rõ ràng ":danger-full-access" = false ở trên. Không chỉ định :workspace sẽ cho phép một lớp yêu cầu khác cung cấp mục này. Các hồ sơ có mục mang giá trị false hoặc không có trong bảng hợp nhất cuối cùng sẽ không dùng được.

Sự tách biệt này cho phép tổ chức thực thi các giới hạn, trong khi người dùng tùy chỉnh cấu hình trong phạm vi đó. Các hồ sơ quyền tạo ra có thể được hệ thống điều khiển sử dụng hoặc áp dụng trực tiếp cho một lệnh, như chúng ta sẽ thấy tiếp theo.

Sử dụng lệnh codex sandbox

Codex CLI cung cấp lệnh sandbox để dễ dàng chạy một lệnh bất kỳ theo hồ sơ quyền được định nghĩa trong cấu hình Codex. Lệnh này thường được dùng để thử nghiệm hồ sơ, bảo đảm sandbox ngăn được những hành vi mà hồ sơ được thiết kế để chặn.

Ví dụ, lệnh sau cố cấu hình VS Code để chạy một trình định dạng tự động độc hại khi lưu. Giả sử .vscode đã tồn tại, hồ sơ dev định nghĩa ở trên phải chặn thao tác ghi này vì thư mục đó chỉ cho phép đọc (mặc định, codex sandbox coi cwd là thư mục gốc của không gian làm việc):

Bash

1
codex sandbox --permission-profile dev -- \
2
bash -c 'cat > .vscode/settings.json' <<'JSON'
3
{
4
"prettier.prettierPath": "./node_modules/evil-prettier",
5
"[typescript]": {
6
"editor.defaultFormatter": "esbenp.prettier-vscode",
7
"editor.formatOnSave": true
8
}
9
}
10
JSON

Đúng như vậy, trên macOS, thao tác này thất bại với thông báo:

Văn bản thuần túy

1
bash: .vscode/settings.json: Operation not permitted

Lệnh codex sandbox cho phép sử dụng cơ chế sandbox của Codex độc lập với phiên tác nhân. Bạn có thể dùng cùng ngôn ngữ cấu hình và cơ chế thực thi riêng cho từng nền tảng để giới hạn các lệnh do công cụ của mình khởi chạy.

Ví dụ: chạy máy chủ MCP trong sandbox

Với máy chủ MCP dùng stdio được cấu hình trong config.toml, hệ thống điều khiển Codex không cố đưa lệnh khởi động máy chủ vào sandbox. Codex không thể suy luận đáng tin cậy máy chủ đó cần những tệp hay dịch vụ mạng nào, nên việc áp dụng hồ sơ sandbox mặc định có thể khiến một cấu hình vốn hợp lệ không hoạt động.

Ví dụ, cách thông thường để cấu hình máy chủ MCP @modelcontextprotocol/server-memory⁠(mở trong cửa sổ mới) dùng với Codex như sau:

TOML

1
[mcp_servers.memory]
2
command = "npx"
3
args = [
4
"-y",
5
"@modelcontextprotocol/server-memory@1.0.0"
6
]
7

8
[mcp_servers.memory.env]
9
MEMORY_FILE_PATH = "~/mcp-data/memory.jsonl"

Vì lệnh npx này chạy ngoài sandbox, lệnh có thể ghi tệp và gửi yêu cầu mạng với quyền như người dùng đang chạy Codex, một phạm vi quyền quá rộng. Để siết chặt quyền, chúng ta có thể định nghĩa hồ sơ quyền tên memory-mcp, rồi bọc lệnh npx ban đầu bằng codex sandbox --permission-profile memory-mcp để giới hạn nơi máy chủ được ghi và ngăn máy chủ truy cập mạng:

TOML

1
[permissions.memory-mcp.filesystem]
2
# Allow broad reads for Node.js/npm dependencies and configuration.
3
":root" = "read"
4
"~/.npm" = "write"
5
"~/mcp-data" = "write"
6

7
[permissions.memory-mcp.network]
8
enabled = false
9

10
[mcp_servers.memory]
11
command = "codex"
12
args = [
13
"sandbox",
14
"--permission-profile",
15
"memory-mcp",
16
"--",
17
"npx",
18
"--offline",
19
"@modelcontextprotocol/server-memory@1.0.0"
20
]
21

22
[mcp_servers.memory.env]
23
MEMORY_FILE_PATH = "~/mcp-data/memory.jsonl"

Trước khi khởi động máy chủ, hãy tạo thư mục dữ liệu của máy chủ và lưu gói đã ghim phiên bản vào bộ nhớ đệm npm. Nhờ đó, npx --offline có thể khởi chạy máy chủ theo hồ sơ vô hiệu hóa truy cập mạng:

Bash

1
# The sandbox can write to this folder, but it cannot create it.
2
mkdir -p ~/mcp-data
3

4
# Installing the MCP server requires network access.
5
npx -y --package=@modelcontextprotocol/server-memory@1.0.0 -c true

Khi gói đã được lưu vào bộ nhớ đệm, Codex có thể khởi động máy chủ bộ nhớ mà không cần truy cập mạng; quyền ghi chỉ giới hạn ở bộ nhớ đệm npm và thư mục dữ liệu của máy chủ.

Cách triển khai sandbox của Codex

Phần triển khai sandbox chuyển hồ sơ quyền thành các giới hạn do hệ điều hành thực thi. Logic cốt lõi về xử lý yêu cầu và chính sách của proxy mạng được dùng chung trên cả ba hệ điều hành chính, còn việc thiết lập proxy và tích hợp với sandbox phụ thuộc vào từng hệ điều hành. Chúng tôi sẽ xem xét proxy dùng chung trước, rồi đến cách triển khai trên macOS, Linux và Windows.

Proxy mạng

Để thực thi các giới hạn mạng của hồ sơ quyền, hệ thống điều khiển khởi động một proxy mạng và cấu hình sandbox để cho phép kết nối đến proxy, đồng thời chặn kết nối trực tiếp đến các máy bên ngoài. Proxy kiểm tra từng yêu cầu theo các quy tắc tên miền của hồ sơ để quyết định có chuyển tiếp hay không.

Trong kho lưu trữ Codex, proxy mạng được triển khai trong crate codex-network-proxy⁠(mở trong cửa sổ mới). Hệ thống điều khiển dùng crate này như một thư viện, nhưng cũng có thể biên dịch crate này thành CLI độc lập⁠(mở trong cửa sổ mới). Khi được bật, mặc định codex-network-proxy khởi động cả proxy HTTP lẫn proxy SOCKS5. Địa chỉ của các proxy này được truyền cho tiến trình do sandbox khởi tạo qua biến môi trường. Ngoài các biến môi trường chuẩn như HTTP_PROXY, HTTPS_PROXY và ALL_PROXY, một số biến môi trường riêng của ứng dụng⁠(mở trong cửa sổ mới) thường dùng (như PIP_PROXY) cũng được chèn vào. Tất nhiên, không phải chương trình nào cũng tuân theo các biến môi trường này. Nếu một chương trình cố kết nối trực tiếp đến máy bên ngoài, các giới hạn sandbox của hệ điều hành sẽ chặn kết nối đó, như mô tả trong các phần dành riêng cho từng nền tảng bên dưới.

Proxy mạng chịu trách nhiệm thực thi các giới hạn mạng được định nghĩa trong hồ sơ quyền. Ví dụ, hồ sơ dev ở trên cho phép yêu cầu đến *.openai.com và từ chối rõ ràng yêu cầu đến evil.example. Khi một yêu cầu nhắm đến tên miền không khớp quy tắc cho phép hoặc từ chối nào, proxy có thể tạm dừng yêu cầu và chuyển cho hệ thống điều khiển xử lý phê duyệt. Giống ví dụ về lệnh shell, Codex có thể hỏi trực tiếp người dùng hoặc chuyển yêu cầu đến tính năng Tự động rà soát⁠(mở trong cửa sổ mới). Sau khi nhận quyết định, proxy cho phép yêu cầu tiếp tục hoặc từ chối bằng phản hồi lỗi.

Thứ tự xử lý ở đây rất quan trọng vì ngay cả việc tra cứu DNS cũng có thể làm rò rỉ thông tin được mã hóa trong tên máy chủ. Vì vậy, proxy chỉ phân giải tên máy chủ được yêu cầu sau khi xác định rằng yêu cầu được cho phép hoặc phê duyệt. Lưu ý rằng quy tắc ký tự đại diện có phạm vi rộng hoặc quyền truy cập dịch vụ DNS vẫn có thể tạo điều kiện đánh cắp dữ liệu qua DNS.

macOS

Trên macOS, Codex dùng Seatbelt⁠(mở trong cửa sổ mới), cơ chế sandbox của Apple được thực thi ở cấp nhân hệ điều hành. Chính sách Seatbelt được viết bằng Sandbox Profile Language (SBPL), một ngôn ngữ dựa trên Scheme để diễn đạt các giới hạn sandbox. Codex gọi Seatbelt qua lệnh /usr/bin/sandbox-exec của macOS. Giống codex sandbox, lệnh này nhận các tùy chọn mô tả sandbox, theo sau là lệnh cần chạy:

Bash

1
sandbox-exec -p PROFILE [-Dkey=value]* -- PROG ARGS...

PROFILE là một chuỗi SBPL chứa các mục cấu hình sandbox. Ví dụ, đoạn SBPL sau cho phép đọc và ghi /dev/null cùng /dev/zero theo chính sách sandbox:

Scheme

1
(allow file-read* file-test-existence file-write-data
2
(literal "/dev/null")
3
(literal "/dev/zero"))

Khi proxy mạng được bật trong một lần gọi sandbox, các quy tắc như sau được chèn vào hồ sơ để chỉ cho phép kết nối đến các cổng cục bộ thích hợp:

Scheme

1
; local HTTP proxy launched by Codex
2
(allow network-outbound (remote ip "localhost:3128"))
3

4
; local SOCKS proxy launched by Codex
5
(allow network-outbound (remote ip "localhost:8081"))


Hồ sơ cơ sở của Codex bắt đầu bằng
(deny default), nên kết nối đi ra vẫn bị chặn trừ khi được cho phép rõ ràng.

Cuối cùng, SBPL có thể chứa chỗ giữ chỗ dùng (param):

Scheme

1
; Pass -DWRITABLE_ROOT_0=/path/to/dir to specify a folder that cannot be removed.
2
(deny file-write-unlink
3
(require-all
4
(literal (param "WRITABLE_ROOT_0"))
5
(vnode-type DIRECTORY)))

Các chỗ giữ chỗ này được điền bằng tùy chọn -Dkey=value truyền cho sandbox-exec.

Để triển khai API sandbox riêng, Codex xây dựng danh sách đối số⁠(mở trong cửa sổ mới) cho sandbox-exec từ một chính sách cơ sở⁠(mở trong cửa sổ mới), rồi dùng permission_profile và ngữ cảnh khác để điều chỉnh thành hồ sơ Seatbelt hoàn chỉnh. Hồ sơ tạo ra và các đối số -D đi kèm cấu hình những giới hạn do Seatbelt thực thi, còn proxy mạng thực thi các quy tắc mạng bổ sung. Khi đã có đầy đủ danh sách đối số, việc gọi sandbox-exec khá đơn giản.

Việc tạo SBPL chính xác khá khó vì Apple không cung cấp tài liệu về ngôn ngữ này cho bên thứ ba. Thực tế, man sandbox-exec ghi rõ The sandbox-exec command is DEPRECATED (hàm thư viện sandbox_init() được mô tả qua man 3 sandbox_init cũng bị đánh dấu ngừng khuyến nghị sử dụng). Dù có cảnh báo ngừng khuyến nghị sử dụng, macOS vẫn cung cấp hồ sơ Seatbelt trong /usr/share/sandbox, và phần mềm bên thứ ba, bao gồm Google Chrome và Chromium⁠(mở trong cửa sổ mới), vẫn tiếp tục dựa vào Seatbelt. Vì vậy, chúng tôi dự định tiếp tục dùng Seatbelt trong tương lai gần.

Linux

Để tạo sandbox trên Linux, Codex kết hợp bubblewrap⁠(mở trong cửa sổ mới) (bwrap), công cụ dòng lệnh tạo môi trường biệt lập, với seccomp-bpf⁠(mở trong cửa sổ mới), cơ chế của nhân Linux để lọc lời gọi hệ thống. Một công cụ hỗ trợ nội bộ tên codex-linux-sandbox điều phối việc thiết lập. Giống sandbox-exec trên macOS, công cụ này nhận cấu hình sandbox, theo sau là lệnh cần chạy:

Bash

1
codex-linux-sandbox SANDBOX_ARGS... -- PROG ARGS...

Khi cần cô lập hệ thống tệp hoặc định tuyến qua proxy, codex-linux-sandbox gọi bwrap để tạo môi trường sandbox ban đầu. Sau đó, bwrap khởi chạy codex-linux-sandbox --apply-seccomp-then-exec bên trong sandbox. Lần gọi thứ hai này dùng seccomp-bpf để áp dụng thêm các giới hạn trước khi chạy lệnh của người dùng.

Để tạo môi trường sandbox ban đầu, Codex dùng bubblewrap để tạo khung nhìn hệ thống tệp trong một không gian tên gắn kết riêng, phản ánh các quy tắc hệ thống tệp của hồ sơ quyền. Vì đây là nền tảng của cách triển khai sandbox, Codex đóng gói sẵn một bản bwrap phòng khi người dùng chưa cài đặt, nhưng ưu tiên bản cài đặt tương thích của ⁠(mở trong cửa sổ mới)bwrap⁠(mở trong cửa sổ mới) tìm thấy trên PATH, nếu có. Thực tế cho thấy một số bản phân phối Linux mặc định vô hiệu hóa quyền truy cập không gian tên người dùng⁠(mở trong cửa sổ mới), nhưng cho phép ngoại lệ đối với bwrap của hệ thống.

Cũng giống sandbox-exec, bwrap nhận cấu hình sandbox, theo sau là lệnh cần chạy trong sandbox. Thay vì dùng ngôn ngữ cấu hình riêng như SBPL, bwrap dùng các cờ riêng lẻ để cấu hình. Codex dùng các tùy chọn sau để tạo khung nhìn hệ thống tệp:

  • --bind để chỉ định tệp hoặc thư mục cho phép ghi

  • --ro-bind để chỉ định tệp hoặc thư mục chỉ đọc

  • --perms 000 --tmpfs DIR --remount-ro DIR để từ chối truy cập DIR

  • --perms 000 --ro-bind-data FD FILE để từ chối truy cập FILE (trong đó FD là bộ mô tả tệp đang mở trỏ đến /dev/null)

Để áp dụng các mẫu glob từ chối bằng những tùy chọn này, Codex mở rộng các mẫu đó thành đường dẫn cụ thể trước khi khởi chạy từng lệnh. Các đường dẫn mới khớp mẫu không được tự động thêm vào giới hạn sandbox của lệnh đó.

Codex còn chỉ định các tùy chọn như --unshare-ipc và --unshare-pid để ngăn sandbox truy cập các loại tài nguyên khác trên máy chủ, nên tác động của bubblewrap không chỉ dừng ở việc tệp nào được hiển thị.

Khi dùng bubblewrap, Codex truyền --unshare-net mỗi khi mạng bị vô hiệu hóa hoặc kết nối phải đi qua proxy mạng, qua đó tạo không gian tên mạng mới cho sandbox. Sau đó, chúng tôi dùng seccomp-bpf để giới hạn thêm các lời gọi hệ thống về mạng và các họ socket mà lệnh có thể sử dụng.


Cụ thể, chúng tôi dùng
crate seccompiler⁠(mở trong cửa sổ mới) để biên dịch động một chương trình BPF dựa trên các bộ lọc mong muốn⁠(mở trong cửa sổ mới) rồi áp dụng cho tiến trình khởi chạy trong sandbox, để toàn bộ cây tiến trình kế thừa các ràng buộc này. Vì vậy, bwrap không chạy lệnh của người dùng mà chạy trình khởi chạy codex-linux-sandbox với các đối số cấu hình riêng, theo sau là lệnh của người dùng:

Bash

1
bwrap BWRAP_ARGS... -- \
2
codex-linux-sandbox --apply-seccomp-then-exec CODEX_LINUX_SANDBOX_ARGS... -- \
3
PROG ARGS...

Để áp dụng bộ lọc seccomp mà không cần đặc quyền nâng cao, trình khởi chạy đặt cờ no_new_privs của Linux⁠(mở trong cửa sổ mới). Các tiến trình con kế thừa cờ này, ngăn các tiến trình này nhận thêm đặc quyền khi thực thi chương trình khác, chẳng hạn tệp thực thi setuid.

Các bộ lọc seccomp phụ thuộc vào cấu hình mạng. Khi truy cập mạng bị vô hiệu hóa, chúng tôi chặn một số lời gọi hệ thống liên quan đến mạng, như connect(2) và bind(2). Tuy nhiên, khi proxy mạng được bật trong sandbox, chúng tôi cho phép socket IP để có thể kết nối đến bộ lắng nghe TCP do codex-linux-sandbox tạo ra, nhưng mặc định chặn việc tạo socket miền Unix độc lập vì các socket này có thể vô tình cho phép truy cập tài nguyên của máy chủ.

Kết nối đến proxy mạng

Khi cấu hình sandbox cần dùng proxy mạng, hệ thống điều khiển Codex tạo một phiên bản proxy có thể tái sử dụng qua nhiều lần gọi codex-linux-sandbox trong cùng một luồng hội thoại Codex. Mỗi sandbox cần có cách truy cập proxy dùng chung đó từ không gian tên mạng biệt lập của mình. Codex cung cấp bộ lắng nghe TCP loopback bên trong không gian tên đó và bố trí một tiến trình bên ngoài sandbox để chấp nhận các kết nối tới bộ lắng nghe rồi chuyển tiếp các kết nối đó đến proxy.

Các sơ đồ sau minh họa thiết lập này cho một điểm cuối proxy; sơ đồ cuối thể hiện một kết nối đi qua điểm cuối đó. Trước khi khởi chạy bubblewrap, codex-linux-sandbox tạo một cặp socket Unix làm kênh điều khiển và tự tạo tiến trình con bằng fork. Tiến trình con chạy run_host_bridge() và chờ nhận bộ mô tả tệp của bộ lắng nghe qua kênh đó:

Sơ đồ hệ thống điều khiển Codex khởi tạo codex-linux-sandbox, tiến trình này tạo tiến trình chuyển tiếp bằng fork, kết nối qua kênh điều khiển socket Unix.

Trong ví dụ này, tiến trình cha dùng exec để thay thế ảnh chương trình của mình bằng bwrap. Thao tác này thiết lập sandbox và khởi chạy codex-linux-sandbox --apply-seccomp-then-exec bên trong, đồng thời truyền FD của kênh điều khiển:

Sơ đồ bwrap tạo không gian tên mạng cho sandbox và khởi chạy codex-linux-sandbox bên trong, với kênh điều khiển socket Unix nối đến tiến trình chuyển tiếp bên ngoài sandbox.

Trong không gian tên mạng của sandbox, lần gọi codex-linux-sandbox thứ hai tạo bộ lắng nghe TCP loopback và truyền bộ mô tả tệp của bộ lắng nghe này qua socket. Bộ lắng nghe vẫn gắn với không gian tên mạng của sandbox, cho phép tiến trình con còn ở bên ngoài chấp nhận kết nối từ các chương trình trong sandbox, đồng thời mở kết nối đi lên trong không gian tên mạng của máy chủ. Sau khi bàn giao, cả hai tiến trình đóng bộ mô tả kênh điều khiển của mình, còn tiến trình trong sandbox đóng bản sao bộ lắng nghe của mình.

Khi bộ lắng nghe TCP sẵn sàng, tiến trình trong sandbox đặt giá trị thích hợp cho HTTP_PROXY⁠(mở trong cửa sổ mới) và các biến môi trường liên quan để trỏ đến bộ lắng nghe đó. Sau đó, tiến trình áp dụng seccomp trước khi tạo tiến trình con bằng fork và thực thi lệnh của người dùng:

Sơ đồ một chương trình trong sandbox kết nối đến bộ lắng nghe TCP loopback, với tiến trình chuyển tiếp codex-linux-sandbox bên ngoài chuyển lưu lượng đến proxy mạng Codex.

Tiến trình bên ngoài sandbox giữ bộ lắng nghe luôn mở. Với mỗi kết nối được chấp nhận, tiến trình này mở một kết nối đến proxy đã cấu hình và chuyển tiếp dữ liệu theo cả hai chiều.

Cơ chế bổ sung này cấp cho lệnh một không gian tên mạng riêng, bao gồm một giao diện loopback riêng biệt. Trên macOS, Seatbelt cho phép lệnh kết nối trực tiếp đến các cổng được chỉ định trên giao diện loopback của máy chủ. Trên Linux, lệnh kết nối đến bộ lắng nghe trong không gian tên biệt lập của mình, còn một tiến trình bên ngoài sandbox chuyển tiếp các kết nối đó đến proxy đã cấu hình. Việc bàn giao bộ mô tả cho phép thiết lập kết nối này mà không để lệnh truy cập không gian tên mạng của máy chủ.

Windows

Đầu năm nay, chúng tôi đã triển khai và viết về những nỗ lực xây dựng sandbox trên Windows. Kể từ đó, Microsoft đã phát hành thư viện MXC cùng các tính năng mới để cô lập tiến trình trong hệ điều hành Windows. Chúng tôi đang thay thế sandbox hiện có bằng một sandbox sử dụng thư viện MXC.

MXC là gì?

MXC (Microsoft eXecution Container) là một hệ thống thực thi mã trong sandbox⁠(mở trong cửa sổ mới) của Microsoft, hỗ trợ nhiều backend cô lập trên Windows, Linux và macOS. Codex hỗ trợ sandbox dựa trên MXC trên các thiết bị Windows tương thích, sử dụng khả năng cô lập tiến trình tích hợp sẵn để giới hạn lệnh trong môi trường hiện có của người dùng.

Chúng tôi đang chuyển sang MXC để cải thiện bảo mật và tính dễ sử dụng, đồng thời khắc phục một số hạn chế của sandbox Windows hiện tại:

  • Cần quyền nâng cao/quyền quản trị để thiết lập sandbox

  • Các thao tác kiểm tra và thiết lập ACL tốn tài nguyên, thực hiện chậm

  • Trạng thái thiết lập sandbox lưu lại trên máy chủ, bao gồm

    • Các ACL

    • Quy tắc tường lửa

    • Tài khoản người dùng sandbox

    • Các tệp của lớp điều khiển

MXC cung cấp một lược đồ cấu hình JSON⁠(mở trong cửa sổ mới). Codex sử dụng MXC SDK⁠(mở trong cửa sổ mới) để tạo yêu cầu thực thi theo lược đồ đó, chứa lệnh, thư mục làm việc, môi trường và các quyền. Các quyền này bao gồm quyền truy cập hệ thống tệp và mạng, cùng các tài nguyên Windows như màn hình nền và bảng tạm.

Chuyển chính sách thành lệnh gọi MXC

Codex dùng thiết lập cố định cho một số cơ chế kiểm soát để cân bằng giữa khả năng tương thích và bảo mật. Codex cho phép đọc registry và giữ quyền truy cập Win32k cùng màn hình nền mà PowerShell cần khi khởi động. Quyền truy cập bảng tạm, chèn sự kiện đầu vào, điều khiển màn hình nền và thiết lập hệ thống đều bị vô hiệu hóa. Cuối cùng, MXC bị ngăn sử dụng phương án dự phòng là sửa quyền hệ thống tệp của máy chủ.

Codex chuyển các quy tắc hệ thống tệp và mạng của hồ sơ quyền thành cấu hình MXC. Sử dụng hồ sơ dev ở trên và giả sử:

  • C:\, D:\ và Z:\ là các ổ đĩa cục bộ duy nhất trên máy.

  • Thư mục gốc của không gian làm việc và thư mục làm việc đều là C:\work\demo.

  • Thư mục chính của người dùng là D:\Users\dev, nên ~/build-cache được phân giải thành D:\Users\dev\build-cache.

  • Mẫu glob từ chối chỉ khớp với C:\work\demo\config\dev.env và C:\work\demo\config\prod.env.

Các thiết lập MXC tương ứng sẽ bao gồm:

JSON

1
{
2
...
3
"filesystem": {
4
"readwritePaths": [
5
"C:\\work\\demo",
6
"D:\\Users\\dev\\build-cache",
7
...
8
],
9
"readonlyPaths": [
10
"C:\\",
11
"D:\\",
12
"Z:\\",
13
"C:\\work\\demo\\.agents",
14
"C:\\work\\demo\\.aws",
15
"C:\\work\\demo\\.codex",
16
"C:\\work\\demo\\.devcontainer",
17
"C:\\work\\demo\\.git",
18
"C:\\work\\demo\\.vscode",
19
...
20
],
21
"deniedPaths": [
22
"C:\\work\\demo\\config\\dev.env",
23
"C:\\work\\demo\\config\\prod.env",
24
"C:\\work\\demo\\secrets"
25
]
26
},
27
"network": {
28
"egress": {
29
"default": "deny",
30
"allow": [{
31
"to": [
32
{"cidr": "127.0.0.0/8"},
33
{"cidr": "::1/128"}
34
]
35
}]
36
},
37
"ingress": {
38
"default": "deny",
39
"hostLoopback": "allow"
40
}
41
},
42
...
43
}

Quyền truy cập thư mục gốc ổ đĩa

Chính sách hệ thống tệp của MXC mặc định từ chối truy cập. Vì vậy, Codex cấp thêm quyền chỉ đọc cho thư mục gốc của các ổ đĩa cục bộ để cung cấp phạm vi đọc rộng mà hồ sơ này cho phép. Các quyền này áp dụng đệ quy, trong phạm vi quyền hệ điều hành hiện có của người dùng.

Một điểm cần lưu ý: quyền ghi cho thư mục gốc ổ đĩa không áp dụng đệ quy, nên Codex mở rộng quyền này để bao gồm các mục con trực tiếp hiện có của ổ đĩa.

Quyền được cấp xung đột

Đường dẫn cụ thể hơn ghi đè quyền cấp cho thư mục tổ tiên, nên C:\work\demo có thể cho phép ghi dù nằm dưới C:\ chỉ đọc, trong khi C:\work\demo\.git vẫn chỉ đọc.

Khi các cách viết đường dẫn khác nhau hoặc bí danh qua symlink/junction trỏ đến cùng một đường dẫn, MXC áp dụng quyền nghiêm ngặt hơn: từ chối được ưu tiên hơn chỉ đọc, còn chỉ đọc được ưu tiên hơn đọc-ghi.

Mẫu glob từ chối

MXC chỉ nhận đường dẫn cụ thể cần từ chối, nên Codex mở rộng các mẫu glob từ chối thành tệp và thư mục khớp mẫu trước khi khởi chạy. Các đường dẫn mới khớp mẫu glob không được tự động thêm vào trong khi lệnh đang chạy.

Truy cập mạng

Các quy tắc tên miền như *.openai.com được thực thi bởi proxy mạng Codex dùng chung đã mô tả ở trên. Codex chạy proxy đó bên ngoài sandbox và truyền các địa chỉ của proxy cho lệnh qua cùng các biến môi trường chuẩn *_PROXY đã đề cập trước đó. MXC chặn kết nối trực tiếp ra bên ngoài nhưng cho phép kết nối loopback trên máy chủ, bao gồm truy cập proxy. Các dịch vụ cục bộ khác vẫn truy cập được.

Trên macOS, Linux và Windows, hệ thống điều khiển dùng cùng một API sandbox để khởi chạy lệnh theo hồ sơ quyền. Phần triển khai riêng của từng nền tảng xử lý việc thiết lập cần thiết để áp dụng các giới hạn đó.

Phát triển dựa trên sandbox của Codex

Khả năng viết và thực thi mã mang đến cho tác nhân một cách linh hoạt để giải quyết vấn đề ngoài phạm vi phát triển phần mềm. Sandbox của Codex cho phép tác nhân dùng khả năng đó trong môi trường hiện có của người dùng, với các giới hạn rõ ràng về truy cập hệ thống tệp và mạng. Đây là một thành phần nền tảng có thể tái sử dụng trong hệ thống điều khiển, và lệnh codex sandbox cho phép các công cụ do bạn tự xây dựng sử dụng thành phần này.

Khi tác nhân đảm nhận nhiều tác vụ hơn, chúng tôi muốn giúp việc sử dụng sandbox trở nên khả thi với nhiều công cụ và môi trường hơn. Điều đó có nghĩa là giúp cấu hình quyền dễ dàng hơn và tận dụng các biện pháp bảo vệ tốt hơn của hệ điều hành khi các biện pháp đó được cung cấp. Mục tiêu của chúng tôi là mở rộng khả năng của tác nhân, đồng thời giữ cho con người quyền kiểm soát những gì tác nhân được truy cập.

Tác giả

OpenAI

Lời cảm ơn

Đặc biệt cảm ơn David Wiesen, Charlie Weems, Viyat Bhalodia và Fotis Chantzis đã đóng góp cho bài viết này.