Jeśli wywołujesz Gemini API bezpośrednio z aplikacji mobilnych i internetowych, ochrona infrastruktury backendu, limitu i zastrzeżonych promptów wymaga wielowarstwowego podejścia do obrony w głąb. Zapoznaj się z tą listą kontrolną, aby wdrożyć zalecane sprawdzone metody zapewniania bezpieczeństwa w usłudze Firebase AI Logic.
Weryfikacja aplikacji, urządzenia i użytkownika
Sprawdź, czy żądania przychodzące pochodzą z prawidłowych, niezmodyfikowanych instancji aplikacji działających na autentycznych urządzeniach, a także od autentycznych użytkowników.
Wymuś Firebase App Check
Wymuś Firebase App Check, aby chronić Gemini API przed nadużyciami, gdy jest wywoływany bezpośrednio z aplikacji. Gdy App Check jest wymuszony, sprawdza, czy przychodzące żądania pochodzą z autentycznej aplikacji lub niezmodyfikowanego urządzenia.
App Check obsługuje dostawców atestów na platformach Apple (DeviceCheck, App Attest lub reCAPTCHA Enterprise), Android (Play Integrity lub reCAPTCHA Enterprise) i w internecie (reCAPTCHA Enterprise). Obsługuje też wszystkich tych dostawców w aplikacjach Flutter i Unity.
2 listopada 2026 r. Firebase automatycznie wymusił App Check dla Firebase AI Logic we wszystkich projektach, aby chronić Gemini API przed nadużyciami. Na potrzeby programowania lokalnego możesz skonfigurować App Check dostawcę debugowania, a następnie zarejestrować aplikację u dostawcy atestu produkcyjnego przed udostępnieniem jej użytkownikom.
Włączanie ochrony przed powtórzeniami za pomocą tokenów o ograniczonym użyciu
W ramach konfigurowania App Check rozważ wymuszenie ochrony przed powtórzeniem, aby tokeny App Check były jednorazowe. Ta opcja zapewnia lepszą ochronę niż ochrona podstawowa i pozwala ustawić odpowiedni poziom ochrony aplikacji i przypadków użycia.
Konfigurowanie ograniczeń kluczy interfejsu API Firebase
Klucze interfejsu API Firebase identyfikują projekt w Firebase i aplikację podczas wysyłania żądań. Aby zapobiec nieautoryzowanemu użyciu kluczy interfejsu API:
W konsoli Google Cloud ustaw „Ograniczenia aplikacji”, aby ograniczyć użycie klucza tylko do żądań z określonego identyfikatora pakietu aplikacji (Apple), nazwy pakietu i odcisku cyfrowego SHA-1 (Android) lub odsyłającego adresu HTTP (sieć).
Sprawdź listę dozwolonych „Ograniczeń interfejsów API” dla każdego klucza:
- Upewnij się, że interfejs API Firebase AI Logic (
firebasevertexai.googleapis.com) znajduje się na liście dozwolonych. - Upewnij się, że jedynymi innymi interfejsami API na liście dozwolonych są konkretne usługi Firebase wymagane przez Twoją aplikację. Zobacz listę wymaganych interfejsów API w przypadku kluczy Firebase z ograniczeniami.
- Upewnij się, że interfejs API Firebase AI Logic (
Pamiętaj, że interfejsy API związane z Firebase używają kluczy interfejsu API tylko do identyfikowania projektu lub aplikacji Firebase, a nie do autoryzacji wywoływania interfejsu API.
Ograniczanie żądań tylko do uwierzytelnionych użytkowników
Rozważ wymuszenie trybu uwierzytelnionych użytkowników, aby wszystkie żądania wysyłane przez Firebase AI Logic musiały zawierać prawidłowe dane logowania z Firebase Authentication. Jeśli żądanie pochodzi od nieuwierzytelnionego użytkownika, zostaje odrzucone z błędem 401: unauthenticated.
Ochrona promptów i utwardzanie żądań
Zapobiegaj dekompilacji klienta, aby nie ujawniać projektów promptów, i zablokuj backend, aby złośliwi użytkownicy nie mogli wykonywać dowolnych promptów.
Korzystanie z szablonów promptów serwera
Używaj szablonów promptów serwera, aby bezpiecznie przechowywać prompty, instrukcje systemowe i konfiguracje modeli w chmurze, zamiast kodować je na stałe w kodzie aplikacji klienckiej, gdzie można je wyodrębnić za pomocą dekompilacji binarnej.
Aplikacja odwołuje się tylko do identyfikatora szablonu i przekazuje dynamiczne zmienne wejściowe. Szablony promptów na serwerze umożliwiają też aktualizowanie promptów lub przełączanie modeli na żądanie bez konieczności wydawania nowej wersji aplikacji.
Sprawdzanie i oczyszczanie zmiennych szablonu dostarczonych przez klienta
Szablony promptów po stronie serwera chronią projekt prompta, ale szablony, które akceptują zmienne dynamiczne, mogą być nadal podatne na wstrzykiwanie promptów. Szablony łączą zmienne wejściowe użytkownika w ostateczny prompt, dlatego pamiętaj o tych kwestiach:
- Sprawdź i oczyść wszystkie dane wejściowe użytkownika po stronie klienta, zanim przekażesz zmienne do szablonu (np. wymuś limity znaków i oczekiwane formaty).
- W szablonach uwzględnij jasne instrukcje systemowe, które określają zasady przetwarzania danych wejściowych użytkownika.
Wymuszanie trybu tylko szablonu
Gdy wszystkie funkcje aplikacji będą używać szablonów promptów serwera, rozważ wymuszenie trybu tylko szablonów. Po wymuszeniu Firebase AI Logic blokuje wszystkie bezpośrednie żądania bez szablonu do Gemini API (403: unauthorized), uniemożliwiając nieuczciwym podmiotom wysyłanie dowolnych promptów lub nadużywanie limitu.
Monitorowanie, limity i rozliczenia
Uzyskaj wgląd w ruch przychodzący i anomalie związane z bezpieczeństwem oraz chroń swój projekt przed nieoczekiwanymi skokami wykorzystania lub niekontrolowanymi kosztami.
Konfigurowanie monitorowania wykorzystania AI w konsoli Firebase
Skonfiguruj monitorowanie wykorzystania AI w konsoli Firebase, aby uzyskać wgląd w kluczowe dane, takie jak liczba żądań, czas oczekiwania, wykorzystanie tokenów i wskaźniki błędów (w tym błędy uwierzytelniania 401 i blokady tylko szablonów 403).
Możesz też sprawdzać poszczególne logi czasu w konsoli Google Cloud.
Ustawianie ograniczania liczby żądań i zarządzanie limitami
Zabezpiecz projekt przed nieoczekiwanymi skokami wykorzystania i atakami typu denial-of-wallet:
- Ustaw limity liczby żądań na użytkownika (domyślnie 100 RPM), aby zapobiec nadmiernemu wykorzystywaniu limitu przez poszczególne instancje klienta.
- Sprawdź limity projektu i zarządzaj nimi w konsoli Google Cloud dla każdego bazowego interfejsu API.
Unikanie niespodziewanych rachunków dzięki alertom i limitom wydatków
Jeśli Twój projekt w Firebase jest objęty abonamentem Blaze (płatność według wykorzystania):
Skonfiguruj alerty dotyczące budżetu i limity wydatków.
Dalsze kroki
- Zapoznaj się z ogólną listą kontrolną dotyczącą zabezpieczeń Firebase.
- Zapoznaj się z ogólną listą kontrolną dotyczącą środowiska produkcyjnego Firebase AI Logic.
- Dowiedz się więcej o cenach i zarządzaniu kosztami w przypadku Firebase AI Logic.