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

Запрос для ИИ: напиши правила безопасности Firebase

Этот запрос поможет ИИ-помощнику (например, 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 не обновляются автоматически. Запрос, описанный в этом руководстве, выполняется один раз, чтобы создать Security Rules на основе текущего состояния проекта. Он не отслеживает постоянно ваше приложение или файловую систему и не будет автоматически обновлять файл Security Rules по мере разработки новых функций.

Вам нужно вручную обновлять Security Rules каждый раз, когда вы:

Добавьте новую коллекцию или путь к базе данных
Изменение структуры или схемы данных
Как изменить структуру хранения файлов

Чтобы обновить Security Rules, вам нужно либо повторно выполнить запрос, чтобы перестроить Security Rules, либо отредактировать их вручную.

Если вы добавите новые функции, не обновив Security Rules, то можете создать:

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

Требования

Ознакомьтесь с рекомендациями по работе с Firebase Security Rules.
Чтобы запустить модульное тестирование для Firebase Security Rules и использовать Firebase Local Emulator Suite, установите Node.js и CLI Firebase. Полные инструкции приведены в статье Как установить, настроить и интегрировать 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 Security Rules, установите MCP-сервер Firebase.

Ограничения

Мы активно работаем над улучшением функции, поэтому список ограничений может измениться. Следите за обновлениями.

Запрос предназначен для создания Firebase Security Rules для Cloud Firestore и Cloud Storage for Firebase. Он пока не может генерировать Security Rules для Firebase Realtime Database.
Firebase Security Rules не вызываются при доступе к базе данных или сегменту с сервера или из другой серверной среды, например при использовании Firebase Admin SDK. Если вы используете Admin SDK, то отвечаете за управление авторизацией и проверку данных в коде серверной части.
Gemini в Firebase в консоли Firebase не может генерировать Firebase Security Rules, даже если вы используете этот запрос. Вместо этого используйте альтернативного ИИ-помощника, у которого есть доступ к вашей базе кода, например Antigravity (описан на этой странице).

Использовать запрос

Эта возможность доступна при использовании MCP-сервера Firebase и навыков агента Firebase с совместимым ИИ-помощником (например, Antigravity) для создания Security Rules и тестов. Эти инструменты анализируют исходный код, чтобы помочь определить схемы данных и шаблоны доступа для Cloud Firestore и Cloud Storage. Они предназначены для составления Security Rules на основе принципа минимальных привилегий и попыток обнаружить уязвимости с помощью итеративного моделирования атак. Чтобы помочь с окончательной проверкой, они предоставляют начальный набор модульных тестов с использованием @firebase/rules-unit-testing, что позволяет вам проверить логику безопасности локально с помощью Firebase Local Emulator Suite.

Чтобы использовать эти инструменты, выполните три шага, описанные в этом разделе:

Создайте Security Rules и тесты.
Проверьте результаты тестирования и подтверждения Security Rules.
Разверните Security Rules в проекте Firebase.

Важно!

При использовании генеративного искусственного интеллекта в приложении учитывайте следующее:

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

Шаг 1. Сгенерируйте Security Rules и тесты

Настройте и запустите инструменты:

Включите навыки агента Firebase:
- Google Antigravity. Чтобы установить плагин Firebase из каталога Antigravity Marketplace, следуйте инструкциям по настройке. Вы также можете установить навыки на уровне проекта, выполнив следующую команду:
```
npx skills add firebase/agent-skills --agent=antigravity
```
- Другие ИИ-агенты для программирования. Следуйте инструкциям по работе с навыками агентов и MCP-сервером.
Запустите ИИ-помощника. Например, введите agy в терминале для CLI или откройте приложение для компьютера.

Примечание. Прежде чем генерировать Security Rules, убедитесь, что вы подключены к MCP-серверу Firebase.
В корневом каталоге проекта попросите агента сгенерировать 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.

Шаг 2. Проверьте результаты тестирования и проверки Security Rules

Убедитесь, что ИИ-агент программирования выполнил следующие действия: После запуска инструментов вы должны получить сгенерированную сводку.
- Проверка синтаксиса. После создания Security Rules ИИ-агент автоматически проверяет синтаксис с помощью команды firebase_validate_security_rules с сервера MCP Firebase.
- Модульное тестирование. После проверки синтаксиса ИИ-агент пытается запустить сгенерированные модульные тесты с помощью Firebase Local Emulator Suite.
Если тесты не запускаются автоматически, запустите Firebase Local Emulator Suite в отдельном терминале, а затем выполните одно из следующих действий:
- Вариант 1. Попросите ИИ-помощника запустить тесты.
```
Firebase Emulator Suite is running in a separate terminal. Please execute the tests.
```
- Вариант 2. Запустите тесты вручную, следуя инструкциям в файле README.md в каталоге rules_test или storage_rules_test.

Шаг 3. Разверните Security Rules в проекте Firebase

Когда вы будете довольны результатом Security Rules, используйте следующие команды CLI Firebase, чтобы развернуть Security Rules в проекте Firebase:

Cloud Firestore
```
firebase deploy --only firestore:rules
```
Cloud Storage for Firebase
```
firebase deploy --only storage
```