หน้านี้ได้รับการแปลโดย Cloud Translation API

ตรวจสอบสิทธิ์โดยใช้ผู้ให้บริการ OAuth ด้วย Cordova

ด้วย Firebase JS SDK คุณสามารถอนุญาตให้ผู้ใช้ Firebase ของคุณตรวจสอบสิทธิ์โดยใช้ผู้ให้บริการ OAuth ที่รองรับในสภาพแวดล้อม Cordova คุณสามารถผสานรวมผู้ให้บริการ OAuth ที่รองรับได้โดยใช้ Firebase SDK เพื่อดำเนินการขั้นตอนการลงชื่อเข้าใช้ หรือโดยดำเนินการขั้นตอน OAuth ด้วยตนเองและส่งข้อมูลรับรอง OAuth ที่เป็นผลลัพธ์ไปยัง Firebase

ตั้งค่าการตรวจสอบสิทธิ์ Firebase สำหรับ Cordova

เพิ่ม Firebase ในโครงการ JavaScript ของคุณ เมื่อเพิ่มข้อมูลโค้ด Firebase ให้จดบันทึกตัวแปรการกำหนดค่า authDomain ซึ่งควรมีลักษณะดังนี้ my-app.firebaseapp.com หากใช้โดเมนที่กำหนดเองแทนโดเมน firebaseapp.com ที่จัดเตรียมโดย Firebase ควรใช้โดเมนที่กำหนดเองแทน
หากต้องการตั้งค่าแอป Android ให้เพิ่มแอป Android ของคุณลงใน คอนโซล Firebase และป้อนรายละเอียดแอปของคุณ คุณไม่จำเป็นต้องสร้าง google-services.json
หากต้องการตั้งค่าแอป iOS ให้สร้างแอปพลิเคชัน iOS และเพิ่มลงใน คอนโซล Firebase คุณจะต้องมี ID ชุด iOS เพื่อเพิ่มในภายหลังเมื่อติดตั้งปลั๊กอิน Scheme URL ที่กำหนดเอง
เปิดใช้งานลิงก์ไดนามิกของ Firebase:
1. ใน คอนโซล Firebase ให้เปิดส่วน ลิงก์แบบไดนามิก
2. หากคุณยังไม่ได้ยอมรับข้อกำหนดของลิงก์แบบไดนามิกและสร้างโดเมนลิงก์แบบไดนามิก ให้ดำเนินการทันที
  หากคุณสร้างโดเมน Dynamic Links แล้ว โปรดจดบันทึกไว้ โดยทั่วไปโดเมนลิงก์แบบไดนามิกจะมีลักษณะเหมือนตัวอย่างต่อไปนี้:
```
example.page.link
```
  คุณจะต้องใช้ค่านี้เมื่อกำหนดค่าแอป Apple หรือ Android เพื่อสกัดกั้นลิงก์ขาเข้า
เปิดใช้งานการลงชื่อเข้าใช้ Google ในคอนโซล Firebase:
1. ใน คอนโซล Firebase ให้เปิดส่วน การตรวจสอบสิทธิ์
2. บนแท็บ วิธีการลงชื่อเข้า ใช้ ให้เปิดใช้งานวิธี การลงชื่อเข้าใช้ Google แล้วคลิก บันทึก

ติดตั้งปลั๊กอินที่จำเป็นในโครงการ Cordova ของคุณ

# Plugin to pass application build info (app name, ID, etc) to the OAuth widget.
cordova plugin add cordova-plugin-buildinfo --save
# Plugin to handle Universal Links (Android app link redirects)
cordova plugin add cordova-universal-links-plugin-fix --save
# Plugin to handle opening secure browser views on iOS/Android mobile devices
cordova plugin add cordova-plugin-browsertab --save
# Plugin to handle opening a browser view in older versions of iOS and Android
cordova plugin add cordova-plugin-inappbrowser --save
# Plugin to handle deep linking through Custom Scheme for iOS
# Substitute *com.firebase.cordova* with the iOS bundle ID of your app.
cordova plugin add cordova-plugin-customurlscheme --variable \
    URL_SCHEME=com.firebase.cordova --save

เพิ่มการกำหนดค่าต่อไปนี้ลงในไฟล์ Cordova config.xml ของคุณ โดยที่ AUTH_DOMAIN คือโดเมนจากขั้นตอน (1) และ DYNAMIC_LINK_DOMAIN คือโดเมนจากขั้นตอน (3c)
```
<universal-links>
    <host name="DYNAMIC_LINK_DOMAIN" scheme="https" />
    <host name="AUTH_DOMAIN" scheme="https">
        <path url="/__/auth/callback"/>
    </host>
</universal-links>
```
การกำหนดค่าตัวอย่างอาจมีลักษณะดังนี้:
```
<universal-links>
    <host name="example.page.link" scheme="https" />
    <host name="example-app.firebaseapp.com" scheme="https">
        <path url="/__/auth/callback"/>
    </host>
</universal-links>
```
หากใช้โดเมนที่กำหนดเอง auth.custom.domain.com ให้แทนที่ my-app.firebaseapp.com ด้วยโดเมนนั้น
สำหรับแอปพลิเคชัน Android singleTask ควรใช้สำหรับ launchMode
```
<preference name="AndroidLaunchMode" value="singleTask" />
```

หมายเหตุ: หากคุณใช้เฟรมเวิร์ก Ionic ควรใช้เวอร์ชันล่าสุดของเฟรมเวิร์กนั้นเพื่อให้แน่ใจว่าแอปให้บริการจากต้นทางด้วยรูปแบบ file:// หรือ ionic:// ซึ่งจำเป็นเพื่อให้ Firebase Auth สามารถจัดการการดำเนินการ signInWithRedirect ได้อย่างถูกต้อง Firebase Auth จะถือว่า http://localhost origin เป็นแอปเบราว์เซอร์บนเว็บ แม้ว่าจะแสดงผลในสภาพแวดล้อม Cordova ก็ตาม

จัดการขั้นตอนการลงชื่อเข้าใช้ด้วย Firebase SDK

Firebase Auth ขึ้นอยู่กับเหตุการณ์ deviceReady เพื่อกำหนดสภาพแวดล้อม Cordova ปัจจุบันอย่างถูกต้อง ตรวจสอบให้แน่ใจว่าอินสแตนซ์ของแอป Firebase ได้รับการเริ่มต้นหลังจากเหตุการณ์นั้นถูกทริกเกอร์
สร้างอินสแตนซ์ของวัตถุผู้ให้บริการ Google:
Web modular API
เรียนรู้เพิ่มเติม เกี่ยวกับ Web API แบบโครงสร้างที่เขย่าได้และ อัปเกรด จาก API เนมสเปซ
```
import { GoogleAuthProvider } from "firebase/auth/cordova";

const provider = new GoogleAuthProvider();auth_create_google_provider.js
```
Web namespaced API
```
var provider = new firebase.auth.GoogleAuthProvider();cordova.js
```

ตรวจสอบสิทธิ์กับ Firebase โดยใช้วัตถุผู้ให้บริการ Google โดยใช้ signInWithRedirect โปรดทราบว่า Cordova ไม่รองรับ signInWithPopup

Web modular API

import { getAuth, signInWithRedirect, getRedirectResult, GoogleAuthProvider } from "firebase/auth/cordova";

const auth = getAuth();
signInWithRedirect(auth, new GoogleAuthProvider())
  .then(() => {
    return getRedirectResult(auth);
  })
  .then((result) => {
    const credential = GoogleAuthProvider.credentialFromResult(result);

    // This gives you a Google Access Token.
    // You can use it to access the Google API.
    const token = credential.accessToken;

    // The signed-in user info.
    const user = result.user;
    // ...
  }).catch((error) => {
    // Handle Errors here.
    const errorCode = error.code;
    const errorMessage = error.message;
  });auth_cordova_sign_in_redirect.js

Web namespaced API

firebase.auth().signInWithRedirect(provider).then(() => {
  return firebase.auth().getRedirectResult();
}).then((result) => {
  /** @type {firebase.auth.OAuthCredential} */
  var credential = result.credential;

  // This gives you a Google Access Token.
  // You can use it to access the Google API.
  var token = credential.accessToken;
  // The signed-in user info.
  var user = result.user;
  // ...
}).catch((error) => {
  // Handle Errors here.
  var errorCode = error.code;
  var errorMessage = error.message;
});cordova.js

ในการจัดการกรณีที่กิจกรรมแอปถูกทำลายก่อนที่การลงชื่อเข้าใช้จะเสร็จสิ้น ให้เรียก getRedirectResult เมื่อแอปของคุณโหลด

Web modular API

import { getAuth, getRedirectResult, GoogleAuthProvider } from "firebase/auth/cordova";

const auth = getAuth();
getRedirectResult(auth)
  .then((result) => {
    const credential = GoogleAuthProvider.credentialFromResult(result);
    if (credential) {        
      // This gives you a Google Access Token.
      // You can use it to access the Google API.
      const token = credential.accessToken;
      // The signed-in user info.
      const user = result.user;
      // ...
    }
  })
  .catch((error) => {
    // Handle Errors here.
    const errorCode = error.code;
    const errorMessage = error.message;
  });auth_cordova_redirect_result.js

Web namespaced API

firebase.auth().getRedirectResult().then((result) => {
  if (result.credential) {
    /** @type {firebase.auth.OAuthCredential} */
    var credential = result.credential;

    // This gives you a Google Access Token.
    // You can use it to access the Google API.
    var token = credential.accessToken;
    // The signed-in user info.
    var user = result.user;
    // ...
  }
}).catch((error) => {
  // Handle Errors here.
  var errorCode = error.code;
  var errorMessage = error.message;
});cordova.js

กลไกเดียวกันนี้สามารถใช้เพื่อเชื่อมโยงผู้ให้บริการใหม่ผ่าน linkWithRedirect หรือเพื่อตรวจสอบสิทธิ์อีกครั้งกับผู้ให้บริการที่มีอยู่โดยใช้ reauthenticateWithRedirect