Możesz zezwolić użytkownikom na logowanie się w aplikacji za pomocą danych logowania różnych dostawców uwierzytelniania, łącząc je z dotychczasowym kontem użytkownika. Użytkownicy są rozpoznawani za pomocą tego samego identyfikatora użytkownika Firebase niezależnie od tego, którego dostawcy uwierzytelniania użyli do zalogowania się. Na przykład użytkownik, który zalogował się za pomocą hasła, może w przyszłości połączyć konto Google i logować się za pomocą dowolnej z tych metod. Użytkownik anonimowy może też połączyć konto na Facebooku, a potem zalogować się na nie, aby nadal korzystać z aplikacji.
Zanim zaczniesz
Dodaj do aplikacji obsługę co najmniej 2 dostawców uwierzytelniania (opcjonalnie anonimowe uwierzytelnianie).
Łączenie danych logowania dostawcy uwierzytelniania sfederowanego z kontem użytkownika
Aby połączyć dane logowania od dostawcy uwierzytelniania, takiego jak Google lub Facebook, z istniejącym kontem użytkownika:
- Zaloguj użytkownika, używając dowolnego dostawcy lub metody uwierzytelniania.
- Pobierz obiekt
AuthProvider
odpowiadający dostawcy, który chcesz powiązać z kontem użytkownika. Przykłady:Web
import { GoogleAuthProvider, FacebookAuthProvider, TwitterAuthProvider, GithubAuthProvider } from "firebase/auth"; const googleProvider = new GoogleAuthProvider(); const facebookProvider = new FacebookAuthProvider(); const twitterProvider = new TwitterAuthProvider(); const githubProvider = new GithubAuthProvider();
Web
var googleProvider = new firebase.auth.GoogleAuthProvider(); var facebookProvider = new firebase.auth.FacebookAuthProvider(); var twitterProvider = new firebase.auth.TwitterAuthProvider(); var githubProvider = new firebase.auth.GithubAuthProvider();
- Poproś użytkownika o zalogowanie się u dostawcy, którego chcesz połączyć. Możesz poprosić użytkowników o zalogowanie się, otwierając wyskakujące okienko lub przekierowując ich na stronę logowania dostawcy. Na urządzeniach mobilnych preferowana jest metoda przekierowania.
- Aby zalogować się w wyskakującym okienku, zadzwoń pod numer
linkWithPopup
:Web
import { getAuth, linkWithPopup, GoogleAuthProvider } from "firebase/auth"; const provider = new GoogleAuthProvider(); const auth = getAuth(); linkWithPopup(auth.currentUser, provider).then((result) => { // Accounts successfully linked. const credential = GoogleAuthProvider.credentialFromResult(result); const user = result.user; // ... }).catch((error) => { // Handle Errors here. // ... });
Web
auth.currentUser.linkWithPopup(provider).then((result) => { // Accounts successfully linked. var credential = result.credential; var user = result.user; // ... }).catch((error) => { // Handle Errors here. // ... });
- Aby zalogować się przez przekierowanie na stronę logowania dostawcy, wywołaj:
linkWithRedirect
: Stosuj się do sprawdzonych metod podczas używania funkcji linkWithRedirect.Web
import { getAuth, linkWithRedirect, GoogleAuthProvider } from "firebase/auth"; const provider = new GoogleAuthProvider(); const auth = getAuth(); linkWithRedirect(auth.currentUser, provider) .then(/* ... */) .catch(/* ... */);
Web
auth.currentUser.linkWithRedirect(provider) .then(/* ... */) .catch(/* ... */);
getRedirectResult
po załadowaniu strony:Web
import { getRedirectResult } from "firebase/auth"; getRedirectResult(auth).then((result) => { const credential = GoogleAuthProvider.credentialFromResult(result); if (credential) { // Accounts successfully linked. const user = result.user; // ... } }).catch((error) => { // Handle Errors here. // ... });
Web
auth.getRedirectResult().then((result) => { if (result.credential) { // Accounts successfully linked. var credential = result.credential; var user = result.user; // ... } }).catch((error) => { // Handle Errors here. // ... });
Połączenie kont nie powiedzie się, jeśli dane logowania są już połączone z kontem innego użytkownika. W takiej sytuacji musisz samodzielnie połączyć konta i powiązane z nimi dane w odpowiednim dla Twojej aplikacji sposób:
Web
import { getAuth, signInWithCredential, linkWithCredential, OAuthProvider } from "firebase/auth"; // The implementation of how you store your user data depends on your application const repo = new MyUserDataRepo(); // Get reference to the currently signed-in user const auth = getAuth(); const prevUser = auth.currentUser; // Get the data which you will want to merge. This should be done now // while the app is still signed in as this user. const prevUserData = repo.get(prevUser); // Delete the user's data now, we will restore it if the merge fails repo.delete(prevUser); // Sign in user with the account you want to link to signInWithCredential(auth, newCredential).then((result) => { console.log("Sign In Success", result); const currentUser = result.user; const currentUserData = repo.get(currentUser); // Merge prevUser and currentUser data stored in Firebase. // Note: How you handle this is specific to your application const mergedData = repo.merge(prevUserData, currentUserData); const credential = OAuthProvider.credentialFromResult(result); return linkWithCredential(prevUser, credential) .then((linkResult) => { // Sign in with the newly linked credential const linkCredential = OAuthProvider.credentialFromResult(linkResult); return signInWithCredential(auth, linkCredential); }) .then((signInResult) => { // Save the merged data to the new user repo.set(signInResult.user, mergedData); }); }).catch((error) => { // If there are errors we want to undo the data merge/deletion console.log("Sign In Error", error); repo.set(prevUser, prevUserData); });
Web
// The implementation of how you store your user data depends on your application var repo = new MyUserDataRepo(); // Get reference to the currently signed-in user var prevUser = auth.currentUser; // Get the data which you will want to merge. This should be done now // while the app is still signed in as this user. var prevUserData = repo.get(prevUser); // Delete the user's data now, we will restore it if the merge fails repo.delete(prevUser); // Sign in user with the account you want to link to auth.signInWithCredential(newCredential).then((result) => { console.log("Sign In Success", result); var currentUser = result.user; var currentUserData = repo.get(currentUser); // Merge prevUser and currentUser data stored in Firebase. // Note: How you handle this is specific to your application var mergedData = repo.merge(prevUserData, currentUserData); return prevUser.linkWithCredential(result.credential) .then((linkResult) => { // Sign in with the newly linked credential return auth.signInWithCredential(linkResult.credential); }) .then((signInResult) => { // Save the merged data to the new user repo.set(signInResult.user, mergedData); }); }).catch((error) => { // If there are errors we want to undo the data merge/deletion console.log("Sign In Error", error); repo.set(prevUser, prevUserData); });
- Aby zalogować się w wyskakującym okienku, zadzwoń pod numer
Łączenie adresu e-mail i hasła z kontem użytkownika
Aby dodać adres e-mail i hasło do istniejącego konta użytkownika:
- Zaloguj użytkownika, używając dowolnego dostawcy lub metody uwierzytelniania.
- Poproś użytkownika o podanie adresu e-mail i nowego hasła.
- Utwórz obiekt
AuthCredential
z adresem e-mail i hasłem:Web
import { EmailAuthProvider } from "firebase/auth"; const credential = EmailAuthProvider.credential(email, password);
Web
var credential = firebase.auth.EmailAuthProvider.credential(email, password);
Przekaż obiekt
AuthCredential
metodzielinkWithCredential
zalogowanego użytkownika:Web
import { getAuth, linkWithCredential } from "firebase/auth"; const auth = getAuth(); linkWithCredential(auth.currentUser, credential) .then((usercred) => { const user = usercred.user; console.log("Account linking success", user); }).catch((error) => { console.log("Account linking error", error); });
Web
auth.currentUser.linkWithCredential(credential) .then((usercred) => { var user = usercred.user; console.log("Account linking success", user); }).catch((error) => { console.log("Account linking error", error); });
Wywołanie funkcji
linkWithCredential
zakończy się niepowodzeniem, jeśli te dane są już połączone z innym kontem użytkownika. W takim przypadku musisz samodzielnie połączyć konta i powiązane z nimi dane w sposób odpowiedni dla Twojej aplikacji (patrz przykład powyżej).
Odłączanie dostawcy uwierzytelniania od konta użytkownika
Możesz odłączyć dostawcę uwierzytelniania od konta, aby użytkownik nie mógł się zalogować za jego pomocą.
Aby odłączyć dostawcę uwierzytelniania od konta użytkownika, przekaż identyfikator dostawcy do metody unlink
. Identyfikatory dostawców uwierzytelniania powiązane z użytkownikiem możesz pobrać z usługi providerData
.
Web
import { getAuth, unlink } from "firebase/auth"; const auth = getAuth(); unlink(auth.currentUser, providerId).then(() => { // Auth provider unlinked from account // ... }).catch((error) => { // An error happened // ... });
Web
user.unlink(providerId).then(() => { // Auth provider unlinked from account // ... }).catch((error) => { // An error happened // ... });