title: 邮箱登录

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

前期准备

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

创建用户

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

1.安装 Wilddog Auth SDK：

将以下 pod 包含在你的 Podfile 中：

  1.   pod 'Wilddog/Auth'

安装 SDK：

  1.   $ pod install

2.创建 Wilddog Auth 实例：

Objective-C Swift
objectivec WDGOptions *option = [[WDGOptions alloc] initWithSyncURL:@"https://<your-wilddog-appid>.wilddogio.com"]; [WDGApp configureWithOptions:option];
swift let options = WDGOptions.init(syncURL: "https://<your-wilddog-appid>.wilddogio.com") WDGApp.configure(with: options)

3.使用 createUserWithEmail:password:completion: 方法创建新用户：

Objective-C Swift
objectivec [[WDGAuth auth] createUserWithEmail:@"12345678@wilddog.com" password:@"password123" completion:^(WDGUser *_Nullable user, NSError *_Nullable error) { // ... }];
swift WDGAuth.auth()?.createUser(withEmail: "12345678@wilddog.com", password: "password123") { (user, error) in // ... }

注意：

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

登录用户

1.安装 Wilddog Auth SDK：

将以下 pod 包含在你的 Podfile 中：

  1.   pod 'Wilddog/Auth'

安装 SDK：

  1.   $ pod install

2.创建 Wilddog Auth 实例：

Objective-C Swift
objectivec WDGOptions *option = [[WDGOptions alloc] initWithSyncURL:@"https://<your-wilddog-appid>.wilddogio.com"]; [WDGApp configureWithOptions:option];
swift let options = WDGOptions.init(syncURL: "https://<your-wilddog-appid>.wilddogio.com") WDGApp.configure(with: options)

3.将该用户的电子邮件地址和密码传递到 signInWithEmail:password:completion:，即可在你应用中登录此用户：

Objective-C Swift
objectivec [[WDGAuth auth] signInWithEmail:@"12345678@wilddog.com" password:@"password123" completion:^(WDGUser *user, NSError *error) { // ... }];
swift WDGAuth.auth()?.signIn(withEmail: "12345678@wilddog.com", password: "password123") { (user, error) in // ... }

注意：

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

退出登录

signOut: 方法用于用户退出登录：

Objective-C Swift
objectivec NSError *error; [[WDGAuth auth] signOut:&error]; if (!error) { // 退出登录成功 }
swift try! WDGAuth.auth()!.signOut()

更多使用

  • 通过 [WDGAuth auth].currentUser 获取当前用户并管理用户。详情请参考 用户管理。
  • Wilddog Auth 可以将你的应用与 Wilddog Sync 无缝集成：使用邮箱登录后，Wilddog Auth 将给用户生成 Wilddog ID。Wilddog ID 结合 规则表达式，可以控制 Wilddog Sync 的用户访问权限。