E-posta İşlemlerinde Aktarma Durumu

Şifre için e-posta işlemleri gönderirken devam URL'si aracılığıyla durumu iletebilirsiniz. Kullanıcının e-posta adresini sıfırlar veya doğrular. Bu, kullanıcının İşlem tamamlandıktan sonra uygulamaya geri dönebilir. Ek olarak, aşağıdaki durumlarda e-posta işlem bağlantısının doğrudan bir mobil uygulamadan işlenip işlenmeyeceğini web sayfası yerine yüklenir.

Bu, aşağıdaki sık karşılaşılan senaryolarda son derece yararlı olabilir:

  • Henüz giriş yapmamış bir kullanıcı, kullanıcının oturum açmış olması gerekir. Ancak kullanıcı bu içeriği unutmuş olabilir ve dolayısıyla şifre sıfırlama akışını tetikler. Baktığınızda, akışa döndüğünde, kullanıcı uygulamada daha önce göründüğü bölüme geri dönmeyi biraz zorlandık.

  • Uygulamalar yalnızca doğrulanmış hesaplara erişim sunabilir. Örneğin, Örneğin, bir bültende kullanıcının, e-posta adresini abone olma. Kullanıcı e-posta doğrulama akışından geçer ve uygulamaya geri dönüp aboneliğini tamamlayabilir.

  • Diğer durumlarda, kullanıcı akışı mobil cihazından başlatmış olabilir. ve doğrulama işleminden sonra mobil uygulama mağazasına geri dönmelerini tarayıcı.

Devam URL'si aracılığıyla durum iletme imkanı, Firebase Auth, kullanıcı deneyimini önemli ölçüde geliştirebilen bir destek sunar.

E-posta işlemlerinde durum/devam URL'si iletme

Devam eden bir URL'yi güvenli bir şekilde iletmek için URL'nin alanının Firebase konsolunda Yetkilendirilmiş alan olarak eklenmelidir. Bu işlem, Kimlik Doğrulama bölümünde bu alanı Oturum açma yöntemi sekmesindeki Yetkili alanlar listesinde bu seçeneği göremiyorsanız.

Gönderim sırasında bir firebase.auth.ActionCodeSettings örneği sağlanmalıdır şifre sıfırlama e-postası veya doğrulama e-postası. Bu arayüz, şu parametrelere sahiptir:

Parametre Tür Açıklama
url dize

Farklı anlamları olan bağlantıyı (durum/devam URL'si) ayarlar farklı bağlamlarda görebilirsiniz:

  • Bağlantı, web işlemi widget'larında işlendiğinde bağlantısını continueUrl sorgu parametresinde kullanmalısınız.
  • Bağlantı doğrudan uygulamada işlendiğinde continueUrl sorgu parametresi, Dinamik Bağlantı.
iOS ({bundleId: string}|tanımsız) iOS paket kimliğini ayarlar. Bu işlem, aşağıdaki durumlarda bağlantıyı bir iOS uygulamasında açmaya çalışır: yüklü olmalıdır. iOS uygulamasının Console'a kayıtlı olması gerekir.
android ({packageName: string, installApp:boole|undefined, minimumVersion: dize|tanımsız}|tanımsız) Android paketi adını ayarlar. Bu işlem, bağlantıyı Android uygulaması yüklüyse. installApp geçilirse Android uygulamasının desteklenmesi durumunda Android uygulamasının yüklenip yüklenmeyeceğini belirtir Uygulama yüklü değil. Bu alan bir olmadan sağlanırsa packageName, packageName bu alanla bağlantılı olarak sağlanmalıdır. minimumVersion belirtilmişse ve yüklendikten sonra, kullanıcı uygulamayı yeni sürüme geçirmek üzere Play Store'a yönlendirilir. Android uygulamasının Console'da kayıtlı olması gerekir.
handleCodeInApp (boole|tanımsız) E-posta işlemi bağlantısının mobil uygulamada mı yoksa web'de mi açılacağı bağlantısını tıklayın. Varsayılan değer, false (yanlış) değeridir. Doğru değerine ayarlandığında, işlem kodu bağlantısı geçiş bağlantısı veya Android uygulama bağlantısı olarak gönderilecek ve uygulama tarafından geri yüklenir. Yanlış durumda kod, web widget'ı, ardından Devam'da yüklendi.
dynamicLinkDomain (dize|tanımsız) Geçerli bağlantı için kullanılacak dinamik bağlantı alan adını (veya alt alan adını) ayarlar Firebase Dynamic Links kullanılarak açılacaksa. Çoklu dinamik bağlantı alanları proje başına yapılandırılabilir. Bu alan, birini seçme olanağınız vardır. Herhangi bir alan sağlanmazsa varsayılan olarak kullanılır.

Aşağıdaki örnekte, bir e-posta doğrulama bağlantısının Firebase Dynamic Link olarak, öncelikle bir mobil uygulamada dinamik bağlantı alan adı example.page.link (iOS uygulaması com.example.ios veya Android uygulaması com.example.android; burada, uygulamanın (yüklü değilse ve minimum sürüm 12 ise) yüklenir). İlgili içeriği oluşturmak için kullanılan derin bağlantı, devam eden URL yükünü içerir https://www.example.com/?email=user@example.com.

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 bağlantıdır. Bunu yapmak için özelliği yoksa, Firebase Konsolu'nda Dynamic Links'in yapılandırılması gerekir.

  1. Firebase Dynamic Links'i etkinleştirin:

    1. Firebase konsolunda Dynamic Links bölümünü açın.
    2. Dynamic Links şartlarını henüz kabul etmediyseniz ve Dynamic Links oluşturduysanız kullanıyorsanız bunu hemen yapın.

      Daha önce Dynamic Links alanı oluşturduysanız bunu not edin. Dynamic Links alan genellikle aşağıdaki örnekteki gibi görünür:

      example.page.link

      Apple veya Android uygulamanızı aşağıdaki amaçlarla yapılandırırken bu değere ihtiyacınız olacaktır: izlemesi için bir istek oluşturur.

  2. Android uygulamalarını yapılandırma:

    1. Bu bağlantıları Android uygulamanızdan işlemeyi planlıyorsanız Android paket adının Firebase Konsolu'nda belirtilmesi gerekir iyi bir fırsattır. Ek olarak, uygulamanın SHA-1 ve SHA-256 sağlayabilirsiniz.
    2. Ayrıca, derin bağlantı için intent filtresini şurada yapılandırmanız gerekir: AndroidManifest.xml dosyanız.
    3. Bu konuyla ilgili daha fazla bilgi için Android Dynamic Links ile ilgili talimatları alma.
  3. iOS uygulamalarını yapılandırma:

    1. Bu bağlantıları iOS uygulamanızdan işlemeyi planlıyorsanız iOS paket kimliğinin Firebase Konsolu'nda belirtilmesi gerekiyor iyi bir fırsattır. Buna ek olarak, App Store Kimliği ve Apple Developer Ekip kimliğinin de belirtilmesi gerekir.
    2. Ayrıca FDL evrensel bağlantı alanını Uygulama özelliklerinizde ilişkili alan.
    3. Uygulamanızı iOS 8 ve daha eski sürümlere dağıtmayı planlıyorsanız iOS paket kimliğinizi gelen e-posta adresi için özel şema olarak ayarlamanız gerekir URL'ler.
    4. Bu konuyla ilgili daha fazla bilgi için iOS Dynamic Links talimatlarını alma.

Web uygulamasındaki e-posta işlemlerini işleme

Bir web'den işlem kodu bağlantısını işlemek isteyip istemediğinizi belirtebilirsiniz uygulamanız ve ardından başka bir web sayfasına veya mobil uygulamaya yönlendirmesi ve mobil uygulamanın kullanılabilir olması koşuluyla, başarılı bir şekilde tamamlandıktan sonra. Bu, handleCodeInApp öğesini false firebase.auth.ActionCodeSettings nesne. iOS paket kimliği veya Android paket adı zorunlu değildir. Bu adların sağlanması, kullanıcının e-posta işlem kodu tamamlandığında belirtilen uygulamaya geri yönlendirmek için.

Burada kullanılan web URL'si, e-posta işlem şablonlarında yapılandırılan web URL'sidir. bölümüne ekleyin. Tüm projeler için varsayılan bir temel sağlanır. Referans e-posta işleyicilerini özelleştirme hakkında daha fazla bilgi nasıl özelleştirileceğini anlatacağım.

Bu durumda, continueUrl sorgu parametresindeki bağlantı yükü ActionCodeSettings içinde belirtilen URL olan bir FDL bağlantısı nesnesini tanımlayın. Uygulamanızdan gelen bağlantıya müdahale edip bunları işleyebilirsiniz bağımlı bir dosya yoksa FDL istemci kitaplığını kullanarak derin bağlantıyı sizin yerinize ayrıştırır.

E-posta doğrulaması gibi e-posta işlemlerini gerçekleştirirken oobCode sorgu parametresinin derin bağlantıdan ayrıştırılması ve ardından uygulanması gerekir applyActionCode aracılığıyla gönderilen e-posta adresine bir bildirimi gönderin.

Mobil uygulamada e-posta işlemlerini yönetme

Şuradaki işlem kodu bağlantısını kullanmak isteyip istemediğinizi belirtebilirsiniz: mobil uygulamanız olması gerekir. Android uygulamalarında android.installApp aracılığıyla uygulamanın kullanıma sunulacağını Cihaz destekleniyorsa ve yüklü değilse yüklenmelidir. Bağlantı, mobil cihazları desteklemeyen bir cihazdan tıklanırsa uygulamada açılırsa bunun yerine bir web sayfasından açılır. Bu, handleCodeInApp öğesini true firebase.auth.ActionCodeSettings nesne. 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 yapılandırıldı. Varsayılan bir temel hazırlandı sahip olacaksınız. Referans e-posta işleyicilerini özelleştirme hakkında daha fazla bilgi nasıl özelleştirileceğini anlatacağım.

Bu durumda, kullanıcıya gönderilen mobil uygulama bağlantısı bir FDL bağlantısı olacaktır. yük, sorguyla birlikte Console'da yapılandırılan işlem kodu URL'sidir. oobCode, mode, apiKey ve continueUrl parametreleri. İkincisi, kampanya ActionCodeSettings nesnesinde belirtilen orijinal URL. Projeyi ek herhangi bir ek olmadan uygulamanızdan gelen bağlantıya müdahale edin ve varsa, web sitesinin derin bağlantısını ayrıştırmak için FDL istemci kitaplığını siz. İşlem kodu, benzer bir mobil uygulamadan doğrudan uygulanabilir web akışında nasıl ele alındığına e-posta işleyicilerini özelleştirme bölümüne göz atın.

E-posta doğrulaması gibi e-posta işlemlerini gerçekleştirirken oobCode sorgu parametresinin derin bağlantıdan ayrıştırılması ve ardından uygulanması gerekir applyActionCode aracılığıyla gönderilen e-posta adresine bir bildirimi gönderin.