更新 Cloud 的 TLS 证书

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。信息

用于在虚拟主机或目标端点/目标服务器中指定密钥库和信任库的名称的方法决定了执行证书更新的方式。您可以使用以下形式指定密钥库和信任库的名称：

• 参考文献 - 首选
• 直接名称
• 流变量

其中每种方法在证书更新流程中都有不同的反应，如下表所示。

在 更新

在更新当前证书之前，请使用以下 openssl 命令对其进行测试：

echo | openssl s_client -servername HOSTNAME -connect ORG-ENV.apigee.net:443 2>/dev/null | openssl x509 -noout -dates -subject

其中 HOSTNAME 是主机别名，ORG-ENV 是组织， 环境例如：

echo | openssl s_client -servername example.com -connect myOrg-prod.apigee.net:443 2>/dev/null | openssl x509 -noout -dates -subject

您会在表单中看到输出：

notBefore=Dec 30 22:11:38 2015 GMT
notAfter=Dec 30 22:11:38 2016 GMT
subject= /OU=Domain Control Validated/CN=*.apigee.net

更新证书后，使用同一命令对其进行测试。

确定虚拟主机或目标端点/目标服务器如何引用密钥库和信任库

1. 登录 https://enterprise.apigee.com，进入 Edge 管理界面。
2. 在“边缘管理界面”菜单中，选择贵组织的名称。
3. 对于虚拟主机，确定虚拟主机如何指定密钥库和信任库。
   1. 根据您的 Edge 界面版本，执行以下操作：
      1. 如果您使用的是传统版 Edge 界面：请依次选择 API > 环境配置。
      2. 如果您使用的是新版 Edge 界面，请依次选择管理 > 环境。
   2. 选择虚拟主机标签页。
   3. 对于要更新的特定虚拟主机，请选择显示按钮以显示其属性。显示屏包含以下属性：
      1. Key Store：当前密钥库的名称，通常指定 作为来自 ref://mykeystoreref 的参考。
         
         或者，也可能由直接名称指定，格式为 myKeystoreName，也可以由流变量指定，形式为 {ssl.keystore}。
      2. 密钥别名。此属性的值是 密钥库。您必须在新密钥库中创建一个具有相同名称的别名。
      3. 受信任证书存储区：当前受信任证书存储区的名称（如果有），通常 在 ref://mytruststoreref 中指定为引用。
         
         或者，也可以使用直接名称（格式为 myTruststoreName）或流变量（格式为 {ssl.truststorestore}）指定它。
4. 对于目标端点/目标服务器，确定目标端点如何指定密钥库和信任库：
   1. 在 Edge 管理界面菜单中，选择 API。
   2. 选择 API 代理的名称。
   3. 选择开发标签页。
   4. 在目标端点下，选择 default。
   5. 代码区域中会显示 TargetEndpoint 定义。查看 <SSLInfo> 元素，用于查看密钥库/truststore 的定义。
      
      注意：如果目标端点使用目标服务器，则目标端点的 XML 定义如下所示，其中 <LoadBalancer> 标记指定了 API 代理使用的目标服务器。

      <TargetEndpoint name="default">
        …
        <HTTPTargetConnection>
          <LoadBalancer>
            <Server name="target1" />
            <Server name="target2" />
          </LoadBalancer>
          <Path>/test</Path>
        </HTTPTargetConnection>
          …
      </TargetEndpoint>

      检查目标服务器定义中的 <SSLInfo> 元素，以确定如何 已定义密钥库/信任库。

更新密钥库中的 TLS 证书

密钥库中的证书过期后，您将无法向密钥库上传新证书。相反， 创建一个新的密钥库并上传证书，然后更新您的虚拟主机或目标服务器/目标 端点以使用新的密钥库。

通常，您应在当前证书过期之前创建新的密钥库，然后更新虚拟主机或目标端点以使用新的密钥库，以便您能够继续处理请求，而不会因证书过期而中断。然后，您便可删除 密钥库。

对于基于云的 Edge 部署：

1. 创建新的密钥库，然后上传证书和密钥，如使用 Edge 界面创建密钥库和信任库中所述。

   在新的密钥库中，确保使用与 现有的密钥库。

2. 对于用于入站连接（表示 API）的虚拟主机 发送到 Edge 中：
   1. 如果您的虚拟主机使用对密钥库的引用，请更新该引用。
   2. 如果您的虚拟主机使用密钥库的直接名称，请与 Apigee Edge 支持联系。
3. 对于出站连接使用的目标端点/目标服务器（即从 Apigee 到后端服务器）：
   1. 如果目标端点/目标服务器使用对密钥库的引用，请更新 参考。无需重新部署代理。
   2. 如果目标端点/目标服务器使用流变量，请更新流变量。否 必须再次部署代理

   3. 如果目标端点/目标服务器使用密钥库的直接名称，请更新引用旧密钥库和密钥别名的所有 API 代理的目标端点/目标服务器配置，以引用新的密钥库和密钥别名。

      然后，您必须重新部署代理。

4. 确认新密钥库可正常运行后，删除旧密钥库 包含过期证书和密钥的密钥库。

更新信任库中的 TLS 证书

当信任库中的证书过期时，您通常会创建新的信任库并上传证书，然后更新虚拟主机或目标服务器/目标端点以使用新的信任库。

如果证书是证书链的一部分，则必须创建一个包含所有 证书并将文件上传到单个别名，或将证书链中的所有证书分别上传到 对每个证书使用不同的别名。

通常，您应在当前证书过期之前创建新的信任库，然后更新虚拟主机或目标端点以使用新的信任库，以便您能够继续处理请求，而不会因证书过期而中断。然后，在确保新信任库正常运行后，您可以删除旧信任库。

对于基于云端的 Edge 部署：

1. 按照说明创建新的信任库并上传证书 使用 Edge 界面创建密钥库和信任库。

   将新证书上传到新信任库时，别名名称无关紧要。

2. 对于用于入站连接（表示 API）的虚拟主机 发送到 Edge 中：
   1. 如果您的虚拟主机使用对信任库的引用，请更新该引用。
   2. 如果您的虚拟主机使用信任库的直接名称，请与 Apigee Edge 支持团队联系。
3. 对于出站连接使用的目标端点/目标服务器，表示 从 Apigee 迁移到后端服务器：
   1. 如果目标端点/目标服务器使用信任库的引用，请更新该引用。无需重新部署代理。
   2. 如果目标端点/目标服务器使用流变量，请更新该流变量。无需重新部署代理。

   3. 如果目标端点/目标服务器使用信任库的直接名称， 更新引用的任何 API 代理的目标端点/目标服务器配置 旧信任库来引用新的密钥库和密钥别名。

      然后，您必须重新部署代理。

4. 确认新的信任库正常运行后，删除包含已过期证书的旧信任库。