KappS Wissensdatenbank · FAQ

Code-Obfuskierung und Schutz vor Reverse Engineering auf Google Play

FAQ Sicherheit

1. Was Google tatsächlich verlangt. Die Vorgabe von Google lautet nicht „Verschleiern, um Geheimnisse zu verbergen“, sondern „Minifizieren und Verschleiern, damit Reverse Engineering teurer wird, und die eigentlichen Sicherheitsprüfungen auf Ihrem Server belassen“. Die Build-Dokumentation von Android (https://developer.android.com/build/shrink-code) beschreibt R8 als Standard-Code-Shrinker im Android-Gradle-Plugin: Er führt Tree Shaking, Ressourcenverkleinerung, Optimierung und Umbenennung von Bezeichnern (Obfuskation) in einem Durchgang aus, und Google stellt ausdrücklich klar, dass „Obfuskation für sich genommen kein Sicherheitsmerkmal ist“ – sie erhöht die Kosten für beiläufiges Reverse Engineering, macht einen Client aber nicht vertrauenswürdig. Der Sicherheitsleitfaden für Entwickler (https://developer.android.com/privacy-and-security/security-best-practices) sagt dasselbe aus der anderen Perspektive: Veröffentlichen Sie niemals Geheimnisse, API-Schlüssel oder serverseitige Logik im APK, denn alles auf dem Gerät kann ausgelesen werden.

2. Aktivieren Sie R8 für Release-Builds. Im build.gradle(.kts) Ihres App-Moduls sollte der Release-Build-Typ minifyEnabled true (das ist R8, das ProGuard-kompatibel ist) und shrinkResources true setzen und auf proguard-rules.pro verweisen. Das Ressourcen-Shrinking entfernt ungenutzte Ressourcen und funktioniert nur, wenn minifyEnabled ebenfalls aktiviert ist. R8 verwendet die optimierte Standardregeldatei (proguard-android-optimize.txt) und wendet daher über das Shrinking hinaus auch Optimierungen wie Method Inlining, Klassen-Zusammenführung und das Entfernen ungenutzter Argumente an. Überprüfen Sie die Wirkung, indem Sie die Größe des Debug- und des Release-Artefakts vergleichen und build/outputs/mapping/release/mapping.txt lesen.

3. Keep-Regeln sind die Ursache der meisten Abstürze im Release. R8 benennt alles um und löscht alles, was es für unerreichbar hält – auch Typen, deren reflektive Verwendung es nicht erkennen kann. Die üblichen Verdächtigen sind JSON-Parser (Gson/Moshi/Jackson-Datenklassen), Retrofit-Interfaces und ihre @SerializedName-Modelle, Room-Entities, kotlinx.serialization, ViewBinding/DataBinding, Parcelable, per XML aufgeblasene Custom Views und alles, was über den Klassennamen geladen wird (Class.forName, JNI, Service Loader). Typische Symptome in der Produktion sind NoSuchMethodException, ClassNotFoundException, leere oder umbenannte JSON-Felder oder ein Absturz, der nur im Release und nie im Debug auftritt. Fügen Sie enge -keep-Regeln hinzu (zum Beispiel -keep class com.example.model.** { *; } für DTOs, -keepclassmembers für @SerializedName-Felder), statt alles per -keep zu schützen, und testen Sie immer den Release-Build, nicht nur Debug. Kotlin benötigt oft -keepclassmembers class **$WhenMappings plus Metadaten-Regeln; AndroidX liefert eigene Consumer-Regeln mit, die R8 automatisch zusammenführt.

4. Laden Sie mapping.txt hoch, damit Absturzberichte lesbar bleiben. R8 schreibt build/app/outputs/mapping/release/mapping.txt (plus configuration.txt und seeds.txt). Laden Sie diese Datei mit dem Release in die Play Console hoch oder lassen Sie es Ihre Release-Pipeline tun, damit die Play Console Stack-Traces und ANRs für Sie deobfuskiert. Ohne sie sieht jeder Produktionsabsturz wie a.a.a.b(Unknown Source) aus und Sie verlieren die Möglichkeit zur Triage. Bewahren Sie das Mapping für jede ausgelieferte Version auf – ein neu gebautes Release braucht eine neue Mapping-Datei.

5. Legen Sie die Sicherheitsentscheidung niemals auf den Client. Das ist der mit Abstand häufigste Designfehler: ein Flag wie isPremium / LicenseValid / IsTampered auszuliefern, das die App lokal auswertet. Alles, was der Client entscheidet, kann der Client patchen — eine Änderung von einem Byte mit apktool oder ein Frida-Hook kippt das Flag. Verlagern Sie die Entscheidung auf Ihr Backend: Die App sollte Belege senden (ein Token, ein Kauftoken, ein Integritätsurteil), und der Server sollte entscheiden. Konkret: Verifizieren Sie Google Play-Billing-Käufe serverseitig mit der Play Developer API (purchases.subscriptionsv2 / purchases.products), statt der Bestätigung auf dem Gerät zu vertrauen, und behandeln Sie jede „Lizenzprüfung“, die das Gerät nie verlässt, als Dekoration, nicht als Schutz.

6. Die Play Integrity API ist der unterstützte Weg, um dieses serverseitige Urteil zu erhalten. Die Play Integrity API (https://developer.android.com/google/play/integrity) ersetzt die veraltete SafetyNet Attestation API. Ihre App ruft sie auf und erhält ein verschlüsseltes, signiertes und kurzlebiges Integritätsurteil, das von den Servern von Google (oder von Ihrem Backend, das die Play Integrity API aufruft) entschlüsselt und verifiziert werden muss – nicht auf dem Gerät. Das Urteil enthält Signale zur Geräteintegrität (MEETS_BASIC_INTEGRITY / MEETS_DEVICE_INTEGRITY / MEETS_STRONG_INTEGRITY), ein Signal zur App-Integrität (die Binärdatei entspricht dem, was Sie hochgeladen haben, was neu verpackte oder veränderte APKs erkennt) sowie Konto- und Lizenzsignale (PLAY_RECOGNITION / LICENSED). Verwenden Sie Standard-Anfragen (empfohlen) statt Classic-Anfragen, die den Legacy-Ablauf darstellen. Sie konfigurieren die API für Ihre App in der Play Console unter App-Integrität und können dort die Fehlerquoten der Urteile beobachten. Ein fehlgeschlagenes Urteil ist ein Signal, kein Beweis – Google warnt davor, ein einzelnes fehlerhaftes Gerät entscheiden zu lassen. Achten Sie daher auf Muster und Anomalien in den Raten und sperren Sie ehrliche Nutzer nicht aus. Das tägliche Anfragekontingent skaliert mit der Installationsbasis (standardmäßig 10.000/Tag); höhere Limits fordern Sie über das Formular an, das unter https://support.google.com/googleplay/android-developer/answer/11395166. verlinkt ist

7. Signierung, Manipulationserkennung und Plays Ein-Klick-Schutz. Zwei Ebenen. (a) App-Signierung: Moderne Apps nutzen das APK-Signaturschema v2/v3 (v4 für schnelle Installation). Mit Play App Signing hält Google den App-Signaturschlüssel, während Sie den Upload-Schlüssel behalten, sodass ein gestohlener Keystore nicht mehr einer übernommenen App gleichkommt und der Upload-Schlüssel rotiert werden kann. Sie können das Zertifikat der App zur Laufzeit mit dem erwarteten vergleichen, aber bedenken Sie, dass diese Prüfung selbst patchbar ist — nutzen Sie sie als serverseitiges Signal. (b) Der automatische Schutz von Google Play („Protected with Play", https://support.google.com/googleplay/android-developer/answer/13857328) ist ein Ein-Klick-Schalter in der Play Console, der Laufzeit-Anti-Tamper- und Anti-Piraterie-Erkennung in die App einbettet und meldet, wenn ein installiertes Binary nicht mit der Store-Version übereinstimmt; er erfordert keine Backend-Integration Ihrerseits. Kombinieren Sie ihn mit dem App-Integritätsurteil von Play Integrity, statt sich auf eines von beiden allein zu verlassen.

8. Härten Sie den Client, aber gehen Sie davon aus, dass er gelesen wird. Über die Obfuskation hinaus: Halten Sie debuggable auf false und entfernen Sie android:debuggable; entfernen Sie Logs im Release (R8 kann Log.d über -assumenosideeffects entfernen, oder Sie erhöhen das Log-Level); hardcodieren Sie keine API-Schlüssel, Tokens oder Endpunkte – rufen Sie sie zur Laufzeit ab und rotieren Sie sie; speichern Sie geräteseitige Schlüssel im Android Keystore (https://developer.android.com/privacy-and-security/keystore), statt sie einzubetten; fügen Sie Certificate-/Public-Key-Pinning hinzu, damit ein gefälschter Server oder ein MITM-Proxy Ihre App nicht steuern kann; behandeln Sie Root-/Emulator-/Debugger-Erkennung nur als weiches Signal (leicht zu umgehen, aber sie erhöht den Aufwand und stoppt das durchschnittliche Skript); obfuskieren oder verschlüsseln Sie wertvolle String-Konstanten (Endpunkte, Feature-Flags) mit R8-String-Obfuskation oder einem kommerziellen Härtungstool, wenn das Asset es rechtfertigt; und verlagern Sie sensible Logik nur dann in NDK-/nativen Code, wenn Sie die Build-Komplexität akzeptieren – nativ ist schwerer, nicht unmöglich, zu reverse-engineeren.

9. Die Richtlinien-Dimension: Klone, Repackaging und die Grenzen der Obfuskation. Die eigene App zu obfuskieren ist legitim und wird empfohlen; Obfuskation zu nutzen, um richtlinienverletzendes Verhalten vor der Prüfung durch Google zu verbergen, ist es nicht. Die Developer Program Policy von Google (https://support.google.com/googleplay/android-developer/answer/17190352) sowie die Richtlinien zu Malware (https://support.google.com/googleplay/android-developer/answer/9888380), Mobile Unwanted Software (https://support.google.com/googleplay/android-developer/answer/9970222) und Deceptive Behavior (https://support.google.com/googleplay/android-developer/answer/16680223) verbieten Apps, die täuschend sind, die Datenerhebung oder Funktionalität verschleiern oder die Geräte-, Netzwerk- oder personenbezogene Daten missbrauchen; eine App, die nur funktioniert, weil ihr Verhalten verborgen ist, scheitert an der Prüfung und wird, falls nach dem Launch entdeckt, entfernt. Auf der anderen Seite ist schwacher Client-Schutz genau das, was anderen ermöglicht, Ihre App neu zu verpacken, Ihre Abrechnung zu umgehen oder sie zu klonen – dieselben Richtlinienseiten zitieren Sie, wenn Sie eine IP- oder Malware-Meldung gegen eine Raubkopie einreichen, und die Identitätstäuschungs-/Nachahmungsregeln von Play decken Nachahmer ab, die Ihre Identität kopieren. Melden Sie rechtsverletzende oder bösartige Klone über das IP-Beschwerdeformular der Play Console und die Meldewege der Richtlinien.

10. Selbst-Audit per Dekompilierung vor dem Release (einmal pro Release durchführen). (1) Das Release-AAB/APK bauen. (2) apktool/JADX auf das Release-Artefakt ansetzen – nicht auf Debug – und die dekompilierte Ausgabe lesen: Bestätigen Sie, dass keine lesbaren Klassen-/Methodennamen Geschäftslogik offenlegen und keine Klartext-Geheimnisse verbleiben. (3) Das APK nach Ihren API-Schlüsseln, Endpunkten, 'Bearer ', 'password', 'secret', 'http://' und Debug-Flags durchsuchen (zum Beispiel strings assets/* | grep -i key). (4) Frida auf einem gerooteten Testgerät ausführen und die Zwei-Minuten-Angriffe versuchen – Lizenz-/Premium-Flag umschalten, den Integritätsaufruf hooken, lokalen Speicher lesen; alles, was gelingt, muss serverseitig wandern. (5) Bestätigen Sie, dass mapping.txt für diese Version erzeugt und hochgeladen wurde. (6) Bestätigen Sie, dass Play Integrity und/oder Protected with Play aktiviert ist und Ihr Backend ein fehlschlagendes Urteil tatsächlich ablehnt. Wenn Obfuskation Ihre einzige Kontrolle ist, behandeln Sie die Daten und die Premium-Logik der App als öffentlich.