竹云IDaaS•开放平台

配置Apple认证源

认证源

# 概述

苹果提供【通过Apple登录】的功能，可以直接通过Apple ID，去登录第三方App或者网站。为方便企业用户的认证登录，IDaaS平台支持配置Apple认证源，用户可以通过Apple认证登录各应用系统，为企业用户带来更简易便捷的登录方式和更好的用户体验。

本章节为您介绍配置Apple认证源的相关操作。

# 前提条件

  • 拥有Apple开发平台的管理员权限。Apple开放平台需要加入 Apple Developer Program （可以以个人或组织加入，需要付费，年费RMB688）
  • 拥有IDaaS企业中心平台的管理员权限。

# 操作步骤

# Apple开发者平台操作

  1. 登录 Apple开发者平台 (opens new window)，添加开发者计划

  2. 拥有管理员权限，可在计划资源下显示 【证书、标识符和描述文件】 访问 标识符(英文) (opens new window)。

# 创建 App ID

  1. Identifiers 菜单中，选择 App IDs, 点击新增

  2. 选择 App IDs，点击 Continue

  3. Select a type 选择 App，点击 Continue

  4. 进入 Register an App ID 页面，输入 Description 和 Bundle ID

    • Description：App 描述，可修改
    • Bundle ID： App 描述，可修改必须唯一，建议输入项目的域名，例如 domain.com 可以输入 com.domain ，不可修改
    • Team ID： 记录该字段，后续用于IDaaS Apple 认证源配置中的 TeamId 字段

  5. 在下方勾选 Sign In with Apple ， 点击 Continue 完成 App ID 的注册

# 创建 Service ID

  1. Identifiers 菜单中，选择 Services IDs, 点击新增

  2. 选择 Services IDs 后点击 Continue 进入 Register a Services ID 页面，输入 Description 和 Services

    • Description： 服务描述，可修改
    • Identifier: 服务标识，不可修改。 后续用于IDaaS Apple 认证源配置中的 ClientId 字段

  3. 完成上一步的配置后， 点击 Continue, 进入以下页面， 完成配置后即创建Services ID成功。

    • Primary App ID： 选择刚刚创建的 App ID 进行绑定
    • Web Domain： 配置安全接口域名，例如 domain.com ，不需要 https 协议头， 可填写IDaaS租户域名
    • Return URLs： 授权登录后的接口回调地址，该地址必须是IDaaS提供的Apple登录地址，例如： https://demo.bccastle.com/api/v1/login/apple

# 创建 Keys

  1. Keys 菜单中，点击新增

  2. 在 Register a New Key 页面中，完成以下配置

    • key name： 可自定义key的名称

    • 勾选 Sign in with Apple， 点击 Configure， 选择之前创建的APP ID， 点击 Save。

  3. 保存后回到 Register a New Key 页面。 点击 Configure后，继续点击 Register。 显示以下页面。

    该页面中显示创建的Key ID，以及提醒您需要下载私钥文件。点击 Download 会下载一个 .p8 的文件。

    注意： 该页面的Key ID需要记录下来，并保存下载的 .p8 文件，后续用于IDaaS Apple认证源配置中的 Apple 私钥 字段

  4. 完成Key的添加后，可通过列表中查看新增的Key，详情页面如下

# IDaaS平台配置Apple认证源

  1. 登录IDaaS企业中心平台，在上方导航栏选择 “认证 > 认证源管理” ，进入Apple认证源页面单击 “添加认证源”

  2. 参考界面提示配置Apple认证源参数，关键参数说明如下。

    基本配置：Apple开发者平台完成以上操作后，可获得下列基本配置

    • TeamId ： 十位数的企业/个人账户编号
    • ClientId ： Apple开发者平台上注册的 Services ID 的 Identifier
    • KeyId： 刚刚注册的 Key 的 key ID
    • Apple 私钥： Apple开发者平台上注册的 Key 时下载的.p8 文件

    未关联用户时：即Apple开放平台返回的AppleID唯一标识在IDaaS中没有关联到系统用户时，可选配置项如下。

    • 绑定：当没有关联到用户时通过设定的绑定方式，跳转至相应的验证页面，输入短信验证码成功后，即可绑定相应的已有用户。
    • 绑定或注册：当没有关联到用户时输入短信验证码，成功后若手机号不存在，则进入注册流程完成注册信息填写后通过认证登录。

配置Apple登录