Login-Token in der App: Keychain und Keystore statt Klartext
Kurz gesagt: Wenn Ihre App Kundinnen und Kunden angemeldet hält, liegt irgendwo auf dem Gerät ein Zugangstoken. Landet dieses Token in einer einfachen Einstellungsdatei, einer lokalen Datenbank oder einer Protokolldatei, kann es bei einem Geräteverlust, über ein Backup oder durch eine Schadsoftware ausgelesen werden. iOS bietet dafür die Keychain, Android das Keystore-System. Beide sind dafür gebaut, kleine Geheimnisse besser zu schützen als normale Dateien. Dieser Artikel erklärt, wie Sie Tokens dort ablegen, welche Einstellungen wichtig sind, wie Sie mit Abmelden und Neuinstallation umgehen und woran Sie bei einer Überprüfung durch Ihre Entwickler erkennen, ob es richtig gemacht ist.
Warum der Speicherort zählt
Ein Zugangstoken ist für Ihre Schnittstelle so viel wert wie ein Passwort. Wer es besitzt, kann im Namen des Kunden Bestellungen sehen, Termine ändern oder Daten abrufen, oft ohne erneute Anmeldung. Trotzdem finden sich Tokens in vielen Apps an Orten, die für Einstellungen gedacht sind: in den UserDefaults unter iOS, in SharedPreferences unter Android oder im lokalen Speicher eines plattformübergreifenden Frameworks. Diese Orte sind praktisch, aber nicht für Geheimnisse gebaut. Je nach Gerät und Konfiguration landen sie unverschlüsselt in Backups oder sind auf manipulierten Geräten leicht lesbar.
iOS: die Keychain
Apple beschreibt die Keychain Services als Mechanismus, kleine Mengen an Nutzerdaten in einer verschlüsselten Datenbank zu speichern, der sogenannten Keychain. Laut Apple ist sie nicht auf Passwörter beschränkt: Auch andere Geheimnisse und Daten, die der Nutzer braucht, ohne sie zu kennen, etwa kryptografische Schlüssel und Zertifikate, gehören dorthin. Ein Login-Token passt genau in diese Beschreibung.
Für jeden Eintrag legen Sie fest, wann er verfügbar ist. Für Tokens, die auch bei Hintergrundaktualisierungen gebraucht werden, ist eine Stufe üblich, die nach dem ersten Entsperren des Geräts gilt. Für besonders sensible Daten gibt es Stufen, die nur bei entsperrtem Gerät gelten oder an das jeweilige Gerät gebunden sind und nicht in Backups auf andere Geräte wandern. Welche Stufe passt, hängt davon ab, was Ihre App im Hintergrund tun muss.
Android: das Keystore-System
Die Android-Dokumentation beschreibt das Keystore-System als Behälter für kryptografische Schlüssel, der das Herauslösen der Schlüssel vom Gerät erschwert. Einmal im Keystore, lassen sich die Schlüssel für kryptografische Operationen nutzen, während das Schlüsselmaterial selbst nicht exportierbar bleibt. Laut Dokumentation verringert das System das Risiko, dass Schlüssel außerhalb des Geräts missbraucht werden, weil sie weder aus dem App-Prozess noch aus dem Gerät herausgelöst werden können. Auf vielen Geräten liegen die Schlüssel zusätzlich in sicherer Hardware, was sich über die Sicherheitsstufe des Schlüssels abfragen lässt.
Wichtig ist der Unterschied zu iOS: Der Keystore verwahrt Schlüssel, nicht beliebige Daten. Das übliche Vorgehen ist daher, im Keystore einen Schlüssel zu erzeugen und das Token damit zu verschlüsseln, bevor es in den App-Speicher geschrieben wird. Ohne den Schlüssel aus dem Keystore ist die gespeicherte Zeichenfolge wertlos.
Plattformübergreifende Apps
Wer mit Flutter, React Native oder einem ähnlichen Framework arbeitet, nutzt meist eine Erweiterung für sicheren Speicher, die unter iOS die Keychain und unter Android den Keystore verwendet. Prüfen Sie, dass genau diese Erweiterung im Einsatz ist und nicht der allgemeine Schlüssel-Wert-Speicher des Frameworks, der für Einstellungen gedacht ist. Lassen Sie sich außerdem zeigen, welche Optionen gesetzt sind, etwa die Verfügbarkeitsstufe unter iOS.
Tokens kurz halten und sauber aufräumen
Sicherer Speicher ist nur ein Teil. Genauso wichtig ist, was gespeichert wird und wie lange es gilt:
- Kurzlebige Zugangstokens und ein Erneuerungstoken. Das Zugangstoken läuft nach kurzer Zeit ab, das Erneuerungstoken holt ein neues. Wird ein Gerät gestohlen, lässt sich das Erneuerungstoken auf dem Server sperren.
- Keine Tokens in Protokollen. Prüfen Sie Debug-Ausgaben, Absturzberichte und Analyse-Ereignisse. Ein einziger Log-Eintrag mit dem vollständigen Token macht den sicheren Speicher wertlos.
- Abmelden heißt löschen. Beim Abmelden entfernt die App das Token aus dem sicheren Speicher und meldet es dem Server als ungültig.
- Neuinstallation bedenken. Einträge in der iOS-Keychain können eine Deinstallation überdauern. Wenn eine frisch installierte App den Nutzer plötzlich angemeldet zeigt, ist das für viele überraschend. Ein Merker im normalen App-Speicher hilft zu erkennen, dass es sich um den ersten Start handelt, und alte Einträge zu entfernen.
So prüfen Sie das Ergebnis
Auch ohne selbst zu programmieren, können Sie gezielt nachfragen. Bitten Sie Ihr Entwicklungsteam um eine kurze Übersicht: wo das Token unter iOS und Android liegt, welche Verfügbarkeitsstufe gilt, wie lange Tokens gültig sind, was beim Abmelden passiert und ob Tokens in Protokollen auftauchen können. Bei einer externen Sicherheitsprüfung der App gehört der Speicherort von Tokens zu den Standardfragen. Die Antworten sollten konkret sein, nicht „ist verschlüsselt“.
Biometrie richtig einordnen
Viele Apps bieten an, sich mit Gesichtserkennung oder Fingerabdruck anzumelden. Das ist bequem, ersetzt aber den sicheren Speicher nicht. Die Biometrie entscheidet nur, ob die App auf ein gespeichertes Geheimnis zugreifen darf. Liegt das Token ungeschützt daneben, bringt die Abfrage wenig. Richtig umgesetzt ist der Keychain-Eintrag oder der Keystore-Schlüssel selbst so konfiguriert, dass er nur nach erfolgreicher biometrischer Prüfung nutzbar ist.
Beispiel zur Veranschaulichung
Ein Linzer Fitnessstudio (Beispiel zur Veranschaulichung) bietet eine App für Kursbuchungen an. Bei einem Code-Review fällt auf, dass das Login-Token im allgemeinen Einstellungsspeicher des Frameworks liegt und in einer Debug-Ausgabe erscheint. Das Team stellt auf eine Erweiterung für sicheren Speicher um, die unter iOS die Keychain und unter Android einen Keystore-Schlüssel nutzt, verkürzt die Gültigkeit des Zugangstokens und führt Erneuerungstokens ein. Beim Abmelden wird das Token gelöscht und auf dem Server gesperrt, die Debug-Ausgabe entfällt.
Typische Fehler
- Tokens in UserDefaults, SharedPreferences oder dem allgemeinen Framework-Speicher ablegen.
- Tokens unbegrenzt gültig machen, sodass ein gestohlenes Token ewig funktioniert.
- Tokens in Logs, Absturzberichten oder Analyse-Ereignissen ausgeben.
- Beim Abmelden nur die Oberfläche zurücksetzen, das Token aber liegen lassen.
- Die Verfügbarkeitsstufe unter iOS nicht bewusst wählen.
Häufige Fragen
Ist die Keychain auf jedem iPhone gleich sicher?
Die Schutzwirkung hängt unter anderem davon ab, ob das Gerät mit einem Code gesichert ist. Ohne Gerätecode ist auch die Keychain schwächer geschützt.
Speichert der Android-Keystore das Token selbst?
Nein, er verwahrt Schlüssel. Das Token wird mit einem solchen Schlüssel verschlüsselt und dann im App-Speicher abgelegt.
Reicht sicherer Speicher allein aus?
Nein. Kurze Gültigkeiten, Sperren auf dem Server und Tokens ohne Spuren in Protokollen gehören dazu.
Was passiert bei einem neuen Handy?
Je nach Einstellung wandern Keychain-Einträge mit dem Backup oder nicht. Gerätegebundene Einträge erfordern eine neue Anmeldung, was für Tokens meist erwünscht ist.
Wenn Sie wissen möchten, ob Ihre App Zugangsdaten so speichert, wie sie sollte, gehen wir die Fragen gern mit Ihnen und Ihrem Team durch: App-Sicherheit besprechen. Wie wir Apps mit Kundenkonten von Anfang an planen, beschreibt unsere Seite App-Entwicklung in Wien.