OpenAI

18 نوفمبر 2026

الهندسة

داخل بيئة العزل في Codex

كيف يشغّل Codex الأوامر على جهازك ضمن حدود تتحكم فيها.

بقلم مايكل بولين، عضو الفريق التقني

في OpenAI، نتبع نهج الدفاع متعدد الطبقات⁠(يفتح في نافذة جديدة) لحماية الوكلاء. ورغم أن استثماراتنا في التدريب والمواءمة أساسية لهذه الجهود، فإننا نضيف أيضًا ميزات إلى منظومة التقييم الخاصة بالوكلاء، Codex⁠(يفتح في نافذة جديدة)، لتوفير وسائل حماية إضافية. ولأن تشغيل الأوامر على جهازك من أكثر المهام التي ينفّذها Codex شيوعًا، وقد ينطوي على مخاطر، أنشأنا بيئة العزل في Codex ليتمكن من العمل في بيئتك الحالية ضمن حدود لنظام الملفات والشبكة تتحكم أنت فيها.

تحدّ ⁠(يفتح في نافذة جديدة)بيئة العزل⁠(يفتح في نافذة جديدة) مما يمكن للبرنامج الوصول إليه أثناء تشغيله. في مهمة لتنظيم الصور، يمكنك إعداد بيئة العزل في Codex للسماح للأوامر بقراءة الملفات وتعديلها في ~/Pictures، مع حظر الوصول إلى الشبكة لمنع رفع الملفات. ولمراجعة التعليمات البرمجية، يمكنك السماح بالوصول إلى الوثائق عبر الإنترنت مع إبقاء ملفات المصدر للقراءة فقط. يضبط المستخدمون بيئة العزل في Codex من خلال ⁠(يفتح في نافذة جديدة)ملفات تعريف الأذونات⁠(يفتح في نافذة جديدة)، التي تحدد قيود نظام الملفات والشبكة لجلسة Codex.

سنستهلّ المقال بشرح المفاضلات التي راعيناها عند اختيار الإعدادات الافتراضية لبيئة العزل في Codex، ثم نشرح تصميمها وكيف تستخدمها منظومة التقييم لتشغيل الأوامر. وسنوضح كيف يمكن للمستخدمين النهائيين والمؤسسات تخصيص أذوناتها بحسب احتياجاتهم، وكيف يمكن للمطورين إعادة استخدامها في أدواتهم الخاصة. وأخيرًا، سنستعرض كيفية فرض هذه القيود على macOS وLinux وWindows.

اختيار حدود بيئة العزل

تقوم فلسفتنا في Codex على تحديد إعدادات افتراضية احترازية لبيئة العزل، مع إتاحة إنجاز عمل مفيد. فمثلًا، عند استخدام مستودع Git بوصفه جذر مساحة العمل، فإن ملف تعريف الأذونات المدمج :workspace:

  • يسمح بالكتابة داخل مساحة العمل، مع إبقاء أدلة مثل .git و.codex للقراءة فقط. يتيح ذلك لـ Codex تعديل التعليمات البرمجية المصدرية دون طلب الإذن لكل تغيير، مع منع التعديلات المباشرة على .codex/config.toml أو خطافات Git ضمن .git/hooks.

  • يسمح بالقراءة على نطاق واسع في نظام الملفات، مع مراعاة أذونات المستخدم الحالية في نظام التشغيل. تعتمد المترجمات وبيئات التشغيل وأدوات البناء على حزم تطوير ومكتبات وإعدادات خارج المستودع. وقصر القراءة على مساحة العمل سيعطّل كثيرًا من مسارات العمل المعتادة. لكن المقابل هو أن ملفات حساسة في مواضع أخرى على الجهاز قد تظل قابلة للقراءة أيضًا، مثل ملفات الإعداد التي تحتوي على مفاتيح API.

  • يعطّل الوصول إلى الشبكة. يمنع ذلك الرفع المباشر إلى الخدمات الخارجية، بما فيه محاولات تسريب البيانات التي يستطيع الأمر قراءتها. ويمنع أيضًا عمليات مشروعة مثل تنزيل التبعيات، التي تتطلب صلاحيات وصول إضافية.

تمنع هذه القيود فئة واسعة من السلوكيات الضارة، لكن تظل بعض الإجراءات الضارة ممكنة. فمثلًا، قد يحقن الوكيل تعليمات برمجية خبيثة في حزمة مثبتة محليًا مثل node_modules/prettier. وقد لا يظهر هذا التغيير في git status لأن Git يتجاهل node_modules عادةً. وإذا كان محرر المستخدم يشغّل تلك النسخة من Prettier عند الحفظ، فقد يؤدي مجرد حفظ ملف إلى تنفيذ التعليمات البرمجية الخبيثة خارج بيئة العزل في Codex. لهذا نتبع نهج الدفاع متعدد الطبقات: تحدّ بيئة العزل مما تستطيع الأوامر الوصول إليه، بينما يساعد التدريب والمواءمة النموذج على استخدام هذا الوصول وفقًا لقصد المستخدم.

للحصول على إرشادات بشأن تخصيص أذونات بيئة العزل ودمجها مع وسائل حماية أخرى في بيئة مؤسسية، راجع الدليل العملي لأمان Codex⁠(يفتح في نافذة جديدة).

تصميم بيئة العزل

تُعدّ الأجهزة الافتراضية والحاويات⁠(يفتح في نافذة جديدة) آليتين شائعتين للعزل، لكننا نتبع نهجًا مختلفًا في بيئة العزل في Codex. فبدلًا من نقل الحوسبة إلى بيئة منفصلة لتحقيق العزل، يستخدم Codex إمكانات العزل في كل منصة لتقييد الأوامر التي تعمل في بيئة المستخدم الحالية.

بالنسبة إلى كثير من المطورين، يُعدّ الحاسوب المحمول بيئة تطوير مصممة خصيصًا لهم، ويمكنهم تغييرها متى شاؤوا. وقد تتطلب إعادة إنشاء تلك البيئة داخل حاوية Docker جهدًا، كما أن بعض سير العمل يظل معتمدًا على أدوات تعمل على المضيف.

لنتأمل مثلًا استخدام Codex لتطوير تطبيق iOS على جهاز Mac. إذا قررت عزل Codex بتشغيله داخل Docker، فلن يتمكن من تشغيل سلسلة أدوات بناء iOS المكوّنة من ملفات تنفيذية أصلية لـ Mac، ولن يتمكن من تشغيل محاكي iPhone لتنفيذ التعليمات البرمجية. يمكن لسير عمل قائم على Docker أن يفوّض عمليات البناء والمحاكاة إلى جهاز Mac المضيف، لكن تلك العمليات ستُنفَّذ خارج بيئة عزل الحاوية، وستحتاج إلى قيود خاصة بها. في Codex، نفضّل إبقاء الأمور بسيطة بالاستثمار بكثافة في العزل الخاص بكل نظام تشغيل، ليتمكن Codex من العمل في البيئة الأنسب للمهمة الحالية.

تتيح منظومة التقييم آليات العزل الخاصة بكل نظام تشغيل عبر واجهة API موحّدة على macOS وWindows وLinux. تستقبل هذه الواجهة أمرًا وملف تعريف أذونات. وإذا كان ملف تعريف الأذونات يسمح بوصول محدود إلى الشبكة، فيجب على الجهة المستدعية توفير وكيل شبكة لفرض تلك الحدود:

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:

تبدأ هذه الدالة العملية داخل بيئة عزل، وتُرجع مقبض Child يمكن لمنظومة التقييم استخدامه لانتظار انتهاء العملية. ترث كل عملية فرعية قيود العزل من عمليتها الأم، لذا تسري هذه القيود على كامل شجرة العمليات التي ينشئها الأمر، حتى العمليات التابعة التي تواصل العمل بعد انتهاء العملية الأصلية.

يوضح الرسم التالي كيف تتكامل هذه المكونات، من الإعداد إلى تشغيل أمر داخل بيئة معزولة. تشرح الأقسام التالية كل مرحلة.

مخطط تدفق: تحدد الإعدادات والمتطلبات المُدارة ملف تعريف أذونات الجلسة؛ وتُطلق منظومة التقييم في Codex الأوامر ضمن قيود عزل خاصة بكل منصة على macOS أو Linux أو Windows. ترث العمليات الفرعية تلك القيود، ويفرض وكيل شبكة اختياري قواعد النطاقات.

كيف تستفيد منظومة التقييم من بيئة العزل

كما هو موضح في تفصيل دورة عمل وكيل Codex، تتولى منظومة التقييم في Codex تنفيذ استدعاءات الأدوات التي يولّدها النموذج. في مهام البرمجة، الأداة الأكثر استخدامًا هي أداة الصدفة، التي تشغّل الأوامر بطريقة تشبه ما يفعله المستخدم في صدفة تفاعلية مثل Bash. سنستعرض هنا أداة الصدفة ⁠(يفتح في نافذة جديدة)exec_command⁠(يفتح في نافذة جديدة) للتنفيذ لمرة واحدة⁠(يفتح في نافذة جديدة) لتوضيح كيف تستخدم منظومة التقييم بيئة العزل لتحقيق الحماية المطلوبة.

هذه نسخة مبسطة لكيفية تنفيذ منظومة التقييم في Codex لاستدعاء الأداة
exec_command دون عزل:

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}

لعزل الأمر، تستدعي منظومة التقييم spawn_command_under_sandbox() بدلًا من subprocess.Popen(). توفّر منظومة التقييم ملف تعريف الأذونات، ووكيل الشبكة عند الحاجة:

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}

تتيح أداة exec_command أيضًا للنموذج طلب أذونات مختلفة لأمر بعينه، لكن منظومة التقييم هي التي تبتّ في الطلب بالموافقة أو الرفض:

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

عند تحديد use_default، تستخدم منظومة التقييم إعدادات العزل الافتراضية للجولة الحالية. يطلب with_additional_permissions توسيع صلاحيات الوصول داخل بيئة العزل، بينما يطلب require_escalated التنفيذ خارجها. تقيّم منظومة التقييم الطلب بناءً على تفضيلات المستخدم قبل تنفيذ الأمر. (فمثلًا، قد يطلب Codex موافقة المستخدم مباشرةً، أو يوجّه الطلب إلى المراجعة التلقائية⁠(يفتح في نافذة جديدة).) إذا سُمح بالتنفيذ، يمرّر Codex قيمتي permission_profile وnetwork_proxy المناسبتين إلى perform_exec_command_with_sandboxing() مع وسائط الأمر من ExecCommandToolCall الأصلي.

أداة الصدفة هي المستخدم الرئيسي للدالة spawn_command_under_sandbox()، كما تعيد منظومة التقييم استخدام بنيتها التحتية للعزل في عمليات مثل قراءة الملفات المحلية وتعديلها. ولا تقتصر إعادة الاستخدام هذه على منظومة التقييم: يتيح لك الأمر codex sandbox دمج تنفيذ الأوامر المعزول في أدواتك الخاصة، كما سنرى لاحقًا. سنلقي بعد ذلك نظرة على كيفية تحديد ملفات تعريف الأذونات.

إعداد بيئة العزل

يتيح لك ملف تعريف أذونات يحمل اسمًا محددًا إعادة استخدام قيود نظام الملفات والشبكة نفسها عبر المشاريع. يمكنك تحديد ملفات تعريف خاصة بك ضمن [permissions] في config.toml. فمثلًا، يحدد ما يلي ملف تعريف باسم dev يوسّع⁠(يفتح في نافذة جديدة) ملف التعريف المدمج :workspace:

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"

يضيف ملف التعريف dev صلاحية الكتابة في ~/build-cache، ويفرض قيودًا إضافية على الملفات في مساحة العمل. يمكن لإدخالات نظام الملفات منح صلاحية القراءة فقط (read)، أو القراءة والكتابة (write)، أو منع الوصول تمامًا (deny).

يتيح لك جدول :workspace_roots تحديد قواعد للمسارات النسبية إلى جذور مساحة عمل المشروع. افتراضيًا، تستخدم واجهة سطر الأوامر في Codex دليل عملها بوصفه جذر مساحة العمل الوحيد، بينما يستخدم تطبيق ChatGPT لسطح المكتب مجلدات المصدر الخاصة بالمشروع. يطبّق Codex كل قاعدة على كل جذر، لذا يجعل إدخال .vscode في dev دليل .vscode للقراءة فقط تحت كل جذر.

إلى جانب قواعده الخاصة، يرث dev وسائل الحماية التالية من :workspace:

TOML

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

أذونات الشبكة

عند إعداد الشبكة لبيئة العزل في Codex، تتوفر ثلاثة خيارات رئيسية تقريبًا:

  • تعطيل الوصول إلى الشبكة بالكامل (الإعداد الافتراضي لملف التعريف :workspace)

  • تفعيل الوصول المباشر والكامل إلى الشبكة (الإعداد الافتراضي لملف التعريف :danger-full-access)

  • قصر الوصول إلى الشبكة على وكيل يقرر ما يسمح بمروره بناءً على ملف تعريف الأذونات


لمنح
dev وصولًا مباشرًا إلى الشبكة، اضبط permissions.dev.network.enabled = true في المستوى الأعلى من config.toml. يمنح ذلك وصولًا كاملًا إلى الشبكة عندما يكون وكيل الشبكة معطّلًا.

لقصر dev على مجموعة من النطاقات، فعّل وكيل الشبكة واضبط قواعد النطاقات الخاصة به:

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

تدعم قواعد النطاقات مطابقة الأسماء حرفيًا أو باستخدام أنماط أحرف البدل، وتكون لقواعد المنع الصريحة الأولوية على قواعد السماح. تتطلب الطلبات الموجّهة إلى نطاقات أخرى موافقة أو تُحظر، كما هو موضح في قسم وكيل الشبكة أدناه.

طبقات الإعداد وفرض الحدود

يمكن للمستخدمين الأفراد ضبط إعدادات افتراضية تسري عبر المشاريع، وتجاوزها لمشروع موثوق بعينه. وقد يرغب مسؤولو المؤسسات أيضًا في ضبط إعدادات افتراضية لمستخدميهم وتحديد الإعدادات التي يُسمح لهؤلاء المستخدمين بتغييرها. يدعم Codex كلا الأمرين عبر إعدادات متعددة الطبقات ومتطلبات مُدارة.

كما هو موضح في أولوية الإعدادات،⁠(يفتح في نافذة جديدة) يدمج Codex الإعدادات من ملفات config.toml متعددة. تُدمج الجداول على جميع المستويات المتداخلة، وتُعتمد قيمة المصدر الأعلى أولوية عند تعارض القيم. أما المصفوفات فتُستبدل بالكامل.

ولهذا تستخدم ملفات تعريف الأذونات جداول لمسارات نظام الملفات ونطاقات الشبكة. يمكن للفريق إضافة إدخالات منفردة أو تجاوزها في إعداداته الخاصة، مع وراثة التغييرات تلقائيًا في جميع الإدخالات الأخرى ضمن الإعدادات الأساسية للمؤسسة:

TOML

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

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

يمكن للمسؤولين أيضًا توفير متطلبات مُدارة⁠(يفتح في نافذة جديدة) عبر requirements.toml لتقييد خيارات الإعداد المتاحة للمستخدمين. قد تأتي هذه المتطلبات من مصادر متعددة، بما فيها ملفات النظام والسياسات المقدّمة عبر السحابة. من حالات الاستخدام الشائعة تحديد allowed_permission_profiles لحصر مجموعة ملفات تعريف الأذونات التي يمكن لمستخدم المؤسسة اختيارها. فمثلًا، يمكن للمسؤول تحديد المتطلبات السحابية التالية:

TOML

1
default_permissions = ":read-only"
2

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

ستكون للمتطلبات السحابية الأولوية على ملف متطلبات النظام في /etc/codex/requirements.toml، لذا لا يمكن لأي إدخال في ذلك الملف تجاوز الإعداد الصريح ":danger-full-access" = false أعلاه. يتيح ترك :workspace دون تحديد لطبقة متطلبات أخرى توفير هذا الإدخال. لا تتاح ملفات التعريف التي تكون قيمة إدخالاتها false أو التي تغيب عن الجدول النهائي بعد الدمج.

يتيح هذا الفصل للمؤسسات فرض حدود، مع تمكين المستخدمين من تخصيص إعداداتهم ضمنها. يمكن لمنظومة التقييم استخدام ملفات تعريف الأذونات الناتجة، أو يمكن تطبيقها مباشرةً على أمر، كما سنرى لاحقًا.

استخدام الأمر codex sandbox

توفّر واجهة سطر الأوامر في Codex الأمر sandbox لتسهيل تشغيل أي أمر وفق ملف تعريف أذونات محدد في إعدادات Codex. ويُستخدم عادةً لاختبار ملف التعريف والتأكد من أن بيئة العزل تمنع السلوك الذي صُممت لحظره.

فمثلًا، يحاول الأمر التالي إعداد VS Code لتشغيل منسّق تلقائي خبيث عند الحفظ. بافتراض أن .vscode موجود بالفعل، ينبغي أن يمنع ملف التعريف dev المحدد أعلاه هذه الكتابة لأن ذلك الدليل للقراءة فقط (يتعامل codex sandbox مع cwd بوصفه جذر مساحة العمل افتراضيًا):

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

وبالفعل، تفشل هذه العملية على macOS مع الرسالة التالية:

نص عادي

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

يتيح الأمر codex sandbox استخدام آلية العزل في Codex بصورة مستقلة عن جلسة الوكيل. يمكنك استخدام لغة الإعداد نفسها وآليات الفرض الخاصة بكل منصة لتقييد الأوامر التي تشغّلها أدواتك.

مثال: عزل خادم MCP

بالنسبة إلى خادم MCP يستخدم stdio ومُعدّ في config.toml، لا تحاول منظومة التقييم في Codex عزل الأمر المستخدم لتشغيل الخادم. لا يستطيع Codex استنتاج الملفات أو خدمات الشبكة التي يحتاجها الخادم بصورة موثوقة، لذا قد يؤدي تطبيق ملف تعريف عزل افتراضي إلى تعطيل إعداد يعمل بصورة سليمة في الأصل.

فمثلًا، الطريقة المعتادة لإعداد خادم MCP @modelcontextprotocol/server-memory⁠(يفتح في نافذة جديدة) لاستخدامه مع Codex هي كما يلي:

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"

ولأن أمر npx هذا يعمل دون عزل، يمكنه كتابة الملفات وإرسال طلبات الشبكة بالأذونات نفسها التي يملكها المستخدم الذي يشغّل Codex، وهي أذونات أوسع من اللازم. لتقييده، يمكننا تحديد ملف تعريف أذونات باسم memory-mcp، ثم تشغيل أمر npx الأصلي عبر codex sandbox --permission-profile memory-mcp لحصر المواقع التي يستطيع الخادم الكتابة فيها ومنعه من الوصول إلى الشبكة:

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"

قبل تشغيل الخادم، أنشئ دليل بياناته وأضف الحزمة ذات الإصدار المحدد إلى ذاكرة التخزين المؤقت في npm. يتيح ذلك لـ npx --offline تشغيل الخادم وفق ملف تعريف يعطّل الوصول إلى الشبكة:

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

بمجرد تخزين الحزمة مؤقتًا، يستطيع Codex تشغيل خادم الذاكرة دون الوصول إلى الشبكة، مع قصر الكتابة على ذاكرة التخزين المؤقت في npm ودليل بيانات الخادم.

آلية تنفيذ بيئة العزل في Codex

تحوّل آلية تنفيذ بيئة العزل ملف تعريف الأذونات إلى قيود يفرضها نظام التشغيل. يستخدم وكيل الشبكة المنطق الأساسي نفسه لمعالجة الطلبات وتطبيق السياسات في أنظمة التشغيل الرئيسية الثلاثة، بينما يختلف إعداده ودمجه مع بيئة العزل بحسب النظام. سنستعرض أولًا الوكيل المشترك، ثم آليات التنفيذ على macOS وLinux وWindows.

وكيل الشبكة

لفرض قيود الشبكة في ملف تعريف الأذونات، تشغّل منظومة التقييم وكيل شبكة وتهيّئ بيئة العزل للسماح بالاتصال به، مع حظر الاتصالات المباشرة بالأجهزة المضيفة الخارجية. يفحص الوكيل كل طلب وفق قواعد النطاقات في ملف التعريف ليقرر ما إذا كان سيمرّره.

في مستودع Codex، يُنفَّذ وكيل الشبكة ضمن حزمة codex-network-proxy⁠(يفتح في نافذة جديدة)، التي تستخدمها منظومة التقييم كمكتبة، ويمكن أيضًا بناؤها على هيئة أداة مستقلة لسطر الأوامر⁠(يفتح في نافذة جديدة). عند تفعيله، يشغّل codex-network-proxy افتراضيًا وكيل HTTP ووكيل SOCKS5 معًا. تُمرَّر عناوين هذين الوكيلين إلى العملية التي تنشئها بيئة العزل عبر متغيرات البيئة. إلى جانب حقن متغيرات البيئة القياسية مثل HTTP_PROXY وHTTPS_PROXY وALL_PROXY، تُحقن أيضًا مجموعة من متغيرات البيئة المعروفة الخاصة بالتطبيقات⁠(يفتح في نافذة جديدة)، مثل PIP_PROXY. لكن ليست كل البرامج تلتزم بمتغيرات البيئة هذه. إذا حاول برنامج الاتصال مباشرةً بمضيف خارجي، تحظره قيود العزل في نظام التشغيل، كما هو موضح في الأقسام الخاصة بكل منصة أدناه.

يتولى وكيل الشبكة تطبيق قيود الشبكة المحددة في ملف تعريف الأذونات. فمثلًا، يسمح ملف التعريف dev الموضح سابقًا بالطلبات إلى *.openai.com، ويمنع صراحةً الطلبات إلى evil.example. عندما يستهدف طلبٌ نطاقًا لا يطابق قاعدة سماح أو منع، يستطيع الوكيل تعليق الطلب وإحالته إلى منظومة التقييم للحصول على الموافقة. وكما في مثال أمر الصدفة، قد يطلب Codex موافقة المستخدم مباشرةً، أو يوجّه الطلب إلى المراجعة التلقائية⁠(يفتح في نافذة جديدة). عند تلقي القرار، يسمح الوكيل بمتابعة الطلب أو يرفض الطلب ويعيد رسالة خطأ.

الترتيب مهم هنا، لأن مجرد استعلام DNS قد يسرّب معلومات مُرمَّزة ضمن اسم المضيف. لذلك لا يحوّل الوكيل اسم المضيف المطلوب إلى عنوان إلا بعد التحقق من أنه مسموح به أو تمت الموافقة عليه. لاحظ أن قواعد أحرف البدل الواسعة أو إتاحة الوصول إلى خدمات DNS قد تظل تسمح بتسريب البيانات عبر DNS.

macOS

على macOS، يستخدم Codex آلية Seatbelt⁠(يفتح في نافذة جديدة) من Apple، وهي آلية عزل تفرضها نواة النظام. تُكتب سياسات Seatbelt بلغة ملفات تعريف العزل (SBPL)، وهي لغة قائمة على Scheme للتعبير عن قيود العزل. يستدعي Codex آلية Seatbelt عبر الأمر /usr/bin/sandbox-exec في macOS. ومثل codex sandbox، يستقبل خيارات تصف بيئة العزل، متبوعةً بالأمر المراد تشغيله:

Bash

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

يمثل PROFILE سلسلة نصية بلغة SBPL تحتوي على إدخالات لضبط بيئة العزل. فمثلًا، يجعل مقتطف SBPL التالي /dev/null و/dev/zero قابلين للقراءة والكتابة وفق سياسة بيئة العزل:

Scheme

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

عند تفعيل وكيل الشبكة ضمن استدعاء بيئة العزل، تُحقن قواعد مثل التالية في ملف التعريف لقصر الاتصالات على المنافذ المحلية المناسبة:

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"))


يبدأ ملف التعريف الأساسي في Codex بـ
(deny default)، لذا تظل الاتصالات الصادرة محظورة ما لم يُسمح بها صراحةً.

وأخيرًا، يمكن أن تتضمن SBPL عناصر نائبة باستخدام (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)))

تُملأ هذه العناصر بقيم خيارات -Dkey=value المُمرّرة إلى sandbox-exec.

لتنفيذ واجهة API الخاصة ببيئة العزل، يقوم Codex بإنشاء قائمة الوسائط⁠(يفتح في نافذة جديدة) لـ sandbox-exec انطلاقًا من سياسة أساسية⁠(يفتح في نافذة جديدة)، ثم يستخدم permission_profile والسياق الإضافي لتعديلها وإنتاج ملف تعريف Seatbelt الكامل. يضبط ملف التعريف الناتج ووسائط -D المرافقة القيود التي يفرضها Seatbelt، بينما يفرض وكيل الشبكة قواعد إضافية للشبكة. بعد تجميع قائمة الوسائط كاملةً، يصبح استدعاء sandbox-exec بسيطًا.

يمثل توليد SBPL صحيحة تحديًا، لأن Apple لا توثّق اللغة لاستخدام الأطراف الثالثة. وبالفعل، ينص man sandbox-exec على The sandbox-exec command is DEPRECATED (وينطبق ذلك أيضًا على دالة المكتبة sandbox_init() الموثّقة عبر man 3 sandbox_init). رغم التنبيه إلى أن استخدام الأمر لم يعد موصى به، لا يزال macOS يتضمن ملفات تعريف Seatbelt في /usr/share/sandbox، وتواصل برمجيات الأطراف الثالثة، ومنها Google Chrome وChromium⁠(يفتح في نافذة جديدة)، الاعتماد على Seatbelt. لذلك نخطط لمواصلة استخدام Seatbelt في المستقبل المنظور.

Linux

لإنشاء بيئة العزل على Linux، يستخدم Codex مزيجًا من bubblewrap⁠(يفتح في نافذة جديدة) (bwrap)، وهي أداة سطر أوامر لبناء بيئات معزولة، وseccomp-bpf⁠(يفتح في نافذة جديدة)، وهي آلية في نواة Linux لترشيح استدعاءات النظام. تتولى أداة مساعدة داخلية باسم codex-linux-sandbox تنسيق الإعداد. ومثل sandbox-exec على macOS، تستقبل إعدادات بيئة العزل متبوعةً بالأمر المراد تشغيله:

Bash

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

عند الحاجة إلى عزل نظام الملفات أو توجيه الاتصالات عبر الوكيل، يستدعي codex-linux-sandbox أداة bwrap لإنشاء بيئة العزل الأولية. ثم يشغّل bwrap الأمر codex-linux-sandbox --apply-seccomp-then-exec داخلها. يستخدم هذا الاستدعاء الثاني seccomp-bpf لتطبيق قيود إضافية قبل تشغيل أمر المستخدم.

لبناء بيئة العزل الأولية، يستخدم Codex أداة bubblewrap لإنشاء عرض لنظام الملفات ضمن نطاق أسماء تركيب منفصل يعكس قواعد نظام الملفات في ملف تعريف الأذونات. ولأن ذلك أساسي لتنفيذ العزل، يضمّن Codex نسخته الخاصة من bwrap في حال لم يكن المستخدم قد ثبّت نسخة خاصة به، لكنه يفضّل نسخة متوافقة مثبتة من ⁠(يفتح في نافذة جديدة)bwrap⁠(يفتح في نافذة جديدة) موجودة في PATH، متى توفرت. فقد تبيّن عمليًا أن بعض توزيعات Linux تعطّل الوصول إلى نطاقات أسماء المستخدمين افتراضيًا⁠(يفتح في نافذة جديدة)، لكنها تستثني نسخة bwrap الخاصة بالنظام.

وكما هو الحال مع sandbox-exec، يستقبل bwrap إعدادات بيئة العزل متبوعةً بأمر لتشغيله داخلها. وبدلًا من استخدام لغة إعداد مخصصة مثل SBPL، يستخدم bwrap خيارات منفردة للإعداد. يستخدم Codex الخيارات التالية لإنشاء عرض نظام الملفات:

  • --bind لتحديد ملف أو دليل قابل للكتابة

  • --ro-bind لتحديد ملف أو دليل للقراءة فقط

  • --perms 000 --tmpfs DIR --remount-ro DIR لمنع الوصول إلى DIR

  • --perms 000 --ro-bind-data FD FILE لمنع الوصول إلى FILE (حيث FD هو واصف ملف مفتوح يشير إلى /dev/null)

لتطبيق أنماط المنع باستخدام هذه الخيارات، يحوّلها Codex إلى مسارات فعلية قبل تشغيل كل أمر. ولا تُضاف المسارات الجديدة المطابقة تلقائيًا إلى قيود بيئة العزل لذلك الأمر.

يحدد Codex أيضًا خيارات مثل --unshare-ipc و--unshare-pid لمنع بيئة العزل من الوصول إلى أنواع أخرى من موارد المضيف، لذا يتجاوز تأثير bubblewrap مجرد التحكم في ظهور الملفات.

عند استخدام bubblewrap، يمرّر Codex الخيار --unshare-net كلما كانت الشبكة معطّلة أو كان لزامًا أن تمر الاتصالات عبر وكيل الشبكة، مما ينشئ نطاق أسماء شبكة جديدًا لبيئة العزل. ثم نستخدم seccomp-bpf لتطبيق قيود إضافية على استدعاءات النظام المتعلقة بالشبكة وعائلات المقابس المتاحة للأمر.


وتحديدًا، نستخدم
حزمة seccompiler⁠(يفتح في نافذة جديدة) من أجل ترجمة برنامج BPF ديناميكيًا بناءً على المرشحات المطلوبة⁠(يفتح في نافذة جديدة) وتطبيقه على عملية برنامج الإطلاق داخل بيئة العزل، لتنتقل القيود بالوراثة إلى شجرة العمليات بأكملها. وبذلك، لا يشغّل bwrap أمر المستخدم مباشرةً، بل يشغّل برنامج الإطلاق codex-linux-sandbox مع وسائط إعداده متبوعةً بأمر المستخدم:

Bash

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

لتطبيق مرشحات seccomp دون صلاحيات مرتفعة، يضبط برنامج الإطلاق علم no_new_privs في Linux⁠(يفتح في نافذة جديدة). ترث العمليات الفرعية هذا العلم، الذي يمنعها من اكتساب صلاحيات إضافية عند تنفيذ برنامج آخر، مثل ملف تنفيذي يستخدم setuid.

تعتمد مرشحات seccomp على إعدادات الشبكة. عند تعطيل الوصول إلى الشبكة، نحظر عددًا من استدعاءات النظام المتعلقة بالشبكة، مثل connect(2) وbind(2). أما عند تفعيل وكيل الشبكة في بيئة العزل، فنسمح بمقابس IP لإتاحة الوصول إلى مستمع TCP الذي ينشئه codex-linux-sandbox، لكننا نحظر افتراضيًا إنشاء مقابس نطاق Unix مستقلة، لأنها قد تتيح دون قصد الوصول إلى موارد المضيف.

الاتصال بوكيل الشبكة

عندما تستدعي إعدادات بيئة العزل استخدام وكيل الشبكة، تنشئ منظومة التقييم في Codex مثيلًا واحدًا من الوكيل يمكن إعادة استخدامه عبر استدعاءات متعددة لـ codex-linux-sandbox ضمن سلسلة المحادثة نفسها في Codex. تحتاج كل بيئة عزل إلى وسيلة للوصول إلى هذا الوكيل المشترك من نطاق أسماء شبكتها المعزول. يوفّر Codex مستمع TCP للاسترجاع المحلي داخل ذلك النطاق، ويهيّئ عملية خارج بيئة العزل لقبول اتصالاته وترحيلها إلى الوكيل.

توضح الرسوم التالية هذا الإعداد لنقطة نهاية واحدة للوكيل، ويعرض الرسم الأخير اتصالًا واحدًا يمر عبرها. قبل تشغيل bubblewrap، ينشئ codex-linux-sandbox زوجًا من مقابس Unix ليعمل كقناة تحكم، ثم ينشئ نسخة فرعية من عمليته. تشغّل العملية الفرعية run_host_bridge() وتنتظر استقبال واصف ملف المستمع عبر تلك القناة:

رسم يوضح منظومة التقييم في Codex وهي تشغّل codex-linux-sandbox، الذي ينشئ عملية ترحيل فرعية متصلة عبر قناة تحكم بمقبس Unix.

في هذا المثال، تستخدم العملية الأم exec لاستبدال صورة برنامجها بـ bwrap. وهذا يهيّئ بيئة العزل ويشغّل codex-linux-sandbox --apply-seccomp-then-exec داخلها، مع تمرير واصف ملف قناة التحكم:

رسم يوضح إنشاء bwrap لنطاق أسماء شبكة لبيئة العزل وتشغيل codex-linux-sandbox داخله، مع قناة تحكم بمقبس Unix تصل إلى عملية الترحيل خارج بيئة العزل.

داخل نطاق أسماء شبكة بيئة العزل، ينشئ الاستدعاء الثاني لـ codex-linux-sandbox مستمع TCP للاسترجاع المحلي، ويمرّر واصف ملفه عبر المقبس. يظل المستمع مرتبطًا بنطاق أسماء شبكة بيئة العزل، مما يتيح للعملية الفرعية التي بقيت خارجها قبول اتصالات البرامج المعزولة، مع فتح اتصالاتها الصادرة ضمن نطاق أسماء شبكة المضيف. بعد تمرير الواصف، تُغلق العمليتان واصفات قناة التحكم لديهما، وتُغلق العملية داخل بيئة العزل نسختها من المستمع.

بمجرد جاهزية مستمع TCP، تقوم العملية داخل بيئة العزل بضبط القيمة المناسبة للمتغير HTTP_PROXY⁠(يفتح في نافذة جديدة) ومتغيرات البيئة ذات الصلة لتشير إلى ذلك المستمع. ثم تطبّق seccomp قبل إنشاء عملية فرعية وتنفيذ أمر المستخدم:

رسم يوضح برنامجًا معزولًا يتصل بمستمع TCP للاسترجاع المحلي، مع عملية ترحيل codex-linux-sandbox خارجية تمرّر حركة البيانات إلى وكيل شبكة Codex.

تُبقي العملية خارج بيئة العزل المستمع مفتوحًا. ولكل اتصال تقبله، تفتح اتصالًا بالوكيل المُعدّ وترحّل البيانات في كلا الاتجاهين.

تمنح هذه الآليات الإضافية الأمر نطاق أسماء شبكة خاصًا به، يتضمن واجهة استرجاع محلي منفصلة. في macOS، يتيح Seatbelt للأمر الاتصال مباشرةً بمنافذ محددة على واجهة الاسترجاع المحلي للمضيف. أما في Linux، فيتصل الأمر بمستمع داخل نطاق أسمائه المعزول، وتتولى عملية خارج بيئة العزل ترحيل تلك الاتصالات إلى الوكيل المُعدّ. يتيح تمرير واصف الملف هذا الاتصال دون إتاحة نطاق أسماء شبكة المضيف للأمر.

Windows

في وقت سابق من هذا العام، نفّذنا آليات للعزل على Windows، وكتبنا عن جهودنا في هذا المجال. ومنذ ذلك الحين، أصدرت Microsoft مكتبة باسم MXC إلى جانب ميزات جديدة لعزل العمليات داخل نظام التشغيل Windows. نعمل حاليًا على استبدال بيئة العزل الحالية بأخرى تستخدم مكتبة MXC.

ما هي MXC؟

يرمز MXC إلى Microsoft eXecution Container، وهو نظام من Microsoft لتنفيذ التعليمات البرمجية في بيئة معزولة⁠(يفتح في نافذة جديدة)، ويدعم عدة آليات احتواء على Windows وLinux وmacOS. يدعم Codex بيئة عزل قائمة على MXC على أجهزة Windows المتوافقة، مستخدمًا عزل العمليات المدمج في النظام لتقييد الأوامر ضمن بيئة المستخدم الحالية.

ننتقل إلى MXC لتحسين الأمان وسهولة الاستخدام، مع معالجة عدة قيود في بيئة العزل الحالية على Windows:

  • الحاجة إلى صلاحيات مرتفعة أو صلاحيات مسؤول لإعداد بيئة العزل

  • بطء عمليات فحص قوائم التحكم في الوصول (ACL) وضبطها وارتفاع تكلفتها

  • بقاء عناصر إعداد بيئة العزل على الجهاز المضيف، ومنها

    • قوائم ACL

    • قواعد جدار الحماية

    • حسابات مستخدمي بيئة العزل

    • ملفات مستوى التحكم

توفّر MXC مخطط إعداد بتنسيق JSON⁠(يفتح في نافذة جديدة). يستخدم Codex حزمة تطوير MXC⁠(يفتح في نافذة جديدة) لإنشاء طلب تنفيذ يتبع ذلك المخطط ويتضمن الأمر ودليل العمل والبيئة والأذونات. تشمل هذه الأذونات الوصول إلى نظام الملفات والشبكة، إلى جانب موارد Windows مثل سطح المكتب والحافظة.

تحويل السياسة إلى استدعاء MXC

يستخدم Codex إعدادات ثابتة لعدة ضوابط لتحقيق التوازن بين التوافق والأمان. فهو يسمح بقراءة سجل النظام، ويُبقي صلاحية الوصول إلى Win32k وسطح المكتب التي يحتاجها PowerShell عند بدء التشغيل. ويعطّل الوصول إلى الحافظة، وحقن المدخلات، والتحكم في سطح المكتب وإعدادات النظام. وأخيرًا، يمنع MXC من اللجوء إلى تعديل أذونات نظام ملفات المضيف كخيار بديل.

يحوّل Codex قواعد نظام الملفات والشبكة في ملف تعريف الأذونات إلى إعدادات MXC. باستخدام ملف التعريف dev السابق، وبافتراض ما يلي:

  • أن C:\ وD:\ وZ:\ هي محركات الأقراص المحلية الوحيدة في الجهاز.

  • أن جذر مساحة العمل ودليل العمل هما C:\work\demo.

  • أن الدليل الرئيسي للمستخدم هو D:\Users\dev، لذا يُحوَّل ~/build-cache إلى D:\Users\dev\build-cache.

  • أن نمط المنع يطابق فقط C:\work\demo\config\dev.env وC:\work\demo\config\prod.env.

ستتضمن إعدادات MXC المقابلة ما يلي:

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
}

الوصول إلى جذور محركات الأقراص

تمنع سياسة نظام الملفات في MXC الوصول افتراضيًا. لذلك يضيف Codex أذونات للقراءة فقط إلى جذور محركات الأقراص المحلية، لتوفير نطاق القراءة الواسع الذي يسمح به ملف التعريف هذا. تسري هذه الأذونات على جميع المستويات الفرعية، مع مراعاة أذونات المستخدم الحالية في نظام التشغيل.

لكن ثمة تفصيل مهم: أذونات جذور محركات الأقراص التي تسمح بالكتابة لا تسري على المستويات الفرعية، لذا يوسّعها Codex لتشمل العناصر المباشرة الموجودة تحت جذر محرك الأقراص.

تعارض الأذونات

تتجاوز أذونات المسارات الأكثر تحديدًا أذونات المسارات الأعلى منها، لذا يمكن أن يكون C:\work\demo قابلًا للكتابة ضمن C:\ المخصص للقراءة فقط، بينما يظل C:\work\demo\.git للقراءة فقط.

عندما تشير صيغ مختلفة للمسار أو أسماء بديلة عبر روابط رمزية أو نقاط وصل إلى المسار نفسه، تطبّق MXC الإذن الأكثر تقييدًا: فالمنع له الأولوية على القراءة فقط، والقراءة فقط لها الأولوية على القراءة والكتابة.

أنماط المنع

لا تقبل MXC إلا مسارات منع فعلية، لذا يحوّل Codex أنماط المنع إلى الملفات والأدلة المطابقة قبل التشغيل. ولا تُضاف المسارات الجديدة المطابقة للنمط تلقائيًا أثناء تشغيل الأمر.

الوصول إلى الشبكة

يفرض وكيل شبكة Codex المشترك الموضح سابقًا قواعد النطاقات، مثل *.openai.com. يشغّل Codex ذلك الوكيل خارج بيئة العزل، ويمرّر عناوينه إلى الأمر عبر متغيرات البيئة القياسية *_PROXY نفسها المذكورة سابقًا. تحظر MXC الاتصالات الخارجية المباشرة، مع السماح باتصالات الاسترجاع المحلي للمضيف، بما فيها الوصول إلى الوكيل. وتظل الخدمات المحلية الأخرى متاحة للاتصال.

على macOS وLinux وWindows، تستخدم منظومة التقييم واجهة API نفسها لبيئة العزل لتشغيل الأوامر وفق ملف تعريف أذونات. وتتولى آليات التنفيذ الخاصة بكل منصة الإعداد اللازم لتطبيق تلك القيود.

البناء على بيئة العزل في Codex

تمنح كتابة التعليمات البرمجية وتنفيذها الوكلاء وسيلة مرنة لحل مشكلات تتجاوز تطوير البرمجيات. تتيح لهم بيئة العزل في Codex استخدام هذه القدرة في بيئة المستخدم الحالية، ضمن حدود صريحة للوصول إلى نظام الملفات والشبكة. وهي مكوّن أساسي قابل لإعادة الاستخدام داخل منظومة التقييم، ويتيحها الأمر codex sandbox للأدوات التي تبنيها بنفسك.

مع تولّي الوكلاء مزيدًا من المهام، نريد أن نجعل العزل خيارًا عمليًا لمزيد من الأدوات والبيئات. ويعني ذلك تسهيل ضبط الأذونات والاستفادة من وسائل الحماية الأفضل في أنظمة التشغيل كلما توفرت. هدفنا هو توسيع ما يستطيع الوكلاء إنجازه، مع احتفاظ المستخدمين بالتحكم فيما يمكن للوكلاء الوصول إليه.

المؤلف

OpenAI

شكر وتقدير

شكر خاص لديفيد ويزن، وتشارلي ويمز، وفيات بهالوديا، وفوتيس تشانتزيس على مساهمتهم في هذا المقال.