سناریوی رخداد

کلید ثبت‌شده در لاگ فقط یک مقدار موقت (Placeholder) بود

The key in the log was a placeholder

  • سطح ۲: میانی
  • سناریوی رخداد
  • ۲۰ دقیقه

وضعیت

یک بازبین امنیتی متن ثبت‌شده‌ی نشست (Transcript) یک ایجنت درون ساندباکس را بررسی می‌کند. از ایجنت خواسته شده بود خطای یک درخواست ناموفق را عیب‌یابی کند؛ بنابراین ایجنت دستور env را اجرا کرد و متغیرهای محیطی‌اش را در لاگ مشترک تیم چاپ کرد. در یکی از سطرها نوشته شده: M101_RECV_KEY=sbx-cs-<rand>، که در آن بخش تصادفی پوشانده شده است. بازبین تیکتی ثبت می‌کند: ایجنت اعتبارنامه‌ای (Credential) را به‌صورت متن خام در خود نگه داشته، مقدار آن وارد یک لاگ اشتراکی شده و باید فوراً گردش چک‌پوینت‌ها برای تعویض آن انجام شود.

مهندس پلتفرم مخالفت می‌کند و می‌گوید این مقدار اصلاً سکرت (Secret) نیست؛ اما هیچ‌کس نمی‌تواند دلیلش را نشان دهد. خطوط چاپ‌شده، رکورد سکرت در مخزن، چهار درخواستی که از داخل همان ساندباکس فرستاده شده‌اند و لاگ دریافت‌کننده‌ای روی هاست که این درخواست‌ها به آن رسیده‌اند در اختیارتان قرار گرفته است.

نسخه
sbx v0.47.0
مدل
none; shell commands inside the sandbox
سخت‌افزار
one Mac with the microVM runtime

شواهد

four-requests-from-inside.txt
title: four requests from the sandbox that carry the placeholder
source: manuals/docker-sandboxes-101/capture/out/10-swap-curl.txt
lang: console
note: Three go to the bound host and one to another name; read the status code of each.
---
$ sbx exec m101-secret sh -c 'curl -sS --max-time 10 -H "Authorization: Bearer $M101_RECV_KEY" -H "X-Demo: $M101_RECV_KEY" -o /dev/null -w '"'"'%{http_code}\n'"'"' http://host.docker.internal:18080/from-variable'
204
[exit 0]

$ sbx exec m101-secret sh -c 'curl -sS --max-time 10 -H '"'"'Authorization: Bearer sbx-cs-<rand>'"'"' -H '"'"'X-Demo: sbx-cs-<rand>'"'"' -o /dev/null -w '"'"'%{http_code}\n'"'"' http://host.docker.internal:18080/from-literal'
204
[exit 0]

$ sbx exec m101-secret sh -c 'curl -sS --max-time 10 -H '"'"'Authorization: sbx-cs-<rand>'"'"' -o /dev/null -w '"'"'%{http_code}\n'"'"' http://host.docker.internal:18080/no-scheme'
204
[exit 0]

$ sbx exec m101-secret sh -c 'curl -sS --max-time 10 -H "Authorization: Bearer $M101_RECV_KEY" -o /dev/null -w '"'"'%{http_code}\n'"'"' http://gateway.docker.internal:18080/other-host; echo exit=$?'
curl: (52) Empty reply from server
000
exit=52
[exit 0]
how-a-placeholder-is-set.txt
title: a custom secret with a chosen placeholder prefix
source: manuals/docker-sandboxes-101/capture/out/10-placeholder.txt
lines: 1-5
lang: console
note: The third line says what is saved and for which target.
---
$ sbx secret set-custom --host api.example.test --env M101_NAMED --placeholder 'sk-{rand}' --value m101-dummy-1111
Applied secret updates for <n> running sandbox(es)
Saved custom secret placeholder "sk-<rand>" for target "api.example.test" env "M101_NAMED" in scope "(global)"
You may need to update environment variable M101_NAMED inside existing sandboxes to "sk-<rand>" (the placeholder value).
[exit 0]
the-stored-record.txt
title: the record of M101_RECV_KEY in sbx secret ls
source: manuals/docker-sandboxes-101/capture/out/10-placeholder.txt
lines: 20-29
lang: json
note: Compare the placeholder field with the masked secret field.
---
    {
      "scope": "global",
      "targets": [
        "host.docker.internal",
        "localhost"
      ],
      "env": "M101_RECV_KEY",
      "placeholder": "sbx-cs-<rand>",
      "secret": "m101-d**************0000"
    }
what-the-agent-printed.txt
title: the two custom lines of the environment inside m101-secret
source: manuals/docker-sandboxes-101/capture/out/10-env-sentinel.txt
lines: 4-5
lang: console
note: The value of M101_RECV_KEY is the only one that is not the word proxy-managed.
---
M101_RECV_KEY=sbx-cs-<rand>
MCP_SENTINEL_TOKEN_NAME=proxy-managed
what-the-receiver-logged.txt
title: the three requests as the receiver on the host saw them
source: manuals/docker-sandboxes-101/capture/out/10-receiver.log
lang: text
note: Read the Authorization and X-Demo values, and the Host line.
---
GET /from-variable HTTP/1.1
Host: localhost:18080
User-Agent: curl/8.18.0
Accept: */*
Authorization: Bearer m101-dummy-receiver-0000
X-Demo: m101-dummy-receiver-0000
Accept-Encoding: gzip

GET /from-literal HTTP/1.1
Host: localhost:18080
User-Agent: curl/8.18.0
Accept: */*
Authorization: Bearer m101-dummy-receiver-0000
X-Demo: m101-dummy-receiver-0000
Accept-Encoding: gzip

GET /no-scheme HTTP/1.1
Host: localhost:18080
User-Agent: curl/8.18.0
Accept: */*
Authorization: m101-dummy-receiver-0000
Accept-Encoding: gzip

سؤال‌ها

  1. آیا مقدار چاپ‌شده همان اعتبارنامه است؟ چه چیزی در رکورد مخزن تکلیف این موضوع را روشن می‌کند؟
  2. سه درخواست اول کد وضعیت 204 برگرداندند. دریافت‌کننده در هدر هرکدام چه چیزی دریافت کرد و این موضوع چه نکته‌ای را درباره‌ی محل انجام تعویض (Swap) نشان می‌دهد؟
  3. درخواست چهارم پاسخی دریافت نکرد و با کد 000 ثبت شد. چرا، و این اتفاق درباره‌ی مقدار موقتی که به هاستی غیر از هاست متصل‌شده (Bound) ارسال شود چه می‌گوید؟
  4. این شواهد کدام سطر از دفتر ثبت ادعاهای کتابچه‌ی راهنما را تأیید می‌کنند، و کدام ادعا درباره‌ی پروکسی بررسی‌نشده باقی می‌ماند؟
  5. سرنوشت تیکت چه باید باشد؟

اول شواهد را بخوانید و به سؤال‌ها جواب بدهید، بعد راه‌حل را باز کنید.

راه‌حل گام‌به‌گام
  1. دو سطر چاپ‌شده را بخوانید. مقدار M101_RECV_KEY برابر sbx-cs-<rand> است و سطر سفارشی دیگر کلمه‌ی proxy-managed را در خود دارد. کتابچه‌ی راهنما سه قالب برای مقادیر نشانه‌گذار (Sentinel) در این نسخه تعریف کرده است: proxy-managed برای کلیدهای ارائه‌دهنده، مقداری با ساختار شبیه توکن برای هاست گیت، و sbx-cs-<rand> برای سکرت‌های سفارشی. مقدار چاپ‌شده قالب سکرت سفارشی را دارد.
  2. نحوه‌ی ساخت و ذخیره‌ی مقدار موقت را بررسی کنید. دستور set-custom یک مقدار موقت را برای هاست مقصد و یک نام متغیر محیطی ذخیره می‌کند؛ با فلگ --placeholder 'sk-{rand}' مقدار ذخیره‌شده sk-<rand> خواهد بود. رکورد secret ls برای M101_RECV_KEY دو فیلد مهم دارد: فیلد placeholder برابر sbx-cs-<rand> است، و فیلد secret با ماسک m101-d**************0000 ثبت شده است. متغیر محیطی داخل ساندباکس فیلد اول را در خود دارد. فیلد دوم هرگز از مخزن سکرت‌ها بیرون نرفته است.
  3. رد مقدار موقت را تا هاست متصل‌شده دنبال کنید. از داخل ساندباکس، سه درخواست به host.docker.internal:18080 کد وضعیت 204 گرفتند: یکی با متغیر داخل Bearer، یکی با مقدار موقت به‌شکل متن صریح (Literal)، و یکی با مقدار خام و بدون ساختار طرح (Scheme). دریافت‌کننده برای دو درخواست اول Bearer m101-dummy-receiver-0000، همین مقدار را در X-Demo، و برای درخواست سوم مقدار خام را به‌عنوان کل هدر Authorization ثبت کرد. مقدار واقعی فقط در سمت هاست ظاهر می‌شود؛ درست در همان جایی که مقدار موقت قرار داشت. بنابراین تعویض مقدار، یک جایگزینی زیررشته در فوروارد پروکسی (Forward Proxy) است و فقط برای هاستی رخ می‌دهد که سکرت به آن متصل شده باشد.
  4. رد آن را تا یک نام دیگر دنبال کنید. درخواست چهارم به gateway.docker.internal:18080 فرستاده شد. این نام در NO_PROXY قرار دارد؛ بنابراین curl فوروارد پروکسی را نادیده گرفت و یک اتصال مستقیم باز کرد. پروکسی شفاف (Transparent Proxy) جلوی آن را گرفت: پاسخی دریافت نشد، کد 000 بازگشت و curl با کد خروجی 52 متوقف شد. هیچ تعویضی انجام نشد. مقدار موقتی که به هر جای دیگری ارسال شود، همان مقدار موقت باقی می‌ماند.
  5. نتیجه را در دفتر ثبت ادعاها بیاورید. جدول ادعاهای کتابچه‌ی راهنما گزینه‌ی «مقادیر اعتبارنامه‌ها هرگز وارد ماشین مجازی نمی‌شوند» را بر اساس این دو فایل تأییدشده علامت می‌زند، و تعویض هدر برای هاست متصل‌شده را نیز در هر دو سمت تأیید می‌کند. اما ادعای شنود TLS را به دلیل اینکه زنجیره‌ی گواهی بررسی نشد، بررسی‌نشده باقی می‌گذارد؛ همچنین ادعای خروج داده از طریق هاست مجاز را به دلیل نبود داده‌های ثبت‌شده، مورد اختلاف ثبت می‌کند. دقیقاً همین موارد را در گزارش قید کنید.
نتیجه

مقدار ثبت‌شده در لاگ، مقدار موقت یک سکرت سفارشی است، نه خود اعتبارنامه. اعتبارنامه در مخزن هاست باقی می‌ماند. فوروارد پروکسی آن را فقط درون درخواست‌هایی که به دو هاست متصل‌شده ارسال می‌شوند جای‌گذاری می‌کند، و لاگ دریافت‌کننده نشان می‌دهد که مقدار واقعی برای نخستین بار در همین نقطه وجود دارد. درخواستی که به هر نام دیگری فرستاده شود یا همان مقدار موقت را با خود می‌برد یا مسدود می‌شود. تیکت به‌عنوان «عدم نشت اطلاعات» بسته می‌شود، همراه با دو یادداشت: مقدار موقت به خواننده می‌گوید که برای این هاست‌ها یک سکرت متصل‌شده وجود دارد، و ساندباکس فقط به این دلیل توانست به localhost:18080 دسترسی پیدا کند که یک قاعده‌ی خط‌مشی به آن اجازه داده بود؛ بنابراین دریافت‌کننده همان هاستی بوده که اپراتور انتخاب کرده است.

دو بررسی به ران‌بوک (Runbook) اضافه می‌شود: در زمان مشکوک شدن به نشت اطلاعات از ساندباکس، قبل از هرگونه گردش چک‌پوینت‌ها برای تعویض کلید، مقدار چاپ‌شده را با فیلد placeholder در خروجی sbx secret ls --json مقایسه کنید. برای تعریف سکرت سفارشی جدید، آن را دقیقاً به هاست‌های مشخص متصل کنید و یک درخواست به دریافت‌کننده‌ای که خودتان کنترل می‌کنید بفرستید تا درستی تعویض مقدار (همان‌طور که در شواهد ثبت شد) یک بار اثبات شود.

مسیرهای اشتباه رایج
  • «کلید را فوراً تعویض کنید و لاگ را پاک کنید.» هیچ چیزی در لاگ کلید نیست. گردش چک‌پوینت‌ها هم روی هاست و هم روی دریافت‌کننده هزینه می‌تراشد و مشکلی را حل نمی‌کند؛ در ترنسکریپت بعدی باز هم همان مقدار موقت دیده خواهد شد.
  • «ایجنت به جاکلیدی (Keychain) هاست دسترسی پیدا کرده است.» سیستم مهمان هیچ راه ارتباطی با مخزن ندارد. تعویض مقدار درون پروکسی روی سیستم هاست و پس از خروج درخواست از ماشین مجازی رخ می‌دهد.
  • «کلید واقعی را با e- پاس بدهید تا ایجنت خودش بتواند API را صدا بزند.» یک متغیر معمولی سکرت نیست و نشانه‌گذار دقیقاً برای این وجود دارد که مقدار واقعی هرگز وارد ماشین مجازی نشود. مخزن و متصل کردن آن به هاست مقصد، مسیر پشتیبانی‌شده هستند.
  • «پروکسی فقط هدر Authorization را تغییر می‌دهد، پس مقدار در هدر دیگر امن است.» دریافت‌کننده مقدار را در X-Demo نیز نشان داد. سکرت سفارشی در هر نقطه‌ای از درخواست که مقدار موقت آمده باشد تعویض می‌شود، مشروط بر اینکه درخواست به هاست متصل‌شده برود؛ پس آن را به هاست‌های دقیق متصل کنید.
درس کلی

مقداری که یک فرایند (Process) درون یک مرز امنیتی نمایش می‌دهد فقط زمانی سکرت محسوب می‌شود که همان بایت‌ها در خارج از مرز نیز کار کنند. قبل از اینکه بگویید نشتی رخ داده، محل ذخیره‌سازی مقدار را پیدا کنید، بایت‌های چاپ‌شده را با مقدار موقت ذخیره‌شده مقایسه کنید، و بایت‌های چاپ‌شده را هم از یک مقصد موردانتظار و هم از یک مقصد نامطلوب به دریافت‌کننده‌ای بفرستید که تحت کنترل خودتان است. سپس با ذکر نام فایل‌ها، دقیق بنویسید که این آزمون چه چیزی را ثابت کرد و چه چیزی را ثابت نکرد.

کجای دوره آموزش داده می‌شود

کتابچه‌ی راهنما در صفحه‌ی سکرت‌ها مقدار موقت، تعویض آن و دریافت‌کننده را ثبت کرده است؛ صفحه‌ی پروکسی دو مسیر پروکسی را توضیح می‌دهد، و دفتر ثبت ادعاها مشخص می‌کند که این فایل‌ها کدام ادعا را تأیید می‌کنند.