App Check mit dem Debugging-Anbieter für Flutter verwenden

Nachdem Sie Ihre App für App Check registriert haben, wird sie normalerweise nicht in einem Emulator oder in einer Continuous-Integration-Umgebung (CI) ausgeführt, da diese Umgebungen nicht als gültige Geräte gelten. Wenn Sie Ihre App während der Entwicklung und des Tests in einer solchen Umgebung ausführen möchten, können Sie einen Debug-Build Ihrer App erstellen, bei dem der App Check-Debuganbieter anstelle eines echten Attestierungsanbieters verwendet wird.

Warnung: Der Anbieter für die Fehlerbehebung erlaubt den Zugriff auf Ihre Firebase-Ressourcen von nicht bestätigten Geräten. Verwenden Sie den Debugging-Anbieter nicht in Produktions-Builds Ihrer App und geben Sie Ihre Debug-Builds nicht an nicht vertrauenswürdige Parteien weiter.

Apple-Plattformen

So verwenden Sie den Debuganbieter, während Sie Ihre App interaktiv in einem Simulator ausführen (z. B. während der Entwicklung):

1. Aktivieren Sie App Check mit dem Debugging-Anbieter direkt nach der Initialisierung Ihrer Firebase-App:

   import 'package:flutter/material.dart';
   import 'package:firebase_core/firebase_core.dart';
   
   // Import the firebase_app_check plugin
   import 'package:firebase_app_check/firebase_app_check.dart';
   
   Future<void> main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await Firebase.initializeApp();
     await FirebaseAppCheck.instance.activate(
       // Set appleProvider to `AppleProvider.debug`
       appleProvider: AppleProvider.debug,
     );
     runApp(App());
   }
   

2. Aktivieren Sie das Debugging-Logging in Ihrem Xcode-Projekt (Version 11.0 oder höher):

   1. Öffnen Sie Produkt > Schema > Schema bearbeiten.
   2. Wählen Sie im Menü auf der linken Seite Ausführen und dann den Tab Argumente aus.
   3. Fügen Sie im Abschnitt Arguments Passed on Launch (Beim Start übergebene Argumente) -FIRDebugEnabled hinzu.

3. Öffnen Sie ios/Runner.xcworkspace mit Xcode und führen Sie Ihre App im Simulator aus. Ihre App gibt ein lokales Fehlerbehebungstoken an die Debugging-Ausgabe aus, wenn Firebase versucht, eine Anfrage an das Back-End zu senden. Beispiel:

   Firebase App Check Debug Token:
   123a4567-b89c-12d3-e456-789012345678

4. Wählen Sie in der Firebase-Konsole im Bereich App Check im Dreipunkt-Menü Ihrer App die Option Debug-Tokens verwalten aus. Registrieren Sie dann das Debug-Token, das Sie im vorherigen Schritt protokolliert haben.

   

Nachdem Sie das Token registriert haben, wird es von den Firebase-Backend-Diensten als gültig akzeptiert.

Da mit diesem Token ohne gültiges Gerät auf Ihre Firebase-Ressourcen zugegriffen werden kann, ist es wichtig, dass Sie es für sich behalten. Übernehmen Sie kein Commit für ein öffentliches Repository. Sollte ein registriertes Token manipuliert werden, können Sie es sofort in der Firebase Console widerrufen.

Android

Wenn Sie den Debuganbieter verwenden möchten, während Sie Ihre Flutter-App in einer Android-Umgebung ausführen, implementieren Sie den folgenden Code in Ihrer Flutter-Anwendung:

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    webRecaptchaSiteKey: 'recaptcha-v3-site-key',
    // Set androidProvider to `AndroidProvider.debug`
    androidProvider: AndroidProvider.debug,
  );
  runApp(App());
}

Ihre App gibt ein lokales Fehlerbehebungstoken an die Debugging-Ausgabe aus, wenn Firebase versucht, eine Anfrage an das Back-End zu senden. Beispiel:

D DebugAppCheckProvider: Enter this debug secret into the allow list in
the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

1. Wählen Sie in der Firebase-Konsole im Bereich App Check im Dreipunkt-Menü Ihrer App die Option Debug-Tokens verwalten aus. Registrieren Sie dann das Debug-Token, das Sie im vorherigen Schritt protokolliert haben.

   

Nachdem Sie das Token registriert haben, wird es von den Firebase-Backend-Diensten als gültig akzeptiert.

Web

So verwenden Sie den Debuganbieter, während Sie Ihre App über localhost ausführen (z. B. während der Entwicklung):

Warnung: Versuchen Sie nicht, das Debugging für localhost zu aktivieren, indem Sie localhost den zulässigen Domains von reCAPTCHA hinzufügen. So könnte jeder Ihre App auf seinem lokalen Computer ausführen.

1. Aktivieren Sie in der Datei web/index.html den Fehlerbehebungsmodus, indem Sie self.FIREBASE_APPCHECK_DEBUG_TOKEN auf true setzen:

   <body>
     <script>
       self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
     </script>
   
     ...
   
   </body>
   

2. Führen Sie Ihre Webanwendung lokal aus und öffnen Sie die Entwicklertools des Browsers. In der Debug-Konsole wird ein Debug-Token angezeigt:

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will
   need to safelist it in the Firebase console for it to work.

   Dieses Token wird lokal in Ihrem Browser gespeichert und immer dann verwendet, wenn Sie Ihre Anwendung im selben Browser auf demselben Computer verwenden. Wenn Sie das Token in einem anderen Browser oder auf einem anderen Computer verwenden möchten, setzen Sie self.FIREBASE_APPCHECK_DEBUG_TOKEN anstelle von true als Token-String.

3. Wählen Sie in der Firebase-Konsole im Bereich App Check im Dreipunkt-Menü Ihrer App die Option Debug-Tokens verwalten aus. Registrieren Sie dann das Debug-Token, das Sie im vorherigen Schritt protokolliert haben.

   

Nachdem Sie das Token registriert haben, wird es von den Firebase-Backend-Diensten als gültig akzeptiert.

Da mit diesem Token ohne gültiges Gerät auf Ihre Firebase-Ressourcen zugegriffen werden kann, ist es wichtig, dass Sie es für sich behalten. Committen Sie es nicht in ein öffentliches Repository. Wenn ein registriertes Token manipuliert wird, widerrufen Sie es sofort in der Firebase Console.