用户管理 | 开发文档

本篇文档介绍如何使用 Wilddog Auth 管理用户。它包括：创建用户、获取用户信息、获取用户属性、更新用户信息、删除用户等。

创建用户

创建用户包含以下四种方法：

通过手机登录创建
通过邮箱密码创建
通过第三方身份认证提供商授权创建
在控制面板—身份认证—用户中手动创建

获取用户信息

用户信息包含用户属性及用户的登录信息。

获取当前登录用户

获取当前登录用户是管理用户的基础。

使用监听器：

WilddogAuth auth = WilddogAuth.getInstance();

auth.addAuthStateListener(new WilddogAuth.AuthStateListener(){
    // 设置 Auth 监听器
    @Override
    public void onAuthStateChanged(WilddogAuth wilddogauth){
        WilddogUser user = wilddogauth.getCurrentUser();
        if (user != null) {
            // 用户已登录
        } else {
            // 没有用户登录
        }
    }
});

使用 getCurrentUser () 方法获取当前登录：

WilddogAuth auth = WilddogAuth.getInstance();
WilddogUser user = auth.getCurrentUser();
if (user != null) {
   // 用户已登录
} else {
   // 没有用户登录
}

注意：

推荐使用监听器，这样可以保证在你获取当前用户时 Auth 实例不会处于中间状态，如用户正在登录时。用户可以在登陆后通过 WilddogAuth.getInstance().getCurrentUser() 在任何需要的时候获取到 WilddogUser 对象。

获取用户属性

WilddogUser 实例可以用于获取用户属性。

WilddogUser user = auth.getCurrentUser();
if (user != null) {
    String uid = user.getUid();
    String providerId = user.getProviderId();
    String phone = user.getPhone();
    String name = user.getDisplayName();
    Uri photoUrl = user.getPhotoUrl();
    String email = user.getEmail();
} else {
    // 没有用户登录.
}

获取 Provider 的用户属性

providerData 用于获取所有 Provider 的用户属性。

WilddogUser user = auth.getCurrentUser();
    String uid = user.getUid();
    List<WilddogUser> userProviderInfos = user.getProviderData();
    for (UserInfo profile : userProviderInfos) {
        String providerId = profile.getProviderId();
        String uid = profile.getUid();
        String name = profile.getDisplayName();
        String email = profile.getEmail();
        Uri photoUrl = profile.getPhotoUrl();
    };

更新用户信息

WilddogUser 实例用于更新用户属性及用户的登录信息。

更新用户属性

updateProfile() 方法用于更新用户属性。

例如，更新用户的displayName 和 photoURL 属性：

WilddogUser user = auth.getCurrentUser();

UserProfileChangeRequest profileUpdates = new  UserProfileChangeRequest.Builder()
    .setDisplayName("name")
  .setPhotoUri(Uri.parse("https://example.com/path/photo.jpg"))
    .build();

user.updateProfile(profileUpdates)
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete(Task<Void> task) {
            if (task.isSuccessful()) {
                // 更新成功
            }else{
               // 发生错误
            }
        }
    });

注意：

使用 customToken 登录时，若该登录用户为 admin 用户，则不能更新用户属性。

更新用户手机号

updatePhone() 方法用于更新用户手机号。

WilddogUser user = auth.getCurrentUser();
String phone = "12345678901";

user.updatePhone(phone)
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete(Task<Void> task) {
            if (task.isSuccessful()) {
                // 更新成功
            }else{
               // 发生错误
        Log.d("result",task.getException().toString()) ;
            }
        }
    });

注意：

要更新手机号，该用户必须最近登录过。请参考重新进行身份认证。

使用 customToken 登录时，若该登录用户为 admin 用户，则不能更新用户手机号。

重置手机号认证密码

1.发送重置密码的手机验证码：

String phone = "18888888888";

auth.sendPasswordResetSms(phone)
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete(Task<Void> task) {
             if (task.isSuccessful()) {
                // 发送成功
            }else{
               // 发生错误
        Log.d("result",task.getException().toString()) ;
            }
        }
    });

2.确认重置密码手机验证码：

String phone = "18888888888";
String code = "090909";
String newPass = "newpassword123";
auth.confirmPasswordResetSms(phone，code，newPass)
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete(Task<Void> task) {
             if (task.isSuccessful()) {
                // 重置成功
            }else{
               // 发生错误
        Log.d("result",task.getException().toString()) ;
            }
        }
    });

更新邮箱地址

updateEmail() 方法用于更新用户邮箱地址。

WilddogUser user = auth.getCurrentUser();
user.updateEmail("12345678@gmail.com")
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete(Task<Void> task) {
            if (task.isSuccessful()) {
               // 更新成功
            }else{
              // 发生错误
              Log.d("result" ,task.getException().toString()) ;
            }
        }
    });

注意：

要更新用户的邮箱地址，该用户必须最近登录过。请参考重新进行身份认证。

使用 customToken 登录时，若该登录用户为 admin 用户，则不能更新邮箱地址。

更新用户邮箱或手机号认证密码

updatePassword() 方法用于更新用户邮箱或手机号认证密码。

WilddogUser user = auth.getCurrentUser();
String newPassword = "12345678";
user.updatePassword(newPassword)
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete(Task<Void> task) {
            if (task.isSuccessful()) {
                // 更新成功
            }else{
               // 发生错误
        Log.d("result",task.getException().toString()) ;
            }
        }
    });

注意：

要更新密码，该用户必须最近登录过。请参考重新进行身份认证。

使用 customToken 登录时，若该登录用户为 admin 用户，则不能更新用户密码。

发送重置密码邮件

sendPasswordResetEmail() 方法用于向用户发送重设密码邮件。

String emailAddress = "12345678@gmail.com";
auth.sendPasswordResetEmail(emailAddress)
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete(Task<Void> task) {
             if (task.isSuccessful()) {
                // 更新成功
            }else{
               // 发生错误
        Log.d("result",task.getException().toString()) ;
            }
        }
    });

注意：

在控制面板身份认证—登录方式—邮箱登录中可以设置邮件自定义模板。

删除用户

删除用户的方式有以下两种：

通过 delete() 方法删除
在控制面板身份认证—用户 中手动删除

使用 delete() 方法：

auth.getCurrentUser().delete()
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete(Task<Void> task) {
             if (task.isSuccessful()) {
                // 删除成功
            }else{
               // 发生错误
        Log.d("result",task.getException().toString()) ;
            }
        }
    });

使用控制面板：

注意：

要删除用户，该用户必须最近登录过。请参考重新进行身份认证。

使用 customToken 登录时，若该登录用户为 admin 用户，则不能更新用户密码。

重新进行身份认证

用户长时间未登录的情况下进行下列安全敏感操作会失败：

删除帐户
设置主邮箱地址
更改密码

此时需要重新对用户进行身份认证。

reauthenticate(credential) 方法用于对用户重新进行身份认证。

WilddogUser user = auth.getCurrentUser();
AuthCredential credential = EmailAuthProvider
    .getCredential("12345678@gmail.com", "12345678");
user.reauthenticate(credential)
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete( Task<Void> task) {
           if (task.isSuccessful()) {
                // 重新认证成功
            }else{
               // 发生错误
        Log.d("result",task.getException().toString()) ;
            }
        }
    });

上次更新：2018-06-21