Sicherheitscheckliste für die Verwendung von Firebase AI Logic

Wenn Sie die Gemini API direkt über Ihre mobilen und Web-Apps aufrufen, ist ein mehrstufiger Defense-in-Depth-Ansatz erforderlich, um Ihre Backend-Infrastruktur, Ihr Kontingent und Ihre proprietären Prompts zu schützen. Sehen Sie sich diese Checkliste an, um empfohlene Best Practices für die Sicherheit von Firebase AI Logic zu implementieren.

App-, Geräte- und Nutzerbestätigung

Prüfen Sie, ob eingehende Anfragen von legitimen, nicht manipulierten Instanzen Ihrer App stammen, die auf authentischen Geräten ausgeführt werden, und ob sie von authentischen Nutzern stammen.

Erzwingen Firebase App Check

Erzwingen Sie Firebase App Check, um die Gemini API vor Missbrauch zu schützen, wenn sie direkt von Ihrer App aufgerufen wird. Wenn App Check erzwungen wird, wird geprüft, ob eingehende Anfragen von Ihrer authentischen App und/oder einem nicht manipulierten Gerät stammen.

App Check unterstützt Attestierungsanbieter für Apple-Plattformen (DeviceCheck, App Attest oder reCAPTCHA Enterprise), Android (Play Integrity oder reCAPTCHA Enterprise) und das Web (reCAPTCHA Enterprise). Alle diese Anbieter werden auch für Flutter- und Unity-Apps unterstützt.

Ab Anfang Juli 2026 erzwingt Firebase automatisch App Check für Firebase AI Logic während der geführten Einrichtung in der Firebase-Konsole. Wenn Sie Firebase AI Logic zuvor eingerichtet haben, müssen Sie App Check explizit erzwingen. Für die lokale Entwicklung können Sie den App Check Debug-Anbieter einrichten und Ihre App dann bei einem Produktionsattestierungsanbieter registrieren, bevor Sie sie für Endnutzer veröffentlichen.

Schutz vor Replay-Angriffen mit Tokens mit eingeschränkter Nutzung aktivieren

Im Rahmen der Einrichtung von App Check sollten Sie die Erzwingung des Schutzes vor Replay-Angriffen in Betracht ziehen, damit App Check-Tokens nur einmal verwendet werden können. Diese Option bietet erweiterten Schutz, der über den grundlegenden Schutz hinausgeht. Sie können damit ein angemessenes Schutzniveau für Ihre Anwendung und Anwendungsfälle festlegen.

Einschränkungen für Firebase API-Schlüssel einrichten

Firebase-API-Schlüssel identifizieren Ihr Firebase-Projekt und Ihre App bei Anfragen. So verhindern Sie die unbefugte Nutzung Ihrer API-Schlüssel:

  • Legen Sie in der Google Cloud-Konsole Anwendungseinschränkungen fest, um die Schlüsselnutzung auf Anfragen von der spezifischen Paket-ID (Apple), dem Paketnamen und dem SHA-1-Fingerabdruck (Android) oder dem HTTP-Referrer (Web) Ihrer App zu beschränken.

  • Prüfen Sie die Zulassungsliste API-Einschränkungen für jeden Schlüssel:

    • Achten Sie darauf, dass die Firebase AI Logic API (firebasevertexai.googleapis.com) auf der Zulassungsliste steht.
    • Achten Sie darauf, dass die einzigen anderen APIs auf der Zulassungsliste die spezifischen Firebase-Dienste sind, die Ihre App benötigt. Weitere Informationen finden Sie in der Liste der erforderlichen APIs für eingeschränkte Firebase-Schlüssel.

Beachten Sie, dass Firebase-bezogene APIs API-Schlüssel nur zur Identifizierung des Firebase-Projekts oder der Firebase-App verwenden, nicht zur Autorisierung des API-Aufrufs.

Anfragen auf authentifizierte Nutzer beschränken

Sie können den Modus „Authentifizierte Nutzer“ erzwingen, sodass alle Anfragen über Firebase AI Logic gültige Anmeldedaten von Firebase Authentication enthalten müssen. Wenn eine Anfrage von einem nicht authentifizierten Endnutzer stammt, wird sie mit dem Fehler 401: unauthenticated abgelehnt.

Prompt-Schutz und Anfragehärtung

Verhindern Sie, dass Ihre Prompt-Designs durch Dekompilierung des Clients offengelegt werden, und sichern Sie Ihr Backend, damit böswillige Nutzer keine beliebigen Prompts ausführen können.

Server-Promptvorlagen verwenden

Verwenden Sie Server-Prompt-Vorlagen, um Prompts, Systemanweisungen und Modellkonfigurationen sicher in der Cloud zu speichern, anstatt sie im Client-Anwendungscode hartzucodieren, wo sie durch binäre Dekompilierung extrahiert werden können.

Ihre App verweist nur auf eine Vorlagen-ID und übergibt dynamische Eingabevariablen. Mit Server-Prompt-Vorlagen können Sie auch Prompts aktualisieren oder Modelle bei Bedarf wechseln, ohne eine neue Version Ihrer App veröffentlichen zu müssen.

Vom Client bereitgestellte Vorlagenvariablen validieren und bereinigen

Server-Prompt-Vorlagen schützen Ihr Prompt-Design, aber Vorlagen, die dynamische Variablen akzeptieren, können weiterhin anfällig für Prompt Injection sein. Da Vorlagen die Eingabevariablen des Nutzers in den endgültigen Prompt einfügen, sollten Sie Folgendes tun:

  • Validieren und bereinigen Sie alle Nutzereingaben auf dem Client, bevor Sie Variablen an eine Vorlage übergeben. Erzwingen Sie beispielsweise Zeichenbeschränkungen und erwartete Formate.
  • Fügen Sie Ihren Vorlagen klare Systemanweisungen hinzu, die Leitlinien für die Verarbeitung von Nutzereingaben definieren.

Vorlagenmodus erzwingen

Sie können den Nur-Vorlagen-Modus erzwingen, sobald alle Ihre App-Funktionen Server-Prompt-Vorlagen verwenden. Wenn die Richtlinie erzwungen wird, blockiert Firebase AI Logic alle direkten, nicht vorlagenbasierten Anfragen an die Gemini API (403: unauthorized). So wird verhindert, dass böswillige Akteure beliebige Prompts senden oder Ihr Kontingent missbrauchen.

Monitoring, Limits und Abrechnung

Sie erhalten Einblick in eingehenden Traffic und Sicherheitsanomalien und können Ihr Projekt vor unerwarteten Nutzungsspitzen oder ausufernden Kosten schützen.

KI-Monitoring in der Firebase-Konsole einrichten

Richten Sie KI-Monitoring in der Firebase-Konsole ein, um Einblick in wichtige Messwerte wie Anfrageanzahl, Latenz, Tokennutzung und Fehlerraten (einschließlich 401-Authentifizierungsfehlern und 403-Nur-Vorlagen-Blöcken) zu erhalten. Sie können sich auch einzelne Traces in der Google Cloud-Konsole ansehen.

Ratenbegrenzungen festlegen und Kontingente verwalten

So schützen Sie Ihr Projekt vor unerwarteten Nutzungsspitzen und Denial-of-Wallet-Angriffen:

Unerwartete Rechnungen mit Benachrichtigungen und Ausgabenobergrenzen vermeiden

Wenn für Ihr Firebase-Projekt das Blaze-Preismodell (Pay as you go) gilt:

Nächste Schritte