Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

تجنُّب القواعد غير الآمنة

استخدِم هذا الدليل لفهم الثغرات الأمنية الشائعة في Firebase Security Rules الإعدادات، ومراجعة قواعدك وتأمينها بشكل أفضل، واختبار التغييرات قبل نشرها.

إذا تلقّيت تنبيهًا يشير إلى أنّ بياناتك غير مؤمَّنة بشكل صحيح، راجِع هذه الأخطاء الشائعة وعدِّل أي قواعد معرَّضة للخطر.

الوصول إلى Firebase Security Rules

لعرض Security Rules الحالية، استخدِم إما Firebase CLI أو Firebase console. تأكَّد من تعديل قواعدك باستخدام الطريقة نفسها باستمرار لتجنُّب الكتابة فوق التعديلات عن طريق الخطأ. إذا لم تكن متأكدًا مما إذا كانت القواعد المحدّدة محليًا تعكس آخر التعديلات، يعرض Firebase console دائمًا أحدث إصدار تم نشره من Firebase Security Rules.

للوصول إلى قواعدك من Firebase console، اختَر مشروعك، ثم انتقِل إلى Realtime Database أو Cloud Firestore أو Storage. انقر على القواعد بعد الانتقال إلى قاعدة البيانات أو مساحة التخزين الصحيحة.

للوصول إلى قواعدك من Firebase CLI، انتقِل إلى ملف القواعد المذكور في ملف firebase.json.

فهم Firebase Security Rules

Firebase Security Rules تحمي بياناتك من المستخدمين الضارين. عند إنشاء مثيل قاعدة بيانات أو مساحة تخزين Cloud Storageفي Firebaseconsole، يمكنك اختيار رفض الوصول إلى جميع المستخدمين (الوضع المقفل) أو منح إذن الوصول إلى جميع المستخدمين (وضع الاختبار). على الرغم من أنّك قد تريد إعدادًا أكثر انفتاحًا أثناء التطوير، تأكَّد من تخصيص الوقت لتكوين قواعدك بشكل صحيح وتأمين بياناتك قبل نشر تطبيقك.

أثناء تطوير تطبيقك واختبار إعدادات مختلفة لقواعدك ، استخدِم أحد محاكيات Firebase المحلية لتشغيل تطبيقك في بيئة تطوير محلية.

السيناريوهات الشائعة التي تتضمّن قواعد غير آمنة

يجب مراجعة Security Rules التي ربما تكون قد أعددتها تلقائيًا أو أثناء العمل في البداية على تطوير تطبيقك وتعديلها قبل نشر تطبيقك. تأكَّد من تأمين بيانات المستخدمين بشكل صحيح من خلال تجنُّب الأخطاء الشائعة التالية.

إتاحة إمكانية الوصول المفتوح

أثناء إعداد مشروعك على Firebase، ربما تكون قد ضبطت قواعدك للسماح بالوصول المفتوح أثناء التطوير. قد تعتقد أنّك الشخص الوحيد الذي يستخدم تطبيقك، ولكن إذا نشرته، سيصبح متاحًا على الإنترنت. إذا لم تكن تصادق على هوية المستخدمين وتضبط قواعد الأمان، يمكن لأي مستخدم تخمين رقم تعريف مشروعك سرقة البيانات أو تعديلها أو حذفها.

لا يُنصح بما يلي: إتاحة إذن القراءة والكتابة لـ جميع المستخدمين.

Cloud Firestore

// Allow read/write access to all users under any conditions
// Warning: **NEVER** use this ruleset in production; it allows
// anyone to overwrite your entire database.

service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

Realtime Database

{
  // Allow read/write access to all users under any conditions
  // Warning: **NEVER** use this ruleset in production; it allows
  // anyone to overwrite your entire database.

  "rules": {
    ".read": true,
    ".write": true
  }
}

Cloud Storage

// Anyone can read or write to the bucket, even non-users of your app.
// Because it is shared with App Engine, this will also make
// files uploaded using App Engine public.
// Warning: This rule makes every file in your Cloud Storage bucket accessible to any user.
// Apply caution before using it in production, since it means anyone
// can overwrite all your files.

service firebase.storage {
  match /b/{bucket}/o {
    match /{allPaths=**} {
      allow read, write;
    }
  }
}

الحلّ: قواعد تقيّد إذن القراءة و الكتابة.

أنشِئ قواعد منطقية لتسلسل بياناتك الهرمي. أحد الحلول الشائعة لهذه المشكلة الأمنية هو الأمان المستند إلى المستخدم باستخدام Firebase Authentication. مزيد من المعلومات عن مصادقة هوية المستخدمين باستخدام القواعد.

Cloud Firestore

مالك المحتوى فقط

service cloud.firestore {
  match /databases/{database}/documents {
    // Allow only authenticated content owners access
    match /some_collection/{document} {
      // Allow reads and deletion if the current user owns the existing document
      allow read, delete: if request.auth.uid == resource.data.author_uid;
      // Allow creation if the current user owns the new document
      allow create: if request.auth.uid == request.resource.data.author_uid;
      // Allow updates by the owner, and prevent change of ownership
      allow update: if request.auth.uid == request.resource.data.author_uid
                    && request.auth.uid == resource.data.author_uid;

    }
  }
}

إتاحة إذن الوصول العام والخاص معًا

service cloud.firestore {
  match /databases/{database}/documents {
    // Allow public read access, but only content owners can write
    match /some_collection/{document} {
      // Allow public reads
      allow read: if true
      // Allow creation if the current user owns the new document
      allow create: if request.auth.uid == request.resource.data.author_uid;
      // Allow updates by the owner, and prevent change of ownership
      allow update: if request.auth.uid == request.resource.data.author_uid
                    && request.auth.uid == resource.data.author_uid;
      // Allow deletion if the current user owns the existing document
      allow delete: if request.auth.uid == resource.data.author_uid;
    }
  }
}

Realtime Database

مالك المحتوى فقط

{
  "rules": {
    "some_path": {
      "$uid": {
        // Allow only authenticated content owners access to their data
        ".read": "auth !== null && auth.uid === $uid",
        ".write": "auth !== null && auth.uid === $uid"
      }
    }
  }
}

إتاحة إذن الوصول العام والخاص معًا

{
  // Allow anyone to read data, but only authenticated content owners can
  // make changes to their data

  "rules": {
    "some_path/$uid": {
      ".read": true,
      // or ".read": "auth.uid !== null" for only authenticated users
      ".write": "auth.uid === $uid"
    }
  }
}

Cloud Storage

مالك المحتوى فقط

// Grants a user access to a node matching their user ID
service firebase.storage {
  match /b/{bucket}/o {
    // Files look like: "user/<UID>/file.txt"
    match /user/{userId}/{fileName} {
      allow read, write: if request.auth.uid == userId;
    }
  }
}

إتاحة إذن الوصول العام والخاص معًا

service firebase.storage {
  match /b/{bucket}/o {
    // Files look like: "user/<UID>/file.txt"
    match /user/{userId}/{fileName} {
      allow read;
      allow write: if request.auth.uid == userId;
    }
  }
}

إتاحة إذن الوصول لأي مستخدم تمت مصادقته

في بعض الأحيان، تتحقّق Security Rules من تسجيل دخول المستخدم، ولكنها لا تفرض قيودًا إضافية على إذن الوصول استنادًا إلى عملية المصادقة هذه. إذا كانت إحدى قواعدك تتضمّن auth != null، تأكَّد من أنّك تريد أن يتمكّن أي مستخدم مسجّل الدخول من الوصول إلى البيانات.

لا يُنصح بما يلي: إتاحة إذن القراءة والكتابة لأي مستخدم مسجّل الدخول في قاعدة بياناتك بالكامل.

Cloud Firestore

service cloud.firestore {
  match /databases/{database}/documents {
    match /some_collection/{document} {
      allow read, write: if request.auth.uid != null;
    }
  }
}

Realtime Database

{
  "rules": {
    ".read": "auth.uid !== null",
    ".write": "auth.uid !== null"
  }
}

Cloud Storage

// Only authenticated users can read or write to the bucket
service firebase.storage {
  match /b/{bucket}/o {
    match /{allPaths=**} {
      allow read, write: if request.auth != null;
    }
  }
}

الحلّ: تضييق نطاق إذن الوصول باستخدام شروط الأمان

عند التحقّق من عملية المصادقة، قد تحتاج أيضًا إلى استخدام إحدى خصائص المصادقة لفرض قيود إضافية على إذن الوصول إلى مجموعات بيانات محدّدة لمستخدمين معيّنين. مزيد من المعلومات عن خصائص المصادقة المختلفة .

Cloud Firestore

وصول على أساس الدور

service cloud.firestore {
  match /databases/{database}/documents {
    // Assign roles to all users and refine access based on user roles
    match /some_collection/{document} {
     allow read: if get(/databases/$(database)/documents/users/$(request.auth.uid)).data.role == "Reader"
     allow write: if get(/databases/$(database)/documents/users/$(request.auth.uid)).data.role == "Writer"

     // Note: Checking for roles in your database using `get` (as in the code
     // above) or `exists` carry standard charges for read operations.
    }
  }
}

وصول على أساس السمة

// Give each user in your database a particular attribute
// and set it to true/false
// Then, use that attribute to grant access to subsets of data
// For example, an "administrator" attribute set
// to "true" grants write access to data

service cloud.firestore {
  match /databases/{database}/documents {
    match /some_collection/{document} {
      allow write: if get(/databases/$(database)/documents/users/$(request.auth.uid)).data.admin == true;
      allow read: true;
    }
  }
}

إتاحة إذن الوصول العام والخاص معًا

service cloud.firestore {
  match /databases/{database}/documents {
    // Allow public read access, but only content owners can write
    match /some_collection/{document} {
      allow read: if true
      allow write: if request.auth.uid == request.resource.data.author_uid
    }
  }
}

Realtime Database

مالك المحتوى فقط

{
  "rules": {
    "some_path": {
      "$uid": {
        // Allow only authenticated content owners access to their data
        ".read": "auth.uid === $uid",
        ".write": "auth.uid === $uid"
      }
    }
  }
}

وصول محدّد بالمسار

{
  "rules": {
    "some_path/$uid": {
      ".write": "auth.uid === $uid",
      // Create a "public" subpath in your dataset
      "public": {
        ".read": true
        // or ".read": "auth.uid !== null"
      },
      // Create a "private" subpath in your dataset
      "private": {
        ".read": "auth.uid === $uid"
      }
    }
  }
}

إتاحة إذن الوصول العام والخاص معًا

{
  // Allow anyone to read data, but only authenticated content owners can
  // make changes to their data

  "rules": {
    "some_path/$uid": {
      ".read": true,
      // or ".read": "auth.uid !== null" for only authenticated users
      ".write": "auth.uid === $uid"
    }
  }
}

Cloud Storage

وصول على أساس المجموعة

// Allow reads if the group ID in your token matches the file metadata `owner` property
// Allow writes if the group ID is in the user's custom token
match /files/{groupId}/{fileName} {
  allow read: if resource.metadata.owner == request.auth.token.groupId;
  allow write: if request.auth.token.groupId == groupId;
}

مالك المحتوى فقط

// Grants a user access to a node matching their user ID
service firebase.storage {
  match /b/{bucket}/o {
    // Files look like: "user/<UID>/file.txt"
    match /user/{userId}/{fileName} {
      allow read, write: if request.auth.uid == userId;
    }
  }
}

إتاحة إذن الوصول العام والخاص معًا

service firebase.storage {
  match /b/{bucket}/o {
    // Files look like: "user/<UID>/file.txt"
    match /user/{userId}/{fileName} {
      allow read;
      allow write: if request.auth.uid == userId;
    }
  }
}

(Realtime Database) قواعد موروثة بشكل غير صحيح

Realtime Database Security Rules تتتالى، حيث تلغي القواعد في مسارات أصل أقصر القواعد في العُقد التابعة الأعمق. عند كتابة قاعدة في عُقدة تابعة، تذكَّر أنّه لا يمكنها إلا منح امتيازات إضافية. لا يمكنك تحسين إذن الوصول إلى البيانات أو إبطاله في مسار أعمق في قاعدة بياناتك.

لا يُنصح بما يلي: تحسين القواعد في المسارات التابعة

{
  "rules": {
     "foo": {
        // allows read to /foo/*
        ".read": "data.child('baz').val() === true",
        "bar": {
          /* ignored, since read was allowed already */
          ".read": false
        }
     }
  }
}

الحلّ: كتابة قواعد في مسارات أصل واسعة النطاق، ومنح امتيازات أكثر تحديدًا في المسارات التابعة إذا كانت احتياجات الوصول إلى البيانات تتطلّب مزيدًا من التفاصيل، حافظ على دقة قواعدك. مزيد من المعلومات عن تتالي Realtime Database Security Rules في البنية الأساسية لقواعد الأمان في Realtime Database.Realtime Database Security Rules

وصول مغلق

أثناء تطوير تطبيقك، هناك نهج شائع آخر وهو إبقاء بياناتك مقفلة. يعني هذا عادةً أنّك أغلقت إذن القراءة والكتابة لجميع المستخدمين، على النحو التالي:

Cloud Firestore

// Deny read/write access to all users under any conditions
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if false;
    }
  }
}

Realtime Database

{
  "rules": {
    ".read": false,
    ".write": false
  }
}

Cloud Storage

// Access to files through Cloud Storage is completely disallowed.
// Files may still be accessible through App Engine or Google Cloud Storage APIs.

service firebase.storage {
  match /b/{bucket}/o {
    match /{allPaths=**} {
      allow read, write: if false;
    }
  }
}

لا يزال بإمكان حِزم Firebase Admin SDK وCloud Functions الوصول إلى قاعدة بياناتك. استخدِم هذه القواعد عندما تنوي استخدام Cloud Firestore أو Realtime Database كواجهة خلفية على مستوى الخادم فقط بالتزامن مع حزمة Firebase Admin SDK. على الرغم من أنّها آمنة، عليك اختبار ما إذا كان بإمكان عملاء تطبيقك استرداد البيانات بشكل صحيح.

مزيد من المعلومات عن Cloud Firestore Security Rules وكيفية عملها في البدء باستخدام Cloud Firestore Security Rules.

اختبار Cloud Firestore Security Rules

للتحقّق من سلوك تطبيقك والتحقّق من إعدادات Cloud Firestore Security Rules، استخدِم محاكي Firebase. استخدِم Cloud Firestore المحاكي لتشغيل اختبارات الوحدات وأتمتتها في بيئة محلية قبل نشر أي تغييرات.

للتحقّق بسرعة من Firebase Security Rules في Firebase console، استخدِم محاكي قواعد Firebase.

تجنُّب القواعد غير الآمنة تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الوصول إلى Firebase Security Rules

فهم Firebase Security Rules

السيناريوهات الشائعة التي تتضمّن قواعد غير آمنة

إتاحة إمكانية الوصول المفتوح

Cloud Firestore

Realtime Database

Cloud Storage

Cloud Firestore

مالك المحتوى فقط

إتاحة إذن الوصول العام والخاص معًا

Realtime Database

مالك المحتوى فقط

إتاحة إذن الوصول العام والخاص معًا

Cloud Storage

مالك المحتوى فقط

إتاحة إذن الوصول العام والخاص معًا

إتاحة إذن الوصول لأي مستخدم تمت مصادقته

Cloud Firestore

Realtime Database

Cloud Storage

Cloud Firestore

وصول على أساس الدور

وصول على أساس السمة

إتاحة إذن الوصول العام والخاص معًا

Realtime Database

مالك المحتوى فقط

وصول محدّد بالمسار

إتاحة إذن الوصول العام والخاص معًا

Cloud Storage

وصول على أساس المجموعة

مالك المحتوى فقط

إتاحة إذن الوصول العام والخاص معًا

(Realtime Database) قواعد موروثة بشكل غير صحيح

وصول مغلق

Cloud Firestore

Realtime Database

Cloud Storage

اختبار Cloud Firestore Security Rules

تجنُّب القواعد غير الآمنة