เอกสารนี้อธิบายแนวทางปฏิบัติแนะนำสำหรับการใช้การลงชื่อเข้าใช้แบบเปลี่ยนเส้นทางในเบราว์เซอร์ที่บล็อกคุกกี้ของบุคคลที่สาม คุณต้องทำตามตัวเลือกใดตัวเลือกหนึ่งที่ระบุไว้ที่นี่เพื่อให้ signInWithRedirect() ทำงานได้ตามที่ต้องการในสภาพแวดล้อมฮาร์ดแวร์และซอฟต์แวร์ในทุกเบราว์เซอร์
ภาพรวม
Firebase Authentication JavaScript SDK ใช้ iframe แบบข้ามต้นทางที่เชื่อมต่อกับโดเมนโฮสติ้งของ Firebase ของแอป เพื่อให้ขั้นตอน signInWithRedirect() เป็นไปอย่างราบรื่นสำหรับคุณและผู้ใช้
อย่างไรก็ตาม กลไกนี้ใช้ไม่ได้กับเบราว์เซอร์ที่บล็อกการเข้าถึงพื้นที่เก็บข้อมูลของบุคคลที่สาม
เนื่องจากการขอให้ผู้ใช้ปิดใช้ฟีเจอร์การแบ่งพาร์ติชันพื้นที่เก็บข้อมูลในเบราว์เซอร์แทบจะเป็นไปไม่ได้เลย คุณจึงควรใช้ตัวเลือกการตั้งค่าอย่างใดอย่างหนึ่งต่อไปนี้กับแอปแทน ทั้งนี้ขึ้นอยู่กับรายละเอียดของ Use Case
- หากคุณโฮสต์แอปด้วยโฮสติ้งของ Firebase ในโดเมนย่อยของ
firebaseapp.comคุณจะไม่ได้รับผลกระทบจากปัญหานี้และไม่ต้องดำเนินการใดๆ - หากคุณโฮสต์แอปด้วยโฮสติ้งของ Firebase ในโดเมนที่กำหนดเองหรือโดเมนย่อยของ
web.appให้ใช้ตัวเลือกที่ 1 - หากโฮสต์แอปด้วยบริการอื่นที่ไม่ใช่ Firebase ให้ใช้ตัวเลือกที่ 2, ตัวเลือกที่ 3, ตัวเลือกที่ 4 หรือตัวเลือกที่ 5
ตัวเลือกที่ 1: อัปเดตการกำหนดค่า Firebase เพื่อใช้โดเมนที่กำหนดเองเป็น authDomain
หากโฮสต์แอปด้วยโฮสติ้งของ Firebase โดยใช้โดเมนที่กำหนดเอง คุณสามารถกำหนดค่า Firebase SDK ให้ใช้โดเมนที่กำหนดเองเป็น authDomain ได้ วิธีนี้ช่วยให้มั่นใจได้ว่าแอปและ iframe การตรวจสอบสิทธิ์ใช้โดเมนเดียวกัน ซึ่งจะช่วยป้องกันปัญหาการลงชื่อเข้าใช้ (หากไม่ได้ใช้โฮสติ้งของ Firebase คุณจะต้องใช้ตัวเลือกอื่น) ตรวจสอบว่าคุณได้ตั้งค่าโดเมนที่กำหนดเองในโปรเจ็กต์เดียวกับที่ใช้สำหรับการตรวจสอบสิทธิ์
หากต้องการอัปเดตการกำหนดค่า Firebase เพื่อใช้โดเมนที่กำหนดเองเป็นโดเมนการตรวจสอบสิทธิ์ ให้ทำดังนี้
กำหนดค่า Firebase JS SDK ให้ใช้โดเมนที่กำหนดเองเป็น
authDomain:const firebaseConfig = { apiKey: "<api-key>", authDomain: "<the-domain-that-serves-your-app>", databaseURL: "<database-url>", projectId: "<project-id>", appId: "<app-id>" };
เพิ่ม
authDomainใหม่ลงในรายการ URI การเปลี่ยนเส้นทางที่ได้รับอนุญาตของผู้ให้บริการ OAuth วิธีการจะขึ้นอยู่กับผู้ให้บริการ แต่โดยทั่วไปแล้ว คุณสามารถทำตามส่วน "ก่อนเริ่มต้น" ในผู้ให้บริการรายใดก็ได้เพื่อดูวิธีการที่แน่นอน (เช่น ผู้ให้บริการ Facebook) URI ที่อัปเดตเพื่อให้สิทธิ์จะมีลักษณะเป็นhttps://<the-domain-that-serves-your-app>/__/auth/handlerโดย/__/auth/handlerต่อท้ายเป็นส่วนสำคัญในทำนองเดียวกัน หากคุณใช้ผู้ให้บริการ SAML ให้เพิ่ม
authDomainใหม่ลงใน URL ของ SAML Assertion Consumer Service (ACS)ตรวจสอบว่า
continue_uriอยู่ในรายการโดเมนที่ได้รับอนุญาตติดตั้งใช้งานอีกครั้งด้วยโฮสติ้งของ Firebase หากจำเป็น เพื่อดึงข้อมูลไฟล์การกำหนดค่า Firebase ที่อัปเดตล่าสุดซึ่งโฮสต์อยู่ที่
/__/firebase/init.json
ตัวเลือกที่ 2: เปลี่ยนไปใช้ signInWithPopup()
ใช้ signInWithPopup() แทน signInWithRedirect() โค้ดที่เหลือของแอปจะยังคงเหมือนเดิม แต่วิธีการดึงข้อมูลออบเจ็กต์ UserCredential จะแตกต่างออกไป
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());
```
การลงชื่อเข้าใช้แบบป๊อปอัปอาจไม่เหมาะสำหรับผู้ใช้เสมอไป เนื่องจากบางครั้งป๊อปอัปอาจถูกบล็อกโดยอุปกรณ์หรือแพลตฟอร์ม และขั้นตอนการลงชื่อเข้าใช้ไม่ราบรื่นสำหรับผู้ใช้อุปกรณ์เคลื่อนที่ หากการใช้ป๊อปอัปเป็นปัญหาสำหรับแอป คุณจะต้องทำตามตัวเลือกอื่นๆ
ตัวเลือกที่ 3: คำขอการตรวจสอบสิทธิ์พร็อกซีไปยัง firebaseapp.com
ขั้นตอน signInWithRedirect เริ่มต้นด้วยการเปลี่ยนเส้นทางจากโดเมนแอปไปยังโดเมนที่ระบุในพารามิเตอร์ authDomain ในการกำหนดค่า Firebase ("authDomain โฮสต์โค้ดตัวช่วยลงชื่อเข้าใช้ที่เปลี่ยนเส้นทางไปยังผู้ให้บริการข้อมูลประจำตัว ซึ่งเมื่อดำเนินการสำเร็จแล้วจะเปลี่ยนเส้นทางกลับไปยังโดเมนของแอป
เมื่อขั้นตอนการตรวจสอบสิทธิ์กลับไปยังโดเมนแอป ระบบจะเข้าถึงพื้นที่เก็บข้อมูลของเบราว์เซอร์ของโดเมนผู้ช่วยลงชื่อเข้าใช้ ตัวเลือกนี้และตัวเลือกถัดไป (เพื่อโฮสต์โค้ดด้วยตนเอง) จะช่วยลดการเข้าถึงพื้นที่เก็บข้อมูลแบบข้ามต้นทาง ซึ่งเบราว์เซอร์จะบล็อกไว้
ตั้งค่าพร็อกซีแบบย้อนกลับในเซิร์ฟเวอร์แอปเพื่อให้ระบบส่งต่อคำขอ GET/POST ไปยัง
https://<app domain>/__/auth/ไปที่https://<project>.firebaseapp.com/__/auth/ตรวจสอบว่าการส่งต่อนี้โปร่งใสต่อเบราว์เซอร์ ซึ่งไม่สามารถทำได้ผ่านการเปลี่ยนเส้นทาง 302หากคุณใช้ nginx เพื่อแสดงโดเมนที่กำหนดเอง การกำหนดค่าพร็อกซีแบบย้อนกลับจะมีลักษณะดังนี้
# reverse proxy for signin-helpers for popup/redirect sign in. location /__/auth { proxy_pass https://<project>.firebaseapp.com; }ทำตามขั้นตอนในตัวเลือกที่ 1 เพื่ออัปเดต
redirect_uri, ACS URL และauthDomainที่ได้รับอนุญาต เมื่อคุณทำให้แอปใช้งานได้อีกครั้ง การเข้าถึงพื้นที่เก็บข้อมูลแบบข้ามต้นทางก็จะไม่เกิดขึ้นอีกต่อไป
ตัวเลือกที่ 4: โฮสต์โค้ดตัวช่วยลงชื่อเข้าใช้ด้วยตนเองในโดเมนของคุณ
อีกวิธีหนึ่งในการกำจัดการเข้าถึงพื้นที่เก็บข้อมูลแบบข้ามต้นทางคือการโฮสต์โค้ดตัวช่วยการลงชื่อเข้าใช้ Firebase ด้วยตนเอง อย่างไรก็ตาม วิธีนี้ใช้ไม่ได้กับการลงชื่อเข้าใช้ Apple หรือ SAML ใช้ตัวเลือกนี้เฉพาะในกรณีที่การตั้งค่าพร็อกซีแบบย้อนกลับในตัวเลือกที่ 3 เป็นไปไม่ได้
การโฮสต์โค้ดตัวช่วยมีขั้นตอนต่อไปนี้
ดาวน์โหลดไฟล์เพื่อโฮสต์จากตำแหน่ง
<project>.firebaseapp.comโดยเรียกใช้คำสั่งต่อไปนี้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โฮสต์ไฟล์ข้างต้นภายใต้โดเมนแอปของคุณ ตรวจสอบว่าเว็บเซิร์ฟเวอร์สามารถตอบสนองต่อ
https://<app domain>/__/auth/<filename>และhttps://<app domain>/__/firebase/init.jsonได้ต่อไปนี้คือตัวอย่างการติดตั้งใช้งานเซิร์ฟเวอร์ที่ดาวน์โหลดและโฮสต์ไฟล์
ทำตามขั้นตอนในตัวเลือกที่ 1 เพื่ออัปเดต
redirect_uriที่ได้รับอนุญาตและauthDomainของคุณ เมื่อคุณทำให้แอปใช้งานได้อีกครั้ง การเข้าถึงพื้นที่เก็บข้อมูลแบบข้ามต้นทางก็จะไม่เกิดขึ้นอีกต่อไป
ตัวเลือกที่ 5: จัดการการลงชื่อเข้าใช้ของผู้ให้บริการอย่างอิสระ
Firebase Authentication SDK มี signInWithPopup() และ signInWithRedirect() เป็นเมธอดที่อำนวยความสะดวกในการรวมตรรกะที่ซับซ้อนและหลีกเลี่ยงความจำเป็นในการใช้ SDK อื่น คุณสามารถหลีกเลี่ยงการใช้ทั้ง 2 วิธีได้โดยลงชื่อเข้าใช้ผู้ให้บริการอย่างอิสระ จากนั้นใช้ signInWithCredential() เพื่อแลกเปลี่ยนข้อมูลเข้าสู่ระบบของผู้ให้บริการกับข้อมูลรับรองการตรวจสอบสิทธิ์ Firebase Authentication
ตัวอย่างเช่น คุณสามารถใช้ SDK การลงชื่อเข้าใช้ Google, โค้ดตัวอย่าง เพื่อรับข้อมูลเข้าสู่ระบบของบัญชี Google จากนั้นสร้างอินสแตนซ์ข้อมูลเข้าสู่ระบบ Google ใหม่โดยเรียกใช้โค้ดต่อไปนี้
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() แล้ว ฟังก์ชันที่เหลือของแอปจะทำงานเหมือนเดิม
ดูวิธีการรับข้อมูลเข้าสู่ระบบของ Apple ได้ที่นี่