Form faktörleri arasında kimlik doğrulama

Kimlik Bilgisi Yöneticisi, tüm Android ekosisteminde kimlik doğrulamayı basitleştirir. Kullanıcılara tutarlı bir deneyim sunar ve geliştiricilerin geçiş anahtarları, şifreler ve Google ile oturum açma gibi birleşik oturum açma mekanizmalarını kullanmaları için birleşik bir API yüzeyi sağlar. Temel programlama arayüzü tüm form faktörlerinde aynı olsa da her form faktörünün kendine özgü kullanıcı arayüzü ve kullanıcı deneyimi özellikleri vardır. Başarılı bir uygulama için uygulamanızın kimlik doğrulama akışlarını her cihazın belirli giriş yöntemlerine, ekran boyutlarına ve kullanıcı bağlamlarına uyarlamanız gerekir.

Bu kılavuzda, Kimlik Bilgisi Yöneticisi'nin farklı Android form faktörlerinde nasıl uygulanacağına dair genel bir bakış sunulmakta, önemli noktalar vurgulanmakta ve daha ayrıntılı belgelere bağlantılar verilmektedir.

Mobil cihazlar

Telefonlar, tabletler ve katlanabilir cihazlar dahil olmak üzere mobil cihazlar, Android geliştiricisi için en yaygın hedefi temsil eder. Standart Kimlik Bilgisi Yöneticisi uygulaması, genellikle dokunmatik ekran ve cihaz üzerinde klavye içeren bu cihazlar için uygundur. Bu form faktöründeki kullanıcı deneyimi, diğerleri için uyarlama yapacağınız temel olarak kullanılır. Kimlik doğrulama akışları, form faktörüne uygun olmalı ve cihazın ekran alanının ve giriş yöntemlerinin tüm özelliklerini kullanmalıdır.

Wear OS

Wear OS cihazlar, küçük ekranları ve sınırlı cihaz üzerinde girişleriyle karakterize edilir. Kimlik Bilgisi Yöneticisi'nin geçiş anahtarı uygulaması, kullanıcıların bağlı bir telefon ve şifre hatırlamaya gerek kalmadan uygulamalarda oturum açması için güvenli bir ortam sağlar.

Wear OS için API, mobil cihazlardakiyle aynıdır. Bu nedenle, mevcut bir mobil entegrasyonu yeniden kullanabilirsiniz. Kimlik Bilgisi Yöneticisi ile geçiş anahtarları, Google ile oturum açma ve şifrelerin yanı sıra Veri Katmanı Jeton Paylaşımı, OAuth veya mevcut çözümleriniz gibi diğer kimlik doğrulama yöntemlerini kullanabilirsiniz. Bu özellikler, kullanıcılarınızı Kimlik Bilgisi Yöneticisi'ne geçirirken yedek olarak veya veri katmanı jetonu paylaşımı durumunda uzun vadeli bir çözüm olarak kullanılabilir.

Wear OS için Kimlik Bilgisi Yöneticisi'ni kullanmak için aşağıdaki şartlar gerekir:

• Minimum API düzeyi: minSdkVersion 33 veya üstü
  • Şifreler, geçiş anahtarları ve Google ile oturum açma desteği dahildir
• GMS sürümü: Mobil uygulamalar için gerekenle aynı

Wear OS cihazlardaki kullanıcı arayüzü aşağıdaki gibidir:

Ayrıntılı uygulama kılavuzu ve kod örnekleri için aşağıdaki kaynaklara bakın:

• Giyilebilir cihazlarda kimlik doğrulama: Kimlik Bilgisi Yöneticisi
• Wear OS için kullanıcı arayüzü tasarımı önerileri
• Wear Kimlik Bilgisi Yöneticisi örneği

Sınırlamalar

Wear OS'te Kimlik Bilgisi Yöneticisi'ni kullanmanın aşağıdaki sınırlamaları vardır:

• Geçiş anahtarı oluşturmayı desteklemez.
• Restore Credentials hakkında desteklenmez.

Android XR

Sanal ve artırılmış gerçekliği içeren Android XR ile uygulamalar 3D alanda oluşturulur. Kullanıcı girişi, diğer form faktörlerindeki girişlerden temel olarak farklıdır ve elle yapılan hareketler gibi doğal girişlere dayanır.

Kimlik Bilgisi Yöneticisi'ni XR'a uyarlamak, kimlik doğrulama kullanıcı arayüzünü (geçiş anahtarları, şifreler veya federasyon kimlik doğrulama yöntemleriyle) 3D alan için yeniden düşünmek anlamına gelir. Örneğin, kimlik doğrulama istemleri kayan panellerde görünür ve kullanıcılar elle yapılan hareketleri kullanarak seçim yapar. Ayrıca hedef XR cihazlarınız için belirli donanım veya yazılım ön koşullarını da göz önünde bulundurmanız gerekir.

Önemli bir tasarım zorluğu, VR veya AR ortamında sezgisel ve güvenli bir kimlik doğrulama deneyimi oluşturmaktır. Ayrıca, farklı kişilerin aynı cihazı kullanabileceği çok kullanıcılı XR senaryolarında kimliğin nasıl yönetileceğini de göz önünde bulundurmanız gerekir.

Android XR için Kimlik Bilgisi Yöneticisi'ni kullanmak için aşağıdaki şartlar karşılanmalıdır:

• Minimum API düzeyi: minSdkVersion 34 veya daha yüksek
• GMS sürümü: Mobil uygulamalar için gerekenle aynıdır.
• Emülatör:
  • Minimum emülatör sistem görüntüsü:
    • macOS: Google Play XR ARM 64 v8a Sistem Görüntüsü Sürüm 7
    • Windows: Google Play XR Intel x86_64 Atom System Image Revision 7
  • 35.6.11 Kararlı sürümünden daha yeni emülatör sürümleri

XR'de oturum açma deneyimi aşağıdaki gibi görünebilir:

XR tarafından desteklenmeyen akışlar

Android XR'daki Kimlik Bilgisi Yöneticisi, QR kodu taramak için başka bir cihaz gerektiren kimlik doğrulama akışlarını desteklemez. Bu durum, XR kulaklıklarında oturum açma işlemleri sırasında ve emülatörle test yaparken gözlemlenebilir.

XR hakkında daha fazla bilgi edinmek için Android XR başlıklı makaleyi inceleyin.

Android TV

Android TV cihazları genellikle ortak kullanılır, uzaktan izlenir ve D-pad uzaktan kumandalarla gezinilir. Kullanıcılar bu ortamda kullanıcı adı ve şifre girmekte zorlanabilir. Kimlik Bilgisi Yöneticisi; Google ile oturum açma, kayıtlı şifreler ve cihazlar arası geçiş anahtarlarını destekleyerek Android TV'de kimlik doğrulamayı kolaylaştırır. Ortak kullanılan bir TV'de genellikle birden fazla Google profili bulunur. Kimlik Bilgisi Yöneticisi, seçimleri yalnızca etkin hesapla sınırlamak yerine cihazdaki tüm kimlik bilgilerini getirip göstererek bu ortak ortama uyum sağlar.

Bu ortak doğa, geçiş anahtarlarının nasıl işleneceğini de belirler. Televizyonlarda kişisel bir kilit ekranı bilgi faktörü (LSKF) bulunmadığından geçiş anahtarları doğrudan televizyonda saklanmaz veya oluşturulmaz. Bunun yerine, geçiş anahtarı kimlik doğrulaması, TV'de bir QR kodunun gösterildiği ve kullanıcının biyometrik kimlik doğrulamayı tamamlamak için mobil cihazıyla taradığı cihazlar arası hibrit bir akıştan yararlanır.

isAutoSelectAllowed = true ayarını yaparsanız Google TV'de tıklama gerektirmeyen bir akış mümkündür ancak bu yalnızca tam olarak eşleşen bir kimlik bilgisi varsa geçerlidir. Yerel TV alt sayfası görünmeye devam eder ve kullanıcının hesap onayını gösterir. Kullanıcı iptal etmezse kimlik bilgisi, uzaktan tıklama gerektirmeden otomatik olarak döndürülür. Birden fazla eşleşen kimlik bilgisi varsa otomatik olarak seçilmez ve kullanıcıdan seçim yapması istenir.

Mobil ve TV uygulamalarınız tamamen aynı Android paket adını ve imzalama anahtarını paylaşıyorsa Google Şifre Yöneticisi bunları aynı uygulama kimliği olarak tanır. Bu nedenle, mobil cihaza kaydedilen bir şifre, Digital Asset Links (asset_statements) yapılandırması gerektirmeden doğrudan TV'de sunulabilir. Digital Asset Links yalnızca farklı platformlar arasında (ör. bir uygulama ile web sitesi arasında veya farklı paket adlarına sahip uygulamalar arasında) kimlik bilgileri paylaşılırken gereklidir.

Android TV için Kimlik Bilgisi Yöneticisi'ni kullanmak için aşağıdaki koşulların karşılanması gerekir:

• Minimum API düzeyi: Android 14 (API düzeyi 34, minSdkVersion 34) veya sonraki sürümler
• GMS sürümü: 2026W30 veya daha yeni
• Geçiş anahtarları için donanım: QR kodunu taramak ve FIDO karma akışını tamamlamak için kameralı ve Bluetooth'lu ikincil bir mobil cihaz gerekir.

Sınırlamalar

Android TV ortak kullanılan bir cihaz olduğundan, bu platformda Kimlik Bilgisi Yöneticisi'nin kullanımı, kullanıcı gizliliğini ve güvenliğini korumak için aşağıdaki kısıtlamalara tabidir:

• Yerel geçiş anahtarı oluşturma veya depolama yok: Geçiş anahtarları doğrudan TV'de oluşturulamaz veya depolanamaz. Yerel kimlik bilgileri desteklenmediğinden isteklerinizde preferImmediatelyAvailableCredentials değerini true olarak ayarlamayın. Aksi takdirde, cihazlar arası geçiş anahtarları filtrelenir ve kimlik bilgileri döndürülmez.
• Üçüncü taraf kimlik bilgisi sağlayıcıları yok: Android TV, otomatik doldurmayı desteklemediği için platformda üçüncü taraf şifre yöneticileri kullanılamaz. Kullanıcılar Google Şifre Yöneticisi'ni kullanmalıdır.
• Kimlik bilgilerini geri yükleme yok: Kimlik bilgilerini geri yükleme hakkında kullanılarak yeni cihazlarda otomatik oturum açma, Android TV'de desteklenmez.

TV geliştirme hakkında daha fazla bilgi edinmek için Android TV'ye genel bakış başlıklı makaleyi inceleyin.

Android Automotive OS

Android Automotive OS (AAOS) cihazlar, araçlara entegre edilmiş ortak sistemlerdir. Kimlik Bilgisi Yöneticisi'ni AAOS'a uyarlamak için güvenli kimlik doğrulama (genellikle araç park halindeyken) desteklenmeli ve paylaşılan bir cihazda birden fazla kullanıcı profili barındırılmalıdır.

Büyük ekranlar veya tabletler için optimize edilmiş bir uygulamayı arabalara getirirseniz ve uygulamanız mobil cihazlarda ya da tabletlerde Kimlik Bilgisi Yöneticisi'ni ve geçiş anahtarlarını zaten destekliyorsa kimlik doğrulama akışlarınızda değişiklik yapmanıza gerek kalmadan Android Automotive OS'te çalışır.

Android Automotive OS'te kimlik doğrulama aşağıdaki yöntemleri destekler:

• Geçiş anahtarları (cihazlar arası karma akış): Kullanıcılar, cihazlar arası akış üzerinden mevcut geçiş anahtarlarıyla kimlik doğrulaması yapabilir. Sistem, araba ekranında bir QR kodu gösterir. Kullanıcı bu kodu mobil cihazıyla tarar. Biyometrik ve ekran kilidi doğrulaması kullanıcının telefonunda gerçekleştiğinden kullanıcıların araç ekranında ekran kilidi yapılandırması gerekmez.
• Google ile oturum açma: Google ile oturum açma ekranını doğrudan arabanın ekranında gösterir.
• Kayıtlı şifreler: Kullanıcılar, araç ekranına kimlik bilgilerini manuel olarak girmeden oturum açmak için kayıtlı şifreleri Google Şifre Yöneticisi'nden alabilir.

Android Automotive OS, oturumları ve kimlik bilgilerini profil bazında yönetir. Böylece, kullanıcılara özel oturum verileri profiller arasında (ör. A profili, B profili veya misafir profili) izole edilir.

Android Automotive OS için Kimlik Bilgisi Yöneticisi'ni kullanmak için aşağıdaki şartların karşılanması gerekir:

• Minimum API düzeyi: Android 9 (API düzeyi 28, minSdkVersion 28) veya sonraki sürümler. Cihazlar arası geçiş anahtarı alma özelliği için Android 14 (API düzeyi 34) veya sonraki sürümler gerekir.
• GMS sürümü: Mobil uygulamalar için gereken sürümle aynıdır.

Test sınırlamaları

Geçiş anahtarlarını test etmek için birincil yüzey olarak Android Automotive OS derlemesi çalıştıran fiziksel bir cihaz gerekir. Kurulum talimatları için Pixel Tablet'te Android Automotive OS kullanarak test etme başlıklı makaleyi inceleyin. Emülatörler, FIDO karma akışı için gereken Bluetooth Düşük Enerji'yi (BLE) desteklemediğinden geçiş anahtarı testi için kullanılamaz.

Sınırlamalar ve desteklenmeyen akışlar

Android Automotive OS'te Kimlik Bilgisi Yöneticisi'ni kullanırken aşağıdaki sınırlamalar geçerlidir:

• Yerel geçiş anahtarı depolama veya alma yok: Araçlar ortak cihazlar olduğundan doğrudan yerel geçiş anahtarı alma işlemi desteklenmez. Geçiş anahtarlarının doğrudan araçla senkronize edilmesi güvenlik riski oluşturur. Bu nedenle, geçiş anahtarları cihazlar arası hibrit akış üzerinden kullanılmalıdır.
• Hemen kullanılabilir kimlik bilgileri desteklenmiyor: Uygulamanız geçiş anahtarı isteyip preferImmediatelyAvailableCredentials değerini true olarak ayarlarsa otomotiv kullanıcı arayüzü hemen sonlandırılır ve NoCredentialException istisnası oluşturulur. Bu senaryo için uygun bir yedek kullanıcı deneyimi sağlayın.
• Üçüncü taraf kimlik bilgisi sağlayıcıları yok: Üçüncü taraf şifre yöneticileri Android Automotive OS'te desteklenmez. Kullanıcıların kimlik doğrulaması için Google Şifre Yöneticisi'ni veya cihazlar arası karma akışları kullanması gerekir.
• Kayıtlı şifre oluşturulmaz: API, doğrudan araç arayüzünden yeni bir kayıtlı şifre oluşturulmasını ve kaydedilmesini desteklemez. Kimlik bilgisi oluşturma, FIDO karma akışını kullanan yeni geçiş anahtarlarıyla sınırlıdır.

Automotive OS geliştirme hakkında daha fazla bilgi edinmek için Android Automotive OS'e genel bakış başlıklı makaleyi inceleyin.

Ek kaynaklar

• Kimlik Bilgisi Yöneticisi hakkında
• Kimlik bilgilerini geri yükleme hakkında
• Android TV'ye genel bakış
• Android Automotive OS'e genel bakış