Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Xác thực bằng Đăng nhập Google bằng JavaScript

Bạn có thể cho phép người dùng của mình xác thực với Firebase bằng Tài khoản Google của họ bằng cách tích hợp Đăng nhập bằng Google vào ứng dụng của bạn. Bạn có thể tích hợp Đăng nhập bằng Google bằng cách sử dụng SDK Firebase để thực hiện quy trình đăng nhập hoặc bằng cách thực hiện quy trình Đăng nhập bằng Google theo cách thủ công và chuyển mã thông báo ID kết quả đến Firebase.

Trước khi bắt đầu

  1. Thêm Firebase vào dự án JavaScript của bạn .
  2. Bật Đăng nhập bằng Google trong bảng điều khiển Firebase:
    1. Trong bảng điều khiển Firebase , hãy mở phần Xác thực .
    2. Trên tab Phương thức đăng nhập, hãy bật phương pháp đăng nhập Google và nhấp vào Lưu .

Xử lý quy trình đăng nhập với SDK Firebase

Nếu bạn đang xây dựng một ứng dụng web, thì cách dễ nhất để xác thực người dùng của bạn với Firebase bằng Tài khoản Google của họ là xử lý quy trình đăng nhập bằng SDK JavaScript của Firebase. (Nếu bạn muốn xác thực người dùng trong Node.js hoặc môi trường không phải trình duyệt khác, bạn phải xử lý quy trình đăng nhập theo cách thủ công.)

Để xử lý quy trình đăng nhập với SDK JavaScript của Firebase, hãy làm theo các bước sau:

  1. Tạo một phiên bản của đối tượng nhà cung cấp Google:
    var provider = new firebase.auth.GoogleAuthProvider();
    
  2. Tùy chọn : Chỉ định phạm vi OAuth 2.0 bổ sung mà bạn muốn yêu cầu từ nhà cung cấp xác thực. Để thêm phạm vi, hãy gọi addScope . Ví dụ:
    provider.addScope('https://www.googleapis.com/auth/contacts.readonly');
    
    Xem tài liệu của nhà cung cấp xác thực .
  3. Tùy chọn : Để bản địa hóa luồng OAuth của nhà cung cấp sang ngôn ngữ ưa thích của người dùng mà không chuyển rõ ràng các thông số OAuth tùy chỉnh có liên quan, hãy cập nhật mã ngôn ngữ trên bản sao Auth trước khi bắt đầu luồng OAuth. Ví dụ:
    firebase.auth().languageCode = 'pt';
    // To apply the default browser preference instead of explicitly setting it.
    // firebase.auth().useDeviceLanguage();
    
  4. Tùy chọn : Chỉ định các thông số nhà cung cấp OAuth tùy chỉnh bổ sung mà bạn muốn gửi cùng với yêu cầu OAuth. Để thêm thông số tùy chỉnh, hãy gọi setCustomParameters trên trình cung cấp đã khởi tạo với một đối tượng chứa khóa như được chỉ định bởi tài liệu của nhà cung cấp OAuth và giá trị tương ứng. Ví dụ:
    provider.setCustomParameters({
      'login_hint': 'user@example.com'
    });
    
    Các thông số OAuth bắt buộc dành riêng không được phép và sẽ bị bỏ qua. Xem tham chiếu nhà cung cấp xác thực để biết thêm chi tiết.
  5. Xác thực với Firebase bằng đối tượng nhà cung cấp của Google. Bạn có thể nhắc người dùng của mình đăng nhập bằng Tài khoản Google của họ bằng cách mở cửa sổ bật lên hoặc bằng cách chuyển hướng đến trang đăng nhập. Phương pháp chuyển hướng được ưu tiên trên thiết bị di động.
    • Để đăng nhập bằng cửa sổ bật lên, hãy gọi signInWithPopup :
      firebase.auth().signInWithPopup(provider).then(function(result) {
        // This gives you a Google Access Token. You can use it to access the Google API.
        var token = result.credential.accessToken;
        // The signed-in user info.
        var user = result.user;
        // ...
      }).catch(function(error) {
        // Handle Errors here.
        var errorCode = error.code;
        var errorMessage = error.message;
        // The email of the user's account used.
        var email = error.email;
        // The firebase.auth.AuthCredential type that was used.
        var credential = error.credential;
        // ...
      });
      
      Cũng lưu ý rằng bạn có thể truy xuất mã thông báo OAuth của nhà cung cấp Google có thể được sử dụng để tìm nạp thêm dữ liệu bằng Google API.

      Đây cũng là nơi bạn có thể nắm bắt và xử lý lỗi. Để có danh sách mã lỗi, hãy xem Tài liệu tham khảo Auth .

    • Để đăng nhập bằng cách chuyển hướng đến trang đăng nhập, hãy gọi signInWithRedirect :
      firebase.auth().signInWithRedirect(provider);
      
      Sau đó, bạn cũng có thể truy xuất mã thông báo OAuth của nhà cung cấp Google bằng cách gọi getRedirectResult khi trang của bạn tải:
      firebase.auth().getRedirectResult().then(function(result) {
        if (result.credential) {
          // This gives you a Google Access Token. You can use it to access the Google API.
          var token = result.credential.accessToken;
          // ...
        }
        // The signed-in user info.
        var user = result.user;
      }).catch(function(error) {
        // Handle Errors here.
        var errorCode = error.code;
        var errorMessage = error.message;
        // The email of the user's account used.
        var email = error.email;
        // The firebase.auth.AuthCredential type that was used.
        var credential = error.credential;
        // ...
      });
      
      Đây cũng là nơi bạn có thể phát hiện và xử lý lỗi. Để có danh sách mã lỗi, hãy xem Tài liệu tham khảo Auth .

Xác thực bằng Firebase trong tiện ích mở rộng của Chrome

Nếu bạn đang xây dựng ứng dụng tiện ích mở rộng Chrome, bạn phải đưa ID tiện ích mở rộng Chrome của mình vào danh sách trắng:

  1. Mở dự án của bạn trong bảng điều khiển Firebase .
  2. Trong phần Xác thực , mở trang Phương pháp đăng nhập .
  3. Thêm một URI như sau vào danh sách Miền được ủy quyền:
    chrome-extension://CHROME_EXTENSION_ID

Chỉ các thao tác bật lên ( signInWithPopuplinkWithPopup ) khả dụng cho các tiện ích mở rộng của Chrome, vì các tiện ích mở rộng Chrome không thể sử dụng chuyển hướng HTTP. Bạn nên gọi các phương thức này từ tập lệnh nền chứ không phải là cửa sổ bật lên hành động của trình duyệt, vì cửa sổ bật lên xác thực sẽ hủy cửa sổ bật lên hành động của trình duyệt.

Trong tệp kê khai của tiện ích mở rộng Chrome của bạn, hãy đảm bảo rằng bạn thêm URL https://apis.google.com vào danh sách trắng content_security_policy .

Bước tiếp theo

Sau khi người dùng đăng nhập lần đầu tiên, tài khoản người dùng mới sẽ được tạo và liên kết với thông tin đăng nhập — nghĩa là tên người dùng và mật khẩu, số điện thoại hoặc thông tin nhà cung cấp xác thực — người dùng đã đăng nhập bằng. Tài khoản mới này được lưu trữ như một phần của dự án Firebase của bạn và có thể được sử dụng để xác định người dùng trên mọi ứng dụng trong dự án của bạn, bất kể người dùng đăng nhập bằng cách nào.

  • Trong ứng dụng của bạn, cách được khuyến nghị để biết trạng thái xác thực của người dùng là đặt người quan sát trên đối tượng Auth . Sau đó, bạn có thể lấy thông tin hồ sơ cơ bản của người dùng từ đối tượng User . Xem Quản lý người dùng .

  • Trong Cơ sở dữ liệu thời gian thực Firebase và Quy tắc bảo mật lưu trữ đám mây, bạn có thể lấy ID người dùng duy nhất của người dùng đã đăng nhập từ biến auth và sử dụng nó để kiểm soát dữ liệu nào mà người dùng có thể truy cập.

Bạn có thể cho phép người dùng đăng nhập vào ứng dụng của mình bằng nhiều nhà cung cấp xác thực bằng cách liên kết thông tin đăng nhập của nhà cung cấp xác thực với tài khoản người dùng hiện có.

Để đăng xuất một người dùng, hãy gọi signOut :

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