OpenAI

১৮ নভেম্বর, ২০২৬

ইঞ্জিনিয়ারিং

Codex স্যান্ডবক্সের ভেতরে

আপনার নির্ধারিত সীমা মেনে Codex কীভাবে আপনার মেশিনে কমান্ড চালায়.

লিখেছেন মাইকেল বোলিন, প্রযুক্তি দলের সদস্য

OpenAI-তে এজেন্ট সুরক্ষিত রাখতে আমরা বহুস্তরীয় প্রতিরক্ষা⁠(একটি নতুন উইন্ডোতে খোলে) পদ্ধতি অনুসরণ করি. প্রশিক্ষণ ও মানবিক উদ্দেশ্যের সঙ্গে সামঞ্জস্য আনার কাজে বিনিয়োগ এই প্রচেষ্টার ভিত্তি. পাশাপাশি বাড়তি সুরক্ষা দিতে আমরা আমাদের এজেন্ট কার্যপরিধি Codex⁠(একটি নতুন উইন্ডোতে খোলে)-এ বিভিন্ন সুবিধা যুক্ত করি. আপনার কম্পিউটারে কমান্ড চালানো Codex-এর সবচেয়ে সাধারণ এবং সম্ভাব্য ঝুঁকিপূর্ণ কাজগুলোর একটি. তাই আমরা Codex স্যান্ডবক্স তৈরি করেছি, যাতে Codex আপনার নিয়ন্ত্রণাধীন ফাইলসিস্টেম ও নেটওয়ার্কের সীমার মধ্যে থেকে আপনার বিদ্যমান পরিবেশেই কাজ করতে পারে.

একটি ⁠(একটি নতুন উইন্ডোতে খোলে)স্যান্ডবক্স⁠(একটি নতুন উইন্ডোতে খোলে) চলমান প্রোগ্রাম কী কী ব্যবহার করতে পারবে তা সীমিত করে. ছবি গোছানোর কাজে আপনি Codex স্যান্ডবক্স এমনভাবে কনফিগার করতে পারেন, যাতে কমান্ড ~/Pictures-এর ফাইল পড়তে ও বদলাতে পারে, কিন্তু আপলোড ঠেকাতে নেটওয়ার্ক ব্যবহার বন্ধ থাকে. কোড পর্যালোচনার জন্য সোর্স ফাইল শুধু পড়ার উপযোগী রেখে অনলাইন ডকুমেন্টেশন দেখার অনুমতি দিতে পারেন. ব্যবহারকারীরা ⁠(একটি নতুন উইন্ডোতে খোলে)অনুমতি প্রোফাইল⁠(একটি নতুন উইন্ডোতে খোলে) দিয়ে Codex স্যান্ডবক্স কনফিগার করেন. এই প্রোফাইল Codex সেশনের ফাইলসিস্টেম ও নেটওয়ার্কের বিধিনিষেধ নির্ধারণ করে.

এই নিবন্ধে প্রথমে Codex স্যান্ডবক্সের পূর্বনির্ধারিত সেটিংস বেছে নেওয়ার সুবিধা-অসুবিধা আলোচনা করব. এরপর স্যান্ডবক্সের নকশা এবং কার্যপরিধি কীভাবে এটি দিয়ে কমান্ড চালায়, তা ব্যাখ্যা করব. ব্যবহারকারী ও প্রতিষ্ঠান কীভাবে নিজেদের প্রয়োজনে এর অনুমতি বদলাতে পারে এবং ডেভেলপাররা কীভাবে নিজেদের সরঞ্জামে স্যান্ডবক্সটি পুনর্ব্যবহার করতে পারেন, তা দেখাব. সবশেষে দেখব macOS, Linux ও Windows-এ এই বিধিনিষেধ কীভাবে কার্যকর করা হয়.

স্যান্ডবক্সের সীমানা নির্ধারণ

Codex-এ আমাদের নীতি হলো স্যান্ডবক্সের জন্য সতর্কতামূলক পূর্বনির্ধারিত সেটিংস রাখা, যা অর্থবহ কাজ করার সুযোগও দেয়. যেমন, কর্মপরিসরের মূল হিসেবে একটি Git রিপোজিটরি থাকলে অন্তর্নির্মিত :workspace অনুমতি প্রোফাইল:

  • কর্মপরিসরে লেখার অনুমতি দেয়, তবে .git ও .codex-এর মতো ডিরেক্টরি শুধু পড়ার উপযোগী রাখে. এতে Codex প্রতিটি পরিবর্তনের জন্য অনুমতি না চেয়ে সোর্স কোড সম্পাদনা করতে পারে, কিন্তু .codex/config.toml বা .git/hooks-এর অধীনে থাকা Git হুক সরাসরি বদলাতে পারে না.

  • ব্যবহারকারীর বিদ্যমান অপারেটিং সিস্টেমের অনুমতি সাপেক্ষে ফাইলসিস্টেমজুড়ে পড়ার সুযোগ দেয়. কম্পাইলার, রানটাইম ও বিল্ড সরঞ্জাম রিপোজিটরির বাইরের SDK, লাইব্রেরি ও কনফিগারেশনের ওপর নির্ভর করে. পড়ার সুযোগ শুধু কর্মপরিসরে সীমিত রাখলে অনেক সাধারণ কর্মপ্রবাহ অচল হয়ে যাবে. এর অসুবিধা হলো, মেশিনের অন্যত্র থাকা সংবেদনশীল ফাইলও পড়া যেতে পারে, যেমন API কী থাকা কনফিগারেশন ফাইল.

  • নেটওয়ার্ক ব্যবহার বন্ধ রাখে. এতে বাইরের পরিষেবায় সরাসরি আপলোড বন্ধ থাকে, এমনকি কমান্ড পড়তে পারে এমন ডেটা চুরি করে পাঠানোর চেষ্টাও আটকে যায়. তবে নির্ভরশীল প্যাকেজ ডাউনলোডের মতো বৈধ কাজও এতে আটকে যায়, যার জন্য বাড়তি অনুমতি দরকার.

এই বিধিনিষেধ অনেক ধরনের ক্ষতিকর আচরণ ঠেকায়, তবু ক্ষতিকর কাজ করা সম্ভব. যেমন, এজেন্ট স্থানীয়ভাবে ইনস্টল করা node_modules/prettier-এর মতো প্যাকেজে ক্ষতিকর কোড ঢুকিয়ে দিতে পারে. এই পরিবর্তন git status-এ নাও দেখা যেতে পারে, কারণ Git প্রায়ই node_modules উপেক্ষা করে. ব্যবহারকারীর সম্পাদক ফাইল সংরক্ষণের সময় Prettier-এর ওই কপি চালালে, শুধু ফাইল সংরক্ষণ করলেই Codex স্যান্ডবক্সের বাইরে ক্ষতিকর কোডটি চলতে পারে. এ কারণেই আমরা বহুস্তরীয় প্রতিরক্ষা অনুসরণ করি: স্যান্ডবক্স কমান্ডের প্রবেশাধিকার সীমিত করে, আর প্রশিক্ষণ ও উদ্দেশ্যের সঙ্গে সামঞ্জস্য আনার কাজ মডেলকে ব্যবহারকারীর অভিপ্রায় অনুযায়ী সেই অধিকার কাজে লাগাতে সাহায্য করে.

প্রাতিষ্ঠানিক পরিবেশে স্যান্ডবক্সের অনুমতি প্রয়োজনমতো সাজানো এবং অন্য সুরক্ষাব্যবস্থার সঙ্গে তা ব্যবহারের নির্দেশনার জন্য দেখুন Codex নিরাপত্তার ব্যবহারিক নির্দেশিকা⁠(একটি নতুন উইন্ডোতে খোলে).

স্যান্ডবক্সের নকশা

ভার্চুয়াল মেশিন ও কন্টেইনার⁠(একটি নতুন উইন্ডোতে খোলে) স্যান্ডবক্সিংয়ের দুটি জনপ্রিয় পদ্ধতি, তবে Codex স্যান্ডবক্সে আমরা ভিন্ন পদ্ধতি নিই. বিচ্ছিন্নতা নিশ্চিত করতে কাজকে আলাদা পরিবেশে সরিয়ে নেওয়ার বদলে Codex প্রতিটি প্ল্যাটফর্মের স্যান্ডবক্সিং সুবিধা ব্যবহার করে. এতে ব্যবহারকারীর বিদ্যমান পরিবেশেই চলমান কমান্ডকে সীমাবদ্ধ রাখা যায়.

অনেক ডেভেলপারের ল্যাপটপই তাঁদের নিজের মতো সাজানো উন্নয়ন পরিবেশ, যা তাঁরা যখন ইচ্ছা বদলাতে পারেন. Docker কন্টেইনারে সেই পরিবেশ আবার তৈরি করতে বেশ কাজ লাগে, আর কিছু কর্মপ্রবাহ তখনও হোস্টে চলা সরঞ্জামের ওপর নির্ভর করে.

উদাহরণ হিসেবে Mac-এ Codex দিয়ে একটি iOS অ্যাপ তৈরির কথা ভাবুন. Codex-কে স্যান্ডবক্সে রাখতে Docker-এর ভেতরে চালালে, এটি Mac-এর নিজস্ব এক্সিকিউটেবল দিয়ে গঠিত iOS বিল্ড টুলচেইন চালাতে পারবে না. কোড চালানোর জন্য iPhone সিমুলেটরও চালু করতে পারবে না. Docker-ভিত্তিক কর্মপ্রবাহ বিল্ড ও সিমুলেটরের কাজ Mac হোস্টকে দিতে পারে, কিন্তু তখন সেসব কাজ কন্টেইনারের স্যান্ডবক্সের বাইরে চলবে এবং আলাদা বিধিনিষেধ লাগবে. Codex-এর ক্ষেত্রে আমরা বিষয়টি সহজ রাখতে অপারেটিং সিস্টেমভিত্তিক স্যান্ডবক্সিংয়ে বেশি বিনিয়োগ করি, যাতে এটি কাজের জন্য সবচেয়ে উপযুক্ত পরিবেশেই চলতে পারে.

কার্যপরিধি macOS, Windows ও Linux-এ একটি অভিন্ন API দিয়ে অপারেটিং সিস্টেমভিত্তিক স্যান্ডবক্সিং ব্যবস্থা ব্যবহারের সুযোগ দেয়. এই API একটি কমান্ড ও একটি অনুমতি প্রোফাইল গ্রহণ করে. অনুমতি প্রোফাইলে সীমিত নেটওয়ার্ক ব্যবহারের সুযোগ থাকলে, সেই সীমা কার্যকর করতে কলকারীকে একটি নেটওয়ার্ক প্রক্সি সরবরাহ করতে হবে:

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}

কমান্ডকে স্যান্ডবক্সে রাখতে কার্যপরিধি subprocess.Popen()-এর বদলে spawn_command_under_sandbox() কল করে. কার্যপরিধি অনুমতি প্রোফাইল এবং প্রয়োজনে নেটওয়ার্ক প্রক্সি সরবরাহ করে:

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 মূল ExecCommandToolCall-এর কমান্ড আর্গুমেন্টের সঙ্গে উপযুক্ত permission_profile ও network_proxy পাঠায় perform_exec_command_with_sandboxing()-এ.

spawn_command_under_sandbox() মূলত শেল সরঞ্জাম ব্যবহার করে. পাশাপাশি স্থানীয় ফাইল পড়া ও বদলানোর মতো কাজেও কার্যপরিধি তার স্যান্ডবক্সিং অবকাঠামো পুনর্ব্যবহার করে. এই পুনর্ব্যবহার কার্যপরিধির বাইরেও সম্ভব: codex sandbox কমান্ড দিয়ে আপনার নিজস্ব সরঞ্জামে স্যান্ডবক্সের মধ্যে কমান্ড চালানোর ব্যবস্থা যোগ করতে পারেন, যা আমরা পরে দেখব. এরপর আমরা দেখব অনুমতি প্রোফাইল কীভাবে নির্ধারণ করা হয়.

স্যান্ডবক্স কনফিগার করা

নামযুক্ত অনুমতি প্রোফাইল দিয়ে বিভিন্ন প্রকল্পে একই ফাইলসিস্টেম ও নেটওয়ার্ক বিধিনিষেধ পুনর্ব্যবহার করা যায়. config.toml-এর [permissions]-এর অধীনে নিজের প্রোফাইল নির্ধারণ করতে পারেন. যেমন, নিচে 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 CLI তার কার্যকরী ডিরেক্টরিকে কর্মপরিসরের একমাত্র মূল ডিরেক্টরি ধরে, আর ChatGPT ডেস্কটপ অ্যাপ প্রকল্পের সোর্স ফোল্ডারগুলো ব্যবহার করে. Codex প্রতিটি মূল ডিরেক্টরিতে প্রতিটি নিয়ম প্রয়োগ করে. তাই dev-এর .vscode এন্ট্রি প্রতিটি মূল ডিরেক্টরির অধীনে .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-কে সরাসরি নেটওয়ার্ক ব্যবহারের অনুমতি দিতে config.toml-এর শীর্ষ স্তরে permissions.dev.network.enabled = true নির্ধারণ করুন. নেটওয়ার্ক প্রক্সি বন্ধ থাকলে এটি পূর্ণ নেটওয়ার্ক প্রবেশাধিকার দেয়.

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 কনফিগারেশনে নির্ধারিত অনুমতি প্রোফাইলের অধীনে যেকোনো কমান্ড সহজে চালাতে Codex CLI একটি sandbox কমান্ড দেয়. এটি সাধারণত প্রোফাইল পরীক্ষা করতে ব্যবহৃত হয়, যাতে নিশ্চিত হওয়া যায় যে স্যান্ডবক্স কাঙ্ক্ষিত আচরণগুলো সত্যিই আটকে দিচ্ছে.

যেমন, নিচের কমান্ড ফাইল সংরক্ষণের সময় ক্ষতিকর স্বয়ংক্রিয় বিন্যাসকারী চালানোর জন্য 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 সার্ভারকে স্যান্ডবক্সে রাখা

config.toml-এ কনফিগার করা stdio MCP সার্ভারের ক্ষেত্রে Codex কার্যপরিধি সার্ভার চালুর কমান্ডকে স্যান্ডবক্সে রাখার চেষ্টা করে না. ওই সার্ভারের কোন ফাইল বা নেটওয়ার্ক পরিষেবা দরকার, তা Codex নির্ভরযোগ্যভাবে অনুমান করতে পারে না. তাই পূর্বনির্ধারিত স্যান্ডবক্স প্রোফাইল প্রয়োগ করলে অন্যথায় সঠিক কনফিগারেশনও অচল হতে পারে.

যেমন, Codex-এর সঙ্গে ব্যবহারের জন্য @modelcontextprotocol/server-memory⁠(একটি নতুন উইন্ডোতে খোলে) MCP সার্ভার কনফিগার করার প্রচলিত পদ্ধতি হলো:

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-এর নীতি লেখা হয় Sandbox Profile Language (SBPL)-এ. এটি স্যান্ডবক্সের বিধিনিষেধ প্রকাশের জন্য Scheme-ভিত্তিক একটি ভাষা. Codex macOS-এর /usr/bin/sandbox-exec কমান্ড দিয়ে Seatbelt চালু করে. 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)))

যেগুলোর মান বসানো হয় sandbox-exec-কে দেওয়া -Dkey=value বিকল্প দিয়ে.

নিজস্ব স্যান্ডবক্স API বাস্তবায়নে Codex একটি মূল নীতি⁠(একটি নতুন উইন্ডোতে খোলে) থেকে শুরু করে sandbox-exec-এর আর্গুমেন্টের তালিকা তৈরি করে⁠(একটি নতুন উইন্ডোতে খোলে). এরপর permission_profile ও অন্যান্য প্রাসঙ্গিক তথ্য দিয়ে তা সংশোধন করে সম্পূর্ণ Seatbelt প্রোফাইল তৈরি করে. তৈরি হওয়া প্রোফাইল ও সঙ্গে থাকা -D আর্গুমেন্টগুলো Seatbelt-এর কার্যকর করা বিধিনিষেধ নির্ধারণ করে. আর নেটওয়ার্ক প্রক্সি বাড়তি নেটওয়ার্ক নিয়ম কার্যকর করে. আর্গুমেন্টের পূর্ণ তালিকা তৈরি হয়ে গেলে sandbox-exec চালু করা সহজ.

সঠিক SBPL তৈরি করা কঠিন, কারণ তৃতীয় পক্ষের ব্যবহারের জন্য Apple এই ভাষার ডকুমেন্টেশন দেয় না. এমনকি man sandbox-exec-এ বলা আছে The sandbox-exec command is DEPRECATED (একইভাবে man 3 sandbox_init-এ বর্ণিত sandbox_init() লাইব্রেরি ফাংশনও অপ্রচলিত ঘোষিত). অপ্রচলিত ঘোষণার সতর্কতা সত্ত্বেও macOS এখনো /usr/share/sandbox-এ Seatbelt প্রোফাইল সরবরাহ করে. Google Chrome ও Chromium-সহ⁠(একটি নতুন উইন্ডোতে খোলে) তৃতীয় পক্ষের সফটওয়্যারও এখনো Seatbelt-এর ওপর নির্ভর করে. তাই অদূর ভবিষ্যতেও আমরা Seatbelt ব্যবহার চালিয়ে যাওয়ার পরিকল্পনা করছি.

Linux

Linux-এ স্যান্ডবক্স তৈরি করতে Codex একসঙ্গে ব্যবহার করে bubblewrap⁠(একটি নতুন উইন্ডোতে খোলে) (bwrap) ও seccomp-bpf⁠(একটি নতুন উইন্ডোতে খোলে). প্রথমটি বিচ্ছিন্ন পরিবেশ তৈরির কমান্ড-লাইন সরঞ্জাম, আর দ্বিতীয়টি সিস্টেম কল ছাঁকাইয়ের জন্য Linux কার্নেলের ব্যবস্থা. codex-linux-sandbox নামের একটি অভ্যন্তরীণ সহায়ক প্রোগ্রাম প্রস্তুতির কাজ সমন্বয় করে. macOS-এর sandbox-exec-এর মতো এটি প্রথমে স্যান্ডবক্স কনফিগারেশন এবং তারপর চালানোর কমান্ড গ্রহণ করে:

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 দিয়ে পৃথক মাউন্ট নেমস্পেসে ফাইলসিস্টেমের একটি দৃশ্য তৈরি করে, যা অনুমতি প্রোফাইলের ফাইলসিস্টেমের নিয়ম অনুযায়ী সাজানো. এটি স্যান্ডবক্স বাস্তবায়নের মূল ভিত্তি. তাই ব্যবহারকারী নিজে bwrap ইনস্টল না করলেও চলার জন্য Codex নিজস্ব কপি সঙ্গে রাখে. তবে PATH-এ পাওয়া গেলে এটি bwrap⁠(একটি নতুন উইন্ডোতে খোলে)-এর সামঞ্জস্যপূর্ণ ইনস্টলেশনকে অগ্রাধিকার দেয়⁠(একটি নতুন উইন্ডোতে খোলে). বাস্তবে দেখা গেছে, কিছু Linux ডিস্ট্রিবিউশন পূর্বনির্ধারিতভাবে ব্যবহারকারী নেমস্পেসে প্রবেশাধিকার বন্ধ রাখে⁠(একটি নতুন উইন্ডোতে খোলে), তবে সিস্টেমের bwrap-কে ব্যতিক্রম হিসেবে অনুমতি দেয়.

sandbox-exec-এর মতো bwrap-ও প্রথমে স্যান্ডবক্স কনফিগারেশন এবং তারপর স্যান্ডবক্সে চালানোর কমান্ড গ্রহণ করে. SBPL-এর মতো বিশেষ কনফিগারেশন ভাষার বদলে bwrap কনফিগারেশনের জন্য আলাদা আলাদা ফ্ল্যাগ ব্যবহার করে. ফাইলসিস্টেমের দৃশ্য তৈরি করতে Codex নিচের বিকল্পগুলো ব্যবহার করে:

  • লেখার উপযোগী ফাইল বা ডিরেক্টরি নির্ধারণে --bind

  • শুধু পড়ার উপযোগী ফাইল বা ডিরেক্টরি নির্ধারণে --ro-bind

  • DIR-এ প্রবেশাধিকার বন্ধ করতে --perms 000 --tmpfs DIR --remount-ro DIR

  • FILE-এ প্রবেশাধিকার বন্ধ করতে --perms 000 --ro-bind-data FD 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 ফিল্টার প্রয়োগ করতে লঞ্চার Linux-এর no_new_privs ফ্ল্যাগ নির্ধারণ করে⁠(একটি নতুন উইন্ডোতে খোলে). অধীনস্থ প্রসেসগুলো এই ফ্ল্যাগ পায়. ফলে setuid এক্সিকিউটেবলের মতো অন্য প্রোগ্রাম চালানোর সময় তারা বাড়তি অধিকার অর্জন করতে পারে না.

seccomp ফিল্টারগুলো নেটওয়ার্ক কনফিগারেশনের ওপর নির্ভর করে. নেটওয়ার্ক ব্যবহার বন্ধ থাকলে আমরা connect(2) ও bind(2)-এর মতো বেশ কিছু নেটওয়ার্ক-সংশ্লিষ্ট সিস্টেম কল আটকে দিই. তবে স্যান্ডবক্সে নেটওয়ার্ক প্রক্সি চালু থাকলে আমরা IP সকেটের অনুমতি দিই, যাতে codex-linux-sandbox-এর তৈরি TCP লিসেনারে পৌঁছানো যায়. কিন্তু স্বতন্ত্র Unix ডোমেইন সকেট তৈরি পূর্বনির্ধারিতভাবে বন্ধ রাখি, কারণ সেগুলো অনিচ্ছাকৃতভাবে হোস্টের রিসোর্স ব্যবহারের সুযোগ দিতে পারে.

নেটওয়ার্ক প্রক্সিতে সংযোগ

স্যান্ডবক্স কনফিগারেশনে নেটওয়ার্ক প্রক্সি দরকার হলে Codex কার্যপরিধি প্রক্সির একটি ইনস্ট্যান্স তৈরি করে. একই Codex থ্রেডে codex-linux-sandbox একাধিকবার চালানোর সময় সেটি পুনর্ব্যবহার করা যায়. প্রতিটি স্যান্ডবক্সের বিচ্ছিন্ন নেটওয়ার্ক নেমস্পেস থেকে ওই যৌথ প্রক্সিতে পৌঁছানোর উপায় দরকার. Codex ওই নেমস্পেসে একটি লুপব্যাক TCP লিসেনার রাখে এবং স্যান্ডবক্সের বাইরের একটি প্রসেস দিয়ে তার সংযোগগুলো গ্রহণ করে প্রক্সিতে পৌঁছে দেওয়ার ব্যবস্থা করে.

নিচের চিত্রগুলোতে একটি প্রক্সি এন্ডপয়েন্টের জন্য এই ব্যবস্থা দেখানো হয়েছে. শেষ চিত্রে এর মধ্য দিয়ে একটি সংযোগ দেখানো হয়েছে. bubblewrap চালুর আগে codex-linux-sandbox নিয়ন্ত্রণ চ্যানেল হিসেবে এক জোড়া Unix সকেট তৈরি করে এবং নিজেকে ফর্ক করে. অধীনস্থ প্রসেস run_host_bridge() চালিয়ে ওই চ্যানেলে লিসেনারের ফাইল ডেসক্রিপ্টর পাওয়ার অপেক্ষা করে:

চিত্রে Codex কার্যপরিধিকে codex-linux-sandbox চালু করতে দেখা যাচ্ছে, যা ফর্ক করে একটি রিলে প্রসেস তৈরি করে. প্রসেসটি Unix সকেট নিয়ন্ত্রণ চ্যানেলের মাধ্যমে যুক্ত.

এই উদাহরণে মূল প্রসেস exec দিয়ে নিজের প্রোগ্রাম ইমেজের জায়গায় bwrap বসায়. এটি স্যান্ডবক্স তৈরি করে তার ভেতরে codex-linux-sandbox --apply-seccomp-then-exec চালু করে এবং নিয়ন্ত্রণ চ্যানেলের FD পাঠিয়ে দেয়:

চিত্রে bwrap-কে স্যান্ডবক্সের নেটওয়ার্ক নেমস্পেস তৈরি করে তার ভেতরে codex-linux-sandbox চালু করতে দেখা যাচ্ছে. একটি Unix সকেট নিয়ন্ত্রণ চ্যানেল এটিকে স্যান্ডবক্সের বাইরের রিলে প্রসেসের সঙ্গে যুক্ত করেছে.

দ্বিতীয়বার চালু হওয়া codex-linux-sandbox স্যান্ডবক্সের নেটওয়ার্ক নেমস্পেসে একটি লুপব্যাক TCP লিসেনার তৈরি করে এবং সকেট দিয়ে তার ফাইল ডেসক্রিপ্টর পাঠায়. লিসেনারটি স্যান্ডবক্সের নেটওয়ার্ক নেমস্পেসের সঙ্গেই যুক্ত থাকে. ফলে স্যান্ডবক্সের বাইরে থাকা অধীনস্থ প্রসেস স্যান্ডবক্সের প্রোগ্রামগুলোর সংযোগ গ্রহণ করতে পারে, আর নিজের উজানমুখী সংযোগগুলো খোলে হোস্টের নেটওয়ার্ক নেমস্পেসে. হস্তান্তরের পর উভয় প্রসেস তাদের নিয়ন্ত্রণ চ্যানেলের ডেসক্রিপ্টর বন্ধ করে. স্যান্ডবক্সের ভেতরের প্রসেস লিসেনারের নিজস্ব কপিটিও বন্ধ করে.

TCP লিসেনার প্রস্তুত হলে, স্যান্ডবক্সের ভেতরের প্রসেস HTTP_PROXY-এর উপযুক্ত মান নির্ধারণ করে⁠(একটি নতুন উইন্ডোতে খোলে) এবং সংশ্লিষ্ট এনভায়রনমেন্ট ভেরিয়েবলগুলোকে ওই লিসেনারের দিকে নির্দেশ করে. এরপর ব্যবহারকারীর কমান্ড চালানোর জন্য ফর্ক করার আগে এটি seccomp প্রয়োগ করে:

চিত্রে স্যান্ডবক্সের একটি প্রোগ্রামকে লুপব্যাক TCP লিসেনারে সংযোগ করতে দেখা যাচ্ছে. বাইরের একটি codex-linux-sandbox রিলে সেই ডেটা চলাচল Codex নেটওয়ার্ক প্রক্সিতে পাঠাচ্ছে.

স্যান্ডবক্সের বাইরের প্রসেস লিসেনারটি খোলা রাখে. প্রতিটি গৃহীত সংযোগের জন্য এটি নির্ধারিত প্রক্সির সঙ্গে একটি সংযোগ খোলে এবং উভয় দিকে ডেটা আদান-প্রদান করে.

এই অতিরিক্ত ব্যবস্থায় কমান্ডটি পৃথক লুপব্যাক ইন্টারফেসসহ নিজস্ব নেটওয়ার্ক নেমস্পেস পায়. macOS-এ Seatbelt কমান্ডকে হোস্টের লুপব্যাক ইন্টারফেসের নির্দিষ্ট পোর্টে সরাসরি সংযোগ করতে দেয়. Linux-এ কমান্ডটি বরং তার বিচ্ছিন্ন নেমস্পেসের ভেতরের লিসেনারে সংযোগ করে, আর স্যান্ডবক্সের বাইরের একটি প্রসেস সেই সংযোগগুলো নির্ধারিত প্রক্সিতে পৌঁছে দেয়. ডেসক্রিপ্টর হস্তান্তরের ফলে হোস্টের নেটওয়ার্ক নেমস্পেসে কমান্ডকে প্রবেশাধিকার না দিয়েই এই সংযোগ সম্ভব হয়.

Windows

এ বছরের শুরুতে আমরা Windows-এ স্যান্ডবক্সিং বাস্তবায়ন করেছি এবং আমাদের সেই উদ্যোগ নিয়ে লিখেছি. এরপর Microsoft Windows অপারেটিং সিস্টেমে প্রসেস বিচ্ছিন্ন রাখার নতুন সুবিধার পাশাপাশি MXC নামের একটি লাইব্রেরি প্রকাশ করেছে. আমরা এখন বিদ্যমান স্যান্ডবক্সের বদলে MXC লাইব্রেরি ব্যবহার করে এমন একটি স্যান্ডবক্স চালু করছি.

MXC কী?

MXC (Microsoft eXecution Container) হলো Microsoft-এর একটি স্যান্ডবক্সে কোড চালানোর ব্যবস্থা⁠(একটি নতুন উইন্ডোতে খোলে), যা Windows, Linux ও macOS-এ কোডকে সীমাবদ্ধ রাখার একাধিক ব্যাকএন্ড সমর্থন করে. উপযুক্ত Windows ডিভাইসে Codex একটি MXC-ভিত্তিক স্যান্ডবক্স সমর্থন করে. এটি অপারেটিং সিস্টেমের নিজস্ব প্রসেস বিচ্ছিন্নকরণ সুবিধা দিয়ে ব্যবহারকারীর বিদ্যমান পরিবেশেই কমান্ডকে সীমাবদ্ধ রাখে.

নিরাপত্তা ও ব্যবহারযোগ্যতা উন্নত করতে এবং বিদ্যমান Windows স্যান্ডবক্সের কয়েকটি সীমাবদ্ধতা দূর করতে আমরা MXC-তে যাচ্ছি:

  • স্যান্ডবক্স স্থাপনে উচ্চতর বা প্রশাসনিক প্রবেশাধিকারের প্রয়োজন

  • ACL যাচাই ও নির্ধারণে বেশি রিসোর্স বা সময় ব্যয়

  • হোস্ট মেশিনে স্যান্ডবক্স স্থাপনের তথ্য ও পরিবর্তন স্থায়ীভাবে থেকে যাওয়া, যার মধ্যে রয়েছে

    • ACL

    • ফায়ারওয়ালের নিয়ম

    • স্যান্ডবক্সের ব্যবহারকারী

    • নিয়ন্ত্রণ স্তরের ফাইল

MXC একটি JSON কনফিগারেশন স্কিমা⁠(একটি নতুন উইন্ডোতে খোলে) সরবরাহ করে. Codex MXC SDK⁠(একটি নতুন উইন্ডোতে খোলে) দিয়ে ওই স্কিমা অনুযায়ী চালানোর অনুরোধ তৈরি করে, যাতে কমান্ড, কার্যকরী ডিরেক্টরি, পরিবেশ ও অনুমতি অন্তর্ভুক্ত থাকে. এই অনুমতিগুলো ফাইলসিস্টেম ও নেটওয়ার্কে প্রবেশাধিকারের পাশাপাশি ডেস্কটপ ও ক্লিপবোর্ডের মতো Windows রিসোর্স ব্যবহারের সুযোগ নিয়ন্ত্রণ করে.

নীতি থেকে MXC চালানোর নির্দেশনা তৈরি

সামঞ্জস্য ও নিরাপত্তার ভারসাম্য রাখতে Codex কয়েকটি নিয়ন্ত্রণের জন্য স্থির সেটিংস ব্যবহার করে. এটি রেজিস্ট্রি পড়তে দেয় এবং চালু হওয়ার সময় PowerShell-এর প্রয়োজনীয় Win32k ও ডেস্কটপে প্রবেশাধিকার বজায় রাখে. ক্লিপবোর্ডে প্রবেশাধিকার, ইনপুট ইনজেকশন এবং ডেস্কটপ ও সিস্টেম সেটিংস নিয়ন্ত্রণ বন্ধ থাকে. সবশেষে, বিকল্প ব্যবস্থা হিসেবে হোস্টের ফাইলসিস্টেমের অনুমতি পরিবর্তন করা থেকে 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:\-এর অধীনে C:\work\demo-তে লেখা যেতে পারে, অথচ C:\work\demo\.git শুধু পড়ার উপযোগী থাকে.

পাথের ভিন্ন বানান বা সিমলিংক/জাংশনের বিকল্প নাম একই পাথ নির্দেশ করলে MXC কঠোরতর অনুমতিটি প্রয়োগ করে: শুধু পড়ার অনুমতির চেয়ে নিষেধাজ্ঞা অগ্রাধিকার পায়, আর পড়া ও লেখার অনুমতির চেয়ে শুধু পড়ার অনুমতি অগ্রাধিকার পায়.

নিষেধাজ্ঞার গ্লব প্যাটার্ন

MXC শুধু নিষিদ্ধ করার সুনির্দিষ্ট পাথ গ্রহণ করে. তাই চালুর আগে Codex নিষেধাজ্ঞার গ্লবের সঙ্গে মেলা ফাইল ও ডিরেক্টরির তালিকা তৈরি করে. কমান্ড চলাকালে গ্লবের সঙ্গে মেলা নতুন পাথ স্বয়ংক্রিয়ভাবে যোগ হয় না.

নেটওয়ার্কে প্রবেশাধিকার

*.openai.com-এর মতো ডোমেইন নিয়মগুলো আগে বর্ণিত অভিন্ন Codex নেটওয়ার্ক প্রক্সি কার্যকর করে. Codex ওই প্রক্সি স্যান্ডবক্সের বাইরে চালায় এবং আগে উল্লেখ করা একই মানসম্মত *_PROXY এনভায়রনমেন্ট ভেরিয়েবলের মাধ্যমে তার ঠিকানাগুলো কমান্ডকে দেয়. MXC বাইরের সরাসরি সংযোগ বন্ধ রাখে, তবে প্রক্সিতে প্রবেশাধিকারসহ হোস্টের লুপব্যাক সংযোগের অনুমতি দেয়. অন্য স্থানীয় পরিষেবাগুলোতেও পৌঁছানো যায়.

macOS, Linux ও Windows-এ অনুমতি প্রোফাইলের অধীনে কমান্ড চালু করতে কার্যপরিধি একই স্যান্ডবক্স API ব্যবহার করে. এই বিধিনিষেধ প্রয়োগের প্রয়োজনীয় প্রস্তুতি সংশ্লিষ্ট প্ল্যাটফর্মের বাস্তবায়ন সামলায়.

Codex স্যান্ডবক্সকে ভিত্তি করে নতুন সরঞ্জাম তৈরি

কোড লেখা ও চালানোর ক্ষমতা এজেন্টকে সফটওয়্যার উন্নয়নের বাইরেও সমস্যা সমাধানের নমনীয় উপায় দেয়. Codex স্যান্ডবক্স ফাইলসিস্টেম ও নেটওয়ার্কে প্রবেশাধিকারের সুস্পষ্ট সীমা রেখে ব্যবহারকারীর বিদ্যমান পরিবেশে সেই ক্ষমতা ব্যবহারের সুযোগ দেয়. এটি কার্যপরিধির মধ্যে পুনর্ব্যবহারযোগ্য একটি মৌলিক উপাদান. codex sandbox কমান্ড দিয়ে আপনার তৈরি সরঞ্জামেও এটি ব্যবহার করা যায়.

এজেন্ট যত বেশি কাজের দায়িত্ব নিচ্ছে, তত বেশি সরঞ্জাম ও পরিবেশে স্যান্ডবক্সিংকে ব্যবহারোপযোগী করতে চাই আমরা. এর অর্থ হলো অনুমতি কনফিগার করা সহজ করা এবং অপারেটিং সিস্টেমে উন্নত সুরক্ষা আসার সঙ্গে সঙ্গে তা কাজে লাগানো. আমাদের লক্ষ্য এজেন্টের কাজের ক্ষমতা বাড়ানো, কিন্তু তারা কী কী ব্যবহার করতে পারবে তার নিয়ন্ত্রণ মানুষের হাতেই রাখা.

লেখকবৃন্দ

OpenAI

কৃতজ্ঞতা স্বীকার

এই লেখায় অবদানের জন্য ডেভিড উইজেন, চার্লি উইমস, ভিয়াত ভালোদিয়া ও ফোটিস চান্টজিসকে বিশেষ ধন্যবাদ.