env-var-auditor: پیدا کردن کلیدهای مخفی که به مرورگر لو رفتن
خلاصهٔ کاملتر
env-var-auditor یه ابزار CLI برای پروژههای Node.js و Next.js هست که مصرف متغیرهای محیطی رو با تحلیل ایستا (یعنی خوندن کد بدون اجرا کردنش) بررسی میکنه. سازندهش میگه ابزارهایی مثل t3-env و envalid فقط موقع بالا اومدن برنامه مقدارها رو چک میکنن و یه سری مشکل رو اصلاً نمیبینن.
این ابزار سه دسته مشکل پیدا میکنه. اول، متغیرهایی که تو فایل .env هستن ولی هیچ جای کد ازشون استفاده نمیشه، یعنی تنظیمات مرده. دوم، متغیرهایی که کد میخونه ولی تو هیچ فایل env نیستن و تو production بیصدا undefined میشن. سوم، و به گفتهی نویسنده مهمترینش، متغیرهایی که به باندل سمت کلاینت نشت میکنن.
مشکل اینجاست که اگه تو یه Client Component (یعنی فایلی با 'use client' که تو مرورگر اجرا میشه) به یه کلید مخفی دست بزنی، Next.js ممکنه اونو بدون هیچ هشدار یا خطایی وارد کد مرورگر کنه. مثال خود مقاله این صفحهی پرداخته:
'use client';
export default function CheckoutPage() {
// This key is now in your browser bundle. Every visitor can read it.
const stripe = new Stripe(process.env.STRIPE_SECRET_KEY!);
}ابزار دو حالت رو تو فایلهای کلاینت گزارش میده: متغیری که پیشوند NEXT_PUBLIC_ نداره، و متغیری که پیشوند داره ولی اسمش شبیه یه راز هست، مثل sk_، whsec_، SECRET یا _TOKEN. تشخیص با AST و از طریق ts-morph انجام میشه، نه regex. پس دسترسی مستقیم، براکتی و destructuring رو میشناسه و دسترسیهای داینامیک مثل process.env[someVar] رو جدا به عنوان «قابل بررسی نیست» علامت میزنه.
خروجی میتونه جدول، JSON، SARIF (برای نمایش تو تب Security گیتهاب)، JUnit XML یا یه گزارش HTML باشه. یه حالت baseline هم داره که فقط مشکلهای جدید رو گزارش میده، یعنی میشه رو یه پروژهی قدیمی هم بدون خفه شدن زیر هشدارها راهش انداخت. پشتیبانی از monorepo با --workspaces، یه پلاگین ESLint با دو قانون، هوک pre-commit و اعلان Slack هم داره.
نکات کلیدی:
- سه دسته مشکل: تعریفشده ولی بیاستفاده، خوندهشده ولی تعریفنشده، و لورفته به کلاینت
- کد خروج 1 یعنی متغیر لورفته به کلاینت و میشه ازش برای شکست دادن CI استفاده کرد
- تشخیص با AST از طریق ts-morph هست، نه regex
- فرمتهای خروجی: table، JSON، SARIF، JUnit و HTML
- محدودیت: ارجاعهای غیرمستقیم مثل const env = process.env; env.FOO رو دنبال نمیکنه




