Android Entegrasyon Akışı

Parolalar için Smart Lock'u Android uygulamanıza entegre etmek için, Credentials API'sine çağrıları uygulamanızın başlatma ve oturum açma akışına eklemeniz gerekir. Aşağıdaki diyagram, Parolalar için Smart Lock kullanan tipik bir Android uygulamasının akışını göstermektedir.

Smart Lock for Passwords entegre etmenin birçok yolu varken ve bir entegrasyonun özellikleri uygulamanın yapısına ve kullanıcı deneyimine bağlı olsa da çoğu uygulama için aşağıdaki akış önerilir. Bu akışı kullanan uygulamalar şu kullanıcı deneyimi avantajlarına sahiptir:

• Tek bir kimlik bilgilerinin kaydedildiği hizmetinizin mevcut kullanıcıları hemen oturum açar ve uygulamayı açtıklarında doğrudan oturum açma görünümüne giderler.
• Birden çok kimlik bilgisi kaydedilmiş veya otomatik oturum açmayı devre dışı bırakmış kullanıcıların, uygulamanın oturum açma görünümüne gitmeden önce yalnızca bir iletişim kutusunu yanıtlaması gerekir.
• Kayıtlı kimlik bilgileri olmayan veya henüz kaydolmamış kullanıcılar, adlarını ve e-postalarını tek bir dokunuşla seçebilir ve bu bilgiler önceden doldurulmuş olarak oturum açma veya kayıt görünümüne akıllıca gönderilebilir.
• Kullanıcılar çıkış yaptıklarında, uygulama otomatik olarak tekrar oturum açmamalarını sağlar.

Kimlik bilgilerini alın

1. Uygulama başladığında, hiçbir kullanıcı oturum CredentialsClient.request() , CredentialsClient.request() çağırın.
2. Task başarılı olursa, kullanıcının kimlik bilgilerini getResult().getCredential() ile alın ve oturum açmak için kullanın.
3. Task başarısız olursa ve istisna bir ResolvableApiException ve getStatusCode() , RESOLUTION_REQUIRED döndürürse, bir kimlik bilgisi seçmek için kullanıcı girişi gerekir. Kullanıcıdan kayıtlı bir hesabı seçmesini istemek için startResolutionForResult() öğesini çağırın, ardından kullanıcının kimlik bilgilerini almak ve oturum açmak için kullanmak için getParcelableExtra(Credential.EXTRA_KEY) öğesini çağırın.
   Alınan kimlik bilgileriyle oturum açma, parola yanlış olduğundan veya hesap mevcut olmadığından başarısız olursa, kimlik bilgilerini CredentialsClient.delete() ile Smart Lock'tan silin.

Kimlik bilgilerini kaydedin

4. Eğer Task bir ile başarısız ApiException ve getStatusCode() döndürür SIGN_IN_REQUIRED , kullanıcı hiçbir kimlik kurtardı ve oturum veya oturum açma veya kaydolma süreci mevcut kullanarak elle kaydolması gerekir. Kullanıcı oturum açmayı başarıyla tamamladıktan sonra, kullanıcıya gelecekte almak üzere kimlik bilgilerini kaydetme fırsatı sağlayabilirsiniz (adım 5).

   Kullanıcının e-posta adresi gibi oturum açma ipuçlarını alarak kullanıcının daha hızlı ve daha kolay oturum açmasına veya kaydolmasına yardımcı olabilirsiniz. Kullanıcı ipucunu seçebilir ve kimlik bilgilerini yazmayı atlayabilir. Uygulamanız kullanıcıların oturum açmasını gerektiriyorsa, ilk kimlik bilgileri isteği başarısız olduktan hemen sonra ipuçlarını almayı seçebilirsiniz (aksi takdirde, kullanıcı oturum açma veya kayıt akışını başlatana kadar bekleyebilirsiniz).

   1. CredentialsClient.getHintPickerIntent() öğesini çağırın ve kullanıcıdan bir hesap getParcelableExtra(Credential.EXTRA_KEY) , ardından oturum açma ipucunu almak için getParcelableExtra(Credential.EXTRA_KEY) öğesini çağırın.
   2. İpucunun kullanıcı kimliği mevcut bir kullanıcıyla eşleşirse, onunla oturum açma formunu önceden doldurun ve kullanıcının oturum açmak için parolayı girmesine izin verin.
   3. İpucunun kullanıcı kimliği mevcut bir kullanıcıyla eşleşmiyorsa, kayıt formunu kullanıcının kimliği ve adıyla önceden doldurun ve kullanıcının yeni bir hesap oluşturmasına izin verin.

5. Kullanıcı başarıyla oturum açtıktan veya bir hesap oluşturduktan sonra, kullanıcı kimliğini ve parolayı CredentialsClient.save() ile kaydedin.

   Kullanıcı, Google Oturum Açma gibi bir federe kimlik sağlayıcısıyla oturum setAccountType , kimlik olarak kullanıcının e-posta adresiyle Credential nesnesini oluşturun ve setAccountType ile kimlik sağlayıcıyı belirtin.

oturumu Kapat

6. Kullanıcı oturumu kapattığında, kullanıcının hemen tekrar oturum açmasını önlemek için CredentialsClient.disableAutoSignIn() çağrısı yapın. Otomatik oturum açmayı devre dışı bırakmak, kullanıcıların hesaplar arasında kolayca geçiş yapmasına da olanak tanır (örneğin, iş ve kişisel hesaplar arasında veya hesaplar arasında) paylaşılan cihazlarda - oturum açma bilgilerini yeniden girmek zorunda kalmadan.

Parolalar için Smart Lock'u uygulamanıza entegre etmeye hazır mısınız? Başlayın .