Ş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:
|
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 Dynamic Links'i yapılandırma
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.
Firebase Dynamic Links'i etkinleştirin:
- Firebase konsolunda Dynamic Links bölümünü açın.
-
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.
Android uygulamalarını yapılandırma:
- 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.
- Ayrıca, derin bağlantı için intent filtresini şurada yapılandırmanız gerekir:
AndroidManifest.xml
dosyanız. - Bu konuyla ilgili daha fazla bilgi için Android Dynamic Links ile ilgili talimatları alma.
iOS uygulamalarını yapılandırma:
- 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.
- Ayrıca FDL evrensel bağlantı alanını Uygulama özelliklerinizde ilişkili alan.
- 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.
- 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.