App Check mit dem Debugging-Anbieter in Web-Apps verwenden

Wenn Sie Ihre Anwendung für App Check registriert haben und sie in einer Umgebung ausführen möchten, die von App Check normalerweise nicht als gültig eingestuft wird, z. B. lokal während der Entwicklung oder in einer Umgebung für kontinuierliche Integration (CI), können Sie einen Debug-Build Ihrer App erstellen, der den App Check-Debuganbieter anstelle eines echten Attestierungsanbieters verwendet.

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 Anwendung und geben Sie Ihre Debug-Builds nicht an nicht vertrauenswürdige Parteien weiter.

Debug-Anbieter auf localhost verwenden

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 localhost-Debugging zu aktivieren, indem Sie localhost zu den zulässigen Domains von reCAPTCHA hinzufügen. So könnte jeder Ihre App auf seinem lokalen Computer ausführen.

1. Aktivieren Sie in Ihrem Debug-Build den Debug-Modus, indem Sie self.FIREBASE_APPCHECK_DEBUG_TOKEN auf true festlegen, bevor Sie App Check initialisieren. Beispiel:

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   initializeAppCheck(app, { /* App Check options */ });
   

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   firebase.appCheck().activate(/* site key or provider */);
   

   Hinweis :In Firebase Web SDK-Versionen vor Version 9 wird self.FIREBASE_APPCHECK_DEBUG_TOKEN beim Importieren gelesen, nicht bei der Initialisierung oder Aktivierung. Daher musste es in index.html festgelegt werden, bevor das Code-Bundle geladen wurde. Führen Sie ein Upgrade auf Version 9 durch, um diese Einschränkung zu vermeiden.

2. Rufen Sie Ihre Webanwendung lokal auf 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.

3. Wählen Sie im Abschnitt App Check der Firebase-Konsole im Dreipunkt-Menü Ihrer App die Option Fehlerbehebungstokens 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 dieses Token den Zugriff auf Ihre Firebase-Ressourcen ohne gültiges Gerät ermöglicht, sollten Sie es unbedingt schützen. Übernehmen Sie kein Commit für ein öffentliches Repository und widerrufen Sie ein registriertes Token, das jemals kompromittiert wurde, sofort in der Firebase-Konsole.

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, legen Sie self.FIREBASE_APPCHECK_DEBUG_TOKEN auf den Tokenstring anstelle von true fest.

Debug-Anbieter in einer CI-Umgebung verwenden

So verwenden Sie den Debuganbieter in einer CI-Umgebung (Continuous Integration):

1. Wählen Sie in der Firebase-Konsole im Bereich App Check im Dreipunkt-Menü Ihrer App die Option Debug-Tokens verwalten aus. Erstellen Sie dann ein neues Debug-Token. Sie benötigen das Token im nächsten Schritt.

   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. Committe es nicht in ein öffentliches Repository. Wenn ein registriertes Token manipuliert wird, widerrufe es sofort in der Firebase-Konsole.

   

2. Fügen Sie das gerade erstellte Debug-Token dem sicheren Schlüsselspeicher Ihres CI-Systems hinzu (z. B. die verschlüsselten Geheimnisse von GitHub Actions oder die verschlüsselten Variablen von Travis CI).

3. Konfigurieren Sie bei Bedarf Ihr CI-System so, dass Ihr Debug-Token in der CI-Umgebung als Umgebungsvariable verfügbar ist. Geben Sie der Variablen einen Namen wie APP_CHECK_DEBUG_TOKEN_FROM_CI.

4. Aktivieren Sie in Ihrem Debug-Build den Debug-Modus, indem Sie self.FIREBASE_APPCHECK_DEBUG_TOKEN auf den Wert der Umgebungsvariablen für das Debug-Token festlegen, bevor Sie App Check importieren. Beispiel:

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = process.env.APP_CHECK_DEBUG_TOKEN_FROM_CI;
   initializeAppCheck(app, { /* App Check options */ });
   

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = process.env.APP_CHECK_DEBUG_TOKEN_FROM_CI;
   firebase.appCheck().activate(/* site key or provider */);
   

Wenn Ihre App in einer CI-Umgebung ausgeführt wird, akzeptieren die Firebase-Backenddienste das gesendete Token als gültig.