E-posta İşlemlerinde Geçiş Durumu

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
`setUrl(String url)`	Farklı bağlamlarda farklı anlamları olan bağlantıyı (eyalet / devam URL'si) ayarlar: Bağlantı, web eylem widget'larında işlendiğinde, bu `continueUrl` sorgu parametresindeki derin bağlantıdır. Bağlantı doğrudan uygulamada işlendiğinde, bu Dinamik Bağlantı'nın derin bağlantısındaki `continueUrl` sorgu parametresidir.
`setIOSBundleId(String iOSBundleId)`	İ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.
`setAndroidPackageName(String androidPackageName, boolean installIfNotAvailable, String minimumVersion)`	Android paketinin adını ayarlar. Bu, yüklüyse bağlantıyı bir android uygulamasında açmaya çalışacaktır. İnstallIfNotAvailable `true` değerine ayarlanırsa, cihaz destekliyorsa ve uygulama önceden yüklenmediyse Android uygulamasının yüklenip yüklenmeyeceğini belirler. MinimumVersion belirtilirse ve uygulamanın eski bir sürümü yüklüyse, kullanıcı uygulamayı yükseltmek için Play Store'a götürülür. Android uygulamasının Konsolda kayıtlı olması gerekir.
`setHandleCodeInApp(boolean status)`	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.
`setDynamicLinkDomain(String dynamicLinkDomain)`	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://www.example.com/?email=user@example.com 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.");
                }
            }
        });
 MainActivity.java

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.")
            }
        }
 MainActivity.kt

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:
1. Firebase konsolunda Dinamik Bağlantılar bölümünü açın.
2. 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:
1. 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.
2. Ayrıca AndroidManifest.xml dosyanızdaki derin bağlantı için niyet filtresini yapılandırmanız gerekecektir.
3. Bununla ilgili daha fazla bilgi için Android Dinamik Bağlantıları Alma talimatlarına bakın .
İOS uygulamalarını yapılandırma:
1. 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.
2. Ayrıca, uygulama özelliklerinizde FDL evrensel bağlantı etki alanını İlişkili Etki Alanı olarak yapılandırmanız gerekir.
3. 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.
4. 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.