文档

PEM格式无效会在Adobe Commerce中触发密钥验证错误

Last update: Mon Mar 30 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

在Adobe Commerce中，在Commerce Services Connector中为Adobe支付服务配置API密钥时，会发生密钥验证错误。 当私钥PEM(Privacy-Enhanced Mail)文件的格式不正确时，会出现这些错误。 要解决此问题，请更正PEM(Privacy-Enhanced Mail)文件格式，以便将Base64内容与页眉和页脚正确分开。

描述 description

环境

产品：Adobe Commerce

问题/症状

安装过程中出现以下症状：

  • 添加沙盒密钥时，错误消息状态​ 公钥无效 ​和​私钥无效。
  • 由于PEM格式不正确，私钥验证失败，且密钥内容与页眉或页脚放在同一行。

解决方法 resolution

要解决此问题，请执行以下步骤：

  1. 确保私钥PEM文件的Base64内容位于页眉和页脚之间的单独行中，且没有额外的字符或前导空格。 在Commerce Services Connector中了解详情。

  2. 如果存在额外的字符或前导空格，您可以使用以下沙盒私钥标准化沙盒：

    code language-none 
    awk '
function trim(s){ sub(/[  \t\r\n] +/, "", s); sub(/[  \t\r\n] +$/, "", s); return s }

# BEGIN/END lines: print as-is (trimmed), no extra newlines
/-----BEGIN / { print trim($0); next }
/-----END /   { print trim($0); next }

# Body: remove *all* whitespace then wrap at 64 chars
{
  line = trim($0)
  gsub(/[  \t\r\n] /, "", line)
  while (length(line) > 64) { print substr(line,1,64); line = substr(line,65) }
  if (length(line)) print line
}' <key_incorrect_oneline.pem> > <key_normalized_multiline.pem>

  3. 在Commerce服务连接器配置中输入更正后的沙盒私钥。 在Commerce Services Connector中了解详情。

  4. 如果成功，请使用规范化的生产私钥重复此操作。

  5. 刷新“Commerce服务连接器”页面。

  6. 在连接器界面中重新验证公钥和私钥。

  7. 验证是否不再出现无效的密钥错误。

注释

  • 沙盒和生产环境的公钥均不需要更改。
  • 规范化PEM文件应按照标准PEM格式要求（每行包装64个字符的Base64数据）提供或生成。

相关阅读

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f