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.

Quản lý người dùng trong Firebase

Tạo người dùng

Bạn tạo một người dùng mới trong dự án căn cứ hỏa lực của bạn bằng cách gọi createUserWithEmailAndPassword phương pháp hoặc bằng cách đăng nhập người dùng lần đầu tiên sử dụng một nhà cung cấp danh tính liên kết, chẳng hạn như Google đăng nhập hoặc Facebook Login .

Bạn cũng có thể tạo người dùng mật khẩu xác thực mới từ phần xác thực của các căn cứ hỏa lực console , trên trang Users.

Nhận người dùng hiện đã đăng nhập

Cách khuyến khích để có được người sử dụng hiện nay là bằng cách gọi getCurrentUser phương pháp. Nếu không có người dùng đăng nhập, getCurrentUser trả về null:

Java

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user != null) {
    // User is signed in
} else {
    // No user is signed in
}

Kotlin + KTX

val user = Firebase.auth.currentUser
if (user != null) {
    // User is signed in
} else {
    // No user is signed in
}

Có một số trường hợp getCurrentUser sẽ trả về một không null FirebaseUser nhưng token cơ bản là không hợp lệ. Điều này có thể xảy ra, ví dụ: nếu người dùng đã bị xóa trên một thiết bị khác và mã thông báo cục bộ chưa được làm mới. Trong trường hợp này, bạn có thể có được một người dùng hợp lệ getCurrentUser nhưng các cuộc gọi tiếp theo với các nguồn lực thực sẽ thất bại.

getCurrentUser cũng có thể trở null vì đối tượng auth chưa khởi tạo xong.

Nếu bạn đính kèm một AuthStateListener bạn sẽ nhận được một cuộc gọi lại mỗi khi thay đổi trạng thái cơ bản token. Điều này có thể hữu ích để phản ứng với các trường hợp cạnh như những trường hợp được đề cập ở trên.

Nhận hồ sơ của người dùng

Để có được thông tin hồ sơ của người dùng, sử dụng các phương pháp accessor của một thể hiện của FirebaseUser . Ví dụ:

Java

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user != null) {
    // Name, email address, and profile photo Url
    String name = user.getDisplayName();
    String email = user.getEmail();
    Uri photoUrl = user.getPhotoUrl();

    // Check if user's email is verified
    boolean emailVerified = user.isEmailVerified();

    // The user's ID, unique to the Firebase project. Do NOT use this value to
    // authenticate with your backend server, if you have one. Use
    // FirebaseUser.getIdToken() instead.
    String uid = user.getUid();
}

Kotlin + KTX

val user = Firebase.auth.currentUser
user?.let {
    // Name, email address, and profile photo Url
    val name = user.displayName
    val email = user.email
    val photoUrl = user.photoUrl

    // Check if user's email is verified
    val emailVerified = user.isEmailVerified

    // The user's ID, unique to the Firebase project. Do NOT use this value to
    // authenticate with your backend server, if you have one. Use
    // FirebaseUser.getToken() instead.
    val uid = user.uid
}

Nhận thông tin hồ sơ nhà cung cấp cụ thể của người dùng

Để có được thông tin hồ sơ lấy ra từ lần đăng nhập các nhà cung cấp liên quan đến một người sử dụng, sử dụng getProviderData phương pháp. Ví dụ:

Java

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user != null) {
    for (UserInfo profile : user.getProviderData()) {
        // Id of the provider (ex: google.com)
        String providerId = profile.getProviderId();

        // UID specific to the provider
        String uid = profile.getUid();

        // Name, email address, and profile photo Url
        String name = profile.getDisplayName();
        String email = profile.getEmail();
        Uri photoUrl = profile.getPhotoUrl();
    }
}

Kotlin + KTX

val user = Firebase.auth.currentUser
user?.let {
    for (profile in it.providerData) {
        // Id of the provider (ex: google.com)
        val providerId = profile.providerId

        // UID specific to the provider
        val uid = profile.uid

        // Name, email address, and profile photo Url
        val name = profile.displayName
        val email = profile.email
        val photoUrl = profile.photoUrl
    }
}

Cập nhật hồ sơ của người dùng

Bạn có thể cập nhật URL với tên hiển thị và ảnh hồ sơ của người dùng thông tin hồ sơ cá nhân cơ bản của người sử dụng các updateProfile phương pháp. Ví dụ:

Java

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();

UserProfileChangeRequest profileUpdates = new UserProfileChangeRequest.Builder()
        .setDisplayName("Jane Q. User")
        .setPhotoUri(Uri.parse("https://example.com/jane-q-user/profile.jpg"))
        .build();

user.updateProfile(profileUpdates)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "User profile updated.");
                }
            }
        });

Kotlin + KTX

val user = Firebase.auth.currentUser

val profileUpdates = userProfileChangeRequest {
    displayName = "Jane Q. User"
    photoUri = Uri.parse("https://example.com/jane-q-user/profile.jpg")
}

user!!.updateProfile(profileUpdates)
        .addOnCompleteListener { task ->
            if (task.isSuccessful) {
                Log.d(TAG, "User profile updated.")
            }
        }

Đặt địa chỉ email của người dùng

Bạn có thể đặt địa chỉ email của người dùng với các updateEmail phương pháp. Ví dụ:

Java

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();

user.updateEmail("user@example.com")
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "User email address updated.");
                }
            }
        });

Kotlin + KTX

val user = Firebase.auth.currentUser

user!!.updateEmail("user@example.com")
        .addOnCompleteListener { task ->
            if (task.isSuccessful) {
                Log.d(TAG, "User email address updated.")
            }
        }

Gửi cho người dùng một email xác minh

Bạn có thể gửi một email xác minh địa chỉ cho một người dùng với sendEmailVerification phương pháp. Ví dụ:

Java

FirebaseAuth auth = FirebaseAuth.getInstance();
FirebaseUser user = auth.getCurrentUser();

user.sendEmailVerification()
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "Email sent.");
                }
            }
        });

Kotlin + KTX

val user = Firebase.auth.currentUser

user!!.sendEmailVerification()
        .addOnCompleteListener { task ->
            if (task.isSuccessful) {
                Log.d(TAG, "Email sent.")
            }
        }

Bạn có thể tùy chỉnh các mẫu email được sử dụng trong phần xác thực của các căn cứ hỏa lực console , trên Email trang mẫu. Xem Templates Email trong Trung tâm trợ giúp căn cứ hỏa lực.

Nó cũng có thể để vượt qua trạng thái thông qua một tiếp tục URL để chuyển hướng trở lại ứng dụng khi gửi email xác minh.

Ngoài ra, bạn có thể bản địa hóa email xác minh bằng cách cập nhật mã ngôn ngữ trên phiên bản Auth trước khi gửi email. Ví dụ:

Java

auth.setLanguageCode("fr");
// To apply the default app language instead of explicitly setting it.
// auth.useAppLanguage();

Kotlin + KTX

auth.setLanguageCode("fr")
// To apply the default app language instead of explicitly setting it.
// auth.useAppLanguage()

Đặt mật khẩu của người dùng

Bạn có thể đặt mật khẩu của người dùng với các updatePassword phương pháp. Ví dụ:

Java

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
String newPassword = "SOME-SECURE-PASSWORD";

user.updatePassword(newPassword)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "User password updated.");
                }
            }
        });

Kotlin + KTX

val user = Firebase.auth.currentUser
val newPassword = "SOME-SECURE-PASSWORD"

user!!.updatePassword(newPassword)
        .addOnCompleteListener { task ->
            if (task.isSuccessful) {
                Log.d(TAG, "User password updated.")
            }
        }

Gửi email đặt lại mật khẩu

Bạn có thể gửi một email khôi phục mật khẩu cho một người dùng với sendPasswordResetEmail phương pháp. Ví dụ:

Java

FirebaseAuth auth = FirebaseAuth.getInstance();
String emailAddress = "user@example.com";

auth.sendPasswordResetEmail(emailAddress)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "Email sent.");
                }
            }
        });

Kotlin + KTX

val emailAddress = "user@example.com"

Firebase.auth.sendPasswordResetEmail(emailAddress)
        .addOnCompleteListener { task ->
            if (task.isSuccessful) {
                Log.d(TAG, "Email sent.")
            }
        }

Bạn có thể tùy chỉnh các mẫu email được sử dụng trong phần xác thực của các căn cứ hỏa lực console , trên Email trang mẫu. Xem Templates Email trong Trung tâm trợ giúp căn cứ hỏa lực.

Nó cũng có thể để vượt qua trạng thái thông qua một tiếp tục URL để chuyển hướng trở lại ứng dụng khi gửi email đặt lại mật khẩu.

Ngoài ra, bạn có thể bản địa hóa email đặt lại mật khẩu bằng cách cập nhật mã ngôn ngữ trên phiên bản Auth trước khi gửi email. Ví dụ:

Java

auth.setLanguageCode("fr");
// To apply the default app language instead of explicitly setting it.
// auth.useAppLanguage();

Kotlin + KTX

auth.setLanguageCode("fr")
// To apply the default app language instead of explicitly setting it.
// auth.useAppLanguage()

Bạn cũng có thể gửi email đặt lại mật khẩu từ bảng điều khiển Firebase.

Xóa người dùng

Bạn có thể xóa một tài khoản người dùng với delete phương pháp. Ví dụ:

Java

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();

user.delete()
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    Log.d(TAG, "User account deleted.");
                }
            }
        });

Kotlin + KTX

val user = Firebase.auth.currentUser!!

user.delete()
        .addOnCompleteListener { task ->
            if (task.isSuccessful) {
                Log.d(TAG, "User account deleted.")
            }
        }

Bạn cũng có thể sử dụng xóa từ phần xác thực của các căn cứ hỏa lực console , trên trang Users.

Xác thực lại người dùng

Một số hành động chẳng hạn an ninh nhạy cảm như xóa tài khoản , thiết lập một địa chỉ email chính , và thay đổi mật khẩu -require mà người dùng vừa đăng nhập. Nếu bạn thực hiện một trong những hành động này, và người sử dụng đăng nhập quá lâu trước, hành động thất bại và ném FirebaseAuthRecentLoginRequiredException . Khi điều này xảy ra, xác thực lại cho người sử dụng bằng cách đăng nhập mới thông tin từ người sử dụng và đi qua các chứng chỉ để reauthenticate . Ví dụ:

Java

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();

// Get auth credentials from the user for re-authentication. The example below shows
// email and password credentials but there are multiple possible providers,
// such as GoogleAuthProvider or FacebookAuthProvider.
AuthCredential credential = EmailAuthProvider
        .getCredential("user@example.com", "password1234");

// Prompt the user to re-provide their sign-in credentials
user.reauthenticate(credential)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                Log.d(TAG, "User re-authenticated.");
            }
        });

Kotlin + KTX

val user = Firebase.auth.currentUser!!

// Get auth credentials from the user for re-authentication. The example below shows
// email and password credentials but there are multiple possible providers,
// such as GoogleAuthProvider or FacebookAuthProvider.
val credential = EmailAuthProvider
        .getCredential("user@example.com", "password1234")

// Prompt the user to re-provide their sign-in credentials
user.reauthenticate(credential)
        .addOnCompleteListener { Log.d(TAG, "User re-authenticated.") }

Nhập tài khoản người dùng

Bạn có thể nhập tài khoản người dùng từ một tập tin vào dự án căn cứ hỏa lực của bạn bằng cách sử dụng các căn cứ hỏa lực CLI của auth:import lệnh. Ví dụ:

firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14