Bu belgede, bir kullanıcının cihazından şifreleme yöntemiyle doğrulanmış bir e-posta adresi almak için Kimlik Bilgisi Yöneticisi'nin nasıl kullanılacağı açıklanmaktadır. Bu işlem sayesinde uygulama kullanıcılarınızın e-posta adreslerini tek kullanımlık şifreler (OTP) veya sihirli bağlantılarla doğrulaması gerekmez.
Bu dokümanda aşağıdaki konular açıklanmaktadır:
- Android uyumluluğu
- Kullanıcı deneyimi
- Desteklenen hesaplar
- E-posta teslim edilebilirliğinin etkisi
- Google ile oturum açma ile karşılaştırma
Bu kılavuzda, aşağıdaki kavramları bildiğiniz varsayılır:
Android becerileri
GitHub'da gösterDoğrulanmış e-posta adresini alma
android skills add verified-emailAndroid uyumluluğu
Bu özellik, Android 9 (API düzeyi 28) ve sonraki sürümleri çalıştıran cep telefonlarında, tabletlerde ve katlanabilir cihazlarda desteklenir. Google Play Hizmetleri'nin (GMS) minimum sürümü 25.49.x olmalıdır.
Kullanıcı deneyimi
Aşağıdaki bölümlerde, doğrulama akışı sırasındaki kullanıcı deneyimi, yedek doğrulama yöntemlerinin dahil edilmesi ihtiyacı ve çeşitli kullanım alanları için önerilen kullanıcı deneyimi açıklanmaktadır.
Doğrulama akışı
Doğrulanmış bir e-posta adresini paylaşma deneyimi şu şekildedir:
- Kullanıcı bir giriş alanına odaklanır veya Credential Manager API'yi çağıran bir düğmeye dokunur. Ekranın tasarımına bağlı olarak API'yi uygulamanızın ekran yükleme aşamasında da çağırabilirsiniz.
- Uygulamayla paylaşılacak bilgileri gösteren bir alt sayfa görünür. Cihazda bilgi yoksa kullanıcı genel bir hata mesajı görür.
- Kullanıcı Kabul et ve devam et'e dokunduktan sonra bir başarı veya başarısızlık mesajı gösterin.
- Not: Aldığınız doğrulanmış e-posta beklediğinizle eşleşmiyorsa kullanıcıyı uyumsuzluk hakkında bilgilendirin ve farklı bir kimlik bilgisiyle tekrar denemesini isteyin veya OTP gibi alternatif bir doğrulama yöntemi sunun.
- (İsteğe bağlı, önerilir) Kullanıcı hizmetinize kaydoluyorsa daha sonra oturum açmasını kolaylaştırmak için kullanıcıdan bir geçiş anahtarı oluşturmasını istemeniz gerekir.
- Not: E-posta doğrulama süreci, geçiş anahtarı oluşturma işlemini otomatik olarak tetiklemez. Ancak geçiş anahtarı oluşturma adımlarını eklemeniz önemle tavsiye edilir. Geçiş anahtarları, kullanıcıların oturum açmasını kolaylaştırıp daha güvenli hale getirerek ve geleneksel kullanıcı adı ve şifre etkileşimi ihtiyacını ortadan kaldırarak kullanıcılara yardımcı olur.
Birincil ve yedek akışları dahil etme
Sorunsuz bir kullanıcı deneyimi sağlamak için e-posta doğrulaması gerektiren ekranlara aşağıdaki seçenekleri ekleyin:
- Birincil doğrulama seçeneği: Hızlı doğrulama için Credential Manager API akışını tetikleyen bir e-posta alanı veya düğme.
- Alternatif doğrulama seçenekleri: Cihazda bilgi bulunmaması veya alınan e-posta ile beklenen e-posta arasında uyuşmazlık olması gibi hatalar durumunda kullanıcıların "Başka bir yöntemle doğrula" veya "Diğer seçenekler" ile manuel e-posta girişi yapabileceği bir bağlantı ya da düğme. Bu sayede kullanıcılar, farklı bir kimlik bilgisiyle veya manuel olarak OTP girerek doğrulamayı deneyebilir.
Kullanım alanları
Aşağıdaki bölümlerde, e-posta doğrulaması için önerilen kullanım alanları ve önerilen kullanıcı deneyimi açıklanmaktadır.
Kaydol
Kullanıcılar, ayrı bir doğrulama adımına gerek kalmadan doğrulanmış bir e-posta adresiyle hemen hesap oluşturabilir. İsteğe bağlı olarak, kullanıcıdan geçiş anahtarı eklemesini isteyin. Kullanıcı geçiş anahtarı eklemeyi seçerse geçiş anahtarı oluşturma akışını tetikleyin.
Hesap kurtarma
Kullanıcıların spam klasörlerinde kurtarma kodu arama zahmetini ortadan kaldırmak için cihazlarında güvenli bir şekilde saklanan doğrulanmış e-posta adresini kullanarak hesaplarını kurtarmalarına izin verin. Ayrıca, gelecekte kullanmak üzere geçiş anahtarı oluşturmalarını önerin.
Hassas işlemler için yeniden kimlik doğrulama
Ayarları değiştirme veya profil ayrıntılarını güncelleme gibi hassas kullanıcı işlemlerini, hızlı bir yeniden kimlik doğrulama adımı zorunlu kılarak koruyun.
Desteklenen hesaplar
Kimlik Bilgisi Yöneticisi üzerinden e-posta doğrulaması yalnızca tüketici Google Hesaplarının doğrulanmasını destekler. Workspace hesapları ve gözetimli hesaplar desteklenmez.
Tüketici Google Hesabı, @gmail.com olması gerekmeksizin herhangi bir sağlayıcının e-posta adresiyle oluşturulabilir. Ancak Google, bu hesapları farklı şekilde doğrular:
- @gmail.com hesapları için: Google, yetkili kaynaktır ve e-postanın doğrulanmış olduğu bilinir.
- @gmail.com dışındaki hesaplar için: Google, uzun vadede bu e-posta adresleri için yetkili kaynak değildir. Google, hesap oluşturulurken e-posta adresini doğrular ancak bu e-posta adresinin sahibi zaman içinde değişebilir. Bu nedenle, @gmail.com dışındaki adresler için kullanıcının e-posta hesabına hâlâ erişimi olduğundan emin olmak amacıyla OTP gönderme gibi ek bir doğrulama adımı kullanmanız önerilir.
Doğrulamanın ne anlama geldiği hakkında daha fazla bilgi için Dijital Kimlik Bilgileri başlıklı makaleyi inceleyin.
Not: Kullanıcının e-posta bilgilerinin yanı sıra kullanıcının adı, soyadı, adı ve Google Hesabı'nın profil resmi gibi doğrulanmamış diğer alanları da isteyebilirsiniz. Ancak Google yalnızca e-posta adresini doğrular.
Telefon numarası doğrulama için Telefon numaralarını dijital kimlik bilgileriyle doğrulama başlıklı makaleyi inceleyin. Firebase çözümü için Firebase Telefon Numarası Doğrulama başlıklı makaleyi inceleyin.
Geçerlilik ve güncellik
Sistem, cihazdaki etkin Google Hesaplarından kullanıcının mevcut e-posta adresine göre doğrulanabilir kimlik bilgileri (VC'ler) verir. Bu kimlik bilgileri, cihaza önceden (genellikle cihaz boştayken) verilir. Bu kimlik bilgileri birkaç gün boyunca geçerli kalabilir ancak sistem, kimlik bilgilerinin paylaşıldığı anda hesabın hâlâ mevcut, cihazda ve e-posta adresinin geçerli olduğundan emin olmak için bir kontrol gerçekleştirir. Böylece, kimlik bilgilerinin geçerlilik süresi yerine hesabın anlık durumuna öncelik verilir.
Özgünlüğü sağlamak için paylaşım sırasında tek seferlik rastgele sayıyı içeren bir anahtar bağlama (kb) imzası oluşturulur.
Cihaz çevrimdışıysa veya hesap kaldırılmışsa işlem başarısız olur. Süresi dolmuş bir VC veya etkin olmayan bir Google Hesabı için VC sağlanmaz.
E-posta teslim edilebilirliği
Bu işlem, hesabın meşruiyetini onaylasa da gelen kutusuna teslimatı garanti etmez (örneğin, e-posta spam'e yönlendirilebilir). OTP, e-posta teslim edilebilirliğini onaylamanın en kesin yöntemidir.
Google ile oturum açma özelliğiyle karşılaştırma
Hem Dijital Kimlik Bilgileri hem de Google ile oturum açma çözümleri doğrulanmış bir e-posta adresi sağlasa da kullanıcı işlemleri akışları ve kullanım alanları farklıdır:
- Kullanım alanları: Kimlik Bilgisi Yöneticisi e-posta doğrulama akışı yalnızca kaydolma veya oturum açma kullanım alanlarında kullanılmaz. Doğrulanmış e-postanın alınmasını içeren tüm kullanım alanlarında kullanılabilir. Hesap kurtarma da bu kapsamda olabilir.
- Kayıt: Kimlik Bilgisi Yöneticisi akışı, Google ile oturum açma özelliğinin aksine Google kaydı gerektirmez.
Platform desteği: Kimlik Bilgisi Yöneticisi akışı yalnızca Android'e uygun bir çözümdür.
Kapsamlar: Kullanıcı verilerine (ör. kapsamlar aracılığıyla Takvim veya Drive) erişim istemek için OAuth 2.0'ı kullanabilen Google ile oturum açma özelliğinin aksine, Digital Credentials API yalnızca doğrulanmış kimlik özelliklerini almak için kullanılır. Ek yetkilendirme kapsamları istemek için kullanılamaz.
Sonraki adımlar
Bu özelliği uygulamanızda kullanmak için uygulama kılavuzuna bakın.