Yaygın Kimlik Bilgisi Yöneticisi hatalarını giderme

Bu kılavuzda, Kimlik Bilgisi Yöneticisi ile ilgili yaygın hata kodları ve açıklamaları listelenmekte ve bunların nedenleri hakkında bazı bilgiler verilmektedir.

Not: Bu sayfadaki istisnalar, emülatörler için de geçerlidir. Ek hata açıklamaları için androidx.credentials.exceptions bölümüne bakın.

Hata kodu ve açıklaması	Neden
android.os.TransactionTooLargeException	Bu durum, Android 14 ve sonraki sürümlerdeki credentialManager.getCredential() API'sinin, cihazda birden fazla Google Hesabı olduğunda oturum açma iletişim kutusunu görüntüleyememesine neden olan bilinen bir sorundan kaynaklanır. Bu sorun özellikle GetGoogleIdOption ile görülür ve GetSignInWithGoogleOption ile görülmez. Bu sorun, Google Play Hizmetleri 24.40.XX ve sonraki sürümlerinde düzeltilmiştir.
CreateCredentialCancellationException Geçiş anahtarı kaydı veya alma işlemi kullanıcı tarafından iptal edildi.	Kullanıcı, kimlik bilgisi oluşturmamayı veya kullanmamayı seçmiştir. Artık kullanıcı arayüzünüzü alternatif bir oturum açma yöntemi sunacak şekilde ayarlayabilir veya sürecinizdeki sonraki adımlara geçebilirsiniz.
GetCredentialCancellationException	Gerekli kullanıcı yetkisi alınmadığı için kimlik bilgisi alma işlemi sonlandırıldı. Bu durum en sık olarak kullanıcı oturum açma akışını manuel olarak iptal ettiğinde ortaya çıksa da teknik kısıtlamalar nedeniyle isteğin yetkilendirilmediğini de gösterebilir. Bu hata, iznin olmadığını gösterdiğinden isteği otomatik olarak yeniden denemeyin. Bu, kullanıcı deneyimini olumsuz etkiler. Ancak geliştiriciler bu istisnanın sıklığını izlemelidir. Yüksek sayıda "iptal" aslında yetkilendirme kullanıcı arayüzünün başarıyla tamamlanmasını engelleyen bir yapılandırma hatasına (ör. kapsamın eksik veya yanlış olması) işaret edebilir. Beklenmedik trendler fark ederseniz istek parametrelerinizi ve [relying party][2] yapılandırmanızı inceleyin. Not: Hata mesajı, kimlik bilgisinin türüne göre değişebilir: Geçiş anahtarları için hata mesajı "Geçiş anahtarı kaydı veya alma işlemi kullanıcı tarafından iptal edildi" olabilir. Google ile oturum açma için hata mesajı "Etkinlik kullanıcı tarafından iptal edildi" olabilir.
CreateCredentialCustomException veya GetCredentialCustomException	CreateCustomCredentialRequest veya GetCustomCredentialOption alt sınıfına ait bir istek nesnesiyle API çağrıları yapmak için üçüncü taraf SDK'sı kullanırken hatalarla karşılaşabilirsiniz. Bu durum oluşursa e.type ile eşleşen özel istisna türü sabitleri için SDK'yı kontrol edin. Eşleşme bulunmazsa istisnayı bırakmak veya günlüğe kaydetmek güvenlidir.
CreateCredentialInterruptedException veya GetCredentialInterruptedException	Kullanıcı, şifre yöneticilerini yeniden yapılandırmak için ayarlara gittiğinden işlem kesintiye uğramış olabilir. Kesintiye başka nedenler de yol açmış olabilir. Lütfen aramayı tekrar deneyin.
CreateCredentialUnknownException Şifre kaydetme sırasında, tek dokunma ile 16'dan şifre kaydetme hatası yanıtı alındı: [28431] Kullanıcıya Android otomatik doldurma istemi gösterildiği için şifre kaydetme işlemi atlanıyor.	Bu hata yalnızca Google'ın belirlenmiş otomatik doldurma sağlayıcısı olduğu durumlarda Android 13 ve önceki sürümleri etkiler. Bu gibi durumlarda, kullanıcılar Otomatik Doldurma'dan bir kaydetme istemi alır ve şifre Google Şifre Yöneticisi'nde saklanır. Google ile otomatik doldurma kullanılarak kaydedilen kimlik bilgilerinin, Credential Manager API'si ile çift yönlü olarak senkronize edildiğini belirtmek isteriz. Bu nedenle, bu hata güvenle göz ardı edilebilir.
CreatePublicKeyCredentialDomException ve GetPublicKeyCredentialDomException	DOM istisnası daha spesifik bir domError içeriyor olabilir. Daha fazla bilgi için WebAuthn DomException ile eşleyebilirsiniz.
CreatePublicKeyCredentialDomException ve GetPublicKeyCredentialDomException Gelen istek doğrulanamıyor.	Şifre yöneticisinin sunucusu, uygulamanın paket kimliğini tanımıyor. Bu durum, sunucu tarafı entegrasyonunuzla, özellikle de dijital öğe bağlantısı kurulumuyla ilgili olası bir soruna işaret eder. Öğe bağlantı dosyanızdaki paket kimliğinin ve SHA'nın doğruluğunu tekrar kontrol edin.
CreatePublicKeyCredentialDomException: Kayıt sırasında anahtar oluşturulamıyor	Bu sorun, kullanıcı kaydolma sırasında ekran kilidi iletişim kutusunu kapattığında ortaya çıkabilir.
CreateCredentialNoCreateOptionException	Bu istisna, kullanıcının geçerli bir şifre yöneticisi yapılandırmadığını gösterir. Bu hata, kullanıcı tarafından başlatılan manuel iptal akışından değil, ayrı bir hatadan kaynaklanır.
CreatePublicKeyDomException ve GetPublicKeyCredentialDomException Geçiş anahtarı kaydı kullanıcı tarafından iptal edildi. Geçiş anahtarı alma işlemi kullanıcı tarafından iptal edildi.	Bu sorun, kullanıcı bir geçiş anahtarı kaydı / alma işlemi sırasında parmak izi iletişim kutusunu kapattığında ortaya çıkabilir.
GetCredentialProviderConfigurationException ve CreateCredentialProviderConfigurationException getCredentialAsync sağlayıcı bağımlılığı bulunamadı createCredentialAsync sağlayıcı bağımlılığı bulunamadı	androidx.credentials:credentials-play-services-auth:<latest-version> bağımlılığı eksik.
GetCredentialUnsupportedException veya CreateCredentialUnsupportedException Cihazınız kimlik bilgisi yöneticisini desteklemiyor	Kimlik bilgileri kitaplığınızın 1.2.1 veya sonraki bir sürüme güncellendiğinden emin olun.
GetPublicKeyCredentialException Kimlik bilgisinin şifresi çözülemedi	Bu sorun, Google Hesaplarından çıkış yapıp tekrar giriş yaptıktan sonra geçiş anahtarı kullanılmaya çalışıldığında ortaya çıkar. Kullanıcınızdan cihazında Google Hesabı'nda tekrar oturum açmasını isteyin.
NoCreateOptionException	Bu istisna, kullanıcının cihazında geçiş anahtarı kimlik bilgilerinin ayarlanmadığı veya şifre yöneticisinin yapılandırılmadığı durumlarda beklenen bir davranıştır.
NoCredentialException Eşleşen kimlik bilgisi bulunamadı	Bu istisna aşağıdaki durumlarda oluşur: setFilterByAuthorizedAccounts, cihazda yetkili hesaplar olmadan doğru olarak ayarlanır. Cihazda oturum açılmış hesap yok (hesap eklenmemiş veya hesapların yeniden kimlik doğrulaması yapılması gerekiyor). Cihazdaki herhangi bir hesap için oturum açma istemleri devre dışı bırakılırsa alt sayfa kullanıcı arayüzü görünmez. Google Hesabı Ayarları > Google ile oturum açma bölümünde bulunan bu genel ayar, herhangi bir hesap için alt sayfa kullanıcı arayüzünün gösterilmesi amacıyla etkinleştirilmelidir. Bu durum, düğme akışını etkilemez.
Şifrelenmiş veriler kilitlendiği için geçiş anahtarı oluşturulamıyor	Kullanıcının Chrome sunucu tarafı verilerini sıfırlaması gerekir. Bu veriler arasında, kayıtlı şifreler ve geçiş anahtarlarının yanı sıra yer işaretleri ve Chrome ayarları bulunur. Chrome'un hangi verileri sakladığı hakkında daha fazla bilgi edinmek için Hesabınızdaki Chrome verileri sayfasını inceleyin. chrome.google.com/sync adresine gidin. Alt tarafta Verileri temizle'yi seçin. Cihazda Chrome'da senkronizasyonu açın.
On Begin Sign In Failure: 8: Bilinmeyen dahili hata.	Cihaz, Google Hesabı ile düzgün şekilde ayarlanmamış olabilir. Geçiş anahtarı JSON'unun oluşturulma şekliyle ilgili bir sorun olabilir. Uygulamanın doğruluğunu kontrol edin.
Senkronizasyon hesabı alınamıyor	Google Play Hizmetleri'nin 24.40.XX ve sonraki sürümlerinde daha bilgilendirici hata kodları sağlanacaktır. Örneğin, arayanlar artık "Senkronizasyon hesabı alınamıyor" yerine iptal hata mesajı alacak.