آشنایی با «قوانین امنیتی Firebase» برای Cloud Storage

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

همان‌طور که Firebase Authentication اصالت‌سنجی کاربران را برای شما آسان می‌کند، Firebase Security Rules برای Cloud Storage نیز صدور مجوز برای کاربران و اعتبارسنجی درخواست‌ها را برای شما آسان می‌کند. Cloud Storage Security Rules پیچیدگی را برای شما مدیریت می‌کند و به شما اجازه می‌دهد اجازه‌های مبتنی بر مسیر را مشخص کنید. فقط با چند خط کد، می‌توانید قوانین مجوز بنویسید که درخواست‌های Cloud Storage را به کاربر خاصی محدود کند یا اندازه بارگذاری را محدود کند.

Firebase Realtime Database ویژگی مشابهی دارد که Firebase Realtime Database Security Rules نامیده می‌شود

برای کمک هوش مصنوعی، پیام‌واره زیر را در عامل کدنویسی هوش مصنوعی خود (مانند Gemini در Android Studio،‏ Antigravity،‏ Claude Code،‏ Codex، و Cursor) کپی کنید. می‌توانید پیام‌واره را سفارشی‌سازی کنید و با عاملتان تکرار کنید. برای اطلاعات دقیق نصب، به مهارت‌های عامل Firebase مراجعه کنید.

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me write, validate, and deploy Firebase Security Rules to protect my app's Cloud Storage data.

اصالت‌سنجی

دانستن اینکه کاربران شما چه کسانی هستند بخش مهمی از ساختن برنامه است و Firebase Authentication راهکاری آسان برای استفاده، ایمن، و فقط سمت کارخواه برای اصالت‌سنجی ارائه می‌دهد. Firebase Security Rules برای Cloud Storage به Firebase Authentication برای امنیت مبتنی بر کاربر مرتبط است. وقتی کاربری با Firebase Authentication اصالت‌سنجی می‌شود، متغیر request.auth در Cloud Storage Security Rules به شیئی تبدیل می‌شود که حاوی شناسه یکتای کاربر (request.auth.uid) و همه اطلاعات دیگر کاربر در کد (request.auth.token) است. وقتی کاربر اصالت‌سنجی نشده باشد، request.auth برابر با null است. این کار به شما امکان می‌دهد دسترسی به داده را به‌طور ایمن برای هر کاربر کنترل کنید. می‌توانید در بخش اصالت‌سنجی اطلاعات بیشتری کسب کنید.

صدور مجوز

شناسایی کاربر فقط بخشی از امنیت است. وقتی متوجه شدید آن‌ها چه کسانی هستند، به روشی برای کنترل دسترسی آن‌ها به فایل‌ها در Cloud Storage نیاز دارید.

Cloud Storage به شما امکان می‌دهد قوانین مجوزدهی را برای هر فایل و هر مسیر مشخص کنید. این قوانین در سرورهای ما قرار دارند و دسترسی به فایل‌های برنامه‌تان را تعیین می‌کنند. برای مثال، Cloud Storage Security Rules پیش‌فرض برای انجام هرگونه عملیات read یا write روی همه فایل‌ها به Firebase Authentication نیاز دارد:

service firebase.storage {
  match /b/{bucket}/o {
    match /someFolder/{fileName} {
      allow read, write: if request.auth != null;
    }
  }
}

می‌توانید این Security Rules را در کنسول Firebase با رفتن به برگه پایگاه‌های داده و فضای ذخیره‌سازی > فضای ذخیره‌سازی > قوانین ویرایش کنید.

اعتبارسنجی داده‌ها

‫Firebase Security Rules برای Cloud Storage همچنین می‌تواند برای اعتبارسنجی داده‌ها استفاده شود، ازجمله اعتبارسنجی نام و مسیر فایل و همچنین ویژگی‌های فراداده فایل مانند contentType و size.

service firebase.storage {
  match /b/{bucket}/o {
    match /images/{imageId} {
      // Only allow uploads of any image file that's less than 5MB
      allow write: if request.resource.size < 5 * 1024 * 1024
                   && request.resource.contentType.matches('image/.*');
    }
  }
}

مراحل بعدی

دفاع در عمق با «کنترل‌های سرویس‌های VPC»

می‌توانید از کنترل‌های سرویس‌های VPC برای محافظت از کل پروژه‌تان با حاشیه امنیتی استفاده کنید. این جایگزین جامع‌تری برای کنترل دسترسی جزئی‌تر است که Cloud Storage Security Rules ارائه می‌دهد.

«قوانین امنیتی Firebase» و VPC Service Controls باهم کار می‌کنند: «قوانین امنیتی» مجوزدهی را مدیریت می‌کنند (چه کسی می‌تواند به کدام فایل دسترسی داشته باشد)، درحالی‌که VPC Service Controls محافظت در سطح شبکه را ارائه می‌دهد (جلوگیری از خروج داده‌ها از محیط مجاز شما). این رویکرد لایه‌ای بهترین روش برای ایمن‌سازی داده‌های حساس سازمانی است.