Google Play Integrity API implementieren und migrieren auf Google Play
1. Die Migration ist nicht optional – SafetyNet ist vollständig abgeschaltet. Google erklärt in seiner Deprecation-Zeitleiste: „Die SafetyNet Attestation API wurde 2022 eingestellt und im Januar 2025 vollständig abgeschaltet. Entwickler sollten zur Play Integrity API migrieren, die mehrere Integritätsangebote (einschließlich des Integritätsurteils der SafetyNet Attestation) unter einer einzigen API bündelt.“ Jeder noch vorhandene Aufruf schlägt jetzt fehl: „Wenn Sie versuchen, die SafetyNet Attestation API aufzurufen, erhalten Sie einen Fehler. Die Attest-API gibt eine Task zurück, die immer den onFailure-Listener mit einer ApiException und dem Statuscode 7 (NETWORK_ERROR) aufruft.“ Wenn Sie noch eine Version ausliefern, die SafetyNet aufruft, fordern Sie Ihre Nutzer zum Update auf. (https://developer.android.com/privacy-and-security/safetynet/deprecation-timeline)
2. Was die API tatsächlich verifiziert. „Die Play Integrity API hilft Ihnen zu prüfen, ob Nutzeraktionen und Serveranfragen aus Ihrer echten App stammen, die von Google Play installiert wurde und auf einem echten und zertifizierten Android-Gerät läuft." Sie liefert drei zentrale Urteile: accountDetails (nicht autorisierter Zugriff – ob der Nutzer die App auf Google Play installiert oder bezahlt hat), appIntegrity (Code-Manipulation – ob das Binary das unveränderte ist, das Google Play erkennt) und deviceIntegrity (riskante Geräte und emulierte Umgebungen – ein echtes zertifiziertes Android-Gerät oder eine echte Instanz von Google Play Games for PC). Optionale Urteile ergänzen MEETS_STRONG_INTEGRITY (aktuelle Sicherheitsupdates, Android 13+), appAccessRiskVerdict (Bildschirmaufnahme, Overlays und Barrierefreiheits-Missbrauch durch andere Apps), playProtectVerdict (Play Protect aktiv und keine gefährlichen Apps), recentDeviceActivity (anomal hohes Anfragevolumen) und deviceRecall (Beta). (https://developer.android.com/google/play/integrity/overview)
3. Erstellen und verknüpfen Sie ein Google Cloud-Projekt. „Um die API zu integrieren, benötigen Sie ein Google Cloud-Projekt … Anschließend können Sie Ihr Google Cloud-Projekt in der Google Play Console (für Apps) oder der Google Play SDK Console (für SDKs) verknüpfen. Das Verknüpfen Ihres Projekts ist erforderlich", um die erweiterten Funktionen und höhere Kontingente freizuschalten. Sie können die Play Integrity API in der Google Cloud Console aktivieren, oder Sie verknüpfen zuerst, dann wird sie automatisch aktiviert. Achten Sie auf die Falle: „Projekte, die in der Google Cloud Console aktiviert, aber nicht in der Play Console oder Play SDK Console verknüpft sind, haben keinen Anspruch auf zusätzliche Funktionen." (https://developer.android.com/google/play/integrity/setup)
4. Wählen Sie zwischen Standard- und Classic-Anfragen – sie unterscheiden sich in Latenz und Caching. Standard-Anfragen haben die geringste Latenz („durchschnittlich einige hundert Millisekunden") und eine hohe Zuverlässigkeit, ein verwertbares Urteil zu erhalten, nutzen intelligentes Caching auf dem Gerät und delegieren den Schutz vor bestimmten Angriffen an Google Play; Sie bereiten den Token-Provider einmal vor („Warm-up") – eine Instanz „kann das Integritäts-Token nur bis zu 5-mal pro Minute vorbereiten" – und fordern dann bei Bedarf ein Token an. Classic-Anfragen, der ursprüngliche Weg, haben eine höhere Latenz („durchschnittlich einige Sekunden"), lösen eine neue Bewertung aus, die mehr Nutzerdaten und Akku verbraucht, und überlassen bestimmte Gegenmaßnahmen Ihnen, weshalb sie „selten als einmalige Aktion" für eine hochsensible oder wertvolle Aktion erfolgen sollten. Beide erfordern Android 6.0 (API-Level 23) oder höher. Ausdrückliche Regel: „Wenn Sie erwägen, eine Classic-Anfrage zu stellen und sie für die spätere Verwendung zu cachen, sollten Sie stattdessen eine Standard-Anfrage stellen, um das Risiko von Angriffen zu verringern." (https://developer.android.com/google/play/integrity/overview, https://developer.android.com/google/play/integrity/standard)
5. Verifizieren Sie auf Ihrem Server, niemals auf dem Client. Der Ablauf: Die App richtet den Token-Provider mit Ihrer Google Cloud-Projektnummer ein; sie fordert ein Integritätstoken an und übergibt dabei einen Request-Hash; sie erhält ein signiertes und verschlüsseltes Token und leitet es an Ihr Backend weiter; dann „sendet das Backend Ihrer App das Token an einen Google Play-Server. Der Google Play-Server entschlüsselt und verifiziert das Urteil und gibt die Ergebnisse an das Backend Ihrer App zurück." Setzen Sie das Urteil nur im Backend durch – eine clientseitige Prüfung lässt sich herauspatchten. (https://developer.android.com/google/play/integrity/standard)
6. Binden Sie Tokens an die konkrete Anfrage. Standardanfragen sind an einen Anfrage-Hash gebunden, den Sie beim Anfordern des Tokens angeben; klassische Anfragen verwenden das Nonce-Feld mit Inhaltsbindung auf Basis der Anfragedaten oder serverseitiger Logik. Cachen und verwenden Sie Ergebnisse nicht wieder: „Das Cachen eines Ergebnisses erhöht das Risiko von Angriffen wie Exfiltration und Replay." Wenn Sie kurz davor waren, ein klassisches Ergebnis für später zu cachen, wechseln Sie zu einer Standardanfrage. (https://developer.android.com/google/play/integrity/classic)
7. Halten Sie das Kontingent ein. „Standardmäßig kann Ihre App über alle Installationen hinweg bis zu 10.000 Anfragen pro Tag stellen" — Sie können ein höheres Tagesmaximum beantragen, aber kalkulieren Sie damit und richten Sie den Token-Provider selten ein (bis zu 5 Mal pro Minute pro Instanz). (https://developer.android.com/google/play/integrity/overview)
8. Führen Sie Urteile ein, ohne legitime Nutzer zu beeinträchtigen. Die ausdrückliche Empfehlung von Google: „implement the API without enforcement“ zuerst, „gather telemetry and understand your audience before taking action“, dann die Auswirkungen jeder geplanten Durchsetzung abschätzen und Ihre Anti-Missbrauchsstrategie anpassen. Behandeln Sie die API als ein Signal, nicht als die gesamte Strategie: „The Play Integrity API works best when used alongside other signals as part of your overall anti-abuse strategy and not as your sole anti-abuse mechanism.“ Die API ist auf Smartphones, Tablets, Foldables, Android Auto, Android TV, Android XR, ChromeOS, Wear OS und Google Play Games on PC verfügbar. (https://developer.android.com/google/play/integrity/overview)
Versions- und Kontingentgrenzen (geprüft anhand der Seiten von Google am 13.10.2026):
Bibliotheksversionen. Aktuelle Releases (die 1.5.x-Reihe) erfordern Android API-Level 23 (Android 6.0) oder höher für Standard- und klassische Anfragen; die 1.4.0-Reihe unterstützte API-Level 21 (Android 5.0) und höher. Prüfen Sie das Minimum für die exakte Version, die Sie ausliefern, in den Versionshinweisen der Bibliothek statt in einem Tutorial.
Kontingenttypen. Das Standardlimit liegt bei 10.000 Anfragen pro Tag, gebunden an die zugehörige Cloud-Projektnummer, und Google führt Token-Anfragen (clientseitig) und Token-Entschlüsselungen (serverseitig) als getrennte Kontingentaktionen – häufige clientseitige Anfragen verbrauchen nicht automatisch das serverseitige Entschlüsselungskontingent. Für höhere Volumen beantragen Sie eine Kontingenterhöhung bei Google.
Projektverknüpfung. Die API benötigt ein Google Cloud-Projekt, das in der Play Console mit Ihrer App verknüpft ist (oder im Play SDK Console mit Ihrem SDK). Das Kontingent hängt an dieser Projektnummer, daher teilen sich Apps mit demselben Cloud-Projekt ein Limit.