Messwerte für App Check-Anfragen überwachen

Nachdem Sie die App Check-Bibliothek zu Ihrer App hinzugefügt haben, aber bevor Sie die App Check-Erzwingung aktivieren, sollten Sie sicherstellen, dass dies Ihre bestehenden legitimen Nutzer nicht beeinträchtigt.

Ein wichtiges Tool, das Sie bei dieser Entscheidung unterstützt, sind die Messwerte für App Check-Anfragen. Sie können App Check-Messwerte in der Google API Console oder der Firebase Console im Blick behalten.

Messwerte in der Google API Console überwachen

Wenn Sie Messwerte für Ihren iOS-OAuth-Client aufrufen möchten, rufen Sie auf der Seite „Anmeldedaten“ die Bearbeitungsansicht des Clients auf. Dort sehen Sie rechts auf der Seite im Abschnitt Google Identity for iOS Messwerte. Diese Messwerte zeigen Ihnen die Messwerte für Ihre App Check-Anfragen. Die Messwerte enthalten die folgenden Informationen:

  • Anzahl der bestätigten Anfragen: Anfragen mit einem gültigen App Check-Token. Nachdem Sie die Erzwingung von App Check aktiviert haben, sind nur Anfragen in dieser Kategorie erfolgreich.
  • Anzahl der nicht verifizierten Anfragen: wahrscheinlich veraltete Clientanfragen – Anfragen ohne App Check-Token. Diese Anfragen stammen möglicherweise von einer älteren Version Ihrer App, die keine App Check-Implementierung enthält.
  • Anzahl der nicht bestätigten Anfragen: Anfragen unbekannten Ursprungs – Anfragen ohne App Check-Token, die nicht von Ihrer App zu stammen scheinen.
  • Anzahl der nicht bestätigten Anfragen: ungültige Anfragen – Anfragen mit einem ungültigen App Check-Token, was auf emulierte Umgebungen oder einen nicht authentischen Client zurückzuführen sein kann, der versucht, sich als Ihre App auszugeben.

Messwerte in der Firebase Console überwachen

Sie können Messwerte für Ihre Projekte insgesamt oder für einzelne OAuth-Clients aufrufen:

  • Wenn Sie die App Check-Anfragemesswerte für Ihr Projekt aufrufen möchten, öffnen Sie in der Firebase Console den Bereich App Check und maximieren Sie den Bereich Google Identity for iOS. Beispiel:

    Screenshot der Seite mit den App Check-Messwerten

  • Wenn Sie die App Check-Anfragemesswerte für einen bestimmten OAuth-Client aufrufen möchten, öffnen Sie in der Firebase Console die Seite OAuth-Clients und maximieren Sie den entsprechenden Abschnitt für den Client.

Die Anfragemesswerte sind in vier Kategorien unterteilt:

  • Bestätigte Anfragen sind Anfragen mit einem gültigen App Check-Token. Nachdem Sie die App Check-Erzwingung aktiviert haben, sind nur Anfragen in dieser Kategorie erfolgreich.

  • Veraltete Clientanfragen sind Anfragen, bei denen ein App Check-Token fehlt. Diese Anfragen stammen möglicherweise von einer älteren Version des Firebase SDK, bevor App Check in die App aufgenommen wurde.

  • Anfragen mit unbekanntem Ursprung sind Anfragen, die kein App Check-Token haben und nicht so aussehen, als ob sie vom Firebase SDK stammen. Diese können von Anfragen mit gestohlenen API-Schlüsseln oder gefälschten Anfragen ohne das Firebase SDK stammen.

  • Ungültige Anfragen sind Anfragen mit einem ungültigen App Check-Token, was auf emulierte Umgebungen oder einen nicht authentischen Client zurückzuführen sein kann, der versucht, sich als Ihre App auszugeben.

Die Verteilung dieser Kategorien für deine App sollte dir bei der Entscheidung helfen, wann du die Erzwingung aktivieren möchtest. Hier sind einige Richtlinien dafür:

  • Wenn fast alle aktuellen Anfragen von verifizierten Clients stammen, sollten Sie die Erzwingung aktivieren, um Ihre Authentifizierungsendpunkte zu schützen.

  • Wenn ein erheblicher Teil der letzten Anfragen von wahrscheinlich veralteten Clients stammt, sollten Sie warten, bis mehr Nutzer Ihre App aktualisiert haben, bevor Sie die Erzwingung aktivieren, um Nutzer nicht zu beeinträchtigen. Wenn Sie App Check für eine veröffentlichte App erzwingen, funktionieren frühere App-Versionen, die nicht in das App Check SDK eingebunden sind, nicht mehr.

  • Wenn Ihre App noch nicht veröffentlicht wurde, sollten Sie die App Check-Erzwingung sofort aktivieren, da keine veralteten Clients verwendet werden.

Nächste Schritte

Wenn Sie wissen, wie sich App Check auf Ihre Nutzer auswirkt, und Sie bereit sind, fortzufahren, können Sie die Erzwingung von App Check aktivieren.