password.md

title: 邮箱登录

本篇文档介绍在 Wilddog Auth 中如何使用邮箱地址和密码对用户进行身份认证。

前期准备

1. 在控制面板中创建应用。请参考 控制面板-创建应用。
2. 在控制面板 身份认证—登录方式 中打开邮箱登录方式。

创建用户

用邮箱密码创建一个新用户，需完成以下步骤：

1.安装 Wilddog Auth SDK：

compile 'com.wilddog.client:wilddog-auth-android:2.0.5'

2.初始化 Wilddog Auth 实例：

WilddogOptions options = new WilddogOptions.Builder().setSyncUrl("https://<wilddog appId>.wilddogio.com").build();
WilddogApp.initializeApp(this, options);
mAuth = WilddogAuth.getInstance();

3.使用 createUserWithEmailAndPassword(email,password) 方法创建新用户：

  mAuth.createUserWithEmailAndPassword(email, password)
        .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete( Task<AuthResult> task) {
                if (task.isSuccessful()) {
                   // 获取用户
                 WilddogUser user = task.getResult().getWilddogUser();
                  Log.d("result",user.toString());
                }
				else{
                  // 错误处理
                 Log.d("result",task.getException().toString());
                  
				} 
            }
        });

注意：

如果新用户创建成功，默认会处于登录状态，并且你可以在回调方法中获取登录用户。

登录用户

1.安装 Wilddog Auth SDK：

compile 'com.wilddog.client:wilddog-auth-android:2.0.5'

2.初始化 Wilddog Auth 实例：

WilddogOptions options = new WilddogOptions.Builder().setSyncUrl("https://<wilddog appId>.wilddogio.com").build();
WilddogApp.initializeApp(this, options);
mAuth = WilddogAuth.getInstance();

3.将该用户的电子邮件地址和密码传递到 signInWithEmailAndPassword(email,password)，即可在你应用中登录此用户：

  mAuth.signInWithEmailAndPassword(email, password)
        .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
            @Override
            public void onComplete( Task<AuthResult> task) {
                Log.d(TAG, "signInWithEmail:onComplete:" + task.isSuccessful());
                if (!task.isSuccessful()) {
                    Log.w(TAG, "signInWithEmail", task.getException());
                    Toast.makeText(EmailPasswordActivity.this, "Authentication failed.",
                            Toast.LENGTH_SHORT).show();
                }

            }
        });

注意：

如果用户成功登录，你可以在回调方法中获取登录用户。

退出登录

signOut() 方法用于用户退出登录：

mauth.signOut();

更多使用

• 通过 WilddogAuth.getInstance().getCurrentUser() 获取当前用户并管理用户。详情请参考 用户管理。

• Wilddog Auth 可以将你的应用与 Wilddog Sync 无缝集成：使用邮箱登录后，Wilddog Auth 将给用户生成 Wilddog ID。Wilddog ID 结合 规则表达式，可以控制 Wilddog Sync 的用户访问权限。