In diesem Dokument wird beschrieben, wie Sie mit dem Credential Manager eine kryptografisch bestätigte E‑Mail-Adresse vom Gerät eines Nutzers abrufen. Dadurch müssen die Nutzer Ihrer App ihre E-Mail-Adresse nicht mehr mit Einmalpasswörtern (OTPs) oder Magic Links bestätigen.
In diesem Dokument werden die folgenden Bereiche erläutert:
- Android-Kompatibilität
- Nutzererfahrung
- Unterstützte Konten
- Auswirkungen der E‑Mail-Zustellbarkeit
- Vergleich mit Über Google anmelden
In diesem Leitfaden wird davon ausgegangen, dass Sie mit den folgenden Konzepten vertraut sind:
Android-Kompatibilität
Diese Funktion wird auf Smartphones, Tablets und faltbaren Geräten mit Android 9 (API-Level 28) und höher unterstützt. Die erforderliche Mindestversion der Google Play-Dienste (GMS) ist 25.49.x.
Nutzererfahrung
In den folgenden Abschnitten werden die Nutzererfahrung während des Bestätigungsvorgangs, die Notwendigkeit von Fallback-Bestätigungsmethoden sowie die empfohlene Nutzererfahrung für verschiedene Anwendungsfälle beschrieben.
Der Überprüfungsprozess
Der Ablauf für die Freigabe einer bestätigten E‑Mail-Adresse sieht so aus:
- Der Nutzer fokussiert entweder ein Eingabefeld oder tippt auf eine Schaltfläche, die die Credential Manager API aufruft. Je nach Design des Bildschirms können Sie die API auch beim Laden des Bildschirms Ihrer App aufrufen.
- Es wird eine Ansicht am unteren Rand mit den Informationen angezeigt, die mit der App geteilt werden. Wenn auf dem Gerät keine Informationen verfügbar sind, wird eine allgemeine Fehlermeldung angezeigt.
- Nachdem der Nutzer auf Zustimmen und fortfahren getippt hat, wird eine Erfolgs- oder Fehlermeldung angezeigt.
- Hinweis: Wenn die bestätigte E‑Mail-Adresse, die du erhältst, nicht mit der erwarteten übereinstimmt, informiere den Nutzer über die Abweichung und bitte ihn, es mit anderen Anmeldedaten noch einmal zu versuchen, oder biete eine alternative Bestätigungsmethode an, z. B. über Einmalpasswörter.
- (Optional, empfohlen) Wenn sich der Nutzer für Ihren Dienst registriert, sollten Sie ihn auffordern, einen Passkey zu erstellen, um ihm die spätere Anmeldung zu erleichtern.
- Hinweis: Die E‑Mail-Bestätigung löst nicht automatisch die Erstellung eines Passkeys aus. Es wird jedoch dringend empfohlen, die Schritte zum Erstellen von Passkeys einzubeziehen. Passkeys erleichtern Nutzern die Anmeldung und machen sie sicherer. Außerdem ist die herkömmliche Interaktion mit Nutzernamen und Passwort nicht mehr erforderlich.
Primäre und Fallback-Abläufe einbeziehen
Damit die Nutzerfreundlichkeit nicht beeinträchtigt wird, sollten Sie auf Bildschirmen, auf denen eine E‑Mail-Bestätigung erforderlich ist, die folgenden Optionen anbieten:
- Primäre Bestätigungsoption: Ein E-Mail-Feld oder ein Button, um den Credential Manager API-Ablauf für eine schnelle Bestätigung auszulösen.
- Alternative Bestätigungsoptionen: Ein Link oder Button, über den Nutzer die Bestätigung auf andere Weise durchführen können, oder andere Optionen für die manuelle Eingabe der E‑Mail-Adresse, falls Fehler auftreten, z. B. wenn keine Informationen auf dem Gerät verfügbar sind oder die abgerufene und die erwartete E‑Mail-Adresse nicht übereinstimmen. Nutzer sollten die Möglichkeit haben, die Bestätigung mit anderen Anmeldedaten oder durch manuelle Eingabe eines OTP zu versuchen.
Anwendungsfälle
In den folgenden Abschnitten werden die empfohlenen Anwendungsfälle sowie die empfohlene Nutzererfahrung für die E‑Mail-Bestätigung beschrieben.
Registrieren
Nutzer können sofort ein Konto mit einer bestätigten E‑Mail-Adresse erstellen, ohne dass ein separater Bestätigungsschritt erforderlich ist. Optional können Sie den Nutzer auffordern, einen Passkey hinzuzufügen. Wenn sie einen Passkey hinzufügen möchten, lösen Sie den Ablauf Passkey erstellen aus.
Kontowiederherstellung
Damit Nutzer nicht frustriert in ihren Spamordnern nach Wiederherstellungscodes suchen müssen, kannst du ihnen die Möglichkeit geben, ihr Konto mithilfe der bestätigten E‑Mail-Adresse wiederherzustellen, die sicher auf ihrem Gerät gespeichert ist. Schlagen Sie außerdem vor, einen Passkey für die zukünftige Verwendung zu erstellen.
Erneute Authentifizierung für sensible Aktionen
Schützen Sie sensible Nutzeraktionen wie das Ändern von Einstellungen oder das Aktualisieren von Profildetails, indem Sie einen schnellen Schritt zur erneuten Authentifizierung verlangen.
Unterstützte Konten
Die E‑Mail-Bestätigung über den Credential Manager wird nur für private Google-Konten unterstützt. Workspace-Konten und Konten mit Elternaufsicht werden nicht unterstützt.
Ein privates Google-Konto kann mit einer E-Mail-Adresse eines beliebigen Anbieters erstellt werden, nicht unbedingt mit einer @gmail.com-Adresse. Google verifiziert diese Konten jedoch anders:
- Für @gmail.com-Konten: Google ist die maßgebliche Quelle und die E-Mail-Adresse ist verifiziert.
- Für Konten, die nicht auf @gmail.com enden: Google ist langfristig nicht die maßgebliche Quelle für diese E‑Mail-Adressen. Google überprüft die E-Mail-Adresse zwar bei der Kontoerstellung, die Inhaberschaft dieser E-Mail-Adresse kann sich jedoch im Laufe der Zeit ändern. Daher sollten Sie für Adressen, die nicht auf @gmail.com enden, einen zusätzlichen Bestätigungsschritt in Betracht ziehen, z. B. das Senden eines OTP, um sicherzustellen, dass der Nutzer weiterhin Zugriff auf das E-Mail-Konto hat.
Weitere Informationen zur Bedeutung der Überprüfung finden Sie unter Digitale Anmeldedaten.
Hinweis: Neben den E‑Mail-Informationen eines Nutzers können Sie auch andere nicht bestätigte Felder anfordern, z. B. den Vornamen, den Nachnamen, den Namen und das Profilbild des Google-Kontos des Nutzers. Allerdings wird nur die E‑Mail-Adresse von Google überprüft.
Informationen zur Bestätigung der Telefonnummer finden Sie unter Telefonnummern mit digitalen Ausweisen bestätigen. Eine Firebase-Lösung finden Sie unter Bestätigung der Telefonnummer in Firebase.
Gültigkeit und Aktualität
Das System stellt überprüfbare Anmeldedaten (Verifiable Credentials, VCs) basierend auf der aktuellen E‑Mail-Adresse des Nutzers aus den aktiven Google-Konten auf dem Gerät aus. Diese Anmeldedaten werden dem Gerät im Voraus ausgestellt, in der Regel, wenn das Gerät inaktiv ist. Diese Anmeldedaten können zwar mehrere Tage lang gültig sein, das System führt jedoch zum Zeitpunkt der Freigabe der Anmeldedaten eine Prüfung durch, um sicherzustellen, dass das Konto noch vorhanden ist, sich auf dem Gerät befindet und die E-Mail-Adresse gültig ist. Der aktuelle Status des Kontos hat also Vorrang vor dem Gültigkeitszeitraum der Anmeldedaten.
Um die Authentizität zu gewährleisten, wird zum Zeitpunkt der Freigabe eine Key Binding-Signatur (kb) generiert, die die Nonce enthält.
Wenn ein Gerät offline ist oder das Konto entfernt wurde, schlägt der Vorgang fehl, anstatt eine abgelaufene VC oder eine VC für ein inaktives Google-Konto bereitzustellen.
E-Mail-Zustellbarkeit
Durch den Prozess wird zwar die Legitimität des Kontos bestätigt, die Zustellung im Posteingang ist jedoch nicht garantiert. Die E-Mail kann beispielsweise in den Spamordner umgeleitet werden. Ein OTP ist nach wie vor die beste Methode, um die Zustellbarkeit von E‑Mails zu bestätigen.
Vergleich mit „Über Google anmelden“
Sowohl die Lösungen für digitale Anmeldedaten als auch Über Google anmelden bieten eine bestätigte E‑Mail-Adresse, aber die Nutzerflüsse und Anwendungsfälle sind unterschiedlich:
- Anwendungsfälle: Der Ablauf für die E‑Mail-Bestätigung im Credential Manager wird nicht nur bei der Registrierung oder Anmeldung verwendet, sondern kann in jedem Anwendungsfall eingesetzt werden, bei dem eine bestätigte E‑Mail-Adresse abgerufen wird. Dazu könnte auch die Kontowiederherstellung gehören.
- Registrierung: Im Gegensatz zu „Über Google anmelden“ ist für den Credential Manager-Ablauf keine Google-Registrierung erforderlich.
Plattformunterstützung: Der Credential Manager-Ablauf ist eine reine Android-Lösung.
Bereiche: Im Gegensatz zu „Über Google anmelden“, wo OAuth 2.0 verwendet werden kann, um Zugriff auf Nutzerdaten (z. B. Kalender oder Drive über Bereiche) anzufordern, dient die Digital Credentials API ausschließlich dem Abrufen verifizierter Identitätsattribute. Er kann nicht verwendet werden, um zusätzliche Autorisierungsbereiche anzufordern.
Nächste Schritte
Informationen zum Implementieren dieser Funktion in Ihrer App finden Sie im Implementierungsleitfaden.