# 适用于 iOS 的 Apple Wallet pass 配置

配置您的 **Pass Type ID 签名证书**，以便 Pushwoosh 可以为您的应用签署和更新 [Apple Wallet pass](/zh/product/messaging-channels/apple-wallet-passes/) (`.pkpass`)。这是一次性设置。一旦有效的证书就位，Apple Wallet [pass 构建器](/zh/product/messaging-channels/apple-wallet-passes/pass-builder/) 将为该应用解锁。



## 创建证书

<Aside type="caution" title="重要提示">
证书是**按应用**存储的。请为每个签发 pass 的应用进行配置。
</Aside>

1. **注册一个 Pass Type ID。** 在 [Apple Developer Portal](https://developer.apple.com/account/resources/identifiers/list) 中，
   转到 **Certificates, Identifiers & Profiles → Identifiers**，点击 **+**，选择 **Pass Type IDs**，
   然后输入一个反向 DNS 标识符，例如 `pass.com.yourcompany.passtype`。

2. 在 Keychain Access 中 [**生成证书签名请求 (CSR)**](https://developer.apple.com/help/account/certificates/create-a-certificate-signing-request)。
   您将在下一步中上传此文件。

3. **创建证书。** 在 Apple Developer Portal 中打开您的 Pass Type ID，然后点击
   **Create Certificate**。选择 **Pass Type ID Certificate**，上传您的 CSR 文件，并下载
   生成的 `.cer` 文件。双击该文件以将其添加到 Keychain Access。
   请参阅 Apple 文档中的 [创建证书](https://developer.apple.com/help/account/capabilities/create-wallet-identifiers-and-certificates)。

4. **从 Keychain Access 中将证书导出为 .p12 文件**。在 **My Certificates** 部分，
   找到您的 Pass Type ID 证书，右键单击它，然后选择 **Export**。选择 `.p12` 格式
   并设置一个导出密码。您在 Pushwoosh 中将需要此文件和密码。

## 在控制面板中配置证书

1. 在控制面板中，转到 **Settings → Configure platforms**。
2. 在 **MOBILE PLATFORMS** 下，找到 **iOS** 并点击 **SET UP PASSKIT**。

<img src="/configure-platforms-passkit-1.webp" alt="Configure platforms 页面，iOS 行在平台操作按钮中显示 SET UP PASSKIT"/>

3. 点击 **PASS TYPE ID CERTIFICATE FILE (.P12)** 旁边的附件图标，然后选择您的 `.p12` 文件。
4. 在 **PRIVATE KEY PASSWORD** 中，输入您从 Keychain Access 导出 `.p12` 文件时设置的密码。
5. 点击 **Configure**。

<img src="/configure-platforms-passkit-2.webp" alt="Apple Wallet Pass Type ID 证书表单，包含 p12 文件上传、私钥密码字段和 Configure 按钮"/>

<Aside type="tip" title="保持证书最新">
Pass Type ID 证书会过期（Apple 颁发的证书有有限的有效期）。当证书接近到期时，请在您的 Apple Developer 帐户中续订它，导出一个新的 `.p12` 文件，然后在 **Configure platforms** → **SET UP PASSKIT** 页面上重新上传。

如果配置的证书已过期，Pushwoosh 将无法再签署 pass。创建和更新 pass 将会失败，直到您上传一个有效的证书。请在证书失效前更换它，以避免中断正在使用的 pass。
</Aside>