Parola sıfırlamaları için e-posta eylemleri gönderirken veya bir kullanıcının e-postasını doğrularken durumu devam eden bir URL yoluyla iletebilirsiniz. Bu, kullanıcıya işlem tamamlandıktan sonra uygulamaya geri dönme yeteneği sağlar. Ayrıca, e-posta işlem bağlantısının web sayfası yerine yüklendiğinde doğrudan mobil uygulamadan işlenip işlenmeyeceğini belirleyebilirsiniz.
Bu, aşağıdaki yaygın senaryolarda son derece yararlı olabilir:
Şu anda oturum açmamış bir kullanıcı, kullanıcının oturum açmasını gerektiren içeriğe erişmeye çalışıyor olabilir. Ancak, kullanıcı parolasını unutmuş ve bu nedenle parola sıfırlama akışını tetiklemiş olabilir. Akış sonunda kullanıcı, uygulamanın erişmeye çalıştığı bölümüne geri dönmeyi bekler.
Bir uygulama yalnızca doğrulanmış hesaplara erişim sunabilir. Örneğin, bir bülten kullanıcının abone olmadan önce e-postalarını doğrulamasını isteyebilir. Kullanıcı, e-posta doğrulama akışından geçer ve aboneliklerini tamamlamak için uygulamaya geri dönmeyi bekler.
Diğer durumlarda, kullanıcı mobil cihazından akışı başlatmış olabilir ve doğrulamadan sonra tarayıcı yerine mobil uygulamalarına geri dönmeyi bekleyebilir.
Devam URL'siyle durum geçirme özelliğine sahip olmak, Firebase Auth'un sağladığı ve kullanıcı deneyimini önemli ölçüde artırabilecek güçlü bir özelliktir.
E-posta işlemlerinde geçiş durumu / URL'yi devam ettirme
Devam eden bir URL'yi güvenli bir şekilde geçirmek için URL'nin alan adının Firebase konsolunda beyaz listeye eklenmesi gerekir. Bu, Kimlik Doğrulama bölümünde, bu etki alanı, henüz yoksa Oturum açma yöntemi sekmesi altındaki Yetkili etki alanları listesine ekleyerek yapılır.
Parola sıfırlama e-postası veya doğrulama e-postası gönderilirken bir ActionCodeSettings örneği sağlanmalıdır. Aşağıdaki yöntemleri içeren ilişkili ActionCodeSettings.Builder sınıfıyla oluşturulabilir:
|Yöntem||Açıklama|


Farklı bağlamlarda farklı anlamları olan bağlantıyı (eyalet / devam URL'si) ayarlar:
| ||İOS paket kimliğini ayarlar. Bu, yüklüyse bağlantıyı bir iOS uygulamasında açmaya çalışır. İOS uygulamasının Konsolda kayıtlı olması gerekir.|
| || Android paketinin adını ayarlar. Bu, yüklüyse bağlantıyı bir android uygulamasında açmaya çalışacaktır. İnstallIfNotAvailable |
| ||E-posta işlemi bağlantısının önce bir mobil uygulamada mı yoksa web bağlantısında mı açılacağı. Varsayılan, false değeridir. True değerine ayarlandığında, eylem kodu bağlantısı Evrensel Bağlantı veya Android Uygulama Bağlantısı olarak gönderilir ve yüklendiyse uygulama tarafından açılır. Yanlış durumda, kod önce web widget'ına gönderilir ve sonra devam edildiğinde uygulamaya yönlendirilir.|
| ||Firebase Dinamik Bağlantıları kullanılarak açılacaksa, geçerli bağlantı için kullanılacak dinamik bağlantı etki alanını (veya alt etki alanını) ayarlar. Proje başına birden çok dinamik bağlantı alanı yapılandırılabildiğinden, bu alan açıkça bir tane seçebilmenizi sağlar. Hiçbiri belirtilmezse, ilk etki alanı varsayılan olarak kullanılır.|
Aşağıdaki örnek, mobil uygulamada önce Firebase Dinamik Bağlantısı (iOS uygulaması
com.example.ios veya Android uygulaması
com.example.android ) olarak açılacak bir e-posta doğrulama bağlantısının nasıl gönderileceğini gösterir. Derin bağlantı devam URL yükü
https://firstname.lastname@example.org içerecektir.
Java
FirebaseAuth auth = FirebaseAuth.getInstance(); FirebaseUser user = auth.getCurrentUser(); String url = "http://www.example.com/verify?uid=" + user.getUid(); ActionCodeSettings actionCodeSettings = ActionCodeSettings.newBuilder() .setUrl(url) .setIOSBundleId("com.example.ios") // The default for this is populated with the current android package name. .setAndroidPackageName("com.example.android", false, null) .build(); user.sendEmailVerification(actionCodeSettings) .addOnCompleteListener(new OnCompleteListener<Void>() { @Override public void onComplete(@NonNull Task<Void> task) { if (task.isSuccessful()) { Log.d(TAG, "Email sent."); } } });
Kotlin + ktx
val auth = Firebase.auth val user = auth.currentUser!! val url = "http://www.example.com/verify?uid=" + user.uid val actionCodeSettings = ActionCodeSettings.newBuilder() .setUrl(url) .setIOSBundleId("com.example.ios") // The default for this is populated with the current android package name. .setAndroidPackageName("com.example.android", false, null) .build() user.sendEmailVerification(actionCodeSettings) .addOnCompleteListener { task -> if (task.isSuccessful) { Log.d(TAG, "Email sent.") } }
Firebase Dinamik Bağlantılarını Yapılandırma
Firebase Auth, bir mobil uygulamada açılması amaçlanan bir bağlantı gönderirken Firebase Dinamik Bağlantılarını kullanır. Bu özelliği kullanmak için Firebase Konsolunda Dinamik Bağlantıların yapılandırılması gerekir.
Firebase Dinamik Bağlantılarını etkinleştir:
- Firebase konsolunda Dinamik Bağlantılar bölümünü açın.
Dinamik Bağlantılar koşullarını henüz kabul etmediyseniz ve bir Dinamik Bağlantılar etki alanı oluşturmadıysanız, şimdi yapın.
Önceden bir Dinamik Bağlantılar etki alanı oluşturduysanız, buna dikkat edin. Dinamik Bağlantılar etki alanı genellikle aşağıdaki örneğe benzer:
example.page.link
İOS veya Android uygulamanızı gelen bağlantıyı kesecek şekilde yapılandırdığınızda bu değere ihtiyacınız olacaktır.
Android uygulamalarını yapılandırma:
- Bu bağlantıları Android uygulamanızdan yönetmeyi planlıyorsanız, Android paket adının Firebase Konsolu proje ayarlarında belirtilmesi gerekir. Ayrıca, uygulama sertifikasının SHA-1 ve SHA-256'sının sağlanması gerekir.
- Ayrıca AndroidManifest.xml dosyanızdaki derin bağlantı için niyet filtresini yapılandırmanız gerekecektir.
- Bununla ilgili daha fazla bilgi için Android Dinamik Bağlantıları Alma talimatlarına bakın .
İOS uygulamalarını yapılandırma:
- Bu bağlantıları iOS uygulamanızdan yönetmeyi planlıyorsanız, iOS paket kimliğinin Firebase Konsolu proje ayarlarında belirtilmesi gerekir. Ayrıca, App Store Kimliği ve Apple Developer Team ID'nin de belirtilmesi gerekir.
- Ayrıca, uygulama özelliklerinizde FDL evrensel bağlantı etki alanını İlişkili Etki Alanı olarak yapılandırmanız gerekir.
- Uygulamanızı iOS 8 ve sonraki sürümlere dağıtmayı planlıyorsanız, iOS paket kimliğinizi gelen URL'ler için özel bir şema olarak ayarlamanız gerekir.
- Bununla ilgili daha fazla bilgi için iOS Dinamik Bağlantıları Alma talimatlarına bakın .
Bir web uygulamasında e-posta işlemlerini işleme
Eylem kodu bağlantısını önce bir web uygulamasından işlemek isteyip istemediğinizi belirleyebilir ve ardından başarılı bir şekilde tamamlandıktan sonra, mobil uygulama varsa başka bir web sayfasına veya mobil uygulamaya yönlendirebilirsiniz. Bu, ActionCodeSettings.Builder nesnesindeki
setHandleCodeInApp(false) çağrılarak yapılır. Bir iOS paket kimliği veya Android paket adı gerekli olmamakla birlikte, bunların sağlanması, kullanıcının e-posta eylem kodu tamamlandığında belirtilen uygulamaya geri yönlendirmesine izin verecektir.
Burada kullanılan web URL'si, e-posta işlemi şablonları bölümünde yapılandırılan URL'dir. Tüm projeler için varsayılan bir tane hazırlanmıştır. E -posta eylem işleyicisini özelleştirme hakkında daha fazla bilgi için e-posta işleyicilerini özelleştirme konusuna bakın.
Bu durumda,
continueUrl sorgu parametresindeki bağlantı, yükü
ActionCodeSettings nesnesinde belirtilen
URL olan bir FDL bağlantısı olacaktır. Ek bağımlılık olmadan uygulamanızdan gelen bağlantıyı kesebilir ve işleyebilirsiniz, ancak derin bağlantıyı sizin için ayrıştırmak için FDL istemci kitaplığını kullanmanızı öneririz.
E-posta doğrulaması gibi e-posta eylemlerini işlerken,
oobCode sorgu parametresinden eylem kodunun derin bağlantıdan ayrıştırılması ve daha sonra değişikliğin etkili olması için, örneğin e-postanın doğrulanması için
applyActionCode aracılığıyla uygulanması gerekir.
Mobil uygulamada e-posta işlemlerini işleme
Yüklü olması koşuluyla, ilk önce mobil uygulamanızdaki eylem kodu bağlantısını işlemek isteyip istemediğinizi belirleyebilirsiniz. Android uygulamalarında,
installIfNotAvailable boolean aracılığıyla, cihaz destekliyorsa ve zaten yüklü değilse uygulamanın yükleneceğini belirtebilirsiniz. Bağlantı, mobil uygulamayı desteklemeyen bir cihazdan tıklanırsa, bunun yerine bir web sayfasından açılır. Bu, ActionCodeSettings.Builder nesnesinde
setHandleCodeInApp(true) çağrılarak yapılır. Mobil uygulamanın Android paket adının veya iOS paket kimliğinin de belirtilmesi gerekir.
Mobil uygulama olmadığında burada kullanılan yedek web URL'si, e-posta işlemi şablonları bölümünde yapılandırılan URL'dir. Tüm projeler için varsayılan bir tane hazırlanmıştır. E -posta eylem işleyicisini özelleştirme hakkında daha fazla bilgi için e-posta işleyicilerini özelleştirme konusuna bakın.
Bu durumda, kullanıcıya gönderilen mobil uygulama bağlantısı, yükü Konsolda yapılandırılan eylem kodu URL'si olan
oobCode ,
mode ,
apiKey ve
continueUrl sorgu parametreleriyle bir FDL bağlantısı olacaktır. İkincisi,
ActionCodeSettings nesnesinde belirtilen orijinal
URL olacaktır. Ek bağımlılık olmadan uygulamanızdan gelen bağlantıyı kesebilir ve işleyebilirsiniz, ancak derin bağlantıyı sizin için ayrıştırmak için FDL istemci kitaplığını kullanmanızı öneririz. Eylem kodu, e-posta işleyicilerini özelleştirme bölümünde açıklanan web akışından nasıl ele alındığına benzer şekilde doğrudan bir mobil uygulamadan uygulanabilir.
E-posta doğrulaması gibi e-posta eylemlerini işlerken,
oobCode sorgu parametresinden eylem kodunun derin bağlantıdan ayrıştırılması ve daha sonra değişikliğin etkili olması için, örneğin e-postanın doğrulanması için
applyActionCode aracılığıyla uygulanması gerekir.