E-posta Eylemlerinde 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 bir devam URL'si aracılığıyla iletebilirsiniz. Bu, kullanıcıya eylem tamamlandıktan sonra uygulamaya geri dönme olanağı sağlar. Ayrıca, e-posta eylem bağlantısının, bir web sayfası yerine yüklendiğinde doğrudan bir mobil uygulamadan mı yönetileceğini belirtebilirsiniz.

Bu, aşağıdaki yaygın senaryolarda son derece yararlı olabilir:

  • Şu anda oturum açmamış bir kullanıcı, 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ışın 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 haber bülteni, kullanıcının abone olmadan önce e-posta adresini doğrulamasını gerektirebilir. Kullanıcı, e-posta doğrulama akışından geçecek ve aboneliğini tamamlamak için uygulamaya geri dönmeyi bekleyecektir.

  • Diğer durumlarda kullanıcı akışı mobil cihazından başlatmış olabilir ve doğrulamanın ardından tarayıcı yerine mobil uygulamasına geri dönmeyi bekliyor olabilir.

Bir devam URL'si yoluyla durumu aktarma yeteneğine sahip olmak, Firebase Auth'un sağladığı ve kullanıcı deneyimini önemli ölçüde artırabilen güçlü bir özelliktir.

E-posta işlemlerinde durum/devam URL'sini geçirme

Devam eden bir URL'yi güvenli bir şekilde iletmek için, URL'ye ait alan adının Firebase konsolunda beyaz listeye alınması gerekir. Bu, Kimlik Doğrulama bölümünde, bu alan adı zaten mevcut değilse, Oturum açma yöntemi sekmesi altındaki Yetkili alanlar listesine eklenerek gerçekleştirilir.

Parola sıfırlama e-postası veya doğrulama e-postası gönderilirken bir ActionCodeSettings örneğinin sağlanması gerekir. Aşağıdaki yöntemleri içeren ilişkili ActionCodeSettings.Builder sınıfıyla oluşturulabilir:

Yöntem Tanım
setUrl(String url)

Farklı bağlamlarda farklı anlamlara sahip olan bağlantıyı (durum/devam URL'si) ayarlar:

  • Bağlantı web eylemi 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) iOS paket kimliğini ayarlar. Bu, yüklüyse bağlantıyı bir iOS uygulamasında açmaya çalışacaktır. İOS uygulamasının Konsola kaydedilmesi gerekir.
setAndroidPackageName(String androidPackageName, boolean installIfNotAvailable, String minimumVersion) Android paket adını ayarlar. Bu, yüklüyse bağlantıyı bir Android uygulamasında açmaya çalışacaktır. installIfNotAvailable true olarak ayarlanırsa, cihazın desteklemesi ve uygulamanın önceden yüklü olmaması durumunda Android uygulamasının yüklenip yüklenmeyeceğini belirtir. MinimumVersion belirtilirse ve uygulamanın daha eski bir sürümü yüklüyse kullanıcı, uygulamayı yükseltmesi için Play Store'a yönlendirilir. Android uygulamasının Konsola kaydedilmesi gerekiyor.
setHandleCodeInApp(boolean status) E-posta işlem bağlantısının önce bir mobil uygulamada mı yoksa bir web bağlantısında mı açılacağı. Varsayılan yanlıştır. Doğru olarak ayarlandığında eylem kodu bağlantısı Evrensel Bağlantı veya Android Uygulama Bağlantısı olarak gönderilecek ve yüklenmişse uygulama tarafından açılacaktır. Yanlış durumda, kod önce web widget'ına gönderilecek ve ardından devamında, yüklüyse uygulamaya yönlendirilecektir.
setDynamicLinkDomain(String dynamicLinkDomain) Geçerli bağlantının Firebase Dynamic Links kullanılarak açılması durumunda kullanılacak dinamik bağlantı alanını (veya alt alan adını) ayarlar. Proje başına birden fazla dinamik bağlantı alanı yapılandırılabildiğinden, bu alan açıkça bir tanesini seçme olanağı sağlar. Hiçbiri sağlanmazsa varsayılan olarak ilk alan adı kullanılır.

Aşağıdaki örnek, bir mobil uygulamada öncelikle Firebase Dynamic Link (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ı, https://www.example.com/?email=user@example.com devam URL'si yükünü içerecektir.

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

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

Firebase Auth, bir mobil uygulamada açılması amaçlanan bir bağlantıyı gönderirken Firebase Dinamik Bağlantılarını kullanır. Bu özelliği kullanabilmek için Firebase Konsolunda Dinamik Bağlantıların yapılandırılması gerekir.

  1. Firebase Dinamik Bağlantılarını Etkinleştir:

    1. Firebase konsolunda Dinamik Bağlantılar bölümünü açın.
    2. Henüz Dinamik Bağlantılar şartlarını kabul etmediyseniz ve bir Dinamik Bağlantılar alanı oluşturmadıysanız bunu şimdi yapın.

      Zaten bir Dinamik Bağlantılar alanı oluşturduysanız bunu not edin. Dinamik Bağlantılar alanı genellikle aşağıdaki örneğe benzer:

      example.page.link

      Apple veya Android uygulamanızı gelen bağlantıyı kesecek şekilde yapılandırırken bu değere ihtiyacınız olacaktır.

  2. 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 başvuru sertifikasının SHA-1 ve SHA-256'sının sağlanması gerekmektedir.
    2. Ayrıca AndroidManifest.xml dosyanızdaki derin bağlantı için amaç filtresini de yapılandırmanız gerekecektir.
    3. Bununla ilgili daha fazla bilgi için Android Dinamik Bağlantılarını Alma talimatlarına bakın.
  3. iOS 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 ID ve Apple Developer Team ID'nin de belirtilmesi gerekiyor.
    2. Ayrıca uygulama yeteneklerinizde FDL evrensel bağlantı etki alanını İlişkili Etki Alanı olarak yapılandırmanız gerekecektir.
    3. Uygulamanızı iOS 8 ve daha eski sürümlere dağıtmayı planlıyorsanız iOS paket kimliğinizi, gelen URL'ler için özel bir şema olarak ayarlamanız gerekecektir.
    4. Bununla ilgili daha fazla bilgi için iOS Dinamik Bağlantılarını Alma talimatlarına bakın.

Bir web uygulamasında e-posta eylemlerini yönetme

Mobil uygulamanın mevcut olması koşuluyla, eylem kodu bağlantısını önce bir web uygulamasından işlemek ve başarılı bir şekilde tamamlandıktan sonra başka bir web sayfasına veya mobil uygulamaya yönlendirmek isteyip istemediğinizi belirtebilirsiniz. Bu, ActionCodeSettings.Builder nesnesinde setHandleCodeInApp(false) çağrılarak yapılır. iOS paket kimliği veya Android paket adı gerekli olmasa da bunların sağlanması, kullanıcının e-posta eylem kodunu tamamladığında belirtilen uygulamaya geri yönlendirmesine olanak tanır.

Burada kullanılan web URL'si, e-posta eylem şablonları bölümünde yapılandırılan URL'dir. Tüm projeler için varsayılan bir tane sağlanır. E-posta eylem işleyicisinin nasıl özelleştirileceği hakkında daha fazla bilgi edinmek için e-posta işleyicilerini özelleştirme konusuna bakın.

Bu durumda, continueUrl sorgu parametresi içindeki bağlantı, yükü ActionCodeSettings nesnesinde belirtilen URL olan bir FDL bağlantısı olacaktır. Uygulamanızdan gelen bağlantıyı herhangi bir ek bağımlılık olmadan yakalayıp yönetebilseniz de, 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 işlemlerini gerçekleştirirken, değişikliğin etkili olması, yani e-postanın doğrulanması için oobCode sorgu parametresindeki eylem kodunun derin bağlantıdan ayrıştırılması ve ardından applyActionCode aracılığıyla uygulanması gerekir.

Mobil uygulamada e-posta işlemlerini yönetme

Eylem kodu bağlantısını, yüklü olması şartıyla öncelikle mobil uygulamanız içinde işlemek isteyip istemediğinizi belirtebilirsiniz. Android uygulamalarında, installIfNotAvailable boolean'ı aracılığıyla, cihazın desteklemesi ve uygulamanın önceden yüklü olmaması durumunda uygulamanın yükleneceğini belirtme olanağına da sahipsiniz. Bağlantıya 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 gerekecektir.

Hiçbir mobil uygulama mevcut olmadığında burada kullanılan yedek web URL'si, e-posta eylem şablonları bölümünde yapılandırılan URL'dir. Tüm projeler için varsayılan bir tane sağlanır. E-posta eylem işleyicisinin nasıl özelleştirileceği hakkında daha fazla bilgi edinmek 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 oobCode , mode , apiKey ve continueUrl sorgu parametreleriyle yapılandırılan eylem kodu URL'si olan bir FDL bağlantısı olacaktır. İkincisi, ActionCodeSettings nesnesinde belirtilen orijinal URL olacaktır. Uygulamanızdan gelen bağlantıyı herhangi bir ek bağımlılık olmadan yakalayıp yönetebilseniz de, derin bağlantıyı sizin için ayrıştırmak için FDL istemci kitaplığını kullanmanızı öneririz. Eylem kodu, e-posta işleyicilerinin özelleştirilmesi bölümünde açıklanan web akışında nasıl işlendiğine benzer şekilde doğrudan bir mobil uygulamadan uygulanabilir.

E-posta doğrulaması gibi e-posta işlemlerini gerçekleştirirken, değişikliğin etkili olması, yani e-postanın doğrulanması için oobCode sorgu parametresindeki eylem kodunun derin bağlantıdan ayrıştırılması ve ardından applyActionCode aracılığıyla uygulanması gerekir.