iOS 证书设置指南

快来打我* 2023-03-05 06:26 25阅读 0赞

# iOS 证书设置指南 #

## 创建应用程序 ID ##

*  登陆 [苹果开发者网站][Link 1] 进入开发者账户。

![go\_to\_account\_page][go_to_account_page]

*  从开发者账户页面左侧入口进入 “Certificates, IDs & Profiles” 页面。

![go\_to\_cert\_page][go_to_cert_page]

*  创建 App ID，填写 App ID 的 NAME 和 Bundle ID（如果 ID 已经存在可以直接跳过此步骤）。

![add\_appid][add_appid]

注: 此处需要指定具体的 Bundle ID 不要使用通配符。

![appid\_suffix][appid_suffix]

*  为 App 开启 Push Notification 功能。如果是已经创建的 App ID 也可以通过设置开启 Push Notification 功能。

![appid\_service][appid_service]

*  填写好以上属性后，点击 “Continue”，确认 AppId 属性的正确性，点击 “Register”，注册 AppId 成功。

## 两种鉴权方式的配置 ##

极光官网应用的鉴权信息一旦配置，只能用相同 bundleID 的鉴权信息进行更新，无法修改为其他的 bundleID，请在配置前仔细检查 bundleID 是否正确，若因特殊原因需要修改，请联系 support@jpush.cn

### 方式一：通过 .p12 证书鉴权 ###

*  如果你之前没有创建过 Push 证书或者是要重新创建一个新的，请在证书列表下面新建。

![add\_cert][add_cert]

*  新建证书需要注意选择 APNs 证书种类。如图 APNs 证书有开发（Development）和生产（Production）两种。

注：开发证书用于开发调试使用；生产证书既能用于开发调试，也可用于产品发布。此处我们选择生产证书为例。

![cert\_type][cert_type]

*  点击 "Continue", 之后选择该证书准备绑定的 AppID。

![cert\_to\_app][cert_to_app]

*  再点 “Continue” 会让你上传 CSR 文件。（ CSR 文件会在下一步创建）

![update\_CSR][update_CSR]

*  打开系统自带的 KeychainAccess 创建 Certificate Signing Request。如下图操作：

![open\_keychain][open_keychain]

*  填写“用户邮箱”和“常用名称” ，并选择“存储到磁盘”，证书文件后缀为 .certSigningRequest 。

![cert\_info][cert_info]

*  回到浏览器中 CSR 上传页面，上传刚刚生成的后缀为 .certSigningRequest 的文件。
 *  生成证书成功后，点击 “Download” 按钮把证书下载下来，是后缀为 .cer 的文件。

![cert\_ready][cert_ready]

*  双击证书后，会在 “KeychainAccess” 中打开，选择左侧“钥匙串”列表中“登录”，以及“种类”列表中“我的证书”，找到刚才下载的证书，并导出为 .p12 文件。如下图：

![export\_p12][export_p12] ![save\_p12][save_p12]

*  在极光控制台上，进入你应用的应用设置中 iOS 的鉴权方式选择 “证书”，上传刚才导出的 .p12 证书。极光会在后台为你的应用进行鉴权。
 *  Apple 的生产推送证书允许用于开发环境的推送，勾选将生产证书用于开发环境，开发者可以仅上传生产证书，即可在官网推送平台处选择开发环境做推送，不用再生成和上传开发证书。

![add\_to\_portal][add_to_portal]

### 方式二：通过 APNs Auth Key 鉴权 ###

*  点击左侧列表 “Keys” 中的 “All”，看账户中是否已有 auth key，没有则点击 “+” 新建。

![go\_to\_add\_auth\_key][go_to_add_auth_key]

*  填写该 key 的描述并选择服务，如下图。 （注：在开发和生产环境均可使用，且不会过期。）

![create\_auth\_key][create_auth_key]

*  点击 “Continue” 让你确认信息，再点击 “confirm”，就可以下载该 key 了。（注意：记下 key id，而且只可以下载一次，请妥善保存。）

![download\_auth\_key][download_auth_key]

*  获取你之前创建过的应用的 Bundle ID

![get\_bundle\_id][get_bundle_id]

*  在开发者账户的 “Membership” 页面获取 Team ID

![get\_team\_id][get_team_id]

*  在极光控制台上，进入你应用的应用设置中 iOS 的鉴权方式选择 “Token Authentication”，上传 auth key 文件，并填写你的 KEY ID，TeamID，和指定应用的 BundleID。极光会在后台为你的应用进行鉴权。

![add\_to\_portal][add_to_portal 1]

## Provisioning Profile 的创建 ##

*  创建 Provisioning Profile 的前提，已在 Apple Developer 网站创建待发布应用所使用的 Bundle ID 的 App ID，且为该 App ID 创建了 iOS Development 证书。
 *  在[苹果开发者账号的 Provisioning Profile ][Provisioning Profile]页面点击下图按钮，创建 Provisioning Profile

![go\_to\_add\_pp][go_to_add_pp]

*  选择此 Provisioning Profile 的环境后点击 \[Continue\]：

![select\_type][select_type]

*  选择要创建 Provisioning Profile 的 App ID 后点击 \[Continue\]：

![select\_appid][select_appid]

*  选择所属的开发者证书，（这里创建了多个开发者证书，建议只创建一个，方便管理）为了方便，选择了 \[Select All\]，再点击 \[Continue\] 进入下一步：

![select\_cert][select_cert]

*  为该 Provisioning Profile 选择将要安装的设备（一般选择 \[Select All\]），点击 \[Continue\]:

![select\_device][select_device]

*  给该 Provisioning Profile 填写 Profile Name，点击 \[generate\] 完成创建。

![pp\_name][pp_name]

*  填写完 Profile Name 后点击 \[generate\] 完成创建，之后点击 \[DownLoad\] 下载 Provisioning Profile

![pp\_download][pp_download]

*  双击下载下来的 Provisioning Profile，添加到 xcode。

## XCode 的证书配置教程 ##

参照[ iOS SDK 集成指南][iOS SDK]集成 JPush SDK 和上传了推送用到的 p12 证书后在编译运行前需要先配置一下证书，步骤如下：

*  打开 xxx-info.plist 的 Bundle identifier 项把上传到 JPush 控制台的 bundle id 填写进去：

![settings\_bundle][settings_bundle]

*  点击项目，选择目标 TARGETS 后进入 Build Setting 界面，搜索 “Code signing”，按照下图配置

![build\_settings][build_settings]

[Link 1]: https://developer.apple.com/
[go_to_account_page]: /images/20230208/9f0bb914881a411aa9d7fc230ceadf21.png
[go_to_cert_page]: /images/20230208/b0662541762941c6939447cc131504f7.png
[add_appid]: /images/20230208/f80fd46eddc645f19346893e27522203.png
[appid_suffix]: /images/20230208/b5ef148c61b2431e9493f8fb220aacb5.png
[appid_service]: /images/20230208/890d1576dfe84708af20f0b1bd500b8b.png
[add_cert]: /images/20230208/1dd9d1f796ed4cd7837f47dc26c5c65c.png
[cert_type]: /images/20230208/ca2c04e7293c4509ba6c0e9f6b12aeb1.png
[cert_to_app]: /images/20230208/329ae268ecf34637a21124d3d8f766de.png
[update_CSR]: /images/20230208/583e5c5dedb145d18584d6fb1c07ddeb.png
[open_keychain]: /images/20230208/416a7b0b094f457bb10baf4060f9803e.png
[cert_info]: /images/20230208/73a01bb352574e8a858fb8afef9d7a20.png
[cert_ready]: /images/20230208/b8cf088dde0042669cce7a544939d6ea.png
[export_p12]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9kb2NzLmppZ3VhbmcuY24vanB1c2gvY2xpZW50L2ltYWdlL2lvc19jZXJ0L3AxMl85X2V4cG9ydFAxMi5wbmc?x-oss-process=image/format,png
[save_p12]: /images/20230208/c1ef4690404144be816144c9651e4e18.png
[add_to_portal]: /images/20230208/dae8f6ab3dcb4c32862602a6a16f501c.png
[go_to_add_auth_key]: /images/20230208/f910d58b046a4bf9a76335cd0058a4ab.png
[create_auth_key]: /images/20230208/5f0013997be64a01bf5a924e07954877.png
[download_auth_key]: /images/20230208/0edeccd8264e4a4e97d96167553420f4.png
[get_bundle_id]: /images/20230208/c9e4444e9b364539a48e20bb52b729b4.png
[get_team_id]: /images/20230208/78694253c29741d4974f5e9162c41c69.png
[add_to_portal 1]: /images/20230208/37dec875dab542e9ac6bb2be61b13c64.png
[Provisioning Profile]: https://developer.apple.com/account/ios/profile/
[go_to_add_pp]: /images/20230208/afc2ce6459d843f9a925334aae43aefb.png
[select_type]: /images/20230208/b2b9c965a1174b79bc3276e7febd8366.png
[select_appid]: /images/20230208/b2ff5772e71a41979d7b13b2fef21c60.png
[select_cert]: /images/20230208/345f8e5c61394c53a13c69b64cf4ab66.png
[select_device]: /images/20230208/89bafcfc9a5d4a9aa180753e83335ceb.png
[pp_name]: /images/20230208/ee71e40b25d2413a94cadd851a127ab5.png
[pp_download]: /images/20230208/8bd8a1cc6de641c69b618859dd55bf5c.png
[iOS SDK]: https://docs.jiguang.cn/jpush/client/iOS/ios_guide_new/
[settings_bundle]: /images/20230208/24bdb19f59a04a1c9f04f9ec1e337748.png
[build_settings]: /images/20230208/62027eb959e249a8a5c95ab889ac7562.png