Основные правила безопасности

Firebase Security Rules позволяют управлять доступом к сохраненным данным. Гибкий синтаксис правил позволяет создавать правила, соответствующие любым операциям, от всех записей во всей базе данных до операций с определенным документом.

В этом руководстве описаны некоторые из наиболее простых вариантов использования, которые вы можете реализовать при настройке приложения и защите своих данных. Однако прежде чем начать писать правила, вам может потребоваться узнать больше о языке, на котором они написаны, и их поведении.

Чтобы посмотреть и изменить правила, следуйте инструкциям в статье Как управлять Firebase 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 data.

Правила по умолчанию: заблокированный режим

При создании базы данных или хранилища в консоли Firebase вы можете выбрать, будут ли Firebase Security Rules ограничивать доступ к вашим данным (заблокированный режим) или разрешать доступ всем (тестовый режим). В Cloud Firestore и Realtime Database правила по умолчанию для заблокированного режима запрещают доступ всем пользователям. В Cloud Storage доступ к сегментам хранилища могут получить только аутентифицированные пользователи.

Cloud Firestore

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

Realtime Database

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

Cloud Storage

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

Правила для среды разработки

Пока вы работаете над приложением, вам может потребоваться относительно открытый или неограниченный доступ к данным. Только не забудьте обновить Security Rules перед тем, как опубликовать рабочую версию приложения. Также помните, что если вы развернете приложение, оно будет общедоступным, даже если вы его не запустили.

Помните, что Firebase позволяет клиентам напрямую обращаться к вашим данным, а Firebase Security Rules – это единственная защита от злоумышленников. Определение правил отдельно от логики продукта имеет ряд преимуществ: клиенты не несут ответственности за обеспечение безопасности, ошибочные реализации не поставят под угрозу ваши данные, и, самое главное, вы не полагаетесь на промежуточный сервер для защиты данных от мира.

Все пользователи, прошедшие аутентификацию

Мы не рекомендуем оставлять данные доступными для любого пользователя, выполнившего вход, но это может быть полезно при разработке приложения.

Cloud Firestore

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

Realtime Database

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

Cloud Storage

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

Правила, готовые к использованию

При подготовке к развертыванию приложения убедитесь, что ваши данные защищены и пользователям предоставлен надлежащий доступ. Используйте Authentication, чтобы настроить доступ на основе пользователей, и считывайте данные непосредственно из базы данных, чтобы настроить доступ на основе данных.

Рекомендуем писать правила по мере структурирования данных, поскольку от того, как вы настроите правила, зависит, как вы ограничите доступ к данным по разным путям.

Доступ только для владельца контента

Эти правила ограничивают доступ только аутентифицированным владельцем контента. Данные доступны для чтения и записи только одному пользователю, а путь к данным содержит идентификатор пользователя.

Когда это правило работает. Это правило хорошо работает, если данные изолированы по пользователям, то есть если единственный пользователь, которому нужен доступ к данным, – это тот же пользователь, который создал данные.

Когда это правило не работает. Этот набор правил не работает, когда нескольким пользователям нужно записать или прочитать одни и те же данные. Пользователи будут перезаписывать данные или не смогут получить доступ к созданным ими данным.

Чтобы настроить это правило, создайте правило, которое подтверждает, что пользователь, запрашивающий доступ для чтения или записи данных, является владельцем этих данных.

Cloud Firestore

service cloud.firestore {
  match /databases/{database}/documents {
    // Allow only authenticated content owners access
    match /some_collection/{userId}/{document} {
      allow read, write: if request.auth != null && request.auth.uid == userId
    }
  }
}

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"
      }
    }
  }
}

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 != null && request.auth.uid == userId;
    }
  }
}

Смешанный доступ (общедоступный и ограниченный)

Это правило позволяет любому пользователю читать набор данных, но ограничивает возможность создавать или изменять данные по заданному пути только аутентифицированным владельцем контента.

Когда это правило работает. Это правило хорошо подходит для приложений, которым требуются общедоступные элементы, но необходимо ограничить права на редактирование для владельцев этих элементов. например, в мессенджере или блоге.

Когда это правило не работает. Как и в случае с правилом "Только владелец контента", этот набор правил не работает, если нескольким пользователям нужно редактировать одни и те же данные. В конечном итоге пользователи будут перезаписывать данные друг друга.

Чтобы настроить это правило, создайте правило, которое разрешает доступ для чтения всем пользователям (или всем аутентифицированным пользователям) и подтверждает, что пользователь, записывающий данные, является владельцем.

Cloud Firestore

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

{
// 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

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;
    }
  }
}

Доступ на основе атрибутов и ролей

Чтобы эти правила работали, необходимо определить и назначить атрибуты пользователям в ваших данных. Firebase Security Rules проверяет запрос, сравнивая его с данными из базы данных или метаданными файла, чтобы подтвердить или отклонить доступ.

Когда это правило работает. Если вы назначаете пользователям роль, это правило позволяет ограничить доступ на основе ролей или определенных групп пользователей. Например, если вы храните оценки, то можете назначить разные уровни доступа для группы "Ученики" (только чтение своего контента), группы "Учителя" (чтение и запись по своему предмету) и группы "Директора" (чтение всего контента).

Когда это правило не работает. В Realtime Database и Cloud Storage в правилах нельзя использовать метод get(), который можно использовать в правилах Cloud Firestore. Поэтому вам нужно структурировать базу данных или метаданные файла так, чтобы они отражали атрибуты, которые вы используете в правилах.

Чтобы настроить это правило, добавьте в документы пользователей в Cloud Firestore поле, которое вы можете прочитать, а затем настройте правило так, чтобы оно считывало это поле и условно предоставляло доступ. В Realtime Database создайте путь к данным, который определяет пользователей приложения и предоставляет им роль в дочернем узле.

Вы также можете настроить специальные утверждения в Authentication, а затем получать эту информацию из переменной auth.token в любом Firebase Security Rules.

Атрибуты и роли, определяемые данными

Эти правила работают только в Cloud Firestore и Realtime Database.

Cloud Firestore

Помните, что каждый раз, когда ваши правила включают чтение, как в правилах ниже, вам выставляется счет за операцию чтения в Cloud Firestore.

service cloud.firestore {
  match /databases/{database}/documents {
    // For attribute-based access control, Check a boolean `admin` attribute
    allow write: if get(/databases/$(database)/documents/users/$(request.auth.uid)).data.admin == true;
    allow read: true;

    // Alterntatively, for role-based access, assign specific roles to users
    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"
   }
  }
}

Realtime Database

{
  "rules": {
    "some_path": {
      "${subpath}": {
        //
        ".write": "root.child('users').child(auth.uid).child('role').val() === 'admin'",
        ".read": true
      }
    }
  }
}

Атрибуты и роли настраиваемых утверждений

Чтобы реализовать эти правила, настройте пользовательские утверждения в Firebase Authentication, а затем используйте их в правилах.

Cloud Firestore

service cloud.firestore {
  match /databases/{database}/documents {
    // For attribute-based access control, check for an administrator claim
    allow write: if request.auth.token.admin == true;
    allow read: true;

    // Alterntatively, for role-based access, assign specific roles to users
    match /some_collection/{document} {
     allow read: if request.auth.token.reader == "true";
     allow write: if request.auth.token.writer == "true";
   }
  }
}

Realtime Database

{
  "rules": {
    "some_path": {
      "$uid": {
        // Create a custom claim for each role or group
        // you want to use
        ".write": "auth.uid !== null && auth.token.writer === true",
        ".read": "auth.uid !== null && auth.token.reader === true"
      }
    }
  }
}

Cloud Storage

service firebase.storage {
  // Allow reads if the group ID in your token matches the file metadata's `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;
  }
}

Атрибуты аренды

Чтобы реализовать эти правила, настройте многоклиентское обслуживание в Google Cloud Identity Platform (GCIP), а затем используйте клиента в своих правилах. В следующих примерах разрешена запись от пользователя в определенном клиенте, например tenant2-m6tyz.

Cloud Firestore

service cloud.firestore {
  match /databases/{database}/documents {
    // For tenant-based access control, check for a tenantID
    allow write: if request.auth.token.firebase.tenant == 'tenant2-m6tyz';
    allow read: true;
  }
}

Realtime Database

{
  "rules": {
    "some_path": {
      "$uid": {
        // Only allow reads and writes if user belongs to a specific tenant
        ".write": "auth.uid !== null && auth.token.firebase.tenant === 'tenant2-m6tyz'",
        ".read": "auth.uid !== null
      }
    }
  }
}

Cloud Storage

service firebase.storage {
  // Only allow reads and writes if user belongs to a specific tenant
  match /files/{tenantId}/{fileName} {
    allow read: if request.auth != null;
    allow write: if request.auth.token.firebase.tenant == tenantId;
  }
}