Üçüncü taraf depolama alanı erişimini engelleyen tarayıcılarda signInWithRedirect'i kullanmaya yönelik en iyi uygulamalar

Bu belgede, üçüncü taraf çerezlerini engelleyen tarayıcılarda yönlendirmeli oturum açma işlemlerini kullanmayla ilgili en iyi uygulamalar açıklanmaktadır. signInWithRedirect() özelliğinin üretim ortamlarında, tüm tarayıcılarda amaçlandığı gibi çalışması için burada listelenen seçeneklerden birini uygulamanız gerekir.

Genel Bakış

signInWithRedirect() akışını siz ve kullanıcılarınız için sorunsuz hale getirmek amacıyla Firebase Authentication JavaScript SDK'sı, uygulamanızın Firebase Hosting barındırılan alan adına bağlanan bir çapraz kaynak iframe kullanır. Ancak bu mekanizma, üçüncü taraf depolama alanı erişimini engelleyen tarayıcılarda çalışmaz.

Kullanıcılarınızdan tarayıcıda Depolama Bölümlendirme özelliklerini devre dışı bırakmalarını istemek nadiren bir seçenek olduğundan, kullanım alanınızın özelliklerine bağlı olarak uygulamanıza aşağıdaki kurulum seçeneklerinden birini uygulamanız gerekir.

  • Uygulamanızı firebaseapp.com alt alan adında Firebase Hosting ile barındırıyorsanız bu sorundan etkilenmezsiniz ve herhangi bir işlem yapmanız gerekmez.
  • Uygulamanızı Firebase Hosting ile özel bir alanda veya web.app alt alanında barındırıyorsanız 1. seçeneği kullanın.
  • Uygulamanızı Firebase dışında bir hizmetle barındırıyorsanız 2. seçenek, 3. seçenek, 4. seçenek veya 5. seçeneği kullanın.

1. seçenek: Firebase yapılandırmanızı, özel alanınızı authDomain olarak kullanacak şekilde güncelleyin

Uygulamanızı özel alan adı kullanarak Firebase Hosting'de barındırıyorsanız Firebase SDK'sını, özel alan adınızı authDomain olarak kullanacak şekilde yapılandırabilirsiniz. Bu sayede uygulamanız ve kimlik doğrulama iFrame'i aynı alanı kullanır ve oturum açma sorunu önlenir. (Firebase Hosting kullanmıyorsanız farklı bir seçenek kullanmanız gerekir.) Özel alan adını, kimlik doğrulama için kullandığınız projede ayarladığınızdan emin olun.

Firebase yapılandırmanızı, özel alanınızı kimlik doğrulama alanınız olarak kullanacak şekilde güncellemek için aşağıdakileri yapın:

  1. Firebase JS SDK'sını, özel alanınızı authDomain olarak kullanacak şekilde yapılandırın:

    const firebaseConfig = {
      apiKey: "<api-key>",
      authDomain: "<the-domain-that-serves-your-app>",
      databaseURL: "<database-url>",
      projectId: "<project-id>",
      appId: "<app-id>"
    };
    
  1. Yeni authDomain değerini OAuth sağlayıcınızın yetkili yönlendirme URI'leri listesine ekleyin. Bunu nasıl yapacağınız sağlayıcıya bağlıdır ancak genel olarak tam talimatlar için herhangi bir sağlayıcıdaki "Başlamadan önce" bölümünü takip edebilirsiniz (örneğin, Facebook sağlayıcısı). Yetkilendirme için güncellenen URI, https://<the-domain-that-serves-your-app>/__/auth/handler şeklindedir. Sondaki /__/auth/handler önemlidir.

    Benzer şekilde, bir SAML sağlayıcısı kullanıyorsanız yeni authDomain değerini SAML Onaylama Tüketici Hizmeti (ACS) URL'sine ekleyin.

  2. continue_uri alanınızın yetkili alanlar listesinde olduğundan emin olun.

  3. /__/firebase/init.json adresinde barındırılan en güncel Firebase yapılandırma dosyasını almak için gerekirse Firebase Hosting ile yeniden dağıtın.

2. seçenek: signInWithPopup() yöntemine geçme

signInWithRedirect() yerine signInWithPopup() kullanın. Uygulama kodunuzun geri kalanı aynı kalır ancak UserCredential nesnesi farklı şekilde alınır.

Web

  // Before
  // ==============
  signInWithRedirect(auth, new GoogleAuthProvider());
  // After the page redirects back
  const userCred = await getRedirectResult(auth);

  // After
  // ==============
  const userCred = await signInWithPopup(auth, new GoogleAuthProvider());

Web

  // Before
  // ==============
  firebase.auth().signInWithRedirect(new firebase.auth.GoogleAuthProvider());
  // After the page redirects back
  var userCred = await firebase.auth().getRedirectResult();

  // After
  // ==============
  var userCred = await firebase.auth().signInWithPopup(
      new firebase.auth.GoogleAuthProvider());
```

Pop-up oturum açma, kullanıcılar için her zaman ideal değildir. Pop-up'lar bazen cihaz veya platform tarafından engellenir ve mobil kullanıcılar için akış daha az sorunsuz olur. Pop-up'ların kullanılması uygulamanız için sorun teşkil ediyorsa diğer seçeneklerden birini uygulamanız gerekir.

3. seçenek: firebaseapp.com'a proxy kimlik doğrulama istekleri gönderme

signInWithRedirect akışı, uygulama alanınızdan firebase yapılandırmasındaki authDomain parametresinde belirtilen alana (varsayılan olarak ".firebaseapp.com") yönlendirme yaparak başlar. authDomain, kimlik sağlayıcıya yönlendiren oturum açma yardımcısı kodunu barındırır. Bu kod, başarılı olduğunda uygulama alanına geri yönlendirir.

Kimlik doğrulama akışı uygulama alanınıza döndüğünde, oturum açma yardımcısı alanının tarayıcı depolama alanına erişilir. Bu seçenek ve aşağıdaki seçenek (kodu kendi sunucunuzda barındırma), tarayıcılar tarafından engellenen çapraz kaynak depolama erişimini ortadan kaldırır.

  1. Uygulama sunucunuzda ters proxy ayarlayarak https://<app domain>/__/auth/ adresine gönderilen GET/POST isteklerinin https://<project>.firebaseapp.com/__/auth/ adresine yönlendirilmesini sağlayın. Bu yönlendirmenin tarayıcı için şeffaf olduğundan emin olun. Bu işlem 302 yönlendirmesiyle yapılamaz.

    Özel alanınızı sunmak için nginx kullanıyorsanız ters proxy yapılandırması şu şekilde görünür:

    # reverse proxy for signin-helpers for popup/redirect sign in.
    location /__/auth {
      proxy_pass https://<project>.firebaseapp.com;
    }
    
  2. Yetkili redirect_uri, ACS URL'si ve authDomain bilgilerinizi güncellemek için 1. seçenek'teki adımları uygulayın. Uygulamanızı yeniden dağıttıktan sonra çapraz kaynak depolama alanı erişimi artık gerçekleşmez.

4. seçenek: Oturum açma yardımcısı kodunu alanınızda barındırma

Çapraz kaynak depolama alanı erişimini ortadan kaldırmanın bir başka yolu da Firebase oturum açma yardımcı kodunu kendi sunucunuzda barındırmaktır. Ancak bu yaklaşım, Apple oturum açma veya SAML için geçerli değildir. Bu seçeneği yalnızca 3. seçenekteki ters proxy kurulumu mümkün değilse kullanın.

Yardımcı kodun barındırılması aşağıdaki adımlardan oluşur:

  1. Aşağıdaki komutları çalıştırarak barındırılacak dosyaları <project>.firebaseapp.com konumundan indirin:

    mkdir signin_helpers/ && cd signin_helpers
    wget https://<project>.firebaseapp.com/__/auth/handler
    wget https://<project>.firebaseapp.com/__/auth/handler.js
    wget https://<project>.firebaseapp.com/__/auth/experiments.js
    wget https://<project>.firebaseapp.com/__/auth/iframe
    wget https://<project>.firebaseapp.com/__/auth/iframe.js
    wget https://<project>.firebaseapp.com/__/auth/links
    wget https://<project>.firebaseapp.com/__/auth/links.js
    wget https://<project>.firebaseapp.com/__/firebase/init.json
    
  2. Yukarıdaki dosyaları uygulama alanınızda barındırın. Web sunucunuzun https://<app domain>/__/auth/<filename> ve https://<app domain>/__/firebase/init.json isteklerine yanıt verebildiğinden emin olun.

    Dosyaları indiren ve barındıran örnek bir sunucu uygulaması aşağıda verilmiştir.

  3. Yetkili redirect_uri ve authDomain bilgilerinizi güncellemek için 1. seçenek'teki adımları uygulayın. Uygulamanızı yeniden dağıttıktan sonra çapraz kaynak depolama alanı erişimi artık gerçekleşmez.

5. seçenek: Sağlayıcı oturum açma işlemini bağımsız olarak yönetme

Firebase Authentication SDK'sı, karmaşık mantığı sarmalamak ve başka bir SDK'yı dahil etme ihtiyacını ortadan kaldırmak için kolaylık sağlayan yöntemler olarak signInWithPopup() ve signInWithRedirect() yöntemlerini sunar. Sağlayıcınızda bağımsız olarak oturum açıp signInWithCredential() yöntemini kullanarak sağlayıcının kimlik bilgilerini Firebase Authentication kimlik doğrulama bilgileriyle değiştirerek her iki yöntemi de kullanmaktan tamamen kaçınabilirsiniz. Örneğin, Google hesabı kimlik bilgisi almak için Google Sign In SDK'yı, örnek kodu kullanabilir, ardından aşağıdaki kodu çalıştırarak yeni bir Google kimlik bilgisi oluşturabilirsiniz:

Web

  // `googleUser` from the onsuccess Google Sign In callback.
  //  googUser = gapi.auth2.getAuthInstance().currentUser.get();
  const credential = GoogleAuthProvider.credential(googleUser.getAuthResponse().id_token);
  const result = await signInWithCredential(auth, credential);

Web

  // `googleUser` from the onsuccess Google Sign In callback.
  const credential = firebase.auth.GoogleAuthProvider.credential(
      googleUser.getAuthResponse().id_token);
  const result = await firebase.auth().signInWithCredential(credential);

signInWithCredential() yöntemini çağırdıktan sonra uygulamanızın geri kalanı eskisi gibi çalışır.

Apple kimlik bilgisi alma talimatlarını burada bulabilirsiniz.