APNs 证书
重要:
Apple 对 APNs 旧版二进制文件协议的支持将于 2021 年 3 月 31 日结束。Apple 建议您改为使用基于 HTTP/2 的 APNs 提供程序 API。自版本 10.13.0 起,XenMobile Server 支持基于 HTTP/2 的 API。有关更多信息,请参阅https://developer.apple.com/中的新闻更新“Apple 推送通知服务更新”。有关检查与 APN 的连接的帮助,请参阅连接检查。
要在 XenMobile 中注册并管理 iOS 和 macOS 设备,应设置 Apple 提供的 Apple 推送通知服务 (APNs) 证书。
工作流程摘要:
步骤 1:通过以下任一方法创建证书签名请求(CSR):
步骤 2:在 XenMobile Tools 中为 CSR 签名
步骤 4:使用用于步骤 1 的同一台计算机,完成 CSR 并导出 PKCS #12 文件:
步骤 6:续订 APNs 证书
创建证书签名请求
我们建议您在 macOS 上使用钥匙串访问来创建 CSR。还可以通过 Microsoft IIS 或 OpenSSL 创建 CSR。
重要:
- 对于用于创建证书的 Apple ID:
- The Apple ID must be a corporate ID and not a personal ID.
- Record the Apple ID that you use to create the certificate.
- To renew your certificate, use the same organization name and Apple ID. Using a different Apple ID to renew the certificate require device reenrollment.
如果您无意或有意吊销了该证书,则无法管理自己的设备。
- 如果使用 iOS Developer Enterprise Program 创建移动设备管理器推送证书:请务必在 Apple Push Certificates Portal 中处理面向迁移的证书的任何操作。
在 macOS 上使用钥匙串访问创建 CSR
- 在运行 macOS 的计算机上,在应用程序 > 实用工具下方,启动钥匙串访问应用程序。
- 打开钥匙串访问菜单,然后单击证书助理 > 从证书颁发机构请求证书。
- “证书助理”将提示您输入以下信息:
- 电子邮件地址:负责管理证书的个人或角色帐户的电子邮件地址。
- 公用名:负责管理证书的个人或角色帐户的公用名。
- CA 电子邮件地址:证书颁发机构的电子邮件地址。
- 选择存储到磁盘和让我指定密钥对信息选项,然后单击继续。
- 输入 CSR 文件的名称,在您的计算机上保存此文件,然后单击保存。
- 指定密钥对信息:选择密钥大小2048 位以及RSA 算法,然后单击继续。作为 APNs 证书流程的一部分,CSR 文件已可供上载。
- 证书助理完成 CSR 流程后,单击完成。
- 要继续,请为 CSR 签名。
使用 Microsoft IIS 创建 CSR
生成 APNs 证书请求的第一步是创建证书签名请求 (CSR)。对于 Windows,请通过使用 Microsoft IIS 生成 CSR。
- 打开 Microsoft IIS。
- 双击 IIS 的服务器证书图标。
- 在服务器证书窗口中,单击创建证书申请。
- 键入相应的标识名 (DN) 信息,然后单击下一步。
- 为加密服务提供程序选择Microsoft RSA SChannel Cryptographic Provider,并为位长度选择2048,然后单击下一步。
- 输入文件名并指定 CSR 的保存位置,然后单击完成。
- 要继续,请为 CSR 签名。
使用 OpenSSL 创建 CSR
如果无法使用 macOS 设备或 Microsoft IIS 生成 CSR,请使用 OpenSSL。可以从 OpenSSL Web 站点下载并安装 OpenSSL。
在安装了 OpenSSL 的计算机上,从命令提示窗口或 Shell 执行以下命令。
openssl req -new -keyout Customer.key.pem –out CompanyAPNScertificate.csr -newkey rsa:2048
此时将显示以下要求证书命名信息的消息。根据请求输入信息。
You are about to be asked to enter information that will be incorporated into your certificate request. What you are about to enter is what is called a Distinguished Name or a DN. There are quite a few fields but you can leave some blank For some fields there will be a default value, If you enter '.', the field will be left blank. ----- Country Name (2 letter code) [AU]:US State or Province Name (full name) [Some-State]:CA Locality Name (eg, city) []:RWC Organization Name (eg, company) [Internet Widgits Pty Ltd]:Customer Organizational Unit Name (eg, section) [:Marketing Common Name (eg, YOUR name) []:John Doe Email Address []:john.doe@customer.com
在下一条消息中,输入 CSR 私钥的密码。
Please enter the following 'extra' attributes to be sent with your certificate request A challenge password []: An optional company name []:
要继续,请按照下一节中的说明为 CSR 签名。
为 CSR 签名
要将证书与 XenMobile 一起使用,请将其提交给 Citrix 进行签名。Citrix 使用其移动设备管理签名证书给 CSR 签名并返回.plist
格式的已签名文件。
在浏览器中,转至Endpoint Management ToolsWeb 站点,然后单击Request push notification certificate signature(申请推送通知证书签名)。
在创建新证书页面上,单击上载 CSR。
浏览并选择证书。
证书必须采用 .pem/txt 格式。
在Endpoint Management APNs CSR Signing(Endpoint Management APNs CSR 签名)页面上,单击Sign(签名)。将为 CSR 签名并将签名后的 CSR 自动保存到已配置的下载文件夹。
要继续,请按照下一节中的说明提交签名的 CSR。
将签名后的 CSR 提交给 Apple 以获取 APNs 证书
从 Citrix 收到已签名的证书签名请求 (CSR) 后,将 CSR 提交给 Apple,以获取导入到 XenMobile 所需的 APNs 证书。
注意:
有些用户报告登录 Apple 推送门户时遇到问题。或者,登录Apple 开发人员门户,然后按照以下步骤进行操作。
在浏览器中,转到Apple Push Certificates Portal。
单击Create a Certificate(创建证书)。
首次使用 Apple 创建证书:选中I have read and agree to these terms and conditions(我已阅读并同意这些条款和条件)复选框,然后单击Accept(接受)。
单击Choose File(选择文件),浏览到计算机上已签名的 CSR,然后单击Upload(上载)。此时将显示一条确认消息,指示上载成功。
单击Download(下载)以检索 .pem 证书。
要继续,请完成 CSR 并导出 PKCS #12 文件,如下一节中所述。
完成 CSR 并导出 PKCS #12 文件
收到 Apple 提供的 APNs 证书后,返回到钥匙串访问、Microsoft IIS 或 OpenSSL 以将证书导出到 PCKS #12 文件中。
PCKS #12 文件包含 APNs 证书文件和您的私钥。PFX 文件的扩展名通常为 .pfx 或 .p12。可以互换使用 .pfx 和 .p12 文件。
重要:
Citrix 建议您保存或导出本地系统中的个人密钥和公钥。您需要密钥来访问 APNs 证书以便重复使用。如果没有相同的密钥,您的证书无效,您必须重复执行整个 CSR 和 APNs 过程。
在 macOS 上使用钥匙串访问创建 PKCS #12 文件
重要:
在此任务中使用的 macOS 设备应与生成 CSR 时使用的 macOS 设备相同。
在设备上,找到从 Apple 收到的生产标识 (.pem) 证书。
启动钥匙串访问应用程序并导航到登录 > 我的证书选项卡。将产品标识证书拖放到打开的窗口中。
单击证书并展开左箭头以验证证书是否包含关联的私钥。
要开始将证书导出到 PCKS #12 (.pfx) 证书中,请选择证书和私钥,单击鼠标右键,然后选择导出 2 个项目。
为证书文件提供唯一的名称以用于 XenMobile。请勿在名称中包含空格字符。然后,为保存的证书选择一个文件夹位置,选择 .pfx 文件格式,然后单击保存。
输入用于导出证书的密码。Citrix 建议使用具有唯一性的强密码。还要确保证书和密码的安全性,以供以后使用和引用。
钥匙串访问应用程序将提示您输入登录密码或选定的钥匙串。键入密码,然后单击确定。保存的证书现在即可用于 XenMobile Server。
要继续操作,请参阅将 APNs 证书导入到 XenMobile。
使用 Microsoft IIS 创建 PKCS #12 文件
重要:
在此任务中使用的 IIS 服务器应与生成 CSR 时使用的 IIS 服务器相同。
打开 Microsoft IIS。
单击服务器证书图标。
在服务器证书窗口中,单击完成证书申请。
浏览至来自 Apple 的 Certificate.pem 文件。然后,键入友好名称或证书名称,并单击确定。请勿在名称中包含空格字符。
选择在步骤 4 中找到的证书,然后单击导出。
指定 .pfx 证书的位置和文件名以及密码,然后单击确定。
您需要证书的密码才能将其导入 XenMobile。
将 .pfx 证书复制到计划安装 XenMobile 的服务器上。
要继续操作,请参阅将 APNs 证书导入到 XenMobile。
使用 OpenSSL 创建 PKCS #12 文件
如果您使用 OpenSSL 创建 CSR,还可以使用 OpenSSL 创建 .pfx APNs 证书。
在命令提示符或 shell 下,执行以下命令。
Customer.privatekey.pem
为来自 CSR 的私钥。APNs_Certificate.pem
为您刚从 Apple 收到的证书。openssl pkcs12 -export -in APNs_Certificate.pem -inkey Customer.privatekey.pem -out apns_identity.pfx
输入 .pfx 证书文件的密码。记住此密码,因为在将证书上载到 XenMobile 时要再次使用该密码。
记下 .pfx 证书文件的位置。然后,将该文件复制到 XenMobile Server 中,以便可以使用控制台上载文件。
要继续,请将 APNs 证书导入 XenMobile,如下一节中所述。
将 APNs 证书导入到 XenMobile
在收到新 APNs 证书后:将 APNs 证书导入 XenMobile,以便首次添加该证书或者替换证书。
在 XenMobile 控制台中,转至设置 > 证书。
单击导入 > 密钥库。
在用作中,选择APNs。
浏览到计算机上的 .pfx 或 .p12 文件。
输入密码,然后单击导入。
有关 XenMobile 中的证书的详细信息,请参阅证书和身份验证。
续订 APNs 证书
重要:
如果您在续订过程中使用其他 Apple ID,则必须重新注册用户设备。
要续订 APNs 证书,请执行创建证书的步骤,然后转到Apple Push Certificates Portal。使用该门户上载新证书。登录后,将显示您的现有证书或者从您之前的 Apple 开发人员帐户导入的证书。
在 Certificates Portal 中,续订证书的唯一区别是要单击Renew(续订)。您必须在 Certificates Portal 上拥有开发人员帐户才能访问该站点。要续订证书,请使用相同的组织名称和 Apple ID。
要确定 APNs 证书的过期时间,请在 XenMobile 控制台中转至设置 > 证书。如果证书过期,请不要吊销。
使用 Microsoft IIS、钥匙串访问 (macOS) 或 OpenSSL 生成 CSR。有关生成 CSR 的详细信息,请参阅创建证书签名请求。
在浏览器中,转到Endpoint Management 工具。然后,单击Request push notification certificate signature(申请推送通知证书签名)。
单击+ Upload the CSR(+ 上载 CSR)。
在对话框中,导航到 CSR,单击Open(打开),然后单击Sign(签名)。
收到
.plist
文件时,将其保存。在步骤 3 标题中,单击Apple Push Certificates Portal并登录。
选择要续订的证书,然后单击Renew(续订)。
上载
.plist
文件。您将收到输出文件 .pem。保存 .pem 文件。使用该 .pem 文件完成 CSR(根据您在步骤 1 中创建 CSR 时使用的方法)。
将证书导出为 .pfx 文件。
在 XenMobile 控制台中,导入 .pfx 文件并按如下所示完成配置:
- 转到设置 > 证书 > 导入。
- 在导入菜单中,选择密钥库。
- 在密钥库类型菜单中,选择PKCS #12。
在用作中,选择APNs。
- 对于密钥库文件,单击浏览并导航到该文件。
- 在密码中,键入证书密码。
- 键入可选说明。
- 单击导入。
XenMobile 将您重定向回证书页面。名称、状态、有效期开始时间和有效期结束时间字段将更新。