# 多端身份管理

为方便开发者在多端应用中快速完成 App 登录对接，平台推出了「多端身份管理服务」，提供微信登录、短信验证码登录、一键本机号码登录以及 Apple 登录等服务，关于多端身份管理服务的介绍可查看多端身份管理简介。

# 一、开通身份管理服务

创建多端应用后，可进入微信开发者平台的「多端应用」管理控制台，前往「身份管理」模块中进行开通。

开通后，即可对不同的登录方式进行初始化配置。

# 二、使用说明

# 2.1 获取多端应用 ID 与密钥

进入微信开发者平台的「多端应用」管理控制台，前往「应用概览」模块中获取应用 ID 与密钥（即应用 Secret）。

使用该密钥可调用服务端 API。

注：该多端应用需已在多端身份管理中完成接入。

# 2.2 验证码短信配置说明

多端身份管理为开发者提供验证码短信发送服务，开发者只需根据业务场景调用手机验证码登录接口即可。

短信模板内容为：

【短信签名】您的验证码为 {%验证码}，有效期为2分钟，可用于登录{%移动应用名称}

说明：

使用短信验证码服务前，开发者需先前往多端应用控制台绑定移动应用。短信模板内容将自动使用该绑定的移动应用名称，开发者可根据上述指引修改移动应用名称。
短信服务当前为免费限量公测，后续正式收费前将会通知。
短信签名默认为开发小程序名称，开发者可前往多端应用控制台的「身份管理-手机登录-管理-短信签名」处修改为移动应用名称。

# 2.3 Apple 登录配置说明

# 2.3.1 前期准备

接入 Apple 登录，首先需要从苹果开发者网站上获取如下几个信息：

Team ID：唯一标识苹果开发者的信息
Bundle ID：唯一标识苹果应用的信息
Key ID：私钥 ID
Private Key：私钥

# 2.3.2 获取 Team ID

使用苹果开发者账号登录前往 Membership 页面，获取 Team ID（需要是认证且付费过的开发者）。

# 2.3.3 获取 Bundle ID

使用 Apple 开发者账号登录 Developer 控制台，前往「证书、标识符和描述文件」进入「标识符」页面，开始定义 Bundle ID，具体请参考此文档。

# 2.3.4 获取 Key ID 和 Private Key

前往苹果开发者页面，在 Certificates，IDs，& Profiles > Keys Tab 页面，点击图标。

输入名称并勾选上 Sign in with Apple，点击 Configure，确保选中的 Primary App ID 是你刚刚创建的那一个。

点击 Save，Continue，最后点击 Register。

创建之后，获得 Key ID，然后点击 Download 下载该密钥。

打开下载的密钥，并记录其中的内容，格式为

-----BEGIN PRIVATE KEY-----
xxxxxxxxxxx
xxxxxxxxxxx
xxxxxxxxxxx
xxxxxxxxxxx
-----END PRIVATE KEY-----

# 2.3.5 配置身份管理控制台信息

进入微信开发者平台的多端应用控制台，前往「身份管理」模块，选择 Apple 登录-管理。将在 “前期准备” 中记录的 Bundle ID、Team ID、Key ID 和 Private Key 填入并保存。

# 2.4 Apple 登录开发指引

完成上述准备工作，并且已经通过开发者工具构建出一个完整的 xcode 工程，可以开始正式接入 Apple 登录。

# 2.4.1 使用 WeAppIdaas 拓展模块

iOS >= 0.9.8 支持

在 iOS 工程下 miniapp.json 内的 useExtendedSdk 新增 WeAppIdaas 字段并指定 true，重新 pod install 即可。

// miniapp.json
"useExtendedSdk": {
  "WeAppOpenFuns": true,
  "WeAppNetwork": false,
  "WeAppBluetooth": false,
  "WeAppMedia": false,
  "WeAppLBS": false,
  "WeAppLive": false,
  "WeAppOthers": false,
  "WeAppIdaas": true
}

# 2.4.2 在 xcode 中开启 Apple 登录

如下图所示，在第 4 步中会弹出一个选项框，搜索 sign in with Apple，点击即可开启 Apple 登录，添加完后出现第 5 步的配置，即配置完成。