โปรไฟล์สิทธิ์ของ Codex: ตัวอย่าง config.toml สำหรับการรันเอเจนต์อย่างปลอดภัย

โปรไฟล์สิทธิ์ของ Codex กำหนดว่าคำสั่งของเอเจนต์ของคุณสามารถอ่าน เขียน และเข้าถึงอะไรได้บ้าง ต่อไปนี้คือตัวอย่าง config.toml ที่ผ่านการทดสอบแล้ว รวมถึงโปรไฟล์สำหรับงาน API ที่รัน Apidog CLI ได้โดยไม่ต้องเชื่อมต่ออินเทอร์เน็ตสาธารณะ

INEZA Felin-Michel

INEZA Felin-Michel

20 November 2026

โปรไฟล์สิทธิ์ของ Codex: ตัวอย่าง config.toml สำหรับการรันเอเจนต์อย่างปลอดภัย

Apidog สำหรับองค์กร

การติดตั้งแบบ On-Premises

SSO & RBAC

รองรับมาตรฐาน SOC 2

สำรวจ Apidog Enterprise

Codex permission profile คือ policy ที่ตั้งชื่อไว้ใน config.toml ซึ่งกำหนดว่าคำสั่งที่ Codex รันบนเครื่องของคุณสามารถอ่าน เขียน และเข้าถึงอะไรบนเครือข่ายได้บ้าง คุณเลือกใช้ผ่าน default_permissions โดยเริ่มจากแบบ built-in (:read-only, :workspace หรือ :danger-full-access) แล้วเพิ่ม path แบบ read, write และ deny พร้อม allowlist ของโดเมน

คู่มือนี้มีตัวอย่าง config.toml ที่พร้อมคัดลอกไปใช้สำหรับการตั้งค่าที่พบบ่อยที่สุด รวมถึงตัวอย่างสำหรับงาน API ที่ให้ coding agent ของคุณรันการทดสอบ Apidog CLI กับ API host ของคุณเองได้โดยไม่ต้องเปิดอินเทอร์เน็ต

Codex permission profile คืออะไร?

permission profile คือ policy ของ sandbox ที่นำกลับมาใช้ซ้ำได้สำหรับ Codex โดยรวมกฎของ filesystem (ว่าคำสั่งอ่าน เขียน หรือห้ามแตะ path ไหนได้บ้าง) เข้ากับกฎของ network (ว่าคำสั่งเข้าถึงเครือข่ายได้หรือไม่ และเข้าถึงโดเมนไหนได้) Codex บังคับใช้ผ่าน Seatbelt บน macOS, bubblewrap ร่วมกับ seccomp บน Linux และ WSL และใช้ MXC บน Windows

OpenAI อธิบายแนวคิดนี้ไว้ใน Inside the Codex sandbox ที่เผยแพร่เมื่อวันที่ 18 พฤศจิกายน 2026 แทนที่จะย้ายงานของคุณเข้า container Codex กลับจำกัดคำสั่งใน environment เดิมของคุณ ทำให้ native toolchain ยังรันได้ตามปกติ

Codex มี profile built-in มาให้สามแบบ:

โปรไฟล์ Filesystem Network
:read-only คำสั่งอ่านได้ แต่เขียนไม่ได้ ปิด
:workspace เขียนได้ภายใน workspace root และ temp dir; ส่วน .git, .agents, .codex, .aws ยังเป็น read-only ปิด
:danger-full-access ไม่มีข้อจำกัดของ sandbox ภายในเครื่อง เต็มรูปแบบ ตรง

เอกสาร permissions ยังระบุว่าฟีเจอร์นี้อยู่ในสถานะ Beta ดังนั้นคีย์อาจเปลี่ยนไปในแต่ละ release

ตาราง permissions อยู่ตรงไหนใน config.toml

profile ของคุณอยู่ใน ~/.codex/config.toml (หรือใน layer ของ project หรือ system) มีสองส่วนหลักที่ต้องสนใจ:

มีกฎข้อหนึ่งที่คนมักพลาด permission profile ใช้ร่วมกับ sandbox setting แบบเก่าไม่ได้ ถ้ามี sandbox_mode ปรากฏในไฟล์ config ที่โหลดอยู่ หรือคุณส่ง --sandbox เข้าไป Codex จะใช้ setting แบบเก่าและเมิน default_permissions ก่อนสลับให้ลบ sandbox_mode และ [sandbox_workspace_write] ออกก่อน

profile ใช้โมเดล config precedence ปกติ ตารางจะ merge แบบ recursive ทำให้ config ของทีมเพิ่มโดเมนหรือ path หนึ่งรายการใน profile ขององค์กรได้โดยไม่ต้องเขียนซ้ำทั้งหมด

กฎของ filesystem: read, write และ deny

แต่ละรายการใน filesystem จะ map path ไปยัง read, write หรือ deny path ที่เจาะจงกว่าจะชนะ path ที่กว้างกว่า และเมื่อสองรายการชี้ path เดียวกัน deny จะชนะ write ซึ่งชนะ read

รูปแบบ path ที่คุณจะใช้บ่อยที่สุด:

ใช้ extends เพื่อสืบทอดการป้องกันแบบ built-in แทนที่จะสร้างใหม่ทั้งหมด นี่คือ profile ที่คงค่าเริ่มต้นของ :workspace ไว้และล็อก secret:

default_permissions = "dev"

[permissions.dev]
description = "Workspace edits, secrets denied, no network."
extends = ":workspace"

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

[permissions.dev.filesystem.":workspace_roots"]
".vscode" = "read"
"**/*.env" = "deny"
"secrets" = "deny"

กฎภายใต้ :workspace_roots ใช้กับทุก root ดังนั้น secrets หมายถึงโฟลเดอร์ secrets ในแต่ละ project root profile สามารถ extend :read-only, :workspace หรือ profile ที่ตั้งชื่ออื่นได้ แต่ extend :danger-full-access ไม่ได้

บน Linux, WSL และ Windows แบบ native, deny glob แบบ ** ที่ไม่มีขอบเขตอาจต้องใช้ glob_scan_max_depth (อย่างน้อย 1) ภายใต้ [permissions.<name>.filesystem] เพื่อให้ Codex ขยาย pattern ก่อนที่ sandbox จะเริ่ม

แผนภาพแสดงวิธีที่ Codex permission profile กรอง path ใน filesystem และคำขอ network ก่อนที่คำสั่งจะทำงาน

กฎของ network: ปิด, เปิด หรือ allowlist

network มีสามสถานะ และมีสอง setting ที่ควบคุม:

  1. Network ปิด (enabled = false ซึ่งเป็นค่าเริ่มต้นของ :workspace): คำสั่งเข้าถึงเครือข่ายไม่ได้
  2. Network เปิด, proxy ปิด: คำสั่งเข้าถึงได้โดยตรงอย่างไร้ข้อจำกัด กฎโดเมนของคุณจะถูกเมิน
  3. Network เปิด, proxy เปิด: ทราฟฟิกวิ่งผ่าน network proxy ของ Codex ซึ่งบังคับใช้กฎโดเมนของ profile

สถานะที่สองคือหลุมพราง การตั้ง permissions.<name>.network.enabled = true ไม่ได้เปิด proxy คุณต้องมีสิ่งนี้ที่ top level ด้วย:

[features]
network_proxy = true

pattern ของโดเมนรองรับ host แบบตรงตัว (api.example.com), *.example.com สำหรับ subdomain เท่านั้น, **.example.com สำหรับ apex บวก subdomain และ * เป็น wildcard ระดับ global ที่ใช้ได้กับ allow เท่านั้น รายการ deny จะ override รายการ allow และ proxy ที่ทำงานอยู่โดยไม่มีรายการ allow จะบล็อกทุกอย่างภายนอก

เมื่อ proxy ทำงานอยู่ มันจะบล็อก target ใน local และ private network โดยค่าเริ่มต้นด้วย หากต้องการเข้าถึง service ภายในเครื่อง ให้ allowlist host แบบตรงตัว เช่น "localhost" = "allow" หรือ "127.0.0.1" = "allow"

Codex permission profile สำหรับงาน API

นี่คือ profile ที่เราใช้ทดสอบสำหรับการพัฒนา API โดยแก้ไขโค้ดใน workspace ไม่เคยอ่านไฟล์ .env หรือโฟลเดอร์ secrets และเข้าถึงได้แค่ API host ของคุณกับ Apidog:

default_permissions = "api-work"

[features]
network_proxy = true

[permissions.api-work]
description = "Workspace edits, no secrets, API hosts only."
extends = ":workspace"

[permissions.api-work.filesystem.":workspace_roots"]
"**/*.env" = "deny"
"secrets" = "deny"

[permissions.api-work.network]
enabled = true

[permissions.api-work.network.domains]
"api.your-company.com" = "allow"      # the API under test
"staging-api.your-company.com" = "allow"
"**.apidog.com" = "allow"             # Apidog CLI and its API

แทนที่ host สองตัวด้วย host ที่การทดสอบของคุณเรียกใช้ Apidog CLI ส่งคำขอทดสอบจากเครื่องคุณไปยัง API ที่กำลังทดสอบอยู่ ดังนั้น host นั้นต้องถูก allowlist ด้วย ไม่ใช่แค่ของ Apidog หากทดสอบ server ภายในเครื่อง ให้เพิ่ม "localhost" = "allow"

ติดตั้งแพ็กเกจก่อนเริ่ม session ไม่ใช่ระหว่างใช้งาน การรัน npm install -g apidog-cli@latest ต้องใช้ registry.npmjs.org ซึ่ง profile นี้บล็อกไว้โดยเจตนา

มีข้อควรระวังจากการทดสอบของเรา: บน Mac ที่รันแอป proxy หรือ VPN ในโหมด fake-IP DNS ทุก host ที่ allowlist ไว้ resolve ไปยัง address 198.18.x.x guard local/private ถือว่าสิ่งเหล่านี้เป็น private และบล็อกไป Codex จึงรายงานว่า "local/private network addresses are blocked by the sandbox policy" การเพิ่ม allow_local_binding = true ภายใต้ [permissions.api-work.network] แก้ปัญหาได้ แต่ก็เปิด hostname ที่ allowlist ไว้ซึ่ง resolve ไปยัง private address ด้วย ดังนั้นตั้งค่าก็ต่อเมื่อจำเป็นจริง ๆ

ทดสอบ profile ด้วย codex sandbox

อย่าเชื่อถือ profile จนกว่าคุณจะเห็นมันบล็อกอะไรสักอย่าง คำสั่ง codex sandbox รันคำสั่งใด ๆ ภายใต้ profile ที่ตั้งชื่อไว้ และถือว่า directory ปัจจุบันเป็น workspace root:

codex sandbox --permission-profile api-work -- cat README.md .env

ด้วย profile ข้างต้น การรันของเราแสดง README แล้วตามด้วย:

cat: .env: Operation not permitted

การเขียนนอпк workspace ล้มเหลวในลักษณะเดียวกัน (Operation not permitted) ในขณะที่ไฟล์ใหม่ภายใน workspace ถูกสร้างขึ้น สำหรับ network ให้ตรวจสอบว่า proxy บล็อก host ที่คุณไม่ได้ระบุไว้:

codex sandbox -P api-work -- curl -sI https://example.org

proxy ตอบกลับ 403 Forbidden พร้อม x-proxy-error: blocked-by-allowlist ในขณะที่ apidog.com ตอบ 200 บน macOS ให้เพิ่ม --log-denials เพื่อพิมพ์รายการ denial ของ Seatbelt หลังคำสั่งสิ้นสุด

คุณยังใช้ codex sandbox เพื่อ wrap process ที่ Codex ไม่ได้ sandbox ให้เองได้ บทความของ OpenAI ระบุว่า stdio MCP server ใน config.toml รันแบบไม่มี sandbox และแสดงตัวอย่าง profile memory-mcp ที่มี "~/mcp-data" = "write" และ network.enabled = false ครอบคำสั่ง npx ของ server

สลับ profile ระหว่างใช้งานด้วย /permissions

ใน Codex CLI พิมพ์ /permissions เพื่อเปิดตัวเลือก เมื่อมี profile ที่ตั้งชื่อไว้ มันจะแสดงรายการพร้อม description หากต้องการเลือกโดยตรง:

/permissions api-work --approval-policy=on-request --reviewer=user

คำสั่งนี้ตั้ง profile สำหรับ session ปัจจุบันและส่งคำขออนุมัติมาที่คุณ profile กับการอนุมัติเป็นตัวควบคุมที่แยกจากกัน: profile ตัดสินว่าคำสั่งใน sandbox แตะอะไรได้บ้าง ส่วน approval policy ตัดสินว่า Codex จะถามคุณเมื่อใดก่อนก้าวออกนอกกรอบ เอกสารอ้างอิงคำสั่ง CLI มีคำสั่งอื่น ๆ ของ session ให้ดู

ให้ Codex ทดสอบ API ของคุณด้วย Apidog CLI

เมื่อ api-work ทำงานอยู่ Codex สามารถรันการทดสอบ API จริงได้โดยไม่ต้องเปิดอินเทอร์เน็ต Apidog CLI มอบคำสั่งให้ agent ของคุณสำหรับ endpoint, test case และการรัน พร้อม output แบบ JSON ที่อ่านได้ คุณติดตั้งครั้งเดียวภายนอก sandbox:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

จากนั้นส่ง prompt ให้ Codex หนึ่งชุด:

Using Apidog CLI, create a test case in project <projectId> for
GET /orders/{id} on endpoint <endpointId> that asserts a 200 status and
a non-empty "items" array. Run it against environment <envId> and
summarize any failures.

Codex อ่าน payload schema ตรวจสอบ JSON และรัน test case:

apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog test-case run --project <projectId> --endpoint <endpointId> -e <envId> -r cli,json

ในการทดสอบของเรา apidog auth status และ apidog project list ทั้งคู่รันภายใน sandbox api-work โดยมีเพียง **.apidog.com ที่อยู่ใน allowlist token ของคุณอยู่ใน ~/.apidog ซึ่ง profile อ่านได้แต่แก้ไขไม่ได้ สำหรับคำแนะนำแบบครบถ้วน อ่าน วิธีใช้ Apidog CLI ใน Codex และเปลี่ยน -r cli,json เป็น -r junit เมื่อการรันเดียวกันถูกย้ายเข้า CI pipeline แผน Free ของ Apidog รองรับผู้ใช้ได้ถึง 4 คน

แผนภาพการทำงานของ Codex ที่รัน Apidog CLI ภายใน profile api-work โดย network proxy อนุญาต API host และ Apidog และบล็อกโดเมนอื่น ๆ

ข้อจำกัดที่ควรรู้ก่อนเชื่อใจ profile

permission profile ช่วยลดขอบเขตความเสียหาย แต่มันไม่ได้ทำให้ agent ปลอดภัยด้วยตัวเอง เอกสารและบทความของ OpenAI ระบุข้อจำกัดเหล่านี้:

หากคุณเคยใช้วิธีหลบเลี่ยง Codex sandbox การสร้าง custom profile ที่แคบและเจาะจงมักเป็นทางแก้ที่สะอาดกว่า ทีมที่ต้องการบังคับใช้ policy ทั่วทุกเครื่องควรอ่าน Codex security cookbook และ managed allowed_permission_profiles

คำถามที่พบบ่อย

Codex permission profile เริ่มต้นคืออะไร?

ไม่มีตัวไหนที่คุณควรยึดเป็นค่าเริ่มต้น เอกสารแนะนำให้ตั้ง default_permissions อย่างชัดเจนเพื่อพฤติกรรมที่คาดเดาได้ สำหรับงานเขียนโค้ดส่วนใหญ่ :workspace เป็นฐานที่เหมาะสม: เขียนได้ใน workspace root และ temp directory, network ปิด

ทำไมกฎโดเมนของฉันถึงถูกเมิน?

มักเป็นเพราะไม่มี features.network_proxy เมื่อ network.enabled = true แต่ไม่มี proxy คำสั่งจะเข้าถึงเครือข่ายได้โดยตรงอย่างไร้ข้อจำกัด ตรวจสอบด้วยว่าไม่มี config ที่โหลดอยู่ตั้ง sandbox_mode ซึ่งจะปิดการใช้งาน profile ทั้งหมด

ทำอย่างไรให้ Codex หยุดอ่านไฟล์ .env?

เพิ่ม "**/*.env" = "deny" ภายใต้ [permissions.<name>.filesystem.":workspace_roots"] บน Linux, WSL และ Windows ให้ตั้ง glob_scan_max_depth สำหรับ pattern ** ที่ไม่มีขอบเขต และจำไว้ว่า match ใหม่จะไม่ถูกเพิ่มให้ process ที่รันอยู่แล้ว

อนุญาต localhost ใน Codex permission profile ได้ไหม?

ได้ ให้ allowlist host แบบตรงตัว เช่น "localhost" = "allow" หรือ "127.0.0.1" = "allow" ตั้ง allow_local_binding = true เฉพาะเมื่อ hostname ที่ allowlist ไว้ resolve ไปยัง address แบบ local หรือ private

permission profile ทำ sandbox ให้ MCP server ไหม?

ไม่ stdio MCP server ใน config.toml เริ่มทำงานแบบไม่มี sandbox ให้ wrap คำสั่งของ server ด้วย codex sandbox --permission-profile <name> -- พร้อม profile เฉพาะของมันเอง

ใช้ profile ร่วมกับ flag --sandbox ได้ไหม?

ไม่ได้ การส่ง --sandbox หรือตั้งค่า sandbox_mode จะทำให้ Codex ใช้ sandbox setting แบบเก่าแทน default_permissions เลือกใช้ระบบใดระบบหนึ่งต่อ session

ฝึกการออกแบบ API แบบ Design-first ใน Apidog

ค้นพบวิธีที่ง่ายขึ้นในการสร้างและใช้ API