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ırabilecek güçlü bir özelliktir.

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

Bir devam URL'sini güvenli bir şekilde iletmek için, URL'ye ait alanın Firebase konsolunda Yetkili alan olarak eklenmesi 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 firebase.auth.ActionCodeSettings örneğinin sağlanması gerekir. Bu arayüz aşağıdaki parametreleri alır:

Parametre Tip Tanım
url sicim

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.
iOS ({bundleId: string}|tanımsız) 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.
android ({packageName: string, installApp:boolean|untanımsız, minimumVersion: string|untanımsız}|tanımsız) Android paket adını ayarlar. Bu, yüklüyse bağlantıyı bir Android uygulamasında açmayı deneyecektir. installApp iletilirse, cihazın desteklemesi ve uygulamanın önceden yüklü olmaması durumunda Android uygulamasının yüklenip yüklenmeyeceğini belirtir. Bu alan packageName olmadan sağlanırsa, packageName bu alanla birlikte sağlanması gerektiğini açıklayan bir hata atılır. 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.
handleCodeInApp (boolean|tanımsız) 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.
dynamicLinkDomain (dize|tanımsız) 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, özel dinamik bağlantı alanı example.page.link (iOS uygulaması com.example.ios veya Android uygulaması com.example.android Henüz yüklü değilse uygulamanın yükleneceği com.example.android ve minimum sürüm 12 ). Derin bağlantı, https://www.example.com/?email=user@example.com devam URL'si yükünü içerecektir.

var actionCodeSettings = {
  url: 'https://www.example.com/?email=' + firebase.auth().currentUser.email,
  iOS: {
    bundleId: 'com.example.ios'
  },
  android: {
    packageName: 'com.example.android',
    installApp: true,
    minimumVersion: '12'
  },
  handleCodeInApp: true,
  // When multiple custom dynamic link domains are defined, specify which
  // one to use.
  dynamicLinkDomain: "example.page.link"
};
firebase.auth().currentUser.sendEmailVerification(actionCodeSettings)
  .then(function() {
    // Verification email sent.
  })
  .catch(function(error) {
    // Error occurred. Inspect error.code.
  });

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, firebase.auth.ActionCodeSettings nesnesinde handleCodeInApp false olarak ayarlayarak 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, android.installApp aracılığıyla, cihazın desteklemesi ve halihazırda yüklü olmaması halinde 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, firebase.auth.ActionCodeSettings nesnesinde handleCodeInApp öğesinin true değerine ayarlanmasıyla yapılır. Mobil uygulamanın Android paket adının veya iOS paket kimliğinin de belirtilmesi gerekecektir.

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.