Firebase Apple Platformları Yetkilendirme Hatalarını İşleyin

Kimlik Doğrulama yöntemlerindeki tamamlama geri çağrısı, sıfır olmayan bir NSError bağımsız değişkeni alırsa, bir hata oluştu. Üretim kodunuzdaki uygun hata işleme mantığına sevk etmek için, hata kodunu aşağıda listelenen yaygın hatalara ve yönteme özel hatalara karşı kontrol edin.

Bazı hatalar belirli kullanıcı eylemleriyle çözülebilir; örneğin, FIRAuthErrorCodeUserTokenExpired , kullanıcı yeniden oturum açarak ve FIRAuthErrorCodeWrongPassword , kullanıcıdan doğru parolayı girmesi istenerek çözülebilir.

FIRAuthErrorCodeNetworkError veya FIRAuthErrorCodeTooManyRequests durumu dışında, aynı argümanlarla başarısız bir işlemi yeniden denemek asla başarılı olmaz. İşlemin sunucu tarafında etkili olup olmadığı konusunda herhangi bir varsayımda bulunmayın.

Hataları araştırırken veya günlüğe userInfo sözlüğünü inceleyin. FIRAuthErrorNameKey , hatayı tanımlamak için kullanılabilecek bir platformlar arası hata adı dizesi içerir. NSLocalizedDescriptionKey , hatanın bir açıklamasını içerir. Bu açıklama kullanıcı için değil geliştirici içindir. NSUnderlyingErrorKey , temel alınan bir hata varsa, söz konusu hataya neden olan temel hatayı içerir.

Yukarıda listelenen ana alanlara ek olarak, userInfo sözlüğünde hataları teşhis ederken faydalı bulabileceğiniz başka alanlar da olabilir.

Tüm API yöntemlerinde ortak olan hata kodları

kod	Anlam
FIRAuthErrorCodeNetworkError	İşlem sırasında bir ağ hatası oluştuğunu gösterir.
FIRAuthErrorCodeUserNotFound	Kullanıcı hesabının bulunamadığını gösterir. Bu, kullanıcı hesabı silinmişse olabilir.
FIRAuthErrorCodeUserTokenExpired	Geçerli kullanıcının jetonunun süresinin dolduğunu gösterir; örneğin, kullanıcı başka bir cihazda hesap şifresini değiştirmiş olabilir. Kullanıcıdan bu cihazda tekrar oturum açmasını istemeniz gerekir.
FIRAuthErrorCodeTooManyRequests	Arayan cihazdan Firebase Kimlik Doğrulama sunucularına anormal sayıda istek yapıldıktan sonra isteğin engellendiğini gösterir. Bir süre sonra tekrar deneyin.
FIRAuthErrorCodeInvalidAPIKey	Uygulamanın geçersiz bir API anahtarıyla yapılandırıldığını gösterir.
FIRAuthErrorCodeAppNotAuthorized	Uygulamanın, sağlanan API Anahtarı ile Firebase Kimlik Doğrulamasını kullanma yetkisi olmadığını belirtir. Google API Konsolu'na gidin ve kullandığınız API anahtarının, uygulamanızın paket kimliğinin beyaz listeye eklendiğini, kimlik bilgileri sekmesinin altında kontrol edin.
FIRAuthErrorCodeKeychainError	Anahtar zincirine erişirken bir hata oluştuğunu gösterir. NSError.userInfo sözlüğündeki NSLocalizedFailureReasonErrorKey ve NSUnderlyingErrorKey alanları, karşılaşılan hata hakkında daha fazla bilgi içerecektir.
FIRAuthErrorCodeInternalError	Dahili bir hata oluştuğunu gösterir. Lütfen hatayı tüm NSError nesnesiyle bildirin.

Yönteme özel hata kodları

FIRAuth

fetchProvidersForEmail:tamamlama:

kod	Anlam
FIRAuthErrorCodeInvalidEmail	E-posta adresinin hatalı biçimlendirildiğini gösterir.

signInWithEmail:şifre:tamamlama:

kod	Anlam
FIRAuthErrorCodeOperationNotAllowed	E-posta ve parola hesaplarının etkinleştirilmediğini gösterir. Bunları Firebase konsolunun Yetkilendirme bölümünde etkinleştirin.
FIRAuthErrorCodeInvalidEmail	E-posta adresinin hatalı biçimlendirildiğini gösterir.
FIRAuthErrorCodeUserDisabled	Kullanıcının hesabının devre dışı bırakıldığını gösterir.
FIRAuthErrorCodeWrongPassword	Kullanıcının yanlış bir parola ile oturum açmayı denediğini gösterir.

signInWithCredential:tamamlama:

kod	Anlam
FIRAuthErrorCodeInvalidCredential	Sağlanan kimlik bilgisinin geçersiz olduğunu gösterir. Bu, süresi dolmuşsa veya hatalı biçimlendirilmişse olabilir.
FIRAuthErrorCodeInvalidEmail	Kimlik bilgisi EmailPasswordAuthCredential , e-posta adresinin hatalı biçimlendirildiğini gösterir.
FIRAuthErrorCodeOperationNotAllowed	Kimlik bilgisi tarafından temsil edilen kimlik sağlayıcıya sahip hesapların etkinleştirilmediğini gösterir. Bunları Firebase konsolunun Yetkilendirme bölümünde etkinleştirin.
FIRAuthErrorCodeEmailAlreadyInUse	Kimlik bilgisi tarafından onaylanan e-postanın (örneğin bir Facebook erişim belirtecindeki e-posta), bu oturum açma yöntemiyle kimliği doğrulanamayan mevcut bir hesap tarafından zaten kullanıldığını gösterir. Bu kullanıcının e-postası için fetchProvidersForEmail arayın ve ardından döndürülen oturum açma sağlayıcılarından herhangi biriyle oturum açmasını isteyin. Bu hata yalnızca Firebase konsolunda Kimlik Doğrulama ayarları altında "E-posta adresi başına bir hesap" ayarı etkinleştirilirse atılır.
FIRAuthErrorCodeUserDisabled	Kullanıcının hesabının devre dışı bırakıldığını gösterir.
FIRAuthErrorCodeWrongPassword	Kimlik bilgisi EmailPasswordAuthCredential , kullanıcının yanlış bir parolayla oturum açmaya çalıştığını gösterir.

SignInAnonymouslyWithCompletion:

kod	Anlam
FIRAuthErrorCodeOperationNotAllowed	Anonim hesapların etkinleştirilmediğini gösterir. Bunları Firebase konsolunun Yetkilendirme bölümünde etkinleştirin.

signInWithCustomToken:tamamlama:

kod	Anlam
FIRAuthErrorCodeInvalidCustomToken	Özel belirteçle ilgili bir doğrulama hatasını gösterir.
FIRAuthErrorCodeCustomTokenMismatch	Hizmet hesabını ve API anahtarının farklı projelere ait olduğunu gösterir.

createUserWithEmail:parola:tamamlama:

kod	Anlam
FIRAuthErrorCodeInvalidEmail	E-posta adresinin hatalı biçimlendirildiğini gösterir.
FIRAuthErrorCodeEmailAlreadyInUse	Kaydolmayı denemek için kullanılan e-postanın zaten var olduğunu gösterir. Bu kullanıcının hangi oturum açma mekanizmalarını kullandığını kontrol etmek için fetchProvidersForEmail arayın ve kullanıcıdan bunlardan biriyle oturum açmasını isteyin.
FIRAuthErrorCodeOperationNotAllowed	E-posta ve parola hesaplarının etkinleştirilmediğini gösterir. Bunları Firebase konsolunun Kimlik Doğrulama bölümünde etkinleştirin.
FIRAuthErrorCodeWeakPassword	Çok zayıf olarak kabul edilen bir parola belirleme girişimini belirtir. NSError.userInfo sözlük nesnesindeki NSLocalizedFailureReasonErrorKey alanı, kullanıcıya gösterilebilecek daha ayrıntılı açıklama içerecektir.

oturumu Kapat:

kod	Anlam
FIRAuthErrorCodeKeychainError	Anahtarlığa erişirken bir hata oluştuğunu belirtti. NSError.userInfo sözlüğündeki NSLocalizedFailureReasonErrorKey ve NSUnderlyingErrorKey alanları, karşılaşılan hata hakkında daha fazla bilgi içerecektir.

FIRUser

FIRUser işlemleri için yaygın hatalar

kod	Anlam
FIRAuthErrorCodeInvalidUserToken	Oturum açmış kullanıcının oturum bilgilerini tutan yenileme belirtecinin geçersiz olduğunu gösterir. Kullanıcıdan bu cihazda tekrar oturum açmasını istemeniz gerekir.
FIRAuthErrorCodeUserDisabled	Kullanıcı hesabının devre dışı bırakıldığını ve Firebase konsolundaki Kullanıcılar panelinden yeniden etkinleştirilene kadar artık kullanılamayacağını belirtir.

reauthenticateWithCredential:tamamlama:

kod	Anlam
FIRAuthErrorCodeInvalidCredential	Sağlanan kimlik bilgisinin geçersiz olduğunu gösterir. Bu, süresi dolmuşsa veya hatalı biçimlendirilmişse olabilir.
FIRAuthErrorCodeInvalidEmail	Kimlik bilgisi EmailPasswordAuthCredential , e-posta adresinin hatalı biçimlendirildiğini gösterir.
FIRAuthErrorCodeWrongPassword	Kimlik bilgisi EmailPasswordAuthCredential , kullanıcının yanlış bir parolayla yeniden kimlik doğrulama girişiminde bulunduğunu gösterir.
FIRAuthErrorCodeUserMismatch	Geçerli kullanıcı olmayan bir kullanıcıyla yeniden kimlik doğrulama girişiminde bulunulduğunu gösterir.
FIRAuthErrorCodeOperationNotAllowed	Kimlik bilgisi tarafından temsil edilen kimlik sağlayıcıya sahip hesapların etkinleştirilmediğini gösterir. Bunları Firebase konsolunun Yetkilendirme bölümünde etkinleştirin.
FIRAuthErrorCodeEmailAlreadyInUse	Kimlik bilgisi tarafından onaylanan e-postanın (örneğin bir Facebook erişim belirtecindeki e-posta), bu oturum açma yöntemiyle yeniden doğrulanamayan mevcut bir hesap tarafından zaten kullanıldığını gösterir. Bu kullanıcının e-postası için fetchProvidersForEmail arayın ve ardından döndürülen oturum açma sağlayıcılarından herhangi biriyle oturum açmasını isteyin. Bu hata yalnızca Firebase konsolunda Kimlik Doğrulama ayarları altında "E-posta adresi başına bir hesap" ayarı etkinleştirilirse atılır.
FIRAuthErrorCodeUserDisabled	Kullanıcının hesabının devre dışı bırakıldığını gösterir.

updateEmail:tamamlama:

kod	Anlam
FIRAuthErrorCodeEmailAlreadyInUse	E-postanın zaten başka bir hesap tarafından kullanıldığını gösterir.
FIRAuthErrorCodeInvalidEmail	E-posta adresinin hatalı biçimlendirildiğini gösterir.
FIRAuthErrorCodeRequiresRecentLogin	Bir kullanıcının e-postasını güncellemek, kullanıcının yakın zamanda oturum açmasını gerektiren, güvenlik açısından hassas bir işlemdir. Bu hata, kullanıcının yakın zamanda yeterince oturum açmadığını gösterir. Çözümlemek için, FIRUser üzerinde reauthenticateWithCredential:completion: öğesini çağırarak kullanıcının kimliğini yeniden doğrulayın.

güncellemeParolası:tamamlama:

kod	Anlam
FIRAuthErrorCodeOperationNotAllowed	Yöneticinin belirtilen kimlik sağlayıcıyla oturum açmayı devre dışı bıraktığını gösterir.
FIRAuthErrorCodeRequiresRecentLogin	Bir kullanıcının parolasını güncellemek, kullanıcının yakın zamanda oturum açmasını gerektiren, güvenlik açısından hassas bir işlemdir. Bu hata, kullanıcının yakın zamanda yeterince oturum açmadığını gösterir. Çözümlemek için, FIRUser üzerinde reauthenticateWithCredential:completion: öğesini çağırarak kullanıcının kimliğini yeniden doğrulayın.
FIRAuthErrorCodeWeakPassword	Çok zayıf olarak kabul edilen bir parola belirleme girişimini belirtir. NSError.userInfo sözlük nesnesindeki NSLocalizedFailureReasonErrorKey alanı, kullanıcıya gösterilebilecek daha ayrıntılı açıklama içerecektir.

linkWithCredential:tamamlama:

kod	Anlam
FIRAuthErrorCodeProviderAlreadyLinked	Bu hesaba zaten bağlı türde bir sağlayıcı bağlama girişimini gösterir.
FIRAuthErrorCodeCredentialAlreadyInUse	Halihazırda farklı bir Firebase hesabına bağlanmış olan bir kimlik bilgisi ile bağlantı kurma girişimini gösterir.
FIRAuthErrorCodeOperationNotAllowed	Kimlik bilgisi tarafından temsil edilen kimlik sağlayıcıya sahip hesapların etkinleştirilmediğini gösterir. Bunları Firebase konsolunun Yetkilendirme bölümünde etkinleştirin.

Bu yöntem ayrıca FIRUser üzerinde FIRUser updateEmail:completion: ve updatePassword:completion: ile ilişkili hata kodlarını da döndürebilir.

unlinkFromProvider:tamamlama:

kod	Anlam
FIRAuthErrorCodeNoSuchProvider	Hesaba bağlı olmayan bir sağlayıcının bağlantısını kaldırma girişimini gösterir.
FIRAuthErrorCodeRequiresRecentLogin	E-postanın güncellenmesi, kullanıcının yakın zamanda oturum açmasını gerektiren, güvenlik açısından hassas bir işlemdir. Bu hata, kullanıcının yakın zamanda yeterince oturum açmadığını gösterir. Çözümlemek için, FIRUser üzerinde reauthenticateWithCredential:completion: öğesini çağırarak kullanıcının kimliğini yeniden doğrulayın.

sendEmailVerificationWithCompletion:

kod	Anlam
FIRAuthErrorCodeUserNotFound	Kullanıcı hesabının bulunamadığını gösterir.

deleteWithCompletion:

kod	Anlam
FIRAuthErrorCodeRequiresRecentLogin	Bir kullanıcı hesabını silmek, kullanıcının yakın zamanda oturum açmasını gerektiren, güvenlik açısından hassas bir işlemdir. Bu hata, kullanıcının yakın zamanda yeterince oturum açmadığını gösterir. Çözümlemek için, FIRUser üzerinde reauthenticateWithCredential:completion: öğesini çağırarak kullanıcının kimliğini yeniden doğrulayın.