证书要求

在 EKS/AKS 上安装 Automation Suite 的 TLS 和身份令牌签名证书要求。

重要提示：

有关如何在安装后管理证书的详细信息，请参阅管理证书。

Automation Suite 在安装时需要两个证书。

• TLS 证书- 客户端和集群之间的 TLS 通信所必需的。
• 身份令牌签名证书- 签署身份验证令牌所必需的。

重要提示：

安装流程会代表您生成自签名证书。 我们建议您将这些证书替换为由受信任的证书颁发机构 (CA) 签名的证书。 请注意，只有您在安装期间授予 Automation Suite 安装程序管理员权限时，才能在安装时生成证书。 如果您无法向安装程序授予管理员权限，则必须自行创建和管理证书。

除了前面的证书外，如果您希望集群信任外部软件，则可能需要提供其他受信任的 CA 证书。 示例：SQL Server CA 证书、SMTP Server CA 证书、与 S3 兼容的外部对象存储 CA 证书等。

在安装时，您必须为需要安全 TLS 通信的任何外部软件提供 CA 证书。但是，如果尚未启用 TLS 通信，则可以在安装后进行配置。

有关说明，请参阅管理证书。

TLS 证书要求

TLS 证书必须满足以下要求：

• 文件格式应为.pem ，即 Base64 编码的 DER 证书；

• 私钥长度应至少为 2048；

• 扩展密钥用法：TLS Web 服务器身份验证；在 iOS 设备上访问 Automation Suite 所必需的；

• 证书密钥必须解密。如果密钥已加密，请运行以下命令将其解密：

  # replace /path/to/encrypted/cert/key to absolute file path of key
  # replace /path/to/decrypt/cert/key to store decrypt key
  # Once prompted, please entry the passphrase or password to decrypt the key
  
  openssl rsa -in /path/to/encrypted/cert/key -out /path/to/decrypt/cert/key
  

• 应包含安装 Automation Suite 所需的所有 DNS 条目的使用者可选名称。如果集群的 FQDN 为 automationsuite.mycompany.com，则证书 SAN 应具有以下 DNS：

  • automationsuite.mycompany.com
  • *.automationsuite.mycompany.com
  备注：

  或者，如果 * 通配符过于通用，请确保以下 DNS 具有 SAN 条目：

  • automationsuite.mycompany.com
  • alm.automationsuite.mycompany.com
  • monitoring.automationsuite.mycompany.com
  • insights.automationsuite.mycompany.com
  • apps.automationsuite.mycompany.com

TLS 证书文件

Automation Suite 在安装时需要三个文件，如下所示：

• TLS 证书文件- 服务器的公共证书文件。此文件必须包含 PEM 格式的完整公共服务器证书链：叶服务器证书、中间 CA 证书和根 CA，构成该叶证书的签名路径。仅包含属于叶证书实际签名链的证书，请勿包含同级 CA 证书、不相关证书、重复证书或备用 CA 证书。
• TLS 密钥文件- 服务器证书的私钥文件。
• 证书颁发机构捆绑包- 这是 CA 的公共证书，用于签名或颁发 TLS 证书。此文件必须包含完整的证书链，包括根 CA 证书和所有中间证书。仅包含用于对 TLS 服务器证书进行签名的证书。包括其他任何内容都会导致失败。

重要提示：

从 Automation Suite 2.2510.2 开始，ca.crt 必须包含用于对 TLS 服务器证书进行签名的完整证书链，包括所有中间证书和根 CA。不接受部分链，并且包含叶证书的实际签名链之外的证书（例如同级证书、不相关证书、重复证书或备用 CA 证书）也会导致 TLS 验证失败。有关 TLS 证书验证错误的故障排除，请参阅TLS 证书验证错误。

要验证 CA 和 TLS 证书，请在 Linux 计算机上运行以下命令：

# Please replace /path/to/ca-certificate-bundle and /path/to/server-certificate with actual file path.
openssl verify -CAfile /path/to/ca-certificate-bundle /path/to/server-certificate

如果您选择使用自己的证书管理器，并且 TLS 证书由私有或非公共 CA 颁发，则必须手动将叶证书和中间 CA 证书包含在 TLS 证书文件中。如果是公共 CA，客户端系统将自动信任它们，您无需采取进一步的措施。

身份令牌签名证书

Automation Suite 在安装时对令牌签名证书有以下要求：

• 文件格式应为 pkcs12，以便对身份验证令牌进行签名；
• 用于对证书进行签名的密码为必填项。

如果未提供身份令牌签名证书，则 Automation Suite 在安装时使用服务器证书。