App Check mit dem Debug-Anbieter mit C++ verwenden

Nachdem App Check für einen Backend-Dienst erzwungen wurde, werden die Funktionen Ihrer App, die von diesem Backend-Dienst abhängen, 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 Testens in diesen Umgebungen ausführen möchten, müssen Sie einen Debug-Build Ihrer App erstellen, der den App Check-Debug-Anbieter anstelle eines Attestierungsanbieters für die Produktion verwendet.

Konfiguration über Code

So verwenden Sie den Debugging-Anbieter, während Sie Ihre App interaktiv in einem Emulator ausführen (z. B. während der lokalen Entwicklung):

  1. Erstellen Sie in der Firebase-Konsole ein Debug-Token:

    1. Rufen Sie in der Firebase-Konsole den Tab Apps unter Sicherheit > App Check auf.

    2. Suchen Sie Ihre App, klicken Sie auf das Dreipunkt-Menü  und wählen Sie dann Debug-Tokens verwalten aus.

    3. Folgen Sie der Anleitung auf dem Bildschirm, um ein neues Debug-Token zu erstellen.

    Mit diesem Token kann ohne gültiges Gerät auf Ihre Backend-Dienste zugegriffen werden. Es ist daher wichtig, dass Sie es vertraulich behandeln. Übertragen Sie es nicht in ein öffentliches Repository und geben Sie es nicht in Produktions-Builds Ihrer App an. Wenn ein registriertes Token jemals manipuliert wird, löschen Sie es sofort über Debug-Tokens verwalten in der Firebase-Konsole.

    Screenshot des Menüs „Debug-Tokens verwalten“ in der Firebase Console

  2. Führen Sie im Initialisierungscode Ihrer App die folgenden Schritte aus:

    #include "firebase/app_check.h"
    
    void InitializeFirebase() {
      // Configure the Debug Provider factory with your debug token.
      firebase::app_check::DebugAppCheckProviderFactory::GetInstance()
        ->SetDebugToken("YOUR_DEBUG_TOKEN");
    
      // Set App Check to use the debug provider factory
      firebase::app_check::AppCheck::SetAppCheckProviderFactory(
        firebase::app_check::DebugAppCheckProviderFactory::GetInstance());
    
      // Proceed to initialize Firebase as normal
    }
    

Weitere Konfigurationsoptionen

Je nach Plattform sind weitere Konfigurationsoptionen verfügbar, z. B. über die Umgebungsvariablen der Plattformen. Weitere Informationen finden Sie in der Dokumentation zum Debugging-Anbieter für iOS+ oder Android.

Mit diesem Token kann ohne gültiges Gerät auf Ihre Backend-Dienste zugegriffen werden. Es ist daher wichtig, dass Sie es vertraulich behandeln. Übertragen Sie es nicht in ein öffentliches Repository und geben Sie es nicht in Produktions-Builds Ihrer App an. Wenn ein registriertes Token jemals manipuliert wird, löschen Sie es sofort über Debug-Tokens verwalten in der Firebase-Konsole.