Ограничить запросы только для аутентифицированных пользователей

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

Если запрос заблокирован, возвращается ошибка 401: unauthenticated.

Важно! Для режима аутентифицированных пользователей в Firebase AI Logic требуются учетные данные из Firebase Authentication. Если в вашем приложении используется другое решение для аутентификации, принудительное применение этого режима будет блокировать запросы от пользователей.

Важные примечания

При использовании режима аутентифицированных пользователей необходимо учитывать следующее:

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

Когда включен режим аутентифицированных пользователей

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

• Это общепроектная настройка для Firebase AI Logic.

  • Оно применяется ко всем приложениям, зарегистрированным в проекте.
  • Оно применяется только к проекту, в котором оно действует.

• Этот параметр блокирует все запросы через Firebase AI Logic, которые не отправляют учетные данные Firebase Authentication.

  • Пользователь должен пройти аутентификацию через Firebase Authentication до отправки запроса в Firebase AI Logic.
  • Эта настройка применяется ко всем запросам, отправляемым через Firebase AI Logic как в Gemini Developer API, так и в Agent Platform Gemini API (formerly Vertex AI).
  • Эта настройка применяется ко всем запросам, в которых используются шаблоны запросов на сервере.
  • Эту настройку нельзя применить к отдельным пользователям, API или шаблонам.

• Эта настройка не блокирует запросы Gemini API в вашем проекте, которые выполняются не через Firebase AI Logic.

• Если вы используете гибридный режим или режим на устройстве:

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

• Если вы используете Gemini Live API:

  • Этот параметр блокирует использование Gemini Live API для веб-приложений при использовании Firebase AI Logic, даже для аутентифицированных пользователей. Это касается и веб-приложений, использующих Firebase JS SDK или Flutter web.

• Если вы используете REST API Firebase AI Logic:

  • Этот параметр блокирует запросы на инференс, которые не отправляют учетные данные Firebase Authentication. Это касается и запросов шаблонов подсказок сервера, таких как templateGenerateContent или templateStreamGenerateContent.
  • Эта настройка не блокирует запросы уровня управления (например, для управления шаблонами и конфигурациями), поскольку они защищены IAM.

• Эта настройка не блокирует запросы к countTokens (Count Tokens API).

Перед включением режима аутентифицированных пользователей

Прежде чем включить режим аутентификации пользователей, обратите внимание на следующее:

• Если у вас есть версии приложения, в которых не используется Firebase Authentication:

  • Эта настройка заблокирует запросы через Firebase AI Logic от существующих версий приложений.
  • Прежде чем включить режим аутентифицированных пользователей, убедитесь, что все активные клиенты обновлены и используют Firebase Authentication.

• Более старые версии плагина Flutter требуют специального создания экземпляра для отправки учетных данных Firebase Authentication с запросами.

  • Если в вашем приложении используется плагин Flutter firebase_ai версии 3.11.0 или ниже (BoM версии 4.12.0 или ниже) и при создании экземпляра не передается Authentication, этот параметр будет блокировать запросы через Firebase AI Logic, даже если пользователи прошли аутентификацию.
  • Прежде чем включать режим аутентифицированных пользователей, убедитесь, что все активные клиенты Flutter обновлены до более новой версии плагина.

Особый экземпляр, необходимый для Flutter при использовании более старых версий плагина

Нажмите на название своего поставщика Gemini API, чтобы посмотреть контент и код, относящиеся к нему. Gemini Developer API Vertex AI Gemini API

Этот специальный экземпляр требуется, только если в вашем приложении используется плагин Flutter версии 3.11.0 или ниже (BoM версии 4.12.0 или ниже).firebase_ai Если в вашем приложении используется более новая версия плагина, то создавать экземпляр не нужно.

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

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

// ...

final ai = await FirebaseAI.googleAI(
  auth: FirebaseAuth.instance, // for Flutter, pass in Authentication explicitly
);

// ...

Настроить Firebase Authentication

Важно! Для режима аутентифицированных пользователей в Firebase AI Logic требуются учетные данные из Firebase Authentication. Если в вашем приложении используется другое решение для аутентификации, принудительное применение этого режима будет блокировать запросы от пользователей.

В документации по Firebase Authentication вы найдете описания и инструкции по реализации поддерживаемых поставщиков аутентификации, в том числе с использованием паролей, номеров телефонов, популярных поставщиков федеративной идентификации (таких как Google, Facebook и GitHub) и т. д.

После того как вы реализуете Firebase Authentication в своем приложении, оно будет автоматически отправлять учетные данные Firebase Authentication для аутентифицированного пользователя в каждом запросе к Firebase AI Logic.

Обратите внимание на следующее:

• Собственная аутентификация. Вам нужно получить подписанный токен аутентификации, который будет отправляться вместе с запросом к Firebase AI Logic. Подробнее о специальной аутентификации…

• Анонимные пользователи или пользователи, прошедшие аутентификацию с помощью адреса электронной почты и пароля, считаются аутентифицированными, поэтому их запросы к Firebase AI Logic не блокируются.

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

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

Управлять настройками режима аутентифицированных пользователей можно в консоли Firebase.

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

Необходимые разрешения и роли IAM

Чтобы управлять настройками режима аутентифицированных пользователей, требуется разрешение firebasevertexai.configs.update, которое по умолчанию включено в следующие роли IAM: владелец, редактор, администратор Firebase и администратор Firebase AI Logic.

Принудительно включить режим аутентифицированных пользователей

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

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

2. Если вы ещё не сделали этого, настройте Firebase Authentication в своем приложении, как описано выше.

3. Принудительное включение режима аутентифицированных пользователей:

   1. В консоли Firebase выберите AI Services (Сервисы ИИ) > AI Logic (Логика ИИ) > вкладка Settings (Настройки).

   2. В разделе Режим аутентифицированных пользователей установите переключатель Принудительно использовать режим аутентифицированных пользователей в положение Принудительно.

   3. В диалоговом окне подтверждения нажмите Подтвердить.

Как отключить принудительное применение режима аутентифицированных пользователей

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

• Запросы через Firebase AI Logic, которые не отправляют учетные данные Firebase Authentication, будут разрешены.
• Это настройка Firebase AI Logic на уровне проекта.

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

1. В консоли Firebase выберите AI Services (Сервисы ИИ) > AI Logic (Логика ИИ) > вкладка Settings (Настройки).

2. В разделе Режим аутентифицированных пользователей отключите параметр Принудительно включить режим аутентифицированных пользователей.

3. В диалоговом окне подтверждения нажмите Подтвердить.