Контрольный список по обеспечению безопасности при использовании Firebase AI Logic

Если вы вызываете Gemini API напрямую из мобильных и веб-приложений, для защиты инфраструктуры бэкенда, квоты и собственных подсказок требуется многоуровневый подход к глубокой защите. Ознакомьтесь с этим контрольным списком, чтобы внедрить рекомендуемые меры безопасности для Firebase AI Logic.

Проверка приложений, устройств и пользователей

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

Принудительное применение Firebase App Check

Принудительно включите Firebase App Check, чтобы защитить Gemini API от злоупотреблений, когда он вызывается непосредственно из вашего приложения. Когда App Check включен, он проверяет, поступают ли входящие запросы из вашего подлинного приложения и/или с немодифицированного устройства.

App Check поддерживает поставщиков аттестации для платформ Apple (DeviceCheck, App Attest или reCAPTCHA Enterprise), Android (Play Integrity или reCAPTCHA Enterprise) и веб-платформ (reCAPTCHA Enterprise). Он также поддерживает всех этих поставщиков для приложений Flutter и Unity.

2 ноября 2026 г. Firebase автоматически принудительно применила App Check для Firebase AI Logic во всех проектах, чтобы защитить Gemini API от злоупотреблений. Для локальной разработки можно настроить App Check отладочный поставщик, а затем зарегистрировать приложение у рабочего поставщика аттестации перед выпуском для конечных пользователей.

Как включить защиту от повторного воспроизведения с помощью одноразовых токенов

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

Как настроить ограничения для ключей API Firebase

Ключи API Firebase идентифицируют ваш проект и приложение Firebase при выполнении запросов. Чтобы предотвратить несанкционированное использование ключей API, сделайте следующее:

  • Задайте ограничения для приложений в консоли Google Cloud, чтобы ключ использовался только для запросов от определенного идентификатора пакета приложения (Apple), названия пакета и цифрового отпечатка SHA-1 (Android) или HTTP-реферера (веб).

  • Проверьте белый список Ограничения API для каждого ключа:

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

Как ограничить запросы только аутентифицированными пользователями

Рекомендуем включить режим аутентификации пользователей, чтобы все запросы через Firebase AI Logic содержали действительные учетные данные из Firebase Authentication. Если запрос поступает от неаутентифицированного конечного пользователя, он отклоняется с ошибкой 401: unauthenticated.

Защита запросов и усиление безопасности

Защитите свои запросы от декомпиляции клиента, чтобы они не были раскрыты, и заблокируйте бэкенд, чтобы вредоносные пользователи не могли выполнять произвольные запросы.

Как использовать шаблоны запросов к серверу

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

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

Проверка и очистка переменных шаблона, предоставленных клиентом

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

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

Как принудительно включить режим "Только шаблоны"

Когда все функции вашего приложения будут использовать шаблоны запросов на сервере, вы можете принудительно включить режим только шаблонов. Если правило включено, Firebase AI Logic блокирует все прямые запросы к Gemini API (403: unauthorized), которые не используют шаблоны. Это не позволяет злоумышленникам отправлять произвольные запросы или злоупотреблять квотой.

Мониторинг, лимиты и оплата

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

Как настроить ИИ-мониторинг в консоли Firebase

Настройте ИИ-мониторинг в консоли Firebase, чтобы отслеживать ключевые показатели, такие как количество запросов, задержка, использование токенов и частота ошибок (включая ошибки аутентификации 401 и блокировки, связанные с шаблонами 403). Вы также можете изучать отдельные трассировки в консоли Google Cloud.

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

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

Как избежать неожиданных расходов с помощью оповещений и пределов расходов

Если в вашем проекте Firebase используется тарифный план Blaze с оплатой по мере использования:

Дальнейшие действия