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.comalt 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.appalt 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:
Firebase JS SDK'sını, özel alanınızı
authDomainolarak 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>" };
Yeni
authDomaindeğ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
authDomaindeğerini SAML Onaylama Tüketici Hizmeti (ACS) URL'sine ekleyin.continue_urialanınızın yetkili alanlar listesinde olduğundan emin olun./__/firebase/init.jsonadresinde 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 "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.
Uygulama sunucunuzda ters proxy ayarlayarak
https://<app domain>/__/auth/adresine gönderilen GET/POST isteklerininhttps://<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; }Yetkili
redirect_uri, ACS URL'si veauthDomainbilgilerinizi 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:
Aşağıdaki komutları çalıştırarak barındırılacak dosyaları
<project>.firebaseapp.comkonumundan 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.jsonYukarıdaki dosyaları uygulama alanınızda barındırın. Web sunucunuzun
https://<app domain>/__/auth/<filename>vehttps://<app domain>/__/firebase/init.jsonisteklerine yanıt verebildiğinden emin olun.Dosyaları indiren ve barındıran örnek bir sunucu uygulaması aşağıda verilmiştir.
Yetkili
redirect_uriveauthDomainbilgilerinizi 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.