您可以將驗證提供者憑證連結至現有的使用者帳戶,讓使用者透過多個驗證服務提供者登入您的應用程式。無論用來登入的驗證服務供應商為何,系統都會透過相同的 Firebase 使用者 ID 來識別使用者。舉例來說,使用密碼登入的使用者可以連結 Google 帳戶,日後再利用任一方法登入。或者,匿名使用者也可以連結 Facebook 帳戶,之後登入 Facebook 繼續使用您的應用程式。
事前準備
在應用程式中新增支援兩個以上驗證供應商 (可能包括匿名驗證) 的支援。
將驗證服務供應商憑證連結至使用者帳戶
如要將驗證提供者憑證與現有使用者帳戶建立連結,請按照下列步驟操作:
- 使用任何驗證提供者或方式登入使用者。
- 完成新驗證供應商的登入流程,但不包括呼叫其中一種
FirebaseAuth.signInWith
方法。例如,請取得使用者的 Google ID 權杖、Facebook 存取權杖或電子郵件地址和密碼。 取得新驗證供應商的
AuthCredential
:Google 登入
Kotlin+KTX
val credential = GoogleAuthProvider.getCredential(googleIdToken, null)
Java
AuthCredential credential = GoogleAuthProvider.getCredential(googleIdToken, null);
Facebook 登入
Kotlin+KTX
val credential = FacebookAuthProvider.getCredential(token.token)
Java
AuthCredential credential = FacebookAuthProvider.getCredential(token.getToken());
使用電子郵件密碼登入
Kotlin+KTX
val credential = EmailAuthProvider.getCredential(email, password)
Java
AuthCredential credential = EmailAuthProvider.getCredential(email, password);
將
AuthCredential
物件傳遞至已登入使用者的linkWithCredential
方法:Kotlin+KTX
auth.currentUser!!.linkWithCredential(credential) .addOnCompleteListener(this) { task -> if (task.isSuccessful) { Log.d(TAG, "linkWithCredential:success") val user = task.result?.user updateUI(user) } else { Log.w(TAG, "linkWithCredential:failure", task.exception) Toast.makeText( baseContext, "Authentication failed.", Toast.LENGTH_SHORT, ).show() updateUI(null) } }
Java
mAuth.getCurrentUser().linkWithCredential(credential) .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() { @Override public void onComplete(@NonNull Task<AuthResult> task) { if (task.isSuccessful()) { Log.d(TAG, "linkWithCredential:success"); FirebaseUser user = task.getResult().getUser(); updateUI(user); } else { Log.w(TAG, "linkWithCredential:failure", task.getException()); Toast.makeText(AnonymousAuthActivity.this, "Authentication failed.", Toast.LENGTH_SHORT).show(); updateUI(null); } } });
如果憑證已連結至另一個使用者帳戶,對
linkWithCredential
的呼叫將會失敗。在這種情況下,您必須視情況處理應用程式的帳戶和關聯資料合併作業:Kotlin+KTX
val prevUser = auth.currentUser auth.signInWithCredential(credential) .addOnSuccessListener { result -> val currentUser = result.user // Merge prevUser and currentUser accounts and data // ... } .addOnFailureListener { // ... }
Java
FirebaseUser prevUser = FirebaseAuth.getInstance().getCurrentUser(); mAuth.signInWithCredential(credential) .addOnCompleteListener(new OnCompleteListener<AuthResult>() { @Override public void onComplete(@NonNull Task<AuthResult> task) { FirebaseUser currentUser = task.getResult().getUser(); // Merge prevUser and currentUser accounts and data // ... } });
如果呼叫 linkWithCredential
成功,使用者現在可以透過任何已連結的驗證服務供應商登入,並存取相同的 Firebase 資料。
取消驗證提供者與使用者帳戶的連結
您可以取消驗證提供者與帳戶的連結,這樣使用者就無法再以該提供者登入。
如要取消驗證提供者與使用者帳戶的連結,請將提供者 ID 傳遞至 unlink
方法。您可以呼叫
getProviderData
,取得連結至使用者的驗證提供者的提供者 ID。
Kotlin+KTX
Firebase.auth.currentUser!!.unlink(providerId) .addOnCompleteListener(this) { task -> if (task.isSuccessful) { // Auth provider unlinked from account // ... } }
Java
mAuth.getCurrentUser().unlink(providerId) .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() { @Override public void onComplete(@NonNull Task<AuthResult> task) { if (task.isSuccessful()) { // Auth provider unlinked from account // ... } } });