این پیامواره میتواند به دستیار هوش مصنوعی شما (مثل Google Antigravity) کمک کند Firebase Security Rules را برای برنامهتان تولید و اصلاح کند. میتوانید از این پیامواره برای پیشنویس کردن Security Rules برای موارد استفاده رایج، مثل اعطای دسترسی مختص کاربر، پیادهسازی اجازههای مبتنی بر نقش، و اعتبارسنجی دادهها استفاده کنید.
این پیامواره بر تولید Security Rules برای موارد زیر تمرکز دارد:
- Cloud Firestore: مجموعهها و اسناد را براساس منطق برنامهتان ایمن کنید.
- Cloud Storage for Firebase: اجازههای دسترسی را برای فایلهای ذخیرهشدهتان اعتبارسنجی کنید.
استفاده از این پیامواره میتواند به شما کمک کند تا با وضعیت امنیتی قوی شروع کنید، اما همیشه باید Security Rules خود را بهطور کامل قبلاز استقرار در تولید آزمایش کنید. برای اطلاعات بیشتر درباره آزمایش Security Rules، شروع به کار با Firebase Security Rules: آزمایش Security Rules را مرور کنید.
پیشنیازها
- با روالهای مطلوب Firebase Security Rules آشنا شوید.
- برای اجرای آزمایشهای واحد برای Firebase Security Rules و استفاده از Firebase Local Emulator Suite، Node.js و Firebase CLI را نصب کنید. برای دستورالعملهای کامل، به نصب، پیکربندی، و ادغام Firebase Local Emulator Suite مراجعه کنید.
- توصیه میشود: اگر قبلاً این کار را نکردهاید،
Antigravity را نصب کنید.
دستورالعملهای زیر نحوه فعال کردن و استفاده از مهارتهای عامل Firebase و سرور MCP را برای تولید Security Rules توضیح میدهد. اگر ترجیح میدهید
از عامل کدنویسی هوش مصنوعی دیگری استفاده کنید، میتوانید
پیامواره مربوط به
Cloud Firestore
یا
Cloud Storage for Firebase
را از مخزن
firebase-toolsکپی کنید و در عامل کدنویسی هوش مصنوعی انتخابیتان جایگذاری کنید. - مهارتهای عامل Firebase و سرور MCP باهم کار میکنند تا به پیاموارههایی دسترسی پیدا کنند که Firebase Security Rules را تولید و درستیسنجی میکنند و به آزمایش و استقرار Security Rules کمک میکنند. سرور Firebase MCP را نصب کنید قبلاز استفاده از این ابزارها برای تولید Firebase Security Rules.
محدودیتها
ما بهطور فعال درحال بهبود این تجربه هستیم، بنابراین این فهرست محدودیتها ممکن است تغییر کند. برای اطلاع از بهروزرسانیها مرتباً به اینجا سر بزنید.
این پیامواره برای تولید Firebase Security Rules برای Cloud Firestore و Cloud Storage for Firebase طراحی شده است. هنوز نمیتواند برای Firebase Realtime Database، Security Rules تولید کند.
Firebase Security Rules هنگام دسترسی به پایگاه داده یا دسته از سرور یا محیط پسبک دیگر، مثلاً هنگام استفاده از Firebase Admin SDK، فراخوانی نمیشود. اگر از Admin SDK استفاده میکنید، مسئولیت مدیریت مجوز و اعتبارسنجی دادهها در کد باطن برعهده شما است.
Gemini در Firebase در کنسول Firebase نمیتواند Firebase Security Rules تولید کند، حتی هنگام استفاده از این پیامواره. بهجای آن، از دستیار هوش مصنوعی جایگزینی استفاده کنید که به پایگاه کد شما دسترسی دارد، مثل Antigravity (که در این صفحه شرح داده شده است).
استفاده کردن از پیامواره
این قابلیت هنگام استفاده از
سرور Firebase MCP و
مهارتهای عامل Firebase با یک
دستیار هوش مصنوعی سازگار (مانند Antigravity) برای تولید Security Rules و
آزمایشهای شما دردسترس است. این ابزارها
کد منبع شما را تجزیهوتحلیل میکنند تا به شناسایی طرحوارههای داده و الگوهای دسترسی برای
Cloud Firestore و Cloud Storage کمک کنند. این مدلها برای پیشنویس کردن Security Rules
براساس اصل حداقل امتیاز طراحی شدهاند و تلاش میکنند
آسیبپذیریها را ازطریق شبیهسازیهای تکراری «حمله» کشف کنند. برای کمک به درستیسنجی نهایی، آنها یک مجموعه آزمون واحد شروع بااستفاده از @firebase/rules-unit-testing ارائه میدهند که به شما امکان میدهد منطق امنیتی خود را بهطور محلی بااستفاده از Firebase Local Emulator Suite درستیسنجی کنید.
استفاده از این ابزارها مستلزم سه مرحله است که در این بخش شرح داده شده است:
مرحله ۱: تولید Security Rules و آزمایشها
ابزارها را راهاندازی و اجرا کنید:
مهارتهای عامل Firebase را فعال کنید:
Google Antigravity: برای نصب افزایه Firebase از «بازارگاه» Antigravity، به دستورالعملهای راهاندازی مراجعه کنید. همچنین میتوانید با اجرای دستور زیر، مهارتها را در سطح پروژه نصب کنید:
npx skills add firebase/agent-skills --agent=antigravityسایر عاملهای کدنویسی هوش مصنوعی: دستورالعملهای مربوط به مهارتهای عامل و سرور MCP را دنبال کنید.
دستیار هوش مصنوعیتان را راهاندازی کنید (برای مثال،
agyرا در پایانه برای رابط خط فرمان اجرا کنید، یا برنامه رایانه را باز کنید).از ریشه پروژهتان، از عامل بخواهید Security Rules را برای Cloud Firestore یا Cloud Storage براساس نحوه تعامل عامل کدنویسی هوش مصنوعی شما با پیاموارههای MCP تولید کند:
برای عاملهای کدنویسی که از زبان طبیعی استفاده میکنند (مانند Antigravity)، بااستفاده از زبان طبیعی به عامل پیامواره بدهید.
تولید کردن Security Rules برای Cloud Firestore:
Generate Firestore security rules for this project, then run the unit tests.در دایرکتوری والد، عامل یک فایل
firestore.rulesو یک دایرکتوریsecurity_rules_test_firestoreجدید ایجاد میکند که حاوی پروژه Node.js با آزمونهای واحد برای Security Rules تولیدشده است.تولید کردن Security Rules برای Cloud Storage for Firebase:
Generate Cloud Storage security rules for this project, then run the unit tests.در دایرکتوری والد، عامل یک فایل
storage.rulesو یک دایرکتوریsecurity_rules_test_storageجدید ایجاد میکند که حاوی پروژه Node.js با آزمونهای واحد برای Security Rules تولیدشده است.
برای عاملهای کدنویسی که از فرمانهای خط مورب پشتیبانی میکنند (مثل Claude Code)، از فرمانهای زیر استفاده کنید.
تولید کردن Security Rules برای Cloud Firestore:
/firestore:generate_security_rulesتولید کردن Security Rules برای Cloud Storage for Firebase:
/storage:generate_security_rules
برای عاملهای کدنویسی که از ادغام پیامواره MCP پشتیبانی نمیکنند، میتوانید الگوی پیامواره خام را از مخزن
firebase-toolsکپی کنید و آن را در گپ عامل جایگذاری کنید.- تولید Security Rules برای Cloud Firestore: پیامواره را از Cloud Firestore کپی کنید.
- تولید کردن Security Rules برای Cloud Storage for Firebase: پیامواره را از Cloud Storage for Firebase کپی کنید.
مرحله ۲: مرور نتایج آزمایش و اعتبارسنجی Security Rules
مطمئن شوید که موارد زیر توسط عامل کدنویسی هوش مصنوعی شما انجام شده است. پساز اجرای ابزارها، باید خلاصهای تولیدشده دریافت کنید.
اعتبارسنجی نحو: پساز تولید Security Rules، عامل کدنویسی هوش مصنوعی شما بهطور خودکار نحو را بااستفاده از فرمان
firebase_validate_security_rulesاز سرور Firebase MCP اعتبارسنجی میکند.آزمایشهای واحد: پساز اعتبارسنجی نحو، عامل کدنویسی هوش مصنوعی شما تلاش میکند آزمایشهای واحد تولیدشده را بااستفاده از Firebase Local Emulator Suite اجرا کند.
اگر آزمایشها بهطور خودکار اجرا نشد، Firebase Local Emulator Suite را در پایانه جداگانهای شروع کنید، سپس از یکی از گزینههای زیر برای اجرای آزمایشها استفاده کنید:
گزینه ۱: به دستیار هوش مصنوعی خود دستور دهید تا آزمایشها را اجرا کند:
Firebase Emulator Suite is running in a separate terminal. Please execute the tests.گزینه ۲: با دنبال کردن دستورالعملهای موجود در فایل
README.mdدر فهرست راهنمایrules_testیاstorage_rules_test، آزمایشها را بهصورت دستی اجرا کنید.
مرحله ۳: Security Rules را در پروژه Firebase خود مستقر کنید
وقتی از نتیجه Security Rules تولیدشده راضی بودید، از فرمانهای CLI Firebase زیر برای استقرار Security Rules در پروژه Firebase خود استفاده کنید:
Cloud Firestore
firebase deploy --only firestore:rulesCloud Storage for Firebase
firebase deploy --only storage