Beginnen Sie mit der Verwendung von App Check in Unity-Apps

Auf dieser Seite erfahren Sie, wie Sie App Check in einer Unity-App aktivieren, indem Sie die Standardanbieter verwenden: Play Integrity auf Android und Device Check oder App Attest auf Apple-Plattformen. Wenn Sie App Check aktivieren, tragen Sie dazu bei, dass nur Ihre App auf die Firebase-Ressourcen Ihres Projekts zugreifen kann. Sehen Sie sich eine Übersicht über diese Funktion an.

1. Richten Sie Ihr Firebase-Projekt ein

  1. Fügen Sie Ihrem Unity-Projekt Firebase hinzu, falls Sie dies noch nicht getan haben.

  2. Registrieren Sie Ihre Apps für die Verwendung von App Check bei den Anbietern Play Integrity, Device Check oder App Attest im Abschnitt Project Settings > App Check der Firebase-Konsole.

    Normalerweise müssen Sie alle Apps Ihres Projekts registrieren, denn sobald Sie die Erzwingung für ein Firebase-Produkt aktivieren, können nur registrierte Apps auf die Back-End-Ressourcen des Produkts zugreifen.

    Ausführliche Anweisungen zur Registrierung bei jedem Anbieter finden Sie in der Android- und iOS-spezifischen Dokumentation.

  3. Optional : Legen Sie in den App-Registrierungseinstellungen eine benutzerdefinierte Gültigkeitsdauer (Time-to-Live, TTL) für vom Anbieter ausgestellte App Check-Token fest. Sie können die TTL auf einen beliebigen Wert zwischen 30 Minuten und 7 Tagen einstellen. Beachten Sie beim Ändern dieses Werts die folgenden Kompromisse:

    • Sicherheit: Kürzere TTLs bieten mehr Sicherheit, da sie das Fenster verkleinern, in dem ein durchgesickertes oder abgefangenes Token von einem Angreifer missbraucht werden kann.
    • Leistung: Kürzere TTLs bedeuten, dass Ihre App die Bestätigung häufiger durchführt. Da der App-Bestätigungsprozess bei jeder Ausführung Latenz für Netzwerkanforderungen hinzufügt, kann eine kurze TTL die Leistung Ihrer App beeinträchtigen.
    • Kontingent und Kosten: Kürzere TTLs und häufige Neubescheinigungen erschöpfen Ihr Kontingent schneller und kosten bei kostenpflichtigen Diensten möglicherweise mehr. Siehe Kontingente und Limits .

    Die Standard-TTL ist für die meisten Apps angemessen. Beachten Sie, dass die App Check-Bibliothek Token bei etwa der Hälfte der TTL-Dauer aktualisiert.

2. Fügen Sie Ihrer App die App Check-Bibliothek hinzu

Fügen Sie die App Check-Bibliothek in Ihren Satz von Abhängigkeiten ein, indem Sie die Einrichtungsanweisungen für App Check befolgen.

3. App-Check initialisieren

Fügen Sie Ihrer App den folgenden Initialisierungscode hinzu, damit sie ausgeführt wird, bevor Sie Firebase-Dienste verwenden, einschließlich der Erstellung von Firebase-Apps.

Android

  1. Fügen Sie die using-Deklaration für Firebase.AppCheck hinzu:

    using Firebase.AppCheck
  2. Initialisieren Sie die App Check-Bibliothek mit dem Play Integrity-Anbieter:

    FirebaseAppCheck.SetAppCheckProviderFactory(
        PlayIntegrityProviderFactory.Instance);
    

iOS+

  1. Fügen Sie die using-Deklaration für Firebase.AppCheck hinzu:

    using Firebase.AppCheck
  2. Initialisieren Sie die App Check-Bibliothek mit dem Device Check- oder App Attest-Anbieter:

    FirebaseAppCheck.SetAppCheckProviderFactory(
        DeviceCheckProviderFactory.Instance);
    

Nächste Schritte

Sobald die App Check-Bibliothek in Ihrer App installiert ist, beginnen Sie mit der Verteilung der aktualisierten App an Ihre Benutzer.

Die aktualisierte Client-App beginnt mit dem Senden von App-Check-Tokens zusammen mit jeder Anfrage, die sie an Firebase sendet, aber Firebase-Produkte verlangen nicht, dass die Tokens gültig sind, bis Sie die Erzwingung im Abschnitt „App-Check“ der Firebase-Konsole aktivieren.

Überwachen Sie Metriken und aktivieren Sie die Durchsetzung

Bevor Sie die Erzwingung aktivieren, sollten Sie jedoch sicherstellen, dass dadurch Ihre vorhandenen legitimen Benutzer nicht gestört werden. Wenn Sie andererseits eine verdächtige Nutzung Ihrer App-Ressourcen feststellen, sollten Sie die Erzwingung möglicherweise früher aktivieren.

Um diese Entscheidung zu treffen, können Sie sich die App Check-Metriken für die von Ihnen verwendeten Dienste ansehen:

App-Check-Erzwingung aktivieren

Wenn Sie verstehen, wie sich App Check auf Ihre Benutzer auswirkt, und Sie fortfahren möchten, können Sie die Erzwingung von App Check aktivieren:

Verwenden Sie App Check in Debug-Umgebungen

Wenn Sie Ihre App nach der Registrierung für App Check in einer Umgebung ausführen möchten, die App Check normalerweise nicht als gültig einstufen würde, z. B. auf dem Desktop, in einem Emulator während der Entwicklung oder in einer Continuous Integration (CI)-Umgebung können Sie einen Debugbuild Ihrer App erstellen, der den App Check-Debuganbieter anstelle eines echten Nachweisanbieters verwendet.

Siehe Verwenden von App Check mit dem Debug-Anbieter in Unity-Apps .