多端身份管理

WARNING

请注意，当前域名 https://dev.weixin.qq.com/docs/framework 文档已不维护，请前往微信文档中心open in new window 找到对应的新文档继续使用

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

一、开通身份管理服务

  • 创建多端应用后，可进入多端应用详情中，前往「身份管理」模块中进行开通
  • 开通后，即可对不同的登录方式进行初始化配置

二、使用说明

1、获取多端应用 ID 与密钥

登录控制台，前往 “多端应用”-“应用详情”，获取应用 ID 与密钥。

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

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

2、验证码短信配置说明

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

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

说明：

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

3、Apple 登录配置说明

a) 前期准备

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

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

b) 获取 Team ID

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

c) 获取 Bundle ID

前往苹果开发者页面，在 Certificates，Identifiers & Profiles > Identifiers 页面，点击图标创建应用

选择 App IDs 然后点击 Continue 按钮继续

选择格式的应用类型，然后点击 Continue 按钮继续

填写应用描述和 Bundle ID，请记录下此 Bundle ID

滑动浏览器到下面找到 Sign in with Apple 并勾选

最后点击 Continue 按钮创建应用

d) 获取 Key ID 和 Private Key

前往苹果开发者页面open in new window，在 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-----

e) 配置身份管理控制台信息

打开开发平台控制台，选择多端身份管理 -> 指定应用 -> Apple 登录。将在 “前期准备” 中记录的 Bundle ID、Team ID、Key ID 和 Private Key 填入并保存。

4、Apple 登录开发指引

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

a) 使用 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
}

b) 在 xcode 中开启 Apple 登录

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