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.调用 signInAnonymouslyWithCompletion:方法:

Objective-C Swift
objectivec WDGAuth *auth = [WDGAuth auth]; [auth signInAnonymouslyWithCompletion:^(WDGUser *_Nullable user, NSError *_Nullable error) { // ... }];
swift let auth = WDGAuth.auth() auth?.signInAnonymously(){(user, error) in //... }

4.signInAnonymouslyWithCompletion: 方法调用成功后,可以在当前用户对象中获取用户数据:

Objective-C Swift
objectivec WDGUser user = [WDGAuth auth].currentUser; BOOL isAnonymous = user.anonymous; // YES NSString *uid = user.uid;
swift let user = WDGAuth.auth()!.currentUser; let isAnonymous = user!.isAnonymous // true let uid = user!.uid

匿名帐号转成永久帐号

匿名登录的帐号数据将不会被保存,可以通过绑定邮箱认证或第三方认证方式将匿名帐号转成永久帐号。

绑定邮箱认证方式

绑定邮箱认证方式需要以下三个步骤:

1.以任意一种认证方式登录一个帐号。

2.获取邮箱认证方式的 credential。

Objective-C Swift
objectivec WDGAuthCredential *credential = [WDGEmailPasswordAuthProvider credentialWithEmail:@"12345678@wilddog.com" password:@"password123"];
swift let credential = WDGEmailPasswordAuthProvider.credential(withEmail: "12345678@wilddog.com", password: "password123")

3.使用邮箱认证方式绑定。

Objective-C Swift
objectivec WDGAuth *auth = [WDGAuth auth]; [auth.currentUser linkWithCredential:credential completion:^(WDGUser *_Nullable user,NSError *_Nullable error) { // ... }];
swift let auth = WDGAuth.auth() auth!.currentUser?.link(with: credential) { (user, error) in // ... }

绑定第三方认证方式

绑定第三方认证方式需要以下三个步骤:

1.以任意一种认证方式登录一个帐号。

2.获取需要绑定认证方式的 credential。

Objective-C Swift
objectivec // QQ 认证 WDGAuthCredential *credential = [WDGQQAuthProvider credentialWithAccessToken:qqOAuth.accessToken]; // 微博认证 WDGAuthCredential *credential = [WDGSinaAuthProvider credentialWithAccessToken:sinaOAuth.accessToken userID:sinaOAuth.userID]; // 微信认证 WDGAuthCredential *credential = [WDGWeiXinAuthProvider credentialWithCode:weixinOAuth.code];
swift // QQ 认证 let credential = WDGQQAuthProvider.credential(withAccessToken: qqOAuth.accessToken) // 微博认证 let credential = WDGSinaAuthProvider.credential(withAccessToken: sinaOAuth.accessToken, userID: sinaOAuth.userID) // 微信认证 let credential = WDGWeiXinAuthProvider.credential(withCode: weixinOAuth.code)

3.使用第三方认证方式绑定。

Objective-C Swift
objectivec WDGAuth *auth = [WDGAuth auth]; [auth.currentUser linkWithCredential:credential completion:^(WDGUser *_Nullable user,NSError *_Nullable error) { // ... }];
swift let auth = WDGAuth.auth() auth!.currentUser?.link(with: credential) { (user, error) in // ... }

注意:

若使用 customToken 登录时,若 customToken 中 admin 属性为 true,则不能进行关联操作。

退出登录

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 的用户访问权限。