Erste Schritte mit App Check in Unity-Apps

Auf dieser Seite erfahren Sie, wie Sie App Check in einer Unity-App mit den Standardanbietern aktivieren: Play Integrity auf Android-Geräten und Device Check oder App Attest auf Apple-Plattformen. Wenn Sie App Check aktivieren, sorgen Sie dafür, nur Ihre App kann auf die Firebase-Ressourcen Ihres Projekts zugreifen. Hier finden Sie eine Übersicht.

1. Das Firebase-Projekt einrichten

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

  2. Registrieren Sie Ihre Apps für die Verwendung von App Check mit Play Integrity, Device Check oder App Attest-Anbieter in der Projekteinstellungen > App Check der Firebase Console.

    Normalerweise müssen Sie alle Apps Ihres Projekts registrieren, da nur registrierte Apps auf die Backend-Ressourcen eines Firebase-Produkts zugreifen können, wenn Sie die Erzwingung für ein Firebase-Produkt aktivieren.

    Eine ausführliche Anleitung für die Registrierung bei den einzelnen Anbietern finden Sie unter der Dokumentation für Android und iOS.

  3. Optional: Legen Sie in den Einstellungen für die App-Registrierung eine benutzerdefinierte Gültigkeitsdauer fest. (TTL) für App Check-Tokens, die vom Anbieter ausgestellt wurden. Sie können die TTL auf einen beliebigen Wert zwischen 30 Minuten und 7 Tagen festlegen. Wenn Sie diesen Wert ändern, ist sich der folgenden Vor- und Nachteile bewusst:

    • Sicherheit: Kürzere TTLs bieten eine höhere Sicherheit, da das Zeitfenster verkürzt wird, in dem ein gehacktes oder abgefangenes Token von einem Angreifer missbraucht werden kann.
    • Leistung: Kürzere TTLs bedeuten, dass deine App die Attestierung mehr ausführt. häufig auftreten. Da der App-Attestierungsprozess bei jeder Ausführung zu einer Latenz bei Netzwerkanfragen führt, kann eine kurze TTL sich auf die Leistung Ihrer App auswirken.
    • Kontingent und Kosten: Kürzere TTLs und häufige erneute Attestierungen erschöpfen Ihr schnelleren Kontingenten und kosten kostenpflichtige Dienste unter Umständen mehr. Weitere Informationen finden Sie unter Kontingente und Limits.

    Die Standard-TTL ist für die meisten Apps angemessen. Hinweis: Die App Check-Bibliothek aktualisiert Tokens ungefähr bei der Hälfte der TTL-Dauer.

2. App Check-Bibliothek zu Ihrer App hinzufügen

Fügen Sie die App Check-Bibliothek wie folgt in die Abhängigkeiten ein: Anleitung zur Einrichtung von App Check.

3. App Check initialisieren

Fügen Sie Ihrer App den folgenden Initialisierungscode hinzu, damit sie ausgeführt wird, bevor Sie Firebase-Dienste zu nutzen, 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. App Check-Bibliothek mit Device Check oder App Attest initialisieren Anbieter:

    FirebaseAppCheck.SetAppCheckProviderFactory(
    DeviceCheckProviderFactory.Instance);

Nächste Schritte

Sobald die App Check-Bibliothek in Ihrer App installiert ist, können Sie die eine aktualisierte App für Ihre Nutzer bereitzustellen.

Die aktualisierte Client-App sendet dann App Check-Tokens mit jeder Anfrage an Firebase. Die Tokens müssen jedoch erst gültig sein, wenn Sie die Erzwingung im Abschnitt „App Check“ der Firebase Console aktivieren.

Messwerte beobachten und Erzwingung aktivieren

Bevor Sie die Erzwingung aktivieren, sollten Sie jedoch prüfen, ob dies die Nutzung für Ihre bestehenden rechtmäßigen Nutzer nicht beeinträchtigt. Wenn Sie jedoch eine verdächtige Nutzung Ihrer App-Ressourcen feststellen, sollten Sie die Erzwingung früher aktivieren.

Bei der Entscheidung können Sie sich die App-Check-Messwerte für die von Ihnen verwendeten Dienste ansehen:

App Check-Erzwingung aktivieren

Wenn Sie die Auswirkungen von App Check auf Ihre Nutzer verstehen und bereit sind, können Sie die App Check-Erzwingung aktivieren:

App Check in Debug-Umgebungen verwenden

Wenn Sie Ihre App nach der Registrierung für App Check App Check in einer Umgebung, die normalerweise nicht als gültig eingestuft wird, etwa auf einem Desktop-Computer, in einem Emulator während der Entwicklung oder aus einem Integrationsumgebung (CI) können Sie einen Debug-Build Ihrer App erstellen, der verwendet den App Check-Debug-Anbieter anstelle eines echten Attestierungsanbieters.

Weitere Informationen finden Sie unter App Check mit dem Debugging-Anbieter in Unity-Apps verwenden.