JavaScript Kullanarak Firebase ile Telefon Numarasıyla Kimlik Doğrulama

Kullanıcının telefonuna SMS mesajı göndererek oturum açmasını sağlamak için Firebase Authentication kullanabilirsiniz. Kullanıcı, SMS mesajında yer alan tek kullanımlık kodu kullanarak oturum açar.

Uygulamanıza telefon numarasıyla oturum açma özelliği eklemenin en kolay yolu, telefon numarasıyla oturum açmanın yanı sıra şifre tabanlı ve birleşik oturum açma için oturum açma akışlarını uygulayan bir oturum açma widget'ı içeren FirebaseUI'ı kullanmaktır. Bu dokümanda, Firebase SDK'sını kullanarak telefon numarasıyla oturum açma akışının nasıl uygulanacağı açıklanmaktadır.

Başlamadan önce

Henüz yapmadıysanız Firebase konsolundaki başlatma snippet'ini Firebase'i JavaScript projenize ekleme bölümünde açıklandığı şekilde projenize kopyalayın.

Güvenlik endişeleri

Yalnızca telefon numarasıyla kimlik doğrulama, kullanışlı olsa da diğer yöntemlere kıyasla daha az güvenlidir. Bunun nedeni, telefon numarası sahipliğinin kullanıcılar arasında aktarılabilmesidir. Ayrıca, birden fazla kullanıcı profili olan cihazlarda SMS mesajı alabilen tüm kullanıcılar, cihazın telefon numarasını kullanarak bir hesapta oturum açabilir.

Uygulamanızda telefon numarasına dayalı oturum açma yöntemini kullanıyorsanız bu yöntemi daha güvenli oturum açma yöntemleriyle birlikte sunmanız ve kullanıcıları telefon numarasıyla oturum açmanın güvenlik açısından dezavantajları konusunda bilgilendirmeniz gerekir.

Firebase projeniz için telefon numarasıyla oturum açma özelliğini etkinleştirme

Kullanıcıların SMS ile oturum açabilmesi için önce Firebase projenizde telefon numarasıyla oturum açma yöntemini etkinleştirmeniz gerekir:

  1. Firebase konsolunda Güvenlik > Kimlik doğrulama'ya gidin.
  2. Sign-in method (Oturum açma yöntemi) sekmesinde Phone (Telefon) oturum açma sağlayıcısını etkinleştirin.
  3. SMS mesajlarının gönderilmesine izin vermek veya reddetmek istediğiniz bölgeler için bir politika belirleyin. SMS bölge politikası belirlemek, uygulamalarınızı SMS kötüye kullanımına karşı korumaya yardımcı olabilir. Yeni projeler için varsayılan politika hiçbir bölgeye izin vermez.
    1. Firebase konsolunda Security (Güvenlik) > Authentication (Kimlik Doğrulama) > Settings (Ayarlar) sekmesine gidin.
    2. SMS bölge politikası bölümünde SMS bölge politikanızı oluşturun.
  4. Henüz yapmadıysanız uygulamanızın alan adını yetkilendirin:
    1. Firebase konsolunda Security (Güvenlik) > Authentication (Kimlik Doğrulama) > Settings (Ayarlar) sekmesine gidin.
    2. Yetkili alanlar bölümünde Alan ekle'yi tıklayın ve alanınızı ekleyin.

    Telefonla kimlik doğrulama için localhost'un barındırılan alan adı olarak kullanılmasına izin verilmez.

reCAPTCHA doğrulayıcıyı ayarlama

Kullanıcıların telefon numaralarıyla oturum açabilmesi için Firebase'in reCAPTCHA doğrulayıcısını ayarlamanız gerekir. Firebase, kötüye kullanımı önlemek için reCAPTCHA'yı kullanır. Örneğin, telefon numarası doğrulama isteğinin uygulamanızın izin verilen alanlarından birinden geldiğinden emin olur.

reCAPTCHA istemcisini manuel olarak ayarlamanız gerekmez. Firebase SDK'sının RecaptchaVerifier nesnesini kullandığınızda Firebase, gerekli istemci anahtarlarını ve gizli anahtarları otomatik olarak oluşturup yönetir.

RecaptchaVerifier nesnesi, genellikle kullanıcı işlemi gerektirmeden kullanıcıyı doğrulayabilen görünmez reCAPTCHA'yı ve başarıyla tamamlanması için her zaman kullanıcı etkileşimi gerektiren reCAPTCHA widget'ını destekler.

Temelde oluşturulan reCAPTCHA, reCAPTCHA oluşturulmadan önce Auth örneğindeki dil kodu güncellenerek kullanıcının tercihine göre yerelleştirilebilir. Söz konusu yerelleştirme, kullanıcıya gönderilen ve doğrulama kodunu içeren SMS mesajı için de geçerli olacaktır.

Web

import { getAuth } from "firebase/auth";

const auth = getAuth();
auth.languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// auth.useDeviceLanguage();

Web

firebase.auth().languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// firebase.auth().useDeviceLanguage();

Görünmez reCAPTCHA kullanma

Görünmez reCAPTCHA kullanmak için size parametresi invisible olarak ayarlanmış bir RecaptchaVerifier nesnesi oluşturun ve oturum açma formunuzu gönderen düğmenin kimliğini belirtin. Örneğin:

Web

import { getAuth, RecaptchaVerifier } from "firebase/auth";

const auth = getAuth();
window.recaptchaVerifier = new RecaptchaVerifier(auth, 'sign-in-button', {
  'size': 'invisible',
  'callback': (response) => {
    // reCAPTCHA solved, allow signInWithPhoneNumber.
    onSignInSubmit();
  }
});

Web

window.recaptchaVerifier = new firebase.auth.RecaptchaVerifier('sign-in-button', {
  'size': 'invisible',
  'callback': (response) => {
    // reCAPTCHA solved, allow signInWithPhoneNumber.
    onSignInSubmit();
  }
});

reCAPTCHA widget'ını kullanma

Görünür reCAPTCHA widget'ını kullanmak için sayfanızda widget'ı içerecek bir öğe oluşturun ve ardından bir RecaptchaVerifier nesnesi oluşturarak kapsayıcının kimliğini belirtin. Örneğin:

Web

import { getAuth, RecaptchaVerifier } from "firebase/auth";

const auth = getAuth();
window.recaptchaVerifier = new RecaptchaVerifier(auth, 'recaptcha-container', {});

Web

window.recaptchaVerifier = new firebase.auth.RecaptchaVerifier('recaptcha-container');

İsteğe bağlı: reCAPTCHA parametrelerini belirtme

İsteğe bağlı olarak, kullanıcı reCAPTCHA'yı çözdüğünde veya kullanıcı formu göndermeden önce reCAPTCHA'nın süresi dolduğunda çağrılan RecaptchaVerifier nesnesinde geri çağırma işlevleri ayarlayabilirsiniz:

Web

import { getAuth, RecaptchaVerifier } from "firebase/auth";

const auth = getAuth();
window.recaptchaVerifier = new RecaptchaVerifier(auth, 'recaptcha-container', {
  'size': 'normal',
  'callback': (response) => {
    // reCAPTCHA solved, allow signInWithPhoneNumber.
    // ...
  },
  'expired-callback': () => {
    // Response expired. Ask user to solve reCAPTCHA again.
    // ...
  }
});

Web

window.recaptchaVerifier = new firebase.auth.RecaptchaVerifier('recaptcha-container', {
  'size': 'normal',
  'callback': (response) => {
    // reCAPTCHA solved, allow signInWithPhoneNumber.
    // ...
  },
  'expired-callback': () => {
    // Response expired. Ask user to solve reCAPTCHA again.
    // ...
  }
});

İsteğe bağlı: reCAPTCHA'yı önceden oluşturma

Oturum açma isteği göndermeden önce reCAPTCHA'yı önceden oluşturmak istiyorsanız render yöntemini çağırın:

Web

recaptchaVerifier.render().then((widgetId) => {
  window.recaptchaWidgetId = widgetId;
});

Web

recaptchaVerifier.render().then((widgetId) => {
  window.recaptchaWidgetId = widgetId;
});

render çözümlendikten sonra reCAPTCHA'nın widget kimliğini alırsınız. Bu kimliği, reCAPTCHA API'ye çağrı yapmak için kullanabilirsiniz:

Web

const recaptchaResponse = grecaptcha.getResponse(recaptchaWidgetId);

Web

const recaptchaResponse = grecaptcha.getResponse(recaptchaWidgetId);

Kullanıcının telefonuna doğrulama kodu gönderme

Telefon numarasıyla oturum açma işlemini başlatmak için kullanıcıya telefon numarasını girmesini isteyen bir arayüz gösterin ve ardından Firebase'in kullanıcının telefonuna SMS ile kimlik doğrulama kodu göndermesini istemek için signInWithPhoneNumber yöntemini çağırın:

  1. Kullanıcının telefon numarasını alma

    Yasal koşullar değişiklik gösterir ancak en iyi uygulama olarak ve kullanıcılarınızın beklentilerini belirlemek için, telefonla oturum açma özelliğini kullanmaları durumunda doğrulama için bir SMS mesajı alabileceklerini ve standart ücretlerin geçerli olduğunu onlara bildirmeniz gerekir.

  2. Kullanıcının telefon numarasını ve daha önce oluşturduğunuz RecaptchaVerifier değerini ileterek signInWithPhoneNumber yöntemini çağırın.

    Web

    import { getAuth, signInWithPhoneNumber } from "firebase/auth";
    
    const phoneNumber = getPhoneNumberFromUserInput();
    const appVerifier = window.recaptchaVerifier;
    
    const auth = getAuth();
    signInWithPhoneNumber(auth, phoneNumber, appVerifier)
        .then((confirmationResult) => {
          // SMS sent. Prompt user to type the code from the message, then sign the
          // user in with confirmationResult.confirm(code).
          window.confirmationResult = confirmationResult;
          // ...
        }).catch((error) => {
          // Error; SMS not sent
          // ...
        });

    Web

    const phoneNumber = getPhoneNumberFromUserInput();
    const appVerifier = window.recaptchaVerifier;
    firebase.auth().signInWithPhoneNumber(phoneNumber, appVerifier)
        .then((confirmationResult) => {
          // SMS sent. Prompt user to type the code from the message, then sign the
          // user in with confirmationResult.confirm(code).
          window.confirmationResult = confirmationResult;
          // ...
        }).catch((error) => {
          // Error; SMS not sent
          // ...
        });
    signInWithPhoneNumber bir hatayla sonuçlanırsa kullanıcının tekrar deneyebilmesi için reCAPTCHA'yı sıfırlayın:
    grecaptcha.reset(window.recaptchaWidgetId);
    
    // Or, if you haven't stored the widget ID:
    window.recaptchaVerifier.render().then(function(widgetId) {
      grecaptcha.reset(widgetId);
    });

signInWithPhoneNumber yöntemi, kullanıcıya reCAPTCHA doğrulamasını gösterir. Kullanıcı doğrulamayı geçerse Firebase Authentication, kullanıcının telefonuna doğrulama kodu içeren bir SMS mesajı gönderir.

Kullanıcıyı doğrulama koduyla oturum açmaya yönlendirme

signInWithPhoneNumber numaralı telefona yapılan arama başarılı olduktan sonra kullanıcıdan SMS ile aldığı doğrulama kodunu yazmasını isteyin. Ardından, kodu signInWithPhoneNumber'nin karşılama işleyicisine (yani then bloğuna) iletilen ConfirmationResult nesnesinin confirm yöntemine ileterek kullanıcının oturum açmasını sağlayın. Örneğin:

Web

const code = getCodeFromUserInput();
confirmationResult.confirm(code).then((result) => {
  // User signed in successfully.
  const user = result.user;
  // ...
}).catch((error) => {
  // User couldn't sign in (bad verification code?)
  // ...
});

Web

const code = getCodeFromUserInput();
confirmationResult.confirm(code).then((result) => {
  // User signed in successfully.
  const user = result.user;
  // ...
}).catch((error) => {
  // User couldn't sign in (bad verification code?)
  // ...
});

confirm çağrısı başarılı olursa kullanıcının oturumu başarıyla açılır.

Ara AuthCredential nesnesini alma

Kullanıcının hesabı için bir AuthCredential nesnesi almanız gerekiyorsa confirm yöntemini çağırmak yerine onay sonucundaki doğrulama kodunu ve doğrulama kodunu PhoneAuthProvider.credential yöntemine iletin:

var credential = firebase.auth.PhoneAuthProvider.credential(confirmationResult.verificationId, code);

Ardından, kimlik bilgileriyle kullanıcının oturumunu açabilirsiniz:

firebase.auth().signInWithCredential(credential);

Kurgusal telefon numaralarıyla test etme

Firebase konsolunu kullanarak geliştirme için kurgusal telefon numaraları oluşturabilirsiniz. Kurgusal telefon numaralarıyla test yapmanın avantajları şunlardır:

  • Kullanım kotanızı tüketmeden telefon numarası kimlik doğrulamasını test edin.
  • Gerçek bir SMS mesajı göndermeden telefon numarası kimlik doğrulamasını test edin.
  • Aynı telefon numarasıyla kısıtlama olmadan ardışık testler çalıştırabilirsiniz. Bu sayede, inceleme uzmanı test için aynı telefon numarasını kullanırsa uygulama mağazası inceleme sürecinde reddedilme riski en aza indirilir.
  • Google Play Hizmetleri olmadan iOS simülatöründe veya Android emülatöründe geliştirme yapabilme gibi ek bir çaba gerektirmeden geliştirme ortamlarında kolayca test edin.
  • Üretim ortamında gerçek telefon numaralarına normalde uygulanan güvenlik kontrolleri tarafından engellenmeden entegrasyon testleri yazma

Kurgusal telefon numaraları şu koşulları karşılamalıdır:

  1. Kullandığınız telefon numaralarının gerçekten kurgusal olduğundan ve mevcut olmadığından emin olun. Firebase Authentication, gerçek kullanıcılar tarafından kullanılan mevcut telefon numaralarını test numarası olarak ayarlamanıza izin vermez. Seçeneklerden biri, ABD test telefon numaraları olarak 555 ön ekli numaraları kullanmaktır. Örneğin: +1 650-555-3434
  2. Telefon numaraları, uzunluk ve diğer kısıtlamalar açısından doğru şekilde biçimlendirilmelidir. Bu numaralar, gerçek bir kullanıcının telefon numarasıyla aynı doğrulama sürecinden geçer.
  3. Geliştirme için en fazla 10 telefon numarası ekleyebilirsiniz.
  4. Tahmin edilmesi zor test telefon numaraları/kodları kullanın ve bunları sık sık değiştirin.

Kurgusal telefon numaraları ve doğrulama kodları oluşturma

  1. Firebase konsolunda Güvenlik > Kimlik doğrulama'ya gidin.
  2. Oturum açma yöntemi sekmesinde, henüz yapmadıysanız Telefon oturum açma sağlayıcısını etkinleştirin.
  3. Test amaçlı telefon numaraları bölümünü genişletin.
  4. Test etmek istediğiniz telefon numarasını girin. Örneğin: +1 650-555-3434.
  5. Bu numara için 6 haneli doğrulama kodunu girin. Örneğin: 654321.
  6. Her numara için Ekle'yi tıklayın. Gerekirse ilgili satırın üzerine gelip çöp kutusu simgesini tıklayarak telefon numarasını ve kodunu silebilirsiniz.

Manuel test

Uygulamanızda kurgusal bir telefon numarasını doğrudan kullanmaya başlayabilirsiniz. Bu sayede, geliştirme aşamalarında kota sorunları veya kısıtlamalarla karşılaşmadan manuel testler yapabilirsiniz. Ayrıca, Google Play Hizmetleri yüklü olmadan doğrudan bir iOS simülatöründen veya Android emülatöründen de test edebilirsiniz.

Kurgusal telefon numarasını girip doğrulama kodunu gönderdiğinizde gerçek bir SMS gönderilmez. Bunun yerine, oturum açma işlemini tamamlamak için önceden yapılandırılmış doğrulama kodunu girmeniz gerekir.

Oturum açma işlemi tamamlandığında bu telefon numarasıyla bir Firebase kullanıcısı oluşturulur. Kullanıcı, gerçek bir telefon numarası kullanıcısıyla aynı davranış ve özelliklere sahiptir ve Realtime Database/Cloud Firestore ile diğer hizmetlere aynı şekilde erişebilir. Bu işlem sırasında oluşturulan kimlik jetonu, gerçek bir telefon numarası kullanıcısıyla aynı imzaya sahiptir.

Erişimi daha da kısıtlamak istiyorsanız bu kullanıcıları sahte kullanıcı olarak ayırt etmek için özel hak talepleri aracılığıyla bir test rolü belirleyebilirsiniz.

Entegrasyon testi

Firebase Authentication, manuel testin yanı sıra telefonla kimlik doğrulama testi için entegrasyon testleri yazmaya yardımcı olan API'ler de sağlar. Bu API'ler, web'de reCAPTCHA şartını ve iOS'te sessiz push bildirimlerini devre dışı bırakarak uygulama doğrulamayı devre dışı bırakır. Bu sayede, bu akışlarda otomasyon testi yapılabilir ve daha kolay uygulanabilir. Ayrıca, Android'de anında doğrulama akışlarını test etme olanağı sunar.

Web'de, firebase.auth.RecaptchaVerifier öğesini oluşturmadan önce appVerificationDisabledForTesting değerini true olarak ayarlayın. Bu, reCAPTCHA'yı otomatik olarak çözerek telefon numarasını manuel olarak çözmeden geçmenizi sağlar. reCAPTCHA devre dışı bırakılmış olsa bile kurgusal olmayan bir telefon numarası kullanıldığında oturum açma işleminin tamamlanamayacağını unutmayın. Bu API ile yalnızca kurgusal telefon numaraları kullanılabilir.

// Turn off phone auth app verification.
firebase.auth().settings.appVerificationDisabledForTesting = true;

var phoneNumber = "+16505554567";
var testVerificationCode = "123456";

// This will render a fake reCAPTCHA as appVerificationDisabledForTesting is true.
// This will resolve after rendering without app verification.
var appVerifier = new firebase.auth.RecaptchaVerifier('recaptcha-container');
// signInWithPhoneNumber will call appVerifier.verify() which will resolve with a fake
// reCAPTCHA response.
firebase.auth().signInWithPhoneNumber(phoneNumber, appVerifier)
    .then(function (confirmationResult) {
      // confirmationResult can resolve with the fictional testVerificationCode above.
      return confirmationResult.confirm(testVerificationCode)
    }).catch(function (error) {
      // Error; SMS not sent
      // ...
    });

Görünür ve görünmez sahte reCAPTCHA uygulama doğrulayıcıları, uygulama doğrulama devre dışı bırakıldığında farklı davranır:

  • Görünür reCAPTCHA: Görünür reCAPTCHA, appVerifier.render() aracılığıyla oluşturulduğunda bir saniyeden kısa bir gecikmenin ardından otomatik olarak çözülür. Bu, kullanıcının oluşturma işleminden hemen sonra reCAPTCHA'yı tıklamasıyla eşdeğerdir. reCAPTCHA yanıtının süresi bir süre sonra dolar ve ardından tekrar otomatik olarak çözülür.
  • Görünmez reCAPTCHA: Görünmez reCAPTCHA, oluşturma sırasında otomatik olarak çözülmez. Bunun yerine, appVerifier.verify() çağrısı yapıldığında veya reCAPTCHA'nın düğme bağlantısı tıklandığında bir saniyeden kısa bir gecikmeyle çözülür. Benzer şekilde, yanıtın süresi bir süre sonra dolar ve yalnızca appVerifier.verify() çağrısından sonra veya reCAPTCHA'nın düğme bağlantısı tekrar tıklandığında otomatik olarak çözülür.

Sahte bir reCAPTCHA çözüldüğünde, ilgili geri çağırma işlevi sahte yanıtla beklendiği gibi tetiklenir. Süre sonu geri çağırma işlevi de belirtilmişse süre dolduğunda tetiklenir.

Sonraki adımlar

Kullanıcı ilk kez oturum açtıktan sonra yeni bir kullanıcı hesabı oluşturulur ve kullanıcının oturum açarken kullandığı kimlik bilgilerine (kullanıcı adı ve şifre, telefon numarası veya kimlik doğrulama sağlayıcı bilgileri) bağlanır. Bu yeni hesap, Firebase projenizin bir parçası olarak depolanır ve kullanıcının nasıl oturum açtığından bağımsız olarak projenizdeki her uygulamada kullanıcıyı tanımlamak için kullanılabilir.

  • Uygulamalarınızda, kullanıcınızın kimlik doğrulama durumunu öğrenmenin önerilen yolu, Auth nesnesinde bir gözlemci ayarlamaktır. Ardından, kullanıcının temel profil bilgilerini User nesnesinden alabilirsiniz. Kullanıcıları yönetme başlıklı makaleyi inceleyin.

  • Firebase Realtime Database ve Cloud Storage Güvenlik Kurallarınızda, oturum açmış kullanıcının benzersiz kullanıcı kimliğini auth değişkeninden alabilir ve kullanıcının hangi verilere erişebileceğini kontrol etmek için kullanabilirsiniz.

Kimlik doğrulama sağlayıcı kimlik bilgilerini mevcut bir kullanıcı hesabına bağlayarak kullanıcıların birden fazla kimlik doğrulama sağlayıcısı kullanarak uygulamanızda oturum açmasına izin verebilirsiniz.

Bir kullanıcının oturumunu kapatmak için signOut yöntemini çağırın:

Web

import { getAuth, signOut } from "firebase/auth";

const auth = getAuth();
signOut(auth).then(() => {
  // Sign-out successful.
}).catch((error) => {
  // An error happened.
});

Web

firebase.auth().signOut().then(() => {
  // Sign-out successful.
}).catch((error) => {
  // An error happened.
});