> For the complete documentation index, see [llms.txt](https://ifanr.gitbook.io/baas-js-sdk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ifanr.gitbook.io/baas-js-sdk/js-sdk/react-native/signin-signout.md).

# 登入登出

## 通用注册登录

请参考[通用注册登录](/baas-js-sdk/js-sdk/user/auth.md)章节

## 第三方授权登录（微博、微信、Apple）

**接口说明：**

`BaaS.auth.loginWithThirdPartyAuthData(authData, options)`

**参数说明**

authData 为 Object 类型，字段属性如下：

| 属性        | 类型     | 必填 | 默认值 | 说明                       |
| --------- | ------ | -- | --- | ------------------------ |
| authToken | String | 是  | -   | 第三方 OAuth 登录后返回的 token   |
| username  | String | 否  | -   | 用户名，`apple-native` 登录时必填 |

options 为 Object 类型，字段属性如下：

| 参数              | 类型      | 必填 | 默认值       | 说明                                                                                                                                        |
| --------------- | ------- | -- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| provider        | String  | 是  | -         | 第三方平台，目前支持 `wechat-native`（微信第三方登录）、`apple-native`（Signin with Apple）                                                                     |
| createUser      | Boolean | 否  | `true`    | 是否创建用户                                                                                                                                    |
| syncUserProfile | String  | 否  | `'setnx'` | 是否[同步第一层级用户信息](https://ifanr.gitbook.io/baas-js-sdk/js-sdk/react-native/pages/-LYf3xQ6mL61OkgHtLeK#同步第一层级用户信息)，可选值为 overwrite、setnx、false |

**返回结果**

Promise<[UserRecord](/baas-js-sdk/js-sdk/user/account.md)>

**请求示例**

```js
BaaS.auth.loginWithThirdPartyAuthData({
  authToken: '****',
}, {
  provider: 'wechat',
  createUser: true,
  syncUserProfile: 'overwrite',
})
  .then(user => {
    // 登录成功
  })
  .catch(err => {
    // 登录失败
  })
```

err 对象结构请参考[错误码和 HError 对象](/baas-js-sdk/js-sdk/error-code.md)

## 已登录用户关联第三方平台账号

**接口说明：**

`UserRecord.linkThirdPartyWithAuthData(authData, options)`

**参数说明**

authData 为 Object 类型，字段属性如下：

| 属性        | 类型     | 必填 | 默认值 | 说明                       |
| --------- | ------ | -- | --- | ------------------------ |
| authToken | String | 是  | -   | 第三方 OAuth 登录后返回的 token   |
| username  | String | 否  | -   | 用户名，`apple-native` 登录时必填 |

options 为 Object 类型，字段属性如下：

| 参数              | 类型     | 必填 | 默认值       | 说明                                                                                                                                        |
| --------------- | ------ | -- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| provider        | String | 是  | -         | 第三方平台，目前支持 `wechat`（微信登录）、`apple`（Apple 登录）                                                                                               |
| syncUserProfile | String | 否  | `'setnx'` | 是否[同步第一层级用户信息](https://ifanr.gitbook.io/baas-js-sdk/js-sdk/react-native/pages/-LYf3xQ6mL61OkgHtLeK#同步第一层级用户信息)，可选值为 overwrite、setnx、false |

**请求示例**

```js
BaaS.auth.getCurrentUser().then(user => {
  return user.linkThirdPartyWithAuthData({
    authToken: '****',
  }, {
    provider: 'wechat',
    syncUserProfile: 'overwrite',
  })
})
  .then(() => {
    // 关联成功
  })
  .catch(err => {
    // 关联失败
  })
```

err 对象结构请参考[错误码和 HError 对象](/baas-js-sdk/js-sdk/error-code.md)