توسعهدهندگان چگونه در CI/CD و GitHub اطلاعات محرمانه را افشا میکنند
و چگونه متوقف کنید
از ثبت فایلهای .env، چسباندن توکنها در pull requestها و نمایش اسرار در لاگهای CI خودداری کنید. یاد بگیرید اعتبارنامهها در کجا در GitHub و خط لولهها (pipelines) نشت میکنند—و لینکهای رمزگذاریشده یکبار مصرف چگونه به یک گردش کار امنتر برای توسعهدهنده کمک میکنند.

نکات کلیدی
- Never commit `.env` files or cloud keys to Git.
- Assume leaked history is public until rotated and purged carefully.
- Use the platform secret store for CI/CD—not chat pastebins.
- Scan early and rotate immediately when a leak is found.
کلیدهای API معمولاً از طریق حملات رمزنگاری هوشمندانه نشت نمیکنند. آنها از طریق جریانهای کاری توسعهدهندگان نشت میکنند—فایلهای `.env` که در Git ثبت شدهاند، اسراری که در لاگهای CI تکرار شدهاند، و اعتبارنامههایی که «فقط برای مدتی کوتاه» در درخواستهای Pull قرار داده شدهاند.
اگر از قبل میدانید چگونه یک کلید API را بهصورت امن به اشتراک بگذارید، این راهنما لایه بعدی است: اینکه آن کلیدها واقعاً در تحویل نرمافزار مدرن از کجا فرار میکنند و چگونه از تبدیل شدن GitHub، CI/CD و پیکربندیهای محلی به یک آرشیو دائمی از دسترسیهای عملیاتی خود جلوگیری کنید.
این الگو هر بار یکسان است. یک راز وارد سیستمی میشود که برای حفظ تاریخچه ساخته شده است. ماهها بعد، یک فورک (fork)، یک خروجی لاگ، یک لپتاپ هک شده یا اسکن یک مخزن عمومی، آن راحتی را به یک حادثه تبدیل میکند.
چرا فایلهای .env و CI/CD آهنربای نشت اطلاعات برای توسعهدهندگان هستند
فایلهای محیط محلی و خط لولهها برای انتقال سریع پیکربندیها وجود دارند. این سرعت مفید—و خطرناک—است، زیرا اسرار اغلب با همان ابزارهایی جابهجا میشوند که برای بازبینی کد، مصنوعات ساخت (build artifacts) و اتوماسیون استفاده میکنید.
یک فایل `.env` موقتی به نظر میرسد. یک راز ذخیره شده در CI «مدیریت شده» به نظر میرسد. یک `echo $DATABASE_URL` دیباگ در یک مخزن خصوصی بیخطر به نظر میرسد. مهاجمان—و اسکنرهای خودکار اسرار—اهمیتی نمیدهند که آیا افشاگری عمدی بوده یا خیر. آنها به ماندگاری، قابلیت جستجو و شعاع تخریب اهمیت میدهند.
با هر رازی که با Git یا CI در تماس است، طوری رفتار کنید که گویی در نهایت کپی، کپیبرداری یا ایندکس خواهد شد. جریان کاری را بهگونهای طراحی کنید که آن فرض قابل مدیریت باشد: اعتبارنامههای کوتاهمدت، مخازن امنیتی مناسب، و تحویلهای انسانی که متن ساده را در چت یا تیکتها باقی نمیگذارند.
چگونه اسرار از طریق GitHub فرار میکنند
فایلهای .env و پیکربندی کامیت شده
نشت اطلاعات کلاسیک همچنان رایجترین است: `cp .env.example .env`، مقادیر تولید (production) را پر کنید، سپس بدون اینکه متوجه شوید `git add .` کنید. حتی اگر فایل را در commit بعدی حذف کنید، رمز (secret) در تاریخچه Git باقی میماند تا زمانی که آن را بازنویسی کنید—و مخازن عمومی ممکن است بسیار سریع برای یافتن اعتبارنامههای فاش شده اسکن شوند. بازنویسی تاریخچه نیز تمام کپیها را پاک نمیکند: forkها، mirrorها، کشهای CI و کلونهای محلی همچنان میتوانند commitهای قدیمی را نگه دارند.
انواع آن شامل `docker-compose.yml` با رمزهای عبور هاردکد شده، Terraform state با خروجیهای حساس، manifestهای Kubernetes که «رمزهای» base64-encoded را ذخیره میکنند (base64 یک کدگذاری است، نه رمزنگاری—هر کسی که بتواند manifest را بخواند میتواند مقدار را رمزگشایی کند)، و سلولهای notebook که توکنها را چاپ میکنند میباشد. اگر چیزی شبیه به پیکربندی (configuration) به نظر میرسد، فرض کنید اسکنرها با آن مانند یک dump از اعتبارنامهها برخورد خواهند کرد.
Pull requestها، issueها و کامنتها
توسعهدهندگان کلیدهای محیط staging را در توضیحات PR کپی میکنند تا «به بازبین در بازتولید باگ کمک کنند». کامنتهای تیکت و بحثهای GitHub همان مشکل را دارند: ماندگاری قابل جستجو، اعلانها، خلاصههای ایمیلی و اکسپورتها.
مخازن خصوصی (Private repositories) بهطور قابل توجهی قرارگیری تصادفی در معرض دید را کاهش میدهند، اما همچنان جای مناسبی برای ذخیره رمزها نیستند. تغییر دسترسیها، پیمانکاران، حسابهای هک شده، کلونها، بکآپها و ادغامها (integrations) همگی میتوانند متن ساده (plaintext) تاریخی را دوباره ظاهر کنند. برای تحویل کلیدهای API بین انسانها، از یک لینک یکبار مصرف رمزنگاری شده در سمت کلاینت استفاده کنید—نه در کامنت PR.
Forkها، mirrorها و تاریخچهای که هرگز نمیمیرد
یک کلید که یک بار commit شده، میتواند مدتها پس از پاکسازی شاخه اصلی، در forkها، mirrorها، کشهای CI و کلونهای محلی باقی بماند. چرخش رمز (Secret rotation) راهکار واقعی است؛ بازنویسی تاریخچه فقط کنترل خسارت است.
اگر هشدار GitHub Secret Scanning، TruffleHog، gitleaks یا یک ارائهدهنده ابری فعال شد، ابتدا رمز را بچرخانید (rotate). سپس رمز را از شاخههای فعال حذف کنید. تنها پس از آن تصمیم بگیرید که آیا بازنویسی تاریخچه ارزش هزینه هماهنگی را دارد یا خیر.
قانون سخت
هرگز رمزهای زنده را در Git commit نکنید—حتی اعتبارنامههای موقت staging را. اگر یک رمز باید بین افراد جابجا شود، از یک کانال تحویل امن مناسب، مانند یک لینک یکبار مصرف رمزنگاری شده در سمت کلاینت استفاده کنید. اگر اتوماسیون به رمز نیاز دارد، از مکانیزم بومی رمزهای پلتفرم CI، یک مدیریتکننده رمز اختصاصی، یا ترجیحاً اعتبارنامههای کوتاهمدت که از طریق workload identity یا OIDC به دست میآیند استفاده کنید—نه از مخزن.
چگونه رمزها از طریق CI/CD نشت میکنند
متن ساده در فایلهای workflow
قرار دادن مستقیم `API_KEY: sk-...` در `.github/workflows/*.yml`، GitLab CI YAML، یا تنظیمات CircleCI صرفاً commit کردن یک رمز با مراحل اضافی است. فایلهای workflow کد هستند. آنها بازبینی، کلون و برای همیشه نگهداری میشوند.
از مکانیزم بومی رمزهای پلتفرم (GitHub Actions secrets، متغیرهای GitLab CI/CD و موارد مشابه) استفاده کنید و آنها را به عنوان پیوندهای محیطی (environment bindings) ارجاع دهید—نه به صورت YAML هاردکد شده. رمزهای بومی CI بسیار بهتر از مخزن هستند، اما آنها جادو نمیکنند: منطق مخرب workflow، وابستگیهای هک شده و لاگگذاریهای بیدقت همچنان میتوانند مقادیر را در زمان اجرا فاش کنند. OIDC یا سایر federationهای workload identity را به ارائهدهندگان ابری ترجیح دهید تا اصلاً نیازی به کلیدهای ابری طولانیمدت در CI نداشته باشید.
لاگهای pipeline و خروجی debug
لاگهای build آرشیوهای نادیده گرفته شدهای هستند. چاپ کردن متغیرهای محیطی «برای دیباگ کردن استقرار»، dump کردن `process.env`، یا اجرای خروجی پرجزئیات Terraform/Helm میتواند اعتبارنامهها را در ذخیرهساز لاگ بنویسد که طول عمر آن از خودِ job بیشتر است.
فرض کنید لاگها توسط هر کسی که به CI دسترسی دارد—و گاهی توسط هر کسی که میتواند artifactها را دانلود کند—قابل خواندن هستند. رمزها را ماسک کنید، از dump کردن env خودداری کنید و با یک خط لاگ فاش شده مانند یک رمز عبور فاش شده برخورد کنید: آن را بچرخانید (rotate).
Pull requestها از forkها
PRهای مربوط به fork یک تله کلاسیک در CI هستند: اجرای کد غیرقابل اعتماد با رمزها. اکثر پلتفرمها دقیقاً به همین دلیل دسترسی به رمزها را در workflowهای fork محدود میکنند. آن را به همین شکل نگه دارید. هرگز برای اینکه یک بررسی (check) سبز شود، «فقط رمزها را فعال نکنید» برای مشارکتکنندگان خارجی.
برای مخازن داخلی، همچنان jobهای استقرار دارای امتیاز (privileged) را از بررسیهای PR جدا کنید. با کمترین امتیاز (least privilege) بسازید و تست کنید؛ فقط از شاخههای مورد اعتماد با رمزهای صراحتاً اعطا شده، استقرار (deploy) انجام دهید.
Runnerهای مشترک و نشت artifact
Runnerهای self-hosted، کشهای مشترک و artifactهای آپلود شده میتوانند توکنها را طولانیتر از jobی که آنها را ساخته است، نگه دارند. فضای کاری (workspaces) را پاکسازی کنید، کلیدهای کش را با دقت محدود کنید و هرگز فایلهای `.env` را «برای راحتی کار» در artifactهای build بستهبندی نکنید.
یک مدل ذهنی ایمنتر: سه جایی که رمزها میتوانند باشند
سردرگمی زمانی رخ میدهد که تیمها از یک ابزار برای هر کاری استفاده میکنند. مشکل را بر اساس چرخه حیات (lifecycle) تقسیم کنید.
| مکان | بهترین کاربرد | مناسب نیست برای |
|---|---|---|
| Local .env / dotenv | پیکربندی توسعه محلی که روی لپتاپ میماند و به درستی gitignored شده است | اشتراکگذاری با همتیمیها، CI، Git، یا اسرار (secrets) طولانیمدت تولید در قالب متن ساده (plaintext) |
| اسرار بومی CI / Vault / مدیریت اسرار ابری | اتوماسیون استقرار و زمان اجرا (runtime) ماشین به ماشین | تحویل پیامها در چتهای انسانی یا پیامهای طولانیمدت «این را به پیمانکار بده» |
| یادداشت یکبار مصرف با رمزنگاری سمت کلاینت | تحویل کلید، توکن، یا قطعه کد .env از انسان به انسان | ذخیره اسرار تولید برای اپلیکیشنها یا خط لولهها (pipelines) |
استفاده از یک `.env` در فایل gitignored برای توسعه محلی مشکلی ندارد. اسرار حساس تولید نیز در حالت ایدهآل نباید برای مدت طولانی به صورت متن ساده روی دستگاههای توسعهدهنده باقی بمانند؛ در صورت امکان، از مدیریتکننده رمز عبور یا دسترسیهای کوتاهمدت استفاده کنید. PrivateNote در ردیف سوم قرار دارد: تحویل امن بین افراد. این ابزار جایگزینی برای اسرار Actions در GitHub، HashiCorp Vault، AWS Secrets Manager یا مدیریتکننده رمز عبور شما نیست. برای تحویل روزمره کلیدهای API، این روش را با نحوه اشتراکگذاری امن کلید API ترکیب کنید.
گردش کار کاربردی: دور نگه داشتن اسرار از Git و چت
زمانی که یک همتیمی، پیمانکار یا مشتری به مقداری نیاز دارد که در نهایت در CI یا یک `.env` محلی قرار میگیرد، از این توالی استفاده کنید:
- 1
گام 1
ایجاد یک اعتبارنامه (credential) محدود و کوتاهمدت
استفاده از کلیدهای محیط staging، محدودههای فقطخواندنی (read-only)، لیستهای سفید IP و انقضا را ترجیح دهید. از تحویل کلید اصلی تولید به دلیل «سریعتر بودن» خودداری کنید.
- 2
گام 2
تحویل از طریق یک یادداشت یکبار مصرف با رمزنگاری سمت کلاینت
راز (یا همان چند خط `.env` مورد نیاز) را به صورت محلی با PrivateNote رمزنگاری کنید—از طریق web app، CLI، افزونه VS Code / Cursor، یا افزونه Chrome. یک زمان انقضای کوتاه یا حالت «سوختن پس از خواندن» (burn-after-read) تنظیم کنید، سپس لینک یادداشت را—و نه متن ساده را—از طریق Slack، ایمیل یا تیکت ارسال کنید.
- 3
گام 3
نصب در مخزن مناسب
گیرنده، مقدار را در یک `.env` محلی که در gitignored است (برای توسعه)، یک مدیریتکننده رمز عبور، یا مخزن اسرار CI/cloud کپی میکند. آن را دوباره در PR، رشته چت یا یک سند مشترک قرار ندهید.
- 4
گام 4
چرخش (Rotate) پس از اتمام کار
کلیدهای پیمانکار را باطل کنید، پس از بروز حوادث کلیدها را چرخش دهید، و هر اعتبارنامهای را که هرگز در لاگها، Git یا یک تیکت ظاهر شده است، جایگزین کنید. راحتی بدون چرخش، صرفاً پاسخدهی بهbreach (نقض امنیتی) با تأخیر است.
نیاز دارید همین الان یک توکن CI یا چند خط .env را به کسی بدهید؟ به جای commit کردن یا چسباندن متن ساده، یک یادداشت یکبار مصرف با رمزنگاری سمت کلاینت ارسال کنید.
یک یادداشت خصوصی بسازیداشتراکگذاری از همان جایی که کار میکنید
برای ایجاد یک یادداشت یکبار مصرف با رمزنگاری سمت کلاینت، نیازی نیست ترمینال، ویرایشگر یا تب مرورگر خود را ترک کنید. سطح PrivateNote متناسب با موقعیت را انتخاب کنید—رمزنگاری همیشه قبل از آپلود، به صورت محلی روی دستگاه شما انجام میشود. برای راهنمای کاملتر، PrivateNote برای توسعهدهندگان را ببینید.
CLI
خواندن از یک فایل یا pipe کردن stdin تا راز هرگز به عنوان یک آرگومان `echo` در تاریخچه شل (shell history) باقی نماند: `npx privatenote-cli --expire 1h --output-url-only .env.local` یا `cat secret.txt | npx privatenote-cli --expire 1h --output-url-only`. مفید در گردش کارهای شل، اسکریپتها و تحویلهای سریع ترمینال. تنظیمات و پرچمها: PrivateNote CLI.
VS Code و Cursor
افزونه VS Code / Cursor را نصب کنید، سپس از طریق نوار کناری، انتخاب در ویرایشگر، یا منوی راستکلیک رمزنگاری کنید—ایدهآل برای زمانی که راز از قبل در صفحه در یک `.env` یا فایل تنظیمات نمایش داده شده و نباید هرگز به صورت متن ساده به Slack برسد.
افزونه Chrome
وقتی اعتبارنامه در ایمیل، اسناد یا یک تیکت ظاهر میشود، افزونه Chrome متن انتخاب شده را بدون ترک کردن تب، به یک یادداشت یکبار مصرف با رمزنگاری مرورگر تبدیل میکند.
چکلیست توسعهدهنده قبل از هر push و تغییر در pipeline
| نقطه بازرسی | آنچه باید تأیید شود |
|---|---|
| قبل از git commit | `.env`, `*.pem`, `credentials.json`, و فایلهای محرمانه محلی در gitignored شدهاند؛ `git status` هیچ مورد اضافهشدهی غیرمنتظرهای را نشان نمیدهد |
| قبل از باز کردن یک PR | هیچ کلیدی در توضیحات، اسکرینشاتها، فیکسچرها یا فایلهای دیباگ «موقت» وجود ندارد |
| قبل از ویرایش workflowها | اسرار (Secrets) از مکانیزم بومی secrets پلتفرم یا OIDC/workload identity تامین میشوند—نه از طریق YAMLهای hardcoded |
| قبل از دیباگ کردن CI | هیچ `env`، `printenv` یا dumpهای پرجزئیاتی که بتواند اسرار را در لاگها بنویسد، وجود ندارد |
| پس از هرگونه افشا | ابتدا چرخش (Rotate) انجام دهید، سپس تاریخچه/branchها را پاکسازی کنید؛ با اسکنرها به عنوان محرکهای حادثه برخورد کنید |
اسکن اسرار را به مسیر پیشفرض اضافه کنید: pre-commit hookها (gitleaks)، اسکن CI، و GitHub Secret Scanning / push protection. پیشگیری بهتر از بازنویسی قهرمانانهی تاریخچه است.
اگر یک secret از قبل در GitHub باشد چه باید کرد
با این ترتیب عمل کنید: چرخش یا ابطال (rotate or revoke) اعتبارنامه نزد ارائهدهنده، بیاعتبار کردن نشستها یا webhookهای وابسته، حذف secret از branch اصلی، و سپس تصمیمگیری در مورد اینکه آیا بازنویسی تاریخچه برای انطباق یا افشای عمومی لازم است یا خیر. حتی پس از بازنویسی، فرض کنید forkها، mirrorها، کشها و کلونها ممکن است همچنان کپیهایی را تا زمانی که جداگانه رسیدگی نشود، نگه دارند.
مالکان هر سیستمی را که کلید میتواند به آن دسترسی پیدا کند، مطلع کنید. صورتحساب ابری، لاگهای دسترسی و استفادهی غیرعادی از API را بررسی کنید. اگر secret در Slack یا ایمیل نیز چسبانده شده بود، فرض کنید آن آرشیوها هنوز حاوی آن هستند—ببینید چرا ایمیل بدترین مکان برای secrets است و secretهایی که هرگز نباید در چت ارسال کنید.
برای secretهای بسیار باارزش مانند عبارتهای بازیابی (seed phrases) ارز دیجیتال، تا حد امکان از انتقال آنها خودداری کنید. برای سایر اعتبارنامههای ریشهای غیرقابل جایگزین، اصلاً آنها را در یک وبسایت تایپ نکنید—ابتدا بهصورت محلی رمزگذاری کنید و تنها زمانی که مجبور هستید، متن رمزگذاریشده (ciphertext) را به اشتراک بگذارید. این مدل در راهنمای عبارت بازیابی کریپتو پوشش داده شده است.
پرسشهای پرتکرار
آیا یک مخزن private GitHub برای فایلهای .env به اندازه کافی امن است؟
خیر. یک مخزن خصوصی میزان افشا را به شدت محدود میکند، اما همچنان یک فضای ذخیرهسازی مناسب برای secrets نیست. تغییرات دسترسی، حسابهای هک شده، کلونها، بکآپها و ادغامهای شخص ثالث همگی میتوانند متن سادهی (plaintext) تاریخی را دوباره ظاهر کنند. اسرار را کاملاً از Git دور نگه دارید.
آیا secrets مربوط به GitHub Actions کافی هستند؟
آنها جای مناسبی برای بسیاری از مقادیر زمان اجرای CI هستند—بسیار بهتر از فایلهای YAML یا مخزن. با این حال، آنها همچنان مشکل تحویل انسانی، نشت در لاگ، مجوزهای بیش از حد گسترده، ریسکهای fork-PR، یا افشا از طریق مراحل مخرب workflow و وابستگیهای هک شده را حل نمیکنند. مکانیزم بومی secrets پلتفرم را با اصل حداقل دسترسی (least privilege)، لاگگذاری دقیق و ترجیحاً اعتبارنامههای کوتاهمدت از طریق OIDC یا workload identity ترکیب کنید.
آیا باید یک .env.example که محتوای حساس آن حذف شده (redacted) را commit کنم؟
بله. فقط نام متغیرها و جایگزینهای فرضی (dummy placeholders) را commit کنید. هرگز مقادیر واقعی، کلیدهای staging «تقریباً واقعی» یا رشتههای اتصال تولید (production) را که رمز عبور آنها حذف شده اما host و username آنها دستنخورده است (اگر این ترکیب در مدل تهدید شما حساس است) commit نکنید.
آیا یک فایل .env محلی اشکالی ندارد؟
برای توسعه محلی، بله—به شرطی که به درستی gitignored شده باشد و هرگز commit نشود. اسرار حساس تولید در حالت ایدهآل نباید برای مدت نامحدود در فایلهای plaintext `.env` روی ماشینهای توسعهدهنده باقی بمانند؛ در صورت امکان از یک مدیریتکنندهی رمز عبور، دسترسی کوتاهمدت یا یک secrets manager استفاده کنید.
آیا PrivateNote میتواند جایگزین Vault یا secrets در GitHub شود؟
خیر. PrivateNote برای تحویل امن از انسان به انسان است. برای اتوماسیون، از مکانیزم بومی secrets پلتفرم CI و مدیریتکنندههای اختصاصی secrets استفاده کنید. زمانی از PrivateNote استفاده کنید که یک فرد نیاز دارد یک کلید، توکن یا قطعه کد .env را بدون باقی گذاشتن متن ساده در Slack، ایمیل یا GitHub دریافت کند.
سریعترین روش امن برای تحویل یک CI token چیست؟
یک توکن با محدوده دسترسی محدود ایجاد کنید، آن را از طریق یک یادداشت یکبار مصرف رمزگذاریشده در سمت کلاینت (وب، CLI، VS Code، یا Chrome) تحویل دهید، از گیرنده بخواهید آن را در مخزن secret مربوط به CI یا یک مدیریتکنندهی رمز عبور ذخیره کند، و سپس پس از اتمام کار، توکن را ابطال کنید.
جمعبندی
GitHub و CI/CD در حفظ کار عالی هستند. دقیقاً به همین دلیل است که مکانهای ضعیفی برای حفظ secrets هستند.
فایلهای `.env` را تا حد امکان محلی، در gitignore و محدود به محیط توسعه نگه دارید. اعتبارنامههای اتوماسیون را در بخش secrets بومی CI، یک مدیریتکننده secrets یا اعتبارنامههای کوتاهمدت OIDC قرار دهید. زمانی که یک انسان به یک مقدار نیاز دارد، از یک یادداشت یکبار مصرف با رمزنگاری سمت کلاینت استفاده کنید و سپس آن را تغییر دهید (rotate).
اگر تیم شما هنوز کلیدها را در PRها کپی میکند یا اعتبارنامههای «فقط محیط staging» را commit میکند، کار را با API key sharing workflow و چکلیست بالا شروع کنید. برای موارد دسترسی به سرور، از how to share SSH keys securely استفاده کنید. CLI، VS Code extension یا Chrome extension را در مسیر کمترین مقاومت قرار دهید تا گزینه امن، سریع نیز باشد.
راز را به اشتراک بگذارید—نه یک کپی دائمی را
یک توکن CI یا قطعه کد .env را قبل از اینکه وارد چت یا Git شود، بهصورت محلی با PrivateNote رمزنگاری کنید—با استفاده از وباپلیک، CLI، VS Code / Cursor یا افزونه Chrome. از انقضای کوتاه یا قابلیت سوختن پس از خواندن (burn-after-read) استفاده کنید، به جای متن ساده لینک یادداشت یکبار مصرف را بفرستید، و تاریخچه Git و pipeline را از اعتبارنامههای فعال پاک نگه دارید.
یک یادداشت خصوصی بسازید